chore: Update generation configuration at Wed Aug 20 02:30:19 UTC 2025

.github/scripts/update_generation_config.sh

@@ -1,5 +1,5 @@
 #!/bin/bash
-set -e
+set -ex
 # This script should be run at the root of the repository.
 # This script is used to update googleapis_commitish, gapic_generator_version,
 # and libraries_bom_version in generation configuration at the time of running

.github/workflows/hermetic_library_generation.yaml

@@ -37,7 +37,7 @@ jobs:
       with:
         fetch-depth: 0
         token: ${{ secrets.CLOUD_JAVA_BOT_TOKEN }}
-    - uses: googleapis/sdk-platform-java/.github/scripts@v2.61.0
+    - uses: googleapis/sdk-platform-java/.github/scripts@v2.62.0
       if: env.SHOULD_RUN == 'true'
       with:
         base_ref: ${{ github.base_ref }}

README.md

@@ -49,7 +49,7 @@ If you are using Maven without the BOM, add this to your dependencies:
 If you are using Gradle 5.x or later, add this to your dependencies:
 
 ```Groovy
-implementation platform('com.google.cloud:libraries-bom:26.64.0')
+implementation platform('com.google.cloud:libraries-bom:26.66.0')
 
 implementation 'com.google.cloud:google-cloud-firestore'
 ```

generation_config.yaml

@@ -1,6 +1,6 @@
-gapic_generator_version: 2.60.2
-googleapis_commitish: fb0d8ac09cd1c2d94e9da572f0ad4692c8781410
-libraries_bom_version: 26.64.0
+gapic_generator_version: 2.62.0
+googleapis_commitish: 3b2a2ae91db23a9c879b2b725d6a5de6bd64a800
+libraries_bom_version: 26.66.0
 libraries:
   - api_shortname: firestore
     name_pretty: Cloud Firestore

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

@@ -38,6 +38,8 @@
 import com.google.firestore.admin.v1.BulkDeleteDocumentsMetadata;
 import com.google.firestore.admin.v1.BulkDeleteDocumentsRequest;
 import com.google.firestore.admin.v1.BulkDeleteDocumentsResponse;
+import com.google.firestore.admin.v1.CloneDatabaseMetadata;
+import com.google.firestore.admin.v1.CloneDatabaseRequest;
 import com.google.firestore.admin.v1.CollectionGroupName;
 import com.google.firestore.admin.v1.CreateBackupScheduleRequest;
 import com.google.firestore.admin.v1.CreateDatabaseMetadata;
@@ -755,6 +757,23 @@
  *      </ul>
  *       </td>
  *    </tr>
+ *    <tr>
+ *      <td><p> CloneDatabase</td>
+ *      <td><p> Creates a new database by cloning an existing one.
+ * <p>  The new database must be in the same cloud region or multi-region location as the existing database. This behaves similar to [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.FirestoreAdmin.CreateDatabase] except instead of creating a new empty database, a new database is created with the database type, index configuration, and documents from an existing database.
+ * <p>  The [long-running operation][google.longrunning.Operation] can be used to track the progress of the clone, with the Operation's [metadata][google.longrunning.Operation.metadata] field type being the [CloneDatabaseMetadata][google.firestore.admin.v1.CloneDatabaseMetadata]. The [response][google.longrunning.Operation.response] type is the [Database][google.firestore.admin.v1.Database] if the clone was successful. The new database is not readable or writeable until the LRO has completed.</td>
+ *      <td>
+ *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
+ *      <ul>
+ *           <li><p> cloneDatabaseAsync(CloneDatabaseRequest request)
+ *      </ul>
+ *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
+ *      <ul>
+ *           <li><p> cloneDatabaseOperationCallable()
+ *           <li><p> cloneDatabaseCallable()
+ *      </ul>
+ *       </td>
+ *    </tr>
  *  </table>
  *
  * <p>See the individual methods for example code.
@@ -4990,6 +5009,143 @@ public final UnaryCallable<DeleteBackupScheduleRequest, Empty> deleteBackupSched
     return stub.deleteBackupScheduleCallable();
   }
 
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Creates a new database by cloning an existing one.
+   *
+   * <p>The new database must be in the same cloud region or multi-region location as the existing
+   * database. This behaves similar to
+   * [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.FirestoreAdmin.CreateDatabase] except
+   * instead of creating a new empty database, a new database is created with the database type,
+   * index configuration, and documents from an existing database.
+   *
+   * <p>The [long-running operation][google.longrunning.Operation] can be used to track the progress
+   * of the clone, with the Operation's [metadata][google.longrunning.Operation.metadata] field type
+   * being the [CloneDatabaseMetadata][google.firestore.admin.v1.CloneDatabaseMetadata]. The
+   * [response][google.longrunning.Operation.response] type is the
+   * [Database][google.firestore.admin.v1.Database] if the clone was successful. The new database is
+   * not readable or writeable until the LRO has completed.
+   *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+   * try (FirestoreAdminClient firestoreAdminClient = FirestoreAdminClient.create()) {
+   *   CloneDatabaseRequest request =
+   *       CloneDatabaseRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setDatabaseId("databaseId1688905718")
+   *           .setPitrSnapshot(PitrSnapshot.newBuilder().build())
+   *           .setEncryptionConfig(Database.EncryptionConfig.newBuilder().build())
+   *           .putAllTags(new HashMap<String, String>())
+   *           .build();
+   *   Database response = firestoreAdminClient.cloneDatabaseAsync(request).get();
+   * }
+   * }</pre>
+   *
+   * @param request The request object containing all of the parameters for the API call.
+   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   */
+  public final OperationFuture<Database, CloneDatabaseMetadata> cloneDatabaseAsync(
+      CloneDatabaseRequest request) {
+    return cloneDatabaseOperationCallable().futureCall(request);
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Creates a new database by cloning an existing one.
+   *
+   * <p>The new database must be in the same cloud region or multi-region location as the existing
+   * database. This behaves similar to
+   * [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.FirestoreAdmin.CreateDatabase] except
+   * instead of creating a new empty database, a new database is created with the database type,
+   * index configuration, and documents from an existing database.
+   *
+   * <p>The [long-running operation][google.longrunning.Operation] can be used to track the progress
+   * of the clone, with the Operation's [metadata][google.longrunning.Operation.metadata] field type
+   * being the [CloneDatabaseMetadata][google.firestore.admin.v1.CloneDatabaseMetadata]. The
+   * [response][google.longrunning.Operation.response] type is the
+   * [Database][google.firestore.admin.v1.Database] if the clone was successful. The new database is
+   * not readable or writeable until the LRO has completed.
+   *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+   * try (FirestoreAdminClient firestoreAdminClient = FirestoreAdminClient.create()) {
+   *   CloneDatabaseRequest request =
+   *       CloneDatabaseRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setDatabaseId("databaseId1688905718")
+   *           .setPitrSnapshot(PitrSnapshot.newBuilder().build())
+   *           .setEncryptionConfig(Database.EncryptionConfig.newBuilder().build())
+   *           .putAllTags(new HashMap<String, String>())
+   *           .build();
+   *   OperationFuture<Database, CloneDatabaseMetadata> future =
+   *       firestoreAdminClient.cloneDatabaseOperationCallable().futureCall(request);
+   *   // Do something.
+   *   Database response = future.get();
+   * }
+   * }</pre>
+   */
+  public final OperationCallable<CloneDatabaseRequest, Database, CloneDatabaseMetadata>
+      cloneDatabaseOperationCallable() {
+    return stub.cloneDatabaseOperationCallable();
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Creates a new database by cloning an existing one.
+   *
+   * <p>The new database must be in the same cloud region or multi-region location as the existing
+   * database. This behaves similar to
+   * [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.FirestoreAdmin.CreateDatabase] except
+   * instead of creating a new empty database, a new database is created with the database type,
+   * index configuration, and documents from an existing database.
+   *
+   * <p>The [long-running operation][google.longrunning.Operation] can be used to track the progress
+   * of the clone, with the Operation's [metadata][google.longrunning.Operation.metadata] field type
+   * being the [CloneDatabaseMetadata][google.firestore.admin.v1.CloneDatabaseMetadata]. The
+   * [response][google.longrunning.Operation.response] type is the
+   * [Database][google.firestore.admin.v1.Database] if the clone was successful. The new database is
+   * not readable or writeable until the LRO has completed.
+   *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+   * try (FirestoreAdminClient firestoreAdminClient = FirestoreAdminClient.create()) {
+   *   CloneDatabaseRequest request =
+   *       CloneDatabaseRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setDatabaseId("databaseId1688905718")
+   *           .setPitrSnapshot(PitrSnapshot.newBuilder().build())
+   *           .setEncryptionConfig(Database.EncryptionConfig.newBuilder().build())
+   *           .putAllTags(new HashMap<String, String>())
+   *           .build();
+   *   ApiFuture<Operation> future =
+   *       firestoreAdminClient.cloneDatabaseCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }</pre>
+   */
+  public final UnaryCallable<CloneDatabaseRequest, Operation> cloneDatabaseCallable() {
+    return stub.cloneDatabaseCallable();
+  }
+
   @Override
   public final void close() {
     stub.close();

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

@@ -38,6 +38,8 @@
 import com.google.firestore.admin.v1.BulkDeleteDocumentsMetadata;
 import com.google.firestore.admin.v1.BulkDeleteDocumentsRequest;
 import com.google.firestore.admin.v1.BulkDeleteDocumentsResponse;
+import com.google.firestore.admin.v1.CloneDatabaseMetadata;
+import com.google.firestore.admin.v1.CloneDatabaseRequest;
 import com.google.firestore.admin.v1.CreateBackupScheduleRequest;
 import com.google.firestore.admin.v1.CreateDatabaseMetadata;
 import com.google.firestore.admin.v1.CreateDatabaseRequest;
@@ -388,6 +390,17 @@ public UnaryCallSettings<DeleteBackupScheduleRequest, Empty> deleteBackupSchedul
     return ((FirestoreAdminStubSettings) getStubSettings()).deleteBackupScheduleSettings();
   }
 
+  /** Returns the object with the settings used for calls to cloneDatabase. */
+  public UnaryCallSettings<CloneDatabaseRequest, Operation> cloneDatabaseSettings() {
+    return ((FirestoreAdminStubSettings) getStubSettings()).cloneDatabaseSettings();
+  }
+
+  /** Returns the object with the settings used for calls to cloneDatabase. */
+  public OperationCallSettings<CloneDatabaseRequest, Database, CloneDatabaseMetadata>
+      cloneDatabaseOperationSettings() {
+    return ((FirestoreAdminStubSettings) getStubSettings()).cloneDatabaseOperationSettings();
+  }
+
   public static final FirestoreAdminSettings create(FirestoreAdminStubSettings stub)
       throws IOException {
     return new FirestoreAdminSettings.Builder(stub.toBuilder()).build();
@@ -725,6 +738,17 @@ public UnaryCallSettings.Builder<RestoreDatabaseRequest, Operation> restoreDatab
       return getStubSettingsBuilder().deleteBackupScheduleSettings();
     }
 
+    /** Returns the builder for the settings used for calls to cloneDatabase. */
+    public UnaryCallSettings.Builder<CloneDatabaseRequest, Operation> cloneDatabaseSettings() {
+      return getStubSettingsBuilder().cloneDatabaseSettings();
+    }
+
+    /** Returns the builder for the settings used for calls to cloneDatabase. */
+    public OperationCallSettings.Builder<CloneDatabaseRequest, Database, CloneDatabaseMetadata>
+        cloneDatabaseOperationSettings() {
+      return getStubSettingsBuilder().cloneDatabaseOperationSettings();
+    }
+
     @Override
     public FirestoreAdminSettings build() throws IOException {
       return new FirestoreAdminSettings(this);

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

@@ -13,6 +13,9 @@
             "BulkDeleteDocuments": {
               "methods": ["bulkDeleteDocumentsAsync", "bulkDeleteDocumentsAsync", "bulkDeleteDocumentsAsync", "bulkDeleteDocumentsOperationCallable", "bulkDeleteDocumentsCallable"]
             },
+            "CloneDatabase": {
+              "methods": ["cloneDatabaseAsync", "cloneDatabaseOperationCallable", "cloneDatabaseCallable"]
+            },
             "CreateBackupSchedule": {
               "methods": ["createBackupSchedule", "createBackupSchedule", "createBackupSchedule", "createBackupScheduleCallable"]
             },

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

@@ -27,6 +27,8 @@
 import com.google.firestore.admin.v1.BulkDeleteDocumentsMetadata;
 import com.google.firestore.admin.v1.BulkDeleteDocumentsRequest;
 import com.google.firestore.admin.v1.BulkDeleteDocumentsResponse;
+import com.google.firestore.admin.v1.CloneDatabaseMetadata;
+import com.google.firestore.admin.v1.CloneDatabaseRequest;
 import com.google.firestore.admin.v1.CreateBackupScheduleRequest;
 import com.google.firestore.admin.v1.CreateDatabaseMetadata;
 import com.google.firestore.admin.v1.CreateDatabaseRequest;
@@ -278,6 +280,15 @@ public UnaryCallable<DeleteBackupScheduleRequest, Empty> deleteBackupScheduleCal
     throw new UnsupportedOperationException("Not implemented: deleteBackupScheduleCallable()");
   }
 
+  public OperationCallable<CloneDatabaseRequest, Database, CloneDatabaseMetadata>
+      cloneDatabaseOperationCallable() {
+    throw new UnsupportedOperationException("Not implemented: cloneDatabaseOperationCallable()");
+  }
+
+  public UnaryCallable<CloneDatabaseRequest, Operation> cloneDatabaseCallable() {
+    throw new UnsupportedOperationException("Not implemented: cloneDatabaseCallable()");
+  }
+
   @Override
   public abstract void close();
 }