chore: regenerate spanner client (googleapis#23755)

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-rev20241018-2.0.0</version>
+      <version>v1-rev20241020-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-spanner:v1-rev20241018-2.0.0'
+  implementation 'com.google.apis:google-api-services-spanner:v1-rev20241020-2.0.0'
 }
 ```
 

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

@@ -75,7 +75,7 @@ public final class Backup extends com.google.api.client.json.GenericJson {
   /**
    * Output only. The encryption information for the backup, whether it is protected by one or more
    * KMS keys. The information includes all Cloud KMS key versions used to encrypt the backup. The
-   * `encryption_status' field inside of each `EncryptionInfo` is not populated. At least one of the
+   * `encryption_status` field inside of each `EncryptionInfo` is not populated. At least one of the
    * key versions must be available for the backup to be restored. If a key version is revoked in
    * the middle of a restore, the restore behavior is undefined.
    * The value may be {@code null}.
@@ -309,7 +309,7 @@ public Backup setEncryptionInfo(EncryptionInfo encryptionInfo) {
   /**
    * Output only. The encryption information for the backup, whether it is protected by one or more
    * KMS keys. The information includes all Cloud KMS key versions used to encrypt the backup. The
-   * `encryption_status' field inside of each `EncryptionInfo` is not populated. At least one of the
+   * `encryption_status` field inside of each `EncryptionInfo` is not populated. At least one of the
    * key versions must be available for the backup to be restored. If a key version is revoked in
    * the middle of a restore, the restore behavior is undefined.
    * @return value or {@code null} for none
@@ -321,7 +321,7 @@ public java.util.List<EncryptionInfo> getEncryptionInformation() {
   /**
    * Output only. The encryption information for the backup, whether it is protected by one or more
    * KMS keys. The information includes all Cloud KMS key versions used to encrypt the backup. The
-   * `encryption_status' field inside of each `EncryptionInfo` is not populated. At least one of the
+   * `encryption_status` field inside of each `EncryptionInfo` is not populated. At least one of the
    * key versions must be available for the backup to be restored. If a key version is revoked in
    * the middle of a restore, the restore behavior is undefined.
    * @param encryptionInformation encryptionInformation or {@code null} for none

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

@@ -29,6 +29,15 @@
 @SuppressWarnings("javadoc")
 public final class BeginTransactionRequest extends com.google.api.client.json.GenericJson {
 
+  /**
+   * Optional. Required for read-write transactions on a multiplexed session that commit mutations
+   * but do not perform any reads or queries. Clients should randomly select one of the mutations
+   * from the mutation set and send it as a part of this request.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private Mutation mutationKey;
+
   /**
    * Required. Options for the new transaction.
    * The value may be {@code null}.
@@ -45,6 +54,27 @@ public final class BeginTransactionRequest extends com.google.api.client.json.Ge
   @com.google.api.client.util.Key
   private RequestOptions requestOptions;
 
+  /**
+   * Optional. Required for read-write transactions on a multiplexed session that commit mutations
+   * but do not perform any reads or queries. Clients should randomly select one of the mutations
+   * from the mutation set and send it as a part of this request.
+   * @return value or {@code null} for none
+   */
+  public Mutation getMutationKey() {
+    return mutationKey;
+  }
+
+  /**
+   * Optional. Required for read-write transactions on a multiplexed session that commit mutations
+   * but do not perform any reads or queries. Clients should randomly select one of the mutations
+   * from the mutation set and send it as a part of this request.
+   * @param mutationKey mutationKey or {@code null} for none
+   */
+  public BeginTransactionRequest setMutationKey(Mutation mutationKey) {
+    this.mutationKey = mutationKey;
+    return this;
+  }
+
   /**
    * Required. Options for the new transaction.
    * @return value or {@code null} for none

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

@@ -47,6 +47,15 @@ public final class CommitRequest extends com.google.api.client.json.GenericJson
   @com.google.api.client.util.Key
   private java.util.List<Mutation> mutations;
 
+  /**
+   * Optional. If the read-write transaction was executed on a multiplexed session, the precommit
+   * token with the highest sequence number received in this transaction attempt, should be included
+   * here. Failing to do so will result in a FailedPrecondition error.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private MultiplexedSessionPrecommitToken precommitToken;
+
   /**
    * Common options for this request.
    * The value may be {@code null}.
@@ -122,6 +131,27 @@ public CommitRequest setMutations(java.util.List<Mutation> mutations) {
     return this;
   }
 
+  /**
+   * Optional. If the read-write transaction was executed on a multiplexed session, the precommit
+   * token with the highest sequence number received in this transaction attempt, should be included
+   * here. Failing to do so will result in a FailedPrecondition error.
+   * @return value or {@code null} for none
+   */
+  public MultiplexedSessionPrecommitToken getPrecommitToken() {
+    return precommitToken;
+  }
+
+  /**
+   * Optional. If the read-write transaction was executed on a multiplexed session, the precommit
+   * token with the highest sequence number received in this transaction attempt, should be included
+   * here. Failing to do so will result in a FailedPrecondition error.
+   * @param precommitToken precommitToken or {@code null} for none
+   */
+  public CommitRequest setPrecommitToken(MultiplexedSessionPrecommitToken precommitToken) {
+    this.precommitToken = precommitToken;
+    return this;
+  }
+
   /**
    * Common options for this request.
    * @return value or {@code null} for none

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

@@ -44,6 +44,14 @@ public final class CommitResponse extends com.google.api.client.json.GenericJson
   @com.google.api.client.util.Key
   private String commitTimestamp;
 
+  /**
+   * If specified, transaction has not committed yet. Clients must retry the commit with the new
+   * precommit token.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private MultiplexedSessionPrecommitToken precommitToken;
+
   /**
    * The statistics about this Commit. Not returned by default. For more information, see
    * CommitRequest.return_commit_stats.
@@ -80,6 +88,25 @@ public CommitResponse setCommitTimestamp(String commitTimestamp) {
     return this;
   }
 
+  /**
+   * If specified, transaction has not committed yet. Clients must retry the commit with the new
+   * precommit token.
+   * @return value or {@code null} for none
+   */
+  public MultiplexedSessionPrecommitToken getPrecommitToken() {
+    return precommitToken;
+  }
+
+  /**
+   * If specified, transaction has not committed yet. Clients must retry the commit with the new
+   * precommit token.
+   * @param precommitToken precommitToken or {@code null} for none
+   */
+  public CommitResponse setPrecommitToken(MultiplexedSessionPrecommitToken precommitToken) {
+    this.precommitToken = precommitToken;
+    return this;
+  }
+
   @Override
   public CommitResponse set(String fieldName, Object value) {
     return (CommitResponse) super.set(fieldName, value);

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

@@ -47,14 +47,15 @@ public final class CopyBackupEncryptionConfig extends com.google.api.client.json
 
   /**
    * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup.
-   * Values are of the form `projects//locations//keyRings//cryptoKeys/`. Kms keys specified can be
-   * in any order. The keys referenced by kms_key_names must fully cover all regions of the backup's
-   * instance configuration. Some examples: * For single region instance configs, specify a single
-   * regional location KMS key. * For multi-regional instance configs of type GOOGLE_MANAGED, either
-   * specify a multi-regional location KMS key or multiple regional location KMS keys that cover all
-   * regions in the instance config. * For an instance config of type USER_MANAGED, please specify
-   * only regional location KMS keys to cover each region in the instance config. Multi-regional
-   * location KMS keys are not supported for USER_MANAGED instance configs.
+   * Values are of the form `projects//locations//keyRings//cryptoKeys/`. KMS keys specified can be
+   * in any order. The keys referenced by `kms_key_names` must fully cover all regions of the
+   * backup's instance configuration. Some examples: * For regional (single-region) instance
+   * configurations, specify a regional location KMS key. * For multi-region instance configurations
+   * of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional
+   * location KMS keys that cover all regions in the instance configuration. * For an instance
+   * configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each
+   * region in the instance configuration. Multi-region location KMS keys aren't supported for
+   * `USER_MANAGED` type instance configurations.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -100,14 +101,15 @@ public CopyBackupEncryptionConfig setKmsKeyName(java.lang.String kmsKeyName) {
 
   /**
    * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup.
-   * Values are of the form `projects//locations//keyRings//cryptoKeys/`. Kms keys specified can be
-   * in any order. The keys referenced by kms_key_names must fully cover all regions of the backup's
-   * instance configuration. Some examples: * For single region instance configs, specify a single
-   * regional location KMS key. * For multi-regional instance configs of type GOOGLE_MANAGED, either
-   * specify a multi-regional location KMS key or multiple regional location KMS keys that cover all
-   * regions in the instance config. * For an instance config of type USER_MANAGED, please specify
-   * only regional location KMS keys to cover each region in the instance config. Multi-regional
-   * location KMS keys are not supported for USER_MANAGED instance configs.
+   * Values are of the form `projects//locations//keyRings//cryptoKeys/`. KMS keys specified can be
+   * in any order. The keys referenced by `kms_key_names` must fully cover all regions of the
+   * backup's instance configuration. Some examples: * For regional (single-region) instance
+   * configurations, specify a regional location KMS key. * For multi-region instance configurations
+   * of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional
+   * location KMS keys that cover all regions in the instance configuration. * For an instance
+   * configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each
+   * region in the instance configuration. Multi-region location KMS keys aren't supported for
+   * `USER_MANAGED` type instance configurations.
    * @return value or {@code null} for none
    */
   public java.util.List<java.lang.String> getKmsKeyNames() {
@@ -116,14 +118,15 @@ public java.util.List<java.lang.String> getKmsKeyNames() {
 
   /**
    * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup.
-   * Values are of the form `projects//locations//keyRings//cryptoKeys/`. Kms keys specified can be
-   * in any order. The keys referenced by kms_key_names must fully cover all regions of the backup's
-   * instance configuration. Some examples: * For single region instance configs, specify a single
-   * regional location KMS key. * For multi-regional instance configs of type GOOGLE_MANAGED, either
-   * specify a multi-regional location KMS key or multiple regional location KMS keys that cover all
-   * regions in the instance config. * For an instance config of type USER_MANAGED, please specify
-   * only regional location KMS keys to cover each region in the instance config. Multi-regional
-   * location KMS keys are not supported for USER_MANAGED instance configs.
+   * Values are of the form `projects//locations//keyRings//cryptoKeys/`. KMS keys specified can be
+   * in any order. The keys referenced by `kms_key_names` must fully cover all regions of the
+   * backup's instance configuration. Some examples: * For regional (single-region) instance
+   * configurations, specify a regional location KMS key. * For multi-region instance configurations
+   * of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional
+   * location KMS keys that cover all regions in the instance configuration. * For an instance
+   * configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each
+   * region in the instance configuration. Multi-region location KMS keys aren't supported for
+   * `USER_MANAGED` type instance configurations.
    * @param kmsKeyNames kmsKeyNames or {@code null} for none
    */
   public CopyBackupEncryptionConfig setKmsKeyNames(java.util.List<java.lang.String> kmsKeyNames) {

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

@@ -48,13 +48,13 @@ public final class CreateBackupEncryptionConfig extends com.google.api.client.js
   /**
    * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup.
    * Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by
-   * kms_key_names must fully cover all regions of the backup's instance configuration. Some
-   * examples: * For single region instance configs, specify a single regional location KMS key. *
-   * For multi-regional instance configs of type GOOGLE_MANAGED, either specify a multi-regional
-   * location KMS key or multiple regional location KMS keys that cover all regions in the instance
-   * config. * For an instance config of type USER_MANAGED, please specify only regional location
-   * KMS keys to cover each region in the instance config. Multi-regional location KMS keys are not
-   * supported for USER_MANAGED instance configs.
+   * `kms_key_names` must fully cover all regions of the backup's instance configuration. Some
+   * examples: * For regional (single-region) instance configurations, specify a regional location
+   * KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a
+   * multi-region location KMS key or multiple regional location KMS keys that cover all regions in
+   * the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify
+   * only regional location KMS keys to cover each region in the instance configuration. Multi-
+   * region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -101,13 +101,13 @@ public CreateBackupEncryptionConfig setKmsKeyName(java.lang.String kmsKeyName) {
   /**
    * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup.
    * Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by
-   * kms_key_names must fully cover all regions of the backup's instance configuration. Some
-   * examples: * For single region instance configs, specify a single regional location KMS key. *
-   * For multi-regional instance configs of type GOOGLE_MANAGED, either specify a multi-regional
-   * location KMS key or multiple regional location KMS keys that cover all regions in the instance
-   * config. * For an instance config of type USER_MANAGED, please specify only regional location
-   * KMS keys to cover each region in the instance config. Multi-regional location KMS keys are not
-   * supported for USER_MANAGED instance configs.
+   * `kms_key_names` must fully cover all regions of the backup's instance configuration. Some
+   * examples: * For regional (single-region) instance configurations, specify a regional location
+   * KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a
+   * multi-region location KMS key or multiple regional location KMS keys that cover all regions in
+   * the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify
+   * only regional location KMS keys to cover each region in the instance configuration. Multi-
+   * region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.
    * @return value or {@code null} for none
    */
   public java.util.List<java.lang.String> getKmsKeyNames() {
@@ -117,13 +117,13 @@ public java.util.List<java.lang.String> getKmsKeyNames() {
   /**
    * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup.
    * Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by
-   * kms_key_names must fully cover all regions of the backup's instance configuration. Some
-   * examples: * For single region instance configs, specify a single regional location KMS key. *
-   * For multi-regional instance configs of type GOOGLE_MANAGED, either specify a multi-regional
-   * location KMS key or multiple regional location KMS keys that cover all regions in the instance
-   * config. * For an instance config of type USER_MANAGED, please specify only regional location
-   * KMS keys to cover each region in the instance config. Multi-regional location KMS keys are not
-   * supported for USER_MANAGED instance configs.
+   * `kms_key_names` must fully cover all regions of the backup's instance configuration. Some
+   * examples: * For regional (single-region) instance configurations, specify a regional location
+   * KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a
+   * multi-region location KMS key or multiple regional location KMS keys that cover all regions in
+   * the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify
+   * only regional location KMS keys to cover each region in the instance configuration. Multi-
+   * region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.
    * @param kmsKeyNames kmsKeyNames or {@code null} for none
    */
   public CreateBackupEncryptionConfig setKmsKeyNames(java.util.List<java.lang.String> kmsKeyNames) {