chore: regenerate spanner client (googleapis#24914)

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

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

@@ -12471,7 +12471,8 @@ public ExecuteBatchDml set(String parameterName, Object value) {
            * with a `FAILED_PRECONDITION` error. Operations inside read-write transactions might return
            * `ABORTED`. If this occurs, the application should restart the transaction from the beginning. See
            * Transaction for more details. Larger result sets can be fetched in streaming fashion by calling
-           * ExecuteStreamingSql instead.
+           * ExecuteStreamingSql instead. The query string can be SQL or [Graph Query Language
+           * (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
            *
            * Create a request for the method "sessions.executeSql".
            *
@@ -12501,7 +12502,8 @@ public class ExecuteSql extends SpannerRequest<com.google.api.services.spanner.v
              * fails with a `FAILED_PRECONDITION` error. Operations inside read-write transactions might
              * return `ABORTED`. If this occurs, the application should restart the transaction from the
              * beginning. See Transaction for more details. Larger result sets can be fetched in streaming
-             * fashion by calling ExecuteStreamingSql instead.
+             * fashion by calling ExecuteStreamingSql instead. The query string can be SQL or [Graph Query
+             * Language (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
              *
              * Create a request for the method "sessions.executeSql".
              *
@@ -12609,7 +12611,8 @@ public ExecuteSql set(String parameterName, Object value) {
           /**
            * Like ExecuteSql, except returns the result set as a stream. Unlike ExecuteSql, there is no limit
            * on the size of the returned result set. However, no individual row in the result set can exceed
-           * 100 MiB, and no column value can exceed 10 MiB.
+           * 100 MiB, and no column value can exceed 10 MiB. The query string can be SQL or [Graph Query
+           * Language (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
            *
            * Create a request for the method "sessions.executeStreamingSql".
            *
@@ -12636,7 +12639,9 @@ public class ExecuteStreamingSql extends SpannerRequest<com.google.api.services.
             /**
              * Like ExecuteSql, except returns the result set as a stream. Unlike ExecuteSql, there is no
              * limit on the size of the returned result set. However, no individual row in the result set can
-             * exceed 100 MiB, and no column value can exceed 10 MiB.
+             * exceed 100 MiB, and no column value can exceed 10 MiB. The query string can be SQL or [Graph
+             * Query Language (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-
+             * intro).
              *
              * Create a request for the method "sessions.executeStreamingSql".
              *

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

@@ -43,13 +43,15 @@ public final class CrontabSpec extends com.google.api.client.json.GenericJson {
 
   /**
    * Required. Textual representation of the crontab. User can customize the backup frequency and
-   * the backup version time using the cron expression. The version time must be in UTC timzeone.
-   * The backup will contain an externally consistent copy of the database at the version time.
-   * Allowed frequencies are 12 hour, 1 day, 1 week and 1 month. Examples of valid cron
-   * specifications: * `0 2/12 * * * ` : every 12 hours at (2, 14) hours past midnight in UTC. * `0
-   * 2,14 * * * ` : every 12 hours at (2,14) hours past midnight in UTC. * `0 2 * * * ` : once a day
-   * at 2 past midnight in UTC. * `0 2 * * 0 ` : once a week every Sunday at 2 past midnight in UTC.
-   * * `0 2 8 * * ` : once a month on 8th day at 2 past midnight in UTC.
+   * the backup version time using the cron expression. The version time must be in UTC timezone.
+   * The backup will contain an externally consistent copy of the database at the version time. Full
+   * backups must be scheduled a minimum of 12 hours apart and incremental backups must be scheduled
+   * a minimum of 4 hours apart. Examples of valid cron specifications: * `0 2/12 * * *` : every 12
+   * hours at (2, 14) hours past midnight in UTC. * `0 2,14 * * *` : every 12 hours at (2,14) hours
+   * past midnight in UTC. * `0 4 * * *` : (incremental backups only) every 4 hours at (0, 4, 8, 12,
+   * 16, 20) hours past midnight in UTC. * `0 2 * * *` : once a day at 2 past midnight in UTC. * `0
+   * 2 * * 0` : once a week every Sunday at 2 past midnight in UTC. * `0 2 8 * *` : once a month on
+   * 8th day at 2 past midnight in UTC.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -89,13 +91,15 @@ public CrontabSpec setCreationWindow(String creationWindow) {
 
   /**
    * Required. Textual representation of the crontab. User can customize the backup frequency and
-   * the backup version time using the cron expression. The version time must be in UTC timzeone.
-   * The backup will contain an externally consistent copy of the database at the version time.
-   * Allowed frequencies are 12 hour, 1 day, 1 week and 1 month. Examples of valid cron
-   * specifications: * `0 2/12 * * * ` : every 12 hours at (2, 14) hours past midnight in UTC. * `0
-   * 2,14 * * * ` : every 12 hours at (2,14) hours past midnight in UTC. * `0 2 * * * ` : once a day
-   * at 2 past midnight in UTC. * `0 2 * * 0 ` : once a week every Sunday at 2 past midnight in UTC.
-   * * `0 2 8 * * ` : once a month on 8th day at 2 past midnight in UTC.
+   * the backup version time using the cron expression. The version time must be in UTC timezone.
+   * The backup will contain an externally consistent copy of the database at the version time. Full
+   * backups must be scheduled a minimum of 12 hours apart and incremental backups must be scheduled
+   * a minimum of 4 hours apart. Examples of valid cron specifications: * `0 2/12 * * *` : every 12
+   * hours at (2, 14) hours past midnight in UTC. * `0 2,14 * * *` : every 12 hours at (2,14) hours
+   * past midnight in UTC. * `0 4 * * *` : (incremental backups only) every 4 hours at (0, 4, 8, 12,
+   * 16, 20) hours past midnight in UTC. * `0 2 * * *` : once a day at 2 past midnight in UTC. * `0
+   * 2 * * 0` : once a week every Sunday at 2 past midnight in UTC. * `0 2 8 * *` : once a month on
+   * 8th day at 2 past midnight in UTC.
    * @return value or {@code null} for none
    */
   public java.lang.String getText() {
@@ -104,13 +108,15 @@ public java.lang.String getText() {
 
   /**
    * Required. Textual representation of the crontab. User can customize the backup frequency and
-   * the backup version time using the cron expression. The version time must be in UTC timzeone.
-   * The backup will contain an externally consistent copy of the database at the version time.
-   * Allowed frequencies are 12 hour, 1 day, 1 week and 1 month. Examples of valid cron
-   * specifications: * `0 2/12 * * * ` : every 12 hours at (2, 14) hours past midnight in UTC. * `0
-   * 2,14 * * * ` : every 12 hours at (2,14) hours past midnight in UTC. * `0 2 * * * ` : once a day
-   * at 2 past midnight in UTC. * `0 2 * * 0 ` : once a week every Sunday at 2 past midnight in UTC.
-   * * `0 2 8 * * ` : once a month on 8th day at 2 past midnight in UTC.
+   * the backup version time using the cron expression. The version time must be in UTC timezone.
+   * The backup will contain an externally consistent copy of the database at the version time. Full
+   * backups must be scheduled a minimum of 12 hours apart and incremental backups must be scheduled
+   * a minimum of 4 hours apart. Examples of valid cron specifications: * `0 2/12 * * *` : every 12
+   * hours at (2, 14) hours past midnight in UTC. * `0 2,14 * * *` : every 12 hours at (2,14) hours
+   * past midnight in UTC. * `0 4 * * *` : (incremental backups only) every 4 hours at (0, 4, 8, 12,
+   * 16, 20) hours past midnight in UTC. * `0 2 * * *` : once a day at 2 past midnight in UTC. * `0
+   * 2 * * 0` : once a week every Sunday at 2 past midnight in UTC. * `0 2 8 * *` : once a month on
+   * 8th day at 2 past midnight in UTC.
    * @param text text or {@code null} for none
    */
   public CrontabSpec setText(java.lang.String text) {

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

@@ -29,6 +29,18 @@
 @SuppressWarnings("javadoc")
 public final class ExecuteBatchDmlRequest extends com.google.api.client.json.GenericJson {
 
+  /**
+   * Optional. If set to true, this request marks the end of the transaction. The transaction should
+   * be committed or aborted after these statements execute, and attempts to execute any other
+   * requests against this transaction (including reads and queries) will be rejected. Setting this
+   * option may cause some error reporting to be deferred until commit time (e.g. validation of
+   * unique constraints). Given this, successful execution of statements should not be assumed until
+   * a subsequent Commit call completes successfully.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private java.lang.Boolean lastStatements;
+
   /**
    * Common options for this request.
    * The value may be {@code null}.
@@ -67,6 +79,33 @@ public final class ExecuteBatchDmlRequest extends com.google.api.client.json.Gen
   @com.google.api.client.util.Key
   private TransactionSelector transaction;
 
+  /**
+   * Optional. If set to true, this request marks the end of the transaction. The transaction should
+   * be committed or aborted after these statements execute, and attempts to execute any other
+   * requests against this transaction (including reads and queries) will be rejected. Setting this
+   * option may cause some error reporting to be deferred until commit time (e.g. validation of
+   * unique constraints). Given this, successful execution of statements should not be assumed until
+   * a subsequent Commit call completes successfully.
+   * @return value or {@code null} for none
+   */
+  public java.lang.Boolean getLastStatements() {
+    return lastStatements;
+  }
+
+  /**
+   * Optional. If set to true, this request marks the end of the transaction. The transaction should
+   * be committed or aborted after these statements execute, and attempts to execute any other
+   * requests against this transaction (including reads and queries) will be rejected. Setting this
+   * option may cause some error reporting to be deferred until commit time (e.g. validation of
+   * unique constraints). Given this, successful execution of statements should not be assumed until
+   * a subsequent Commit call completes successfully.
+   * @param lastStatements lastStatements or {@code null} for none
+   */
+  public ExecuteBatchDmlRequest setLastStatements(java.lang.Boolean lastStatements) {
+    this.lastStatements = lastStatements;
+    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/ExecuteSqlRequest.java

@@ -45,6 +45,18 @@ public final class ExecuteSqlRequest extends com.google.api.client.json.GenericJ
   @com.google.api.client.util.Key
   private DirectedReadOptions directedReadOptions;
 
+  /**
+   * Optional. If set to true, this statement marks the end of the transaction. The transaction
+   * should be committed or aborted after this statement executes, and attempts to execute any other
+   * requests against this transaction (including reads and queries) will be rejected. For DML
+   * statements, setting this option may cause some error reporting to be deferred until commit time
+   * (e.g. validation of unique constraints). Given this, successful execution of a DML statement
+   * should not be assumed until a subsequent Commit call completes successfully.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private java.lang.Boolean lastStatement;
+
   /**
    * It is not always possible for Cloud Spanner to infer the right SQL type from a JSON value. For
    * example, values of type `BYTES` and values of type `STRING` both appear in params as JSON
@@ -178,6 +190,33 @@ public ExecuteSqlRequest setDirectedReadOptions(DirectedReadOptions directedRead
     return this;
   }
 
+  /**
+   * Optional. If set to true, this statement marks the end of the transaction. The transaction
+   * should be committed or aborted after this statement executes, and attempts to execute any other
+   * requests against this transaction (including reads and queries) will be rejected. For DML
+   * statements, setting this option may cause some error reporting to be deferred until commit time
+   * (e.g. validation of unique constraints). Given this, successful execution of a DML statement
+   * should not be assumed until a subsequent Commit call completes successfully.
+   * @return value or {@code null} for none
+   */
+  public java.lang.Boolean getLastStatement() {
+    return lastStatement;
+  }
+
+  /**
+   * Optional. If set to true, this statement marks the end of the transaction. The transaction
+   * should be committed or aborted after this statement executes, and attempts to execute any other
+   * requests against this transaction (including reads and queries) will be rejected. For DML
+   * statements, setting this option may cause some error reporting to be deferred until commit time
+   * (e.g. validation of unique constraints). Given this, successful execution of a DML statement
+   * should not be assumed until a subsequent Commit call completes successfully.
+   * @param lastStatement lastStatement or {@code null} for none
+   */
+  public ExecuteSqlRequest setLastStatement(java.lang.Boolean lastStatement) {
+    this.lastStatement = lastStatement;
+    return this;
+  }
+
   /**
    * It is not always possible for Cloud Spanner to infer the right SQL type from a JSON value. For
    * example, values of type `BYTES` and values of type `STRING` both appear in params as JSON

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

@@ -54,11 +54,12 @@ public final class Instance extends com.google.api.client.json.GenericJson {
   private String createTime;
 
   /**
-   * Optional. Controls the default backup behavior for new databases within the instance. Note that
-   * `AUTOMATIC` is not permitted for free instances, as backups and backup schedules are not
-   * allowed for free instances. In the `GetInstance` or `ListInstances` response, if the value of
-   * default_backup_schedule_type is unset or NONE, no default backup schedule will be created for
-   * new databases within the instance.
+   * Optional. Controls the default backup schedule behavior for new databases within the instance.
+   * By default, a backup schedule is created automatically when a new database is created in a new
+   * instance. Note that the `AUTOMATIC` value isn't permitted for free instances, as backups and
+   * backup schedules aren't supported for free instances. In the `GetInstance` or `ListInstances`
+   * response, if the value of `default_backup_schedule_type` isn't set, or set to `NONE`, Spanner
+   * doesn't create a default backup schedule for new databases in the instance.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -237,23 +238,25 @@ public Instance setCreateTime(String createTime) {
   }
 
   /**
-   * Optional. Controls the default backup behavior for new databases within the instance. Note that
-   * `AUTOMATIC` is not permitted for free instances, as backups and backup schedules are not
-   * allowed for free instances. In the `GetInstance` or `ListInstances` response, if the value of
-   * default_backup_schedule_type is unset or NONE, no default backup schedule will be created for
-   * new databases within the instance.
+   * Optional. Controls the default backup schedule behavior for new databases within the instance.
+   * By default, a backup schedule is created automatically when a new database is created in a new
+   * instance. Note that the `AUTOMATIC` value isn't permitted for free instances, as backups and
+   * backup schedules aren't supported for free instances. In the `GetInstance` or `ListInstances`
+   * response, if the value of `default_backup_schedule_type` isn't set, or set to `NONE`, Spanner
+   * doesn't create a default backup schedule for new databases in the instance.
    * @return value or {@code null} for none
    */
   public java.lang.String getDefaultBackupScheduleType() {
     return defaultBackupScheduleType;
   }
 
   /**
-   * Optional. Controls the default backup behavior for new databases within the instance. Note that
-   * `AUTOMATIC` is not permitted for free instances, as backups and backup schedules are not
-   * allowed for free instances. In the `GetInstance` or `ListInstances` response, if the value of
-   * default_backup_schedule_type is unset or NONE, no default backup schedule will be created for
-   * new databases within the instance.
+   * Optional. Controls the default backup schedule behavior for new databases within the instance.
+   * By default, a backup schedule is created automatically when a new database is created in a new
+   * instance. Note that the `AUTOMATIC` value isn't permitted for free instances, as backups and
+   * backup schedules aren't supported for free instances. In the `GetInstance` or `ListInstances`
+   * response, if the value of `default_backup_schedule_type` isn't set, or set to `NONE`, Spanner
+   * doesn't create a default backup schedule for new databases in the instance.
    * @param defaultBackupScheduleType defaultBackupScheduleType or {@code null} for none
    */
   public Instance setDefaultBackupScheduleType(java.lang.String defaultBackupScheduleType) {