feat: Automated regeneration of spanner v1 client (#24511)

Auto-created at 2025-10-05 10:15:03 +0000 using the toys pull request generator.

Author: yoshi-code-bot

api_names_out.yaml

@@ -356108,6 +356108,7 @@
 "/spanner:v1/AdaptMessageRequest/payload": payload
 "/spanner:v1/AdaptMessageRequest/protocol": protocol
 "/spanner:v1/AdaptMessageResponse": adapt_message_response
+"/spanner:v1/AdaptMessageResponse/last": last
 "/spanner:v1/AdaptMessageResponse/payload": payload
 "/spanner:v1/AdaptMessageResponse/stateUpdates": state_updates
 "/spanner:v1/AdaptMessageResponse/stateUpdates/state_update": state_update
@@ -356256,6 +356257,7 @@
 "/spanner:v1/CommitResponse/commitStats": commit_stats
 "/spanner:v1/CommitResponse/commitTimestamp": commit_timestamp
 "/spanner:v1/CommitResponse/precommitToken": precommit_token
+"/spanner:v1/CommitResponse/snapshotTimestamp": snapshot_timestamp
 "/spanner:v1/CommitStats": commit_stats
 "/spanner:v1/CommitStats/mutationCount": mutation_count
 "/spanner:v1/Condition": condition

generated/google-apis-spanner_v1/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-spanner_v1
 
+### v0.45.0 (2025-10-05)
+
+* Regenerated from discovery document revision 20250920
+
 ### v0.44.0 (2025-07-20)
 
 * Regenerated from discovery document revision 20250708

generated/google-apis-spanner_v1/lib/google/apis/spanner_v1/classes.rb

@@ -58,6 +58,14 @@ def update!(**args)
       class AdaptMessageResponse
         include Google::Apis::Core::Hashable
 
+        # 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.
+        # Corresponds to the JSON property `last`
+        # @return [Boolean]
+        attr_accessor :last
+        alias_method :last?, :last
+      
         # Optional. Uninterpreted bytes from the underlying wire protocol.
         # Corresponds to the JSON property `payload`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -75,6 +83,7 @@ def initialize(**args)
 
         # Update properties of this object
         def update!(**args)
+          @last = args[:last] if args.key?(:last)
           @payload = args[:payload] if args.key?(:payload)
           @state_updates = args[:state_updates] if args.key?(:state_updates)
         end
@@ -408,9 +417,9 @@ class Backup
         # @return [String]
         attr_accessor :incremental_backup_chain_id
 
-        # 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`.
         # Corresponds to the JSON property `instancePartitions`
         # @return [Array<Google::Apis::SpannerV1::BackupInstancePartition>]
         attr_accessor :instance_partitions
@@ -1220,6 +1229,13 @@ class CommitResponse
         # @return [Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken]
         attr_accessor :precommit_token
 
+        # 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.
+        # Corresponds to the JSON property `snapshotTimestamp`
+        # @return [String]
+        attr_accessor :snapshot_timestamp
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1229,6 +1245,7 @@ def update!(**args)
           @commit_stats = args[:commit_stats] if args.key?(:commit_stats)
           @commit_timestamp = args[:commit_timestamp] if args.key?(:commit_timestamp)
           @precommit_token = args[:precommit_token] if args.key?(:precommit_token)
+          @snapshot_timestamp = args[:snapshot_timestamp] if args.key?(:snapshot_timestamp)
         end
       end
 
@@ -1306,9 +1323,15 @@ class CopyBackupEncryptionConfig
         # @return [String]
         attr_accessor :encryption_type
 
-        # 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/`.
         # Corresponds to the JSON property `kmsKeyName`
         # @return [String]
         attr_accessor :kms_key_name
@@ -1442,9 +1465,15 @@ class CreateBackupEncryptionConfig
         # @return [String]
         attr_accessor :encryption_type
 
-        # 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/`.
         # Corresponds to the JSON property `kmsKeyName`
         # @return [String]
         attr_accessor :kms_key_name
@@ -2164,23 +2193,23 @@ def update!(**args)
       class DdlStatementActionInfo
         include Google::Apis::Core::Hashable
 
-        # The action for the DDL statement, e.g. CREATE, ALTER, DROP, GRANT, etc. This
-        # field is a non-empty string.
+        # The action for the DDL statement, for example, CREATE, ALTER, DROP, GRANT, etc.
+        # This field is a non-empty string.
         # Corresponds to the JSON property `action`
         # @return [String]
         attr_accessor :action
 
-        # The entity name(s) being operated on the DDL statement. E.g. 1. For statement "
-        # CREATE TABLE t1(...)", `entity_names` = ["t1"]. 2. For statement "GRANT ROLE
-        # r1, r2 ...", `entity_names` = ["r1", "r2"]. 3. For statement "ANALYZE", `
-        # entity_names` = [].
+        # The entity names being operated on the DDL statement. For example, 1. For
+        # statement "CREATE TABLE t1(...)", `entity_names` = ["t1"]. 2. For statement "
+        # GRANT ROLE r1, r2 ...", `entity_names` = ["r1", "r2"]. 3. For statement "
+        # ANALYZE", `entity_names` = [].
         # Corresponds to the JSON property `entityNames`
         # @return [Array<String>]
         attr_accessor :entity_names
 
-        # The entity type for the DDL statement, e.g. TABLE, INDEX, VIEW, etc. This
-        # field can be empty string for some DDL statement, e.g. for statement "ANALYZE",
-        # `entity_type` = "".
+        # The entity type for the DDL statement, for example, TABLE, INDEX, VIEW, etc.
+        # This field can be empty string for some DDL statement, for example, for
+        # statement "ANALYZE", `entity_type` = "".
         # Corresponds to the JSON property `entityType`
         # @return [String]
         attr_accessor :entity_type
@@ -3366,12 +3395,12 @@ class InstanceEncryptionConfig
         include Google::Apis::Core::Hashable
 
         # Optional. This field is maintained for backwards compatibility. For new
-        # callers, we recommend using `kms_key_names` to specify the KMS key. `
-        # kms_key_name` should only be used if the location of the KMS key matches the
-        # database instance’s configuration (location) exactly. E.g. The KMS location is
-        # in us-central1 or nam3 and the database instance is also in us-central1 or
-        # nam3. The Cloud KMS key to be used for encrypting and decrypting the database.
-        # Values are of the form `projects//locations//keyRings//cryptoKeys/`.
+        # 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. Values are of the form `projects//locations//keyRings//cryptoKeys/`.
         # Corresponds to the JSON property `kmsKeyName`
         # @return [String]
         attr_accessor :kms_key_name
@@ -3545,7 +3574,7 @@ def update!(**args)
       class InstanceReplicaSelection
         include Google::Apis::Core::Hashable
 
-        # Required. Name of the location of the replicas (e.g., "us-central1").
+        # Required. Name of the location of the replicas (for example, "us-central1").
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
@@ -5956,8 +5985,13 @@ class RestoreDatabaseEncryptionConfig
         # @return [String]
         attr_accessor :encryption_type
 
-        # Optional. The Cloud KMS key that will be used to encrypt/decrypt the restored
-        # database. This field should be set only when encryption_type is `
+        # 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/`.
         # Corresponds to the JSON property `kmsKeyName`
@@ -6467,11 +6501,11 @@ def update!(**args)
       class SingleRegionQuorum
         include Google::Apis::Core::Hashable
 
-        # Required. The location of the serving region, e.g. "us-central1". The location
-        # must be one of the regions within the dual-region instance configuration of
-        # your database. The list of valid locations is available using the
-        # GetInstanceConfig API. This should only be used if you plan to change quorum
-        # to the single-region quorum type.
+        # Required. The location of the serving region, for example, "us-central1". The
+        # location must be one of the regions within the dual-region instance
+        # configuration of your database. The list of valid locations is available using
+        # the GetInstanceConfig API. This should only be used if you plan to change
+        # quorum to the single-region quorum type.
         # Corresponds to the JSON property `servingLocation`
         # @return [String]
         attr_accessor :serving_location
@@ -6884,9 +6918,9 @@ class UpdateDatabaseDdlMetadata
         # @return [Array<String>]
         attr_accessor :statements
 
-        # Output only. When true, indicates that the operation is throttled e.g. due to
-        # resource constraints. When resources become available the operation will
-        # resume and this field will be false again.
+        # Output only. When true, indicates that the operation is throttled, for example,
+        # due to resource constraints. When resources become available the operation
+        # will resume and this field will be false again.
         # Corresponds to the JSON property `throttled`
         # @return [Boolean]
         attr_accessor :throttled
@@ -6911,13 +6945,13 @@ def update!(**args)
       # all at once, to the database schema at some point (or points) in the future.
       # The server checks that the statements are executable (syntactically valid,
       # name tables that exist, etc.) before enqueueing them, but they may still fail
-      # upon later execution (e.g., if a statement from another batch of statements is
-      # applied first and it conflicts in some way, or if there is some data-related
-      # problem like a `NULL` value in a column to which `NOT NULL` would be added).
-      # If a statement fails, all subsequent statements in the batch are automatically
-      # cancelled. Each batch of statements is assigned a name which can be used with
-      # the Operations API to monitor progress. See the operation_id field for more
-      # details.
+      # upon later execution (for example, if a statement from another batch of
+      # statements is applied first and it conflicts in some way, or if there is some
+      # data-related problem like a `NULL` value in a column to which `NOT NULL` would
+      # be added). If a statement fails, all subsequent statements in the batch are
+      # automatically cancelled. Each batch of statements is assigned a name which can
+      # be used with the Operations API to monitor progress. See the operation_id
+      # field for more details.
       class UpdateDatabaseDdlRequest
         include Google::Apis::Core::Hashable
 

generated/google-apis-spanner_v1/lib/google/apis/spanner_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module SpannerV1
       # Version of the google-apis-spanner_v1 gem
-      GEM_VERSION = "0.44.0"
+      GEM_VERSION = "0.45.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.18.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20250708"
+      REVISION = "20250920"
     end
   end
 end

generated/google-apis-spanner_v1/lib/google/apis/spanner_v1/representations.rb

@@ -1090,6 +1090,7 @@ class Representation < Google::Apis::Core::JsonRepresentation
       class AdaptMessageResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :last, as: 'last'
           property :payload, :base64 => true, as: 'payload'
           hash :state_updates, as: 'stateUpdates'
         end
@@ -1377,6 +1378,7 @@ class Representation < Google::Apis::Core::JsonRepresentation
           property :commit_timestamp, as: 'commitTimestamp'
           property :precommit_token, as: 'precommitToken', class: Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken, decorator: Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken::Representation
 
+          property :snapshot_timestamp, as: 'snapshotTimestamp'
         end
       end
 

generated/google-apis-spanner_v1/lib/google/apis/spanner_v1/service.rb

@@ -1169,21 +1169,26 @@ def copy_backup(parent, copy_backup_request_object = nil, fields: nil, quota_use
         # delete the backup. There can be only one pending backup creation per database.
         # Backup creation of different databases can run concurrently.
         # @param [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 `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/`.
         # @param [Google::Apis::SpannerV1::Backup] backup_object
         # @param [String] backup_id
         #   Required. The id of the backup to be created. The `backup_id` appended to `
         #   parent` forms the full backup name of the form `projects//instances//backups/`.
         # @param [String] encryption_config_encryption_type
         #   Required. The encryption type of the backup.
         # @param [String] encryption_config_kms_key_name
-        #   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/`.
         # @param [Array<String>, String] encryption_config_kms_key_names
         #   Optional. Specifies the KMS configuration for the one or more keys used to
         #   protect the backup. Values are of the form `projects//locations//keyRings//
@@ -1406,11 +1411,11 @@ def list_project_instance_backups(parent, filter: nil, page_size: nil, page_toke
         #   the form `projects//instances/`.
         # @param [Google::Apis::SpannerV1::Backup] backup_object
         # @param [String] update_mask
-        #   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.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2252,7 +2257,7 @@ def test_database_iam_permissions(resource, test_iam_permissions_request_object
         # 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 UpdateDatabaseDdlMetadata. The
+        # schema changes. The metadata field type is UpdateDatabaseDdlMetadata. The
         # operation has no response.
         # @param [String] database
         #   Required. The database to update.