chore: regenerate spanner client (googleapis#29680)

Generated in GitHub action: https://togithub.com/googleapis/googleapis/google-api-java-client-services/actions/workflows/codegen.yaml

Author: yoshi-code-bot

clients/google-api-services-spanner/v1/2.0.0/README.md

@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-spanner</artifactId>
-      <version>v1-rev20250708-2.0.0</version>
+      <version>v1-rev20250920-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-spanner:v1-rev20250708-2.0.0'
+  implementation 'com.google.apis:google-api-services-spanner:v1-rev20250920-2.0.0'
 }
 ```
 

clients/google-api-services-spanner/v1/2.0.0/com/google/api/services/spanner/v1/Spanner.java

@@ -4692,10 +4692,10 @@ public Copy set(String parameterName, Object value) {
          * This request holds the parameters needed by the spanner server.  After setting any optional
          * parameters, call the {@link Create#execute()} method to invoke the remote operation.
          *
-         * @param parent Required. The name of the instance in which the backup will be created. This must be the same
-         *        instance that contains the database the backup will be created from. The backup will be
-         *        stored in the location(s) specified in the instance configuration of this instance. Values
-         *        are of the form `projects//instances/`.
+         * @param parent Required. The name of the instance in which the backup is created. This must be the same instance
+         *        that contains the database the backup is created from. The backup will be stored in the
+         *        locations specified in the instance configuration of this instance. Values are of the form
+         *        `projects//instances/`.
          * @param content the {@link com.google.api.services.spanner.v1.model.Backup}
          * @return the request
          */
@@ -4727,10 +4727,10 @@ public class Create extends SpannerRequest<com.google.api.services.spanner.v1.mo
            * Create#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} must
            * be called to initialize this instance immediately after invoking the constructor. </p>
            *
-           * @param parent Required. The name of the instance in which the backup will be created. This must be the same
-         *        instance that contains the database the backup will be created from. The backup will be
-         *        stored in the location(s) specified in the instance configuration of this instance. Values
-         *        are of the form `projects//instances/`.
+           * @param parent Required. The name of the instance in which the backup is created. This must be the same instance
+         *        that contains the database the backup is created from. The backup will be stored in the
+         *        locations specified in the instance configuration of this instance. Values are of the form
+         *        `projects//instances/`.
            * @param content the {@link com.google.api.services.spanner.v1.model.Backup}
            * @since 1.13
            */
@@ -4800,28 +4800,28 @@ public Create setUploadProtocol(java.lang.String uploadProtocol) {
           }
 
           /**
-           * Required. The name of the instance in which the backup will be created. This must be
-           * the same instance that contains the database the backup will be created from. The
-           * backup will be stored in the location(s) specified in the instance configuration of
-           * this instance. Values are of the form `projects//instances/`.
+           * Required. The name of the instance in which the backup is created. This must be the
+           * same instance that contains the database the backup is created from. The backup will be
+           * stored in the locations specified in the instance configuration of this instance.
+           * Values are of the form `projects//instances/`.
            */
           @com.google.api.client.util.Key
           private java.lang.String parent;
 
-          /** Required. The name of the instance in which the backup will be created. This must be the same
-         instance that contains the database the backup will be created from. The backup will be stored in
-         the location(s) specified in the instance configuration of this instance. Values are of the form
+          /** Required. The name of the instance in which the backup is created. This must be the same instance
+         that contains the database the backup is created from. The backup will be stored in the locations
+         specified in the instance configuration of this instance. Values are of the form
          `projects//instances/`.
            */
           public java.lang.String getParent() {
             return parent;
           }
 
           /**
-           * Required. The name of the instance in which the backup will be created. This must be
-           * the same instance that contains the database the backup will be created from. The
-           * backup will be stored in the location(s) specified in the instance configuration of
-           * this instance. Values are of the form `projects//instances/`.
+           * Required. The name of the instance in which the backup is created. This must be the
+           * same instance that contains the database the backup is created from. The backup will be
+           * stored in the locations specified in the instance configuration of this instance.
+           * Values are of the form `projects//instances/`.
            */
           public Create setParent(java.lang.String parent) {
             if (!getSuppressPatternChecks()) {
@@ -4873,14 +4873,23 @@ public Create setEncryptionConfigEncryptionType(java.lang.String encryptionConfi
           }
 
           /**
-           * Optional. The Cloud KMS key that will be used to protect the backup. This field should
-           * be set only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the
-           * form `projects//locations//keyRings//cryptoKeys/`.
+           * Optional. This field is maintained for backwards compatibility. For new callers, we
+           * recommend using `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the
+           * location of the KMS key matches the database instance's configuration (location)
+           * exactly. For example, if the KMS location is in `us-central1` or `nam3`, then the
+           * database instance must also be in `us-central1` or `nam3`. The Cloud KMS key that is
+           * used to encrypt and decrypt the restored database. Set this field only when
+           * encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form
+           * `projects//locations//keyRings//cryptoKeys/`.
            */
           @com.google.api.client.util.Key("encryptionConfig.kmsKeyName")
           private java.lang.String encryptionConfigKmsKeyName;
 
-          /** Optional. The Cloud KMS key that will be used to protect the backup. This field should be set only
+          /** Optional. This field is maintained for backwards compatibility. For new callers, we recommend using
+         `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the location of the KMS key
+         matches the database instance's configuration (location) exactly. For example, if the KMS location
+         is in `us-central1` or `nam3`, then the database instance must also be in `us-central1` or `nam3`.
+         The Cloud KMS key that is used to encrypt and decrypt the restored database. Set this field only
          when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form
          `projects//locations//keyRings//cryptoKeys/`.
            */
@@ -4889,9 +4898,14 @@ public java.lang.String getEncryptionConfigKmsKeyName() {
           }
 
           /**
-           * Optional. The Cloud KMS key that will be used to protect the backup. This field should
-           * be set only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the
-           * form `projects//locations//keyRings//cryptoKeys/`.
+           * Optional. This field is maintained for backwards compatibility. For new callers, we
+           * recommend using `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the
+           * location of the KMS key matches the database instance's configuration (location)
+           * exactly. For example, if the KMS location is in `us-central1` or `nam3`, then the
+           * database instance must also be in `us-central1` or `nam3`. The Cloud KMS key that is
+           * used to encrypt and decrypt the restored database. Set this field only when
+           * encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form
+           * `projects//locations//keyRings//cryptoKeys/`.
            */
           public Create setEncryptionConfigKmsKeyName(java.lang.String encryptionConfigKmsKeyName) {
             this.encryptionConfigKmsKeyName = encryptionConfigKmsKeyName;
@@ -5799,28 +5813,28 @@ public Patch setName(java.lang.String name) {
           }
 
           /**
-           * Required. A mask specifying which fields (e.g. `expire_time`) in the Backup resource
-           * should be updated. This mask is relative to the Backup resource, not to the request
-           * message. The field mask must always be specified; this prevents any future fields from
-           * being erased accidentally by clients that do not know about them.
+           * Required. A mask specifying which fields (for example, `expire_time`) in the backup
+           * resource should be updated. This mask is relative to the backup resource, not to the
+           * request message. The field mask must always be specified; this prevents any future
+           * fields from being erased accidentally by clients that do not know about them.
            */
           @com.google.api.client.util.Key
           private String updateMask;
 
-          /** Required. A mask specifying which fields (e.g. `expire_time`) in the Backup resource should be
-         updated. This mask is relative to the Backup resource, not to the request message. The field mask
-         must always be specified; this prevents any future fields from being erased accidentally by clients
-         that do not know about them.
+          /** Required. A mask specifying which fields (for example, `expire_time`) in the backup resource should
+         be updated. This mask is relative to the backup resource, not to the request message. The field
+         mask must always be specified; this prevents any future fields from being erased accidentally by
+         clients that do not know about them.
            */
           public String getUpdateMask() {
             return updateMask;
           }
 
           /**
-           * Required. A mask specifying which fields (e.g. `expire_time`) in the Backup resource
-           * should be updated. This mask is relative to the Backup resource, not to the request
-           * message. The field mask must always be specified; this prevents any future fields from
-           * being erased accidentally by clients that do not know about them.
+           * Required. A mask specifying which fields (for example, `expire_time`) in the backup
+           * resource should be updated. This mask is relative to the backup resource, not to the
+           * request message. The field mask must always be specified; this prevents any future
+           * fields from being erased accidentally by clients that do not know about them.
            */
           public Patch setUpdateMask(String updateMask) {
             this.updateMask = updateMask;
@@ -9177,7 +9191,7 @@ public TestIamPermissions set(String parameterName, Object value) {
         /**
          * Updates the schema of a Cloud Spanner database by creating/altering/dropping tables, columns,
          * indexes, etc. The returned long-running operation will have a name of the format `/operations/`
-         * and can be used to track execution of the schema change(s). The metadata field type is
+         * and can be used to track execution of the schema changes. The metadata field type is
          * UpdateDatabaseDdlMetadata. The operation has no response.
          *
          * Create a request for the method "databases.updateDdl".
@@ -9205,7 +9219,7 @@ public class UpdateDdl extends SpannerRequest<com.google.api.services.spanner.v1
           /**
            * Updates the schema of a Cloud Spanner database by creating/altering/dropping tables, columns,
            * indexes, etc. The returned long-running operation will have a name of the format `/operations/`
-           * and can be used to track execution of the schema change(s). The metadata field type is
+           * and can be used to track execution of the schema changes. The metadata field type is
            * UpdateDatabaseDdlMetadata. The operation has no response.
            *
            * Create a request for the method "databases.updateDdl".

clients/google-api-services-spanner/v1/2.0.0/com/google/api/services/spanner/v1/model/AdaptMessageResponse.java

@@ -29,6 +29,14 @@
 @SuppressWarnings("javadoc")
 public final class AdaptMessageResponse extends com.google.api.client.json.GenericJson {
 
+  /**
+   * Optional. Indicates whether this is the last AdaptMessageResponse in the stream. This field may
+   * be optionally set by the server. Clients should not rely on this field being set in all cases.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private java.lang.Boolean last;
+
   /**
    * Optional. Uninterpreted bytes from the underlying wire protocol.
    * The value may be {@code null}.
@@ -43,6 +51,25 @@ public final class AdaptMessageResponse extends com.google.api.client.json.Gener
   @com.google.api.client.util.Key
   private java.util.Map<String, java.lang.String> stateUpdates;
 
+  /**
+   * Optional. Indicates whether this is the last AdaptMessageResponse in the stream. This field may
+   * be optionally set by the server. Clients should not rely on this field being set in all cases.
+   * @return value or {@code null} for none
+   */
+  public java.lang.Boolean getLast() {
+    return last;
+  }
+
+  /**
+   * Optional. Indicates whether this is the last AdaptMessageResponse in the stream. This field may
+   * be optionally set by the server. Clients should not rely on this field being set in all cases.
+   * @param last last or {@code null} for none
+   */
+  public AdaptMessageResponse setLast(java.lang.Boolean last) {
+    this.last = last;
+    return this;
+  }
+
   /**
    * Optional. Uninterpreted bytes from the underlying wire protocol.
    * @see #decodePayload()

clients/google-api-services-spanner/v1/2.0.0/com/google/api/services/spanner/v1/model/Backup.java

@@ -127,8 +127,8 @@ public final class Backup extends com.google.api.client.json.GenericJson {
   private java.lang.String incrementalBackupChainId;
 
   /**
-   * Output only. The instance partition(s) storing the backup. This is the same as the list of the
-   * instance partition(s) that the database had footprint in at the backup's `version_time`.
+   * Output only. The instance partition storing the backup. This is the same as the list of the
+   * instance partitions that the database recorded at the backup's `version_time`.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -438,17 +438,17 @@ public Backup setIncrementalBackupChainId(java.lang.String incrementalBackupChai
   }
 
   /**
-   * Output only. The instance partition(s) storing the backup. This is the same as the list of the
-   * instance partition(s) that the database had footprint in at the backup's `version_time`.
+   * Output only. The instance partition storing the backup. This is the same as the list of the
+   * instance partitions that the database recorded at the backup's `version_time`.
    * @return value or {@code null} for none
    */
   public java.util.List<BackupInstancePartition> getInstancePartitions() {
     return instancePartitions;
   }
 
   /**
-   * Output only. The instance partition(s) storing the backup. This is the same as the list of the
-   * instance partition(s) that the database had footprint in at the backup's `version_time`.
+   * Output only. The instance partition storing the backup. This is the same as the list of the
+   * instance partitions that the database recorded at the backup's `version_time`.
    * @param instancePartitions instancePartitions or {@code null} for none
    */
   public Backup setInstancePartitions(java.util.List<BackupInstancePartition> instancePartitions) {

clients/google-api-services-spanner/v1/2.0.0/com/google/api/services/spanner/v1/model/CommitResponse.java

@@ -52,6 +52,15 @@ public final class CommitResponse extends com.google.api.client.json.GenericJson
   @com.google.api.client.util.Key
   private MultiplexedSessionPrecommitToken precommitToken;
 
+  /**
+   * If `TransactionOptions.isolation_level` is set to `IsolationLevel.REPEATABLE_READ`, then the
+   * snapshot timestamp is the timestamp at which all reads in the transaction ran. This timestamp
+   * is never returned.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private String snapshotTimestamp;
+
   /**
    * The statistics about this `Commit`. Not returned by default. For more information, see
    * CommitRequest.return_commit_stats.
@@ -107,6 +116,27 @@ public CommitResponse setPrecommitToken(MultiplexedSessionPrecommitToken precomm
     return this;
   }
 
+  /**
+   * If `TransactionOptions.isolation_level` is set to `IsolationLevel.REPEATABLE_READ`, then the
+   * snapshot timestamp is the timestamp at which all reads in the transaction ran. This timestamp
+   * is never returned.
+   * @return value or {@code null} for none
+   */
+  public String getSnapshotTimestamp() {
+    return snapshotTimestamp;
+  }
+
+  /**
+   * If `TransactionOptions.isolation_level` is set to `IsolationLevel.REPEATABLE_READ`, then the
+   * snapshot timestamp is the timestamp at which all reads in the transaction ran. This timestamp
+   * is never returned.
+   * @param snapshotTimestamp snapshotTimestamp or {@code null} for none
+   */
+  public CommitResponse setSnapshotTimestamp(String snapshotTimestamp) {
+    this.snapshotTimestamp = snapshotTimestamp;
+    return this;
+  }
+
   @Override
   public CommitResponse set(String fieldName, Object value) {
     return (CommitResponse) super.set(fieldName, value);