fix: change REST binding for ListDocuments to support root collection (#900)

* fix: change REST binding for ListDocuments to support root collection PiperOrigin-RevId: 432504691 Source-Link: googleapis/googleapis@3db3087 Source-Link: https://github.com/googleapis/googleapis-gen/commit/80f0375a1a82460532422e504a41ef2a3e2f72e1 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiODBmMDM3NWExYTgyNDYwNTMyNDIyZTUwNGE0MWVmMmEzZTJmNzJlMSJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md Co-authored-by: Jeffrey Rennie <rennie@google.com> Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com> Co-authored-by: Tomo Suzuki <suztomo@google.com>

Author: 3 people

google-cloud-firestore-admin/src/main/java/com/google/cloud/firestore/v1/FirestoreAdminClient.java

@@ -33,22 +33,28 @@
 import com.google.api.gax.rpc.UnaryCallSettings;
 import com.google.cloud.firestore.v1.stub.FirestoreAdminStubSettings;
 import com.google.firestore.admin.v1.CreateIndexRequest;
+import com.google.firestore.admin.v1.Database;
 import com.google.firestore.admin.v1.DeleteIndexRequest;
 import com.google.firestore.admin.v1.ExportDocumentsMetadata;
 import com.google.firestore.admin.v1.ExportDocumentsRequest;
 import com.google.firestore.admin.v1.ExportDocumentsResponse;
 import com.google.firestore.admin.v1.Field;
 import com.google.firestore.admin.v1.FieldOperationMetadata;
+import com.google.firestore.admin.v1.GetDatabaseRequest;
 import com.google.firestore.admin.v1.GetFieldRequest;
 import com.google.firestore.admin.v1.GetIndexRequest;
 import com.google.firestore.admin.v1.ImportDocumentsMetadata;
 import com.google.firestore.admin.v1.ImportDocumentsRequest;
 import com.google.firestore.admin.v1.Index;
 import com.google.firestore.admin.v1.IndexOperationMetadata;
+import com.google.firestore.admin.v1.ListDatabasesRequest;
+import com.google.firestore.admin.v1.ListDatabasesResponse;
 import com.google.firestore.admin.v1.ListFieldsRequest;
 import com.google.firestore.admin.v1.ListFieldsResponse;
 import com.google.firestore.admin.v1.ListIndexesRequest;
 import com.google.firestore.admin.v1.ListIndexesResponse;
+import com.google.firestore.admin.v1.UpdateDatabaseMetadata;
+import com.google.firestore.admin.v1.UpdateDatabaseRequest;
 import com.google.firestore.admin.v1.UpdateFieldRequest;
 import com.google.longrunning.Operation;
 import com.google.protobuf.Empty;
@@ -163,6 +169,27 @@ public UnaryCallSettings<ImportDocumentsRequest, Operation> importDocumentsSetti
  return ((FirestoreAdminStubSettings) getStubSettings()).importDocumentsOperationSettings();
  }
 
+ /** Returns the object with the settings used for calls to getDatabase. */
+ public UnaryCallSettings<GetDatabaseRequest, Database> getDatabaseSettings() {
+ return ((FirestoreAdminStubSettings) getStubSettings()).getDatabaseSettings();
+ }
+
+ /** Returns the object with the settings used for calls to listDatabases. */
+ public UnaryCallSettings<ListDatabasesRequest, ListDatabasesResponse> listDatabasesSettings() {
+ return ((FirestoreAdminStubSettings) getStubSettings()).listDatabasesSettings();
+ }
+
+ /** Returns the object with the settings used for calls to updateDatabase. */
+ public UnaryCallSettings<UpdateDatabaseRequest, Operation> updateDatabaseSettings() {
+ return ((FirestoreAdminStubSettings) getStubSettings()).updateDatabaseSettings();
+ }
+
+ /** Returns the object with the settings used for calls to updateDatabase. */
+ public OperationCallSettings<UpdateDatabaseRequest, Database, UpdateDatabaseMetadata>
+ updateDatabaseOperationSettings() {
+ return ((FirestoreAdminStubSettings) getStubSettings()).updateDatabaseOperationSettings();
+ }
+
  public static final FirestoreAdminSettings create(FirestoreAdminStubSettings stub)
  throws IOException {
  return new FirestoreAdminSettings.Builder(stub.toBuilder()).build();
@@ -333,6 +360,28 @@ public UnaryCallSettings.Builder<ImportDocumentsRequest, Operation> importDocume
  return getStubSettingsBuilder().importDocumentsOperationSettings();
  }
 
+ /** Returns the builder for the settings used for calls to getDatabase. */
+ public UnaryCallSettings.Builder<GetDatabaseRequest, Database> getDatabaseSettings() {
+ return getStubSettingsBuilder().getDatabaseSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to listDatabases. */
+ public UnaryCallSettings.Builder<ListDatabasesRequest, ListDatabasesResponse>
+ listDatabasesSettings() {
+ return getStubSettingsBuilder().listDatabasesSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to updateDatabase. */
+ public UnaryCallSettings.Builder<UpdateDatabaseRequest, Operation> updateDatabaseSettings() {
+ return getStubSettingsBuilder().updateDatabaseSettings();
+ }
+
+ /** Returns the builder for the settings used for calls to updateDatabase. */
+ public OperationCallSettings.Builder<UpdateDatabaseRequest, Database, UpdateDatabaseMetadata>
+ updateDatabaseOperationSettings() {
+ return getStubSettingsBuilder().updateDatabaseOperationSettings();
+ }
+
  @Override
  public FirestoreAdminSettings build() throws IOException {
  return new FirestoreAdminSettings(this);

google-cloud-firestore-admin/src/main/java/com/google/cloud/firestore/v1/FirestoreAdminSettings.java

@@ -19,6 +19,9 @@
  "ExportDocuments": {
  "methods": ["exportDocumentsAsync", "exportDocumentsAsync", "exportDocumentsAsync", "exportDocumentsOperationCallable", "exportDocumentsCallable"]
  },
+ "GetDatabase": {
+ "methods": ["getDatabase", "getDatabase", "getDatabase", "getDatabaseCallable"]
+ },
  "GetField": {
  "methods": ["getField", "getField", "getField", "getFieldCallable"]
  },
@@ -28,12 +31,18 @@
  "ImportDocuments": {
  "methods": ["importDocumentsAsync", "importDocumentsAsync", "importDocumentsAsync", "importDocumentsOperationCallable", "importDocumentsCallable"]
  },
+ "ListDatabases": {
+ "methods": ["listDatabases", "listDatabases", "listDatabases", "listDatabasesCallable"]
+ },
  "ListFields": {
  "methods": ["listFields", "listFields", "listFields", "listFieldsPagedCallable", "listFieldsCallable"]
  },
  "ListIndexes": {
  "methods": ["listIndexes", "listIndexes", "listIndexes", "listIndexesPagedCallable", "listIndexesCallable"]
  },
+ "UpdateDatabase": {
+ "methods": ["updateDatabaseAsync", "updateDatabaseAsync", "updateDatabaseOperationCallable", "updateDatabaseCallable"]
+ },
  "UpdateField": {
  "methods": ["updateFieldAsync", "updateFieldAsync", "updateFieldOperationCallable", "updateFieldCallable"]
  }

google-cloud-firestore-admin/src/main/java/com/google/cloud/firestore/v1/gapic_metadata.json

@@ -15,12 +15,38 @@
  */
 
 /**
- * The interfaces provided are listed below, along with usage samples.
+ * A client to Cloud Firestore API
+ *
+ * <p>The interfaces provided are listed below, along with usage samples.
  *
  * <p>======================= FirestoreAdminClient =======================
  *
- * <p>Service Description: Operations are created by service `FirestoreAdmin`, but are accessed via
- * service `google.longrunning.Operations`.
+ * <p>Service Description: The Cloud Firestore Admin API.
+ *
+ * <p>This API provides several administrative services for Cloud Firestore.
+ *
+ * <p>Project, Database, Namespace, Collection, Collection Group, and Document are used as defined
+ * in the Google Cloud Firestore API.
+ *
+ * <p>Operation: An Operation represents work being performed in the background.
+ *
+ * <p>The index service manages Cloud Firestore indexes.
+ *
+ * <p>Index creation is performed asynchronously. An Operation resource is created for each such
+ * asynchronous operation. The state of the operation (including any errors encountered) may be
+ * queried via the Operation resource.
+ *
+ * <p>The Operations collection provides a record of actions performed for the specified Project
+ * (including any Operations in progress). Operations are not created directly but through calls on
+ * other collections or resources.
+ *
+ * <p>An Operation that is done may be deleted so that it is no longer listed as part of the
+ * Operation collection. Operations are garbage collected after 30 days. By default, ListOperations
+ * will only return in progress and failed operations. To list completed operation, issue a
+ * ListOperations request with the filter `done: true`.
+ *
+ * <p>Operations are created by service `FirestoreAdmin`, but are accessed via service
+ * `google.longrunning.Operations`.
  *
  * <p>Sample for FirestoreAdminClient:
  *

google-cloud-firestore-admin/src/main/java/com/google/cloud/firestore/v1/package-info.java

@@ -23,22 +23,28 @@
 import com.google.api.gax.rpc.OperationCallable;
 import com.google.api.gax.rpc.UnaryCallable;
 import com.google.firestore.admin.v1.CreateIndexRequest;
+import com.google.firestore.admin.v1.Database;
 import com.google.firestore.admin.v1.DeleteIndexRequest;
 import com.google.firestore.admin.v1.ExportDocumentsMetadata;
 import com.google.firestore.admin.v1.ExportDocumentsRequest;
 import com.google.firestore.admin.v1.ExportDocumentsResponse;
 import com.google.firestore.admin.v1.Field;
 import com.google.firestore.admin.v1.FieldOperationMetadata;
+import com.google.firestore.admin.v1.GetDatabaseRequest;
 import com.google.firestore.admin.v1.GetFieldRequest;
 import com.google.firestore.admin.v1.GetIndexRequest;
 import com.google.firestore.admin.v1.ImportDocumentsMetadata;
 import com.google.firestore.admin.v1.ImportDocumentsRequest;
 import com.google.firestore.admin.v1.Index;
 import com.google.firestore.admin.v1.IndexOperationMetadata;
+import com.google.firestore.admin.v1.ListDatabasesRequest;
+import com.google.firestore.admin.v1.ListDatabasesResponse;
 import com.google.firestore.admin.v1.ListFieldsRequest;
 import com.google.firestore.admin.v1.ListFieldsResponse;
 import com.google.firestore.admin.v1.ListIndexesRequest;
 import com.google.firestore.admin.v1.ListIndexesResponse;
+import com.google.firestore.admin.v1.UpdateDatabaseMetadata;
+import com.google.firestore.admin.v1.UpdateDatabaseRequest;
 import com.google.firestore.admin.v1.UpdateFieldRequest;
 import com.google.longrunning.Operation;
 import com.google.longrunning.stub.OperationsStub;
@@ -122,6 +128,23 @@ public UnaryCallable<ImportDocumentsRequest, Operation> importDocumentsCallable(
  throw new UnsupportedOperationException("Not implemented: importDocumentsCallable()");
  }
 
+ public UnaryCallable<GetDatabaseRequest, Database> getDatabaseCallable() {
+ throw new UnsupportedOperationException("Not implemented: getDatabaseCallable()");
+ }
+
+ public UnaryCallable<ListDatabasesRequest, ListDatabasesResponse> listDatabasesCallable() {
+ throw new UnsupportedOperationException("Not implemented: listDatabasesCallable()");
+ }
+
+ public OperationCallable<UpdateDatabaseRequest, Database, UpdateDatabaseMetadata>
+ updateDatabaseOperationCallable() {
+ throw new UnsupportedOperationException("Not implemented: updateDatabaseOperationCallable()");
+ }
+
+ public UnaryCallable<UpdateDatabaseRequest, Operation> updateDatabaseCallable() {
+ throw new UnsupportedOperationException("Not implemented: updateDatabaseCallable()");
+ }
+
  @Override
  public abstract void close();
 }