google-apis-firestore_v1 0.97.0 → 0.99.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87c60e3b964055a23a408ab38df4afbc480efa42f5257ffca479d6b81182cc18
-  data.tar.gz: fcbc4e193746d2888768c34de3587a4a4fc75d9d062e3501136a8f472fbce029
+  metadata.gz: 105fc246a8747b12c36ffdce6e4f3d0e0abb22e127cfc0927255b00dcd6cecd4
+  data.tar.gz: 54690e9c6d59d2701ada7369a423542fe654d5a2e1d1de57082f886453d2f065
 SHA512:
-  metadata.gz: de8873e7253ca195b03caa9dd2a57e1d05397bd1180ba6b2362831744604735c7d63b2d77159caa161915dce603fb1bf1460b4a3f2e2a2650781f6a054c40ec0
-  data.tar.gz: 8c9e1cd7b42b51a4c397112d40cc10d19f0aa4976889e1f1b406ebfe669002cc8379486f2cc865c74aa6a9940a612fd130a54e2eb0937f6c8133e72d14f57318
+  metadata.gz: 28c59d5d24e54cec597ca2be062c35fc85b22e373d407ffe15bbe3fc095c429b699905f48f637a391d9c8db604b4145468cbdd40c53b25ba7eba572154d0798f
+  data.tar.gz: 372ba5fca6ea073bb32e106f87e67c5b88a06d751850915f2a1605f8d82657e00dd419c4b632cfbebdd9ba85ebedb6946e5e05e455d46b1472cbd5edfca8862d

data/CHANGELOG.md

@@ -1,8 +1,16 @@
 # Release history for google-apis-firestore_v1
 
-### v0.97.0 (2026-07-12)
+### v0.99.0 (2026-08-30)
 
-* Regenerated from discovery document revision 20260702
+* Regenerated from discovery document revision 20260818
+
+### v0.98.0 (2026-08-23)
+
+* Regenerated from discovery document revision 20260810
+
+### v0.97.0 (2026-07-19)
+
+* Regenerated from discovery document revision 20260706
 
 ### v0.96.0 (2026-06-21)
 

data/lib/google/apis/firestore_v1/classes.rb

@@ -180,7 +180,7 @@ module Google
         # @return [String]
         attr_accessor :read_time
       
-        # Options for a server request.
+        # Options for a request.
         # Corresponds to the JSON property `requestOptions`
         # @return [Google::Apis::FirestoreV1::RequestOptions]
         attr_accessor :request_options
@@ -258,7 +258,7 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Options for a server request.
+        # Options for a request.
         # Corresponds to the JSON property `requestOptions`
         # @return [Google::Apis::FirestoreV1::RequestOptions]
         attr_accessor :request_options
@@ -318,7 +318,7 @@ module Google
         # @return [Google::Apis::FirestoreV1::TransactionOptions]
         attr_accessor :options
       
-        # Options for a server request.
+        # Options for a request.
         # Corresponds to the JSON property `requestOptions`
         # @return [Google::Apis::FirestoreV1::RequestOptions]
         attr_accessor :request_options
@@ -468,7 +468,7 @@ module Google
       class CommitRequest
         include Google::Apis::Core::Hashable
       
-        # Options for a server request.
+        # Options for a request.
         # Corresponds to the JSON property `requestOptions`
         # @return [Google::Apis::FirestoreV1::RequestOptions]
         attr_accessor :request_options
@@ -875,7 +875,7 @@ module Google
         # @return [String]
         attr_accessor :read_time
       
-        # Options for a server request.
+        # Options for a request.
         # Corresponds to the JSON property `requestOptions`
         # @return [Google::Apis::FirestoreV1::RequestOptions]
         attr_accessor :request_options
@@ -910,7 +910,7 @@ module Google
         end
       end
       
-      # The response for Firestore.Execute.
+      # The response for Firestore.ExecutePipeline.
       class ExecutePipelineResponse
         include Google::Apis::Core::Hashable
       
@@ -1591,6 +1591,77 @@ module Google
         end
       end
       
+      # A Change Stream is a resource that allows users to receive change
+      # notifications from a Firestore database.
+      class GoogleFirestoreAdminV1ChangeStream
+        include Google::Apis::Core::Hashable
+      
+        # The change stream is scoped to a collection group. Only events associated with
+        # the given collection group are visible to the Change Stream. Only a single
+        # change stream can be enabled per collection group.
+        # Corresponds to the JSON property `collectionGroupScope`
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1CollectionGroupScope]
+        attr_accessor :collection_group_scope
+      
+        # Output only. The time the Change Stream was created.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # The change stream is scoped to the entire database. All events in the database
+        # are visible to the Change Stream. One Database scope Change Stream is allowed
+        # per database.
+        # Corresponds to the JSON property `databaseScope`
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1DatabaseScope]
+        attr_accessor :database_scope
+      
+        # Optional. An etag used to determine which version of the configuration is
+        # being edited.
+        # Corresponds to the JSON property `etag`
+        # @return [String]
+        attr_accessor :etag
+      
+        # Identifier. The external resource name of the change stream. Format `projects/`
+        # project`/databases/`database`/changeStreams/`change_stream``
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Required. The retention period of the change stream. This is the amount of
+        # time a change event is available on the change stream. Must be from 1 to 7
+        # days, inclusive. The retention_period must be in day granularity, i.e. it must
+        # be a multiple of 24 hours.
+        # Corresponds to the JSON property `retentionPeriod`
+        # @return [String]
+        attr_accessor :retention_period
+      
+        # Output only. The time the Change Stream started recording events.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        # Output only. The time the Change Stream was last updated.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @collection_group_scope = args[:collection_group_scope] if args.key?(:collection_group_scope)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @database_scope = args[:database_scope] if args.key?(:database_scope)
+          @etag = args[:etag] if args.key?(:etag)
+          @name = args[:name] if args.key?(:name)
+          @retention_period = args[:retention_period] if args.key?(:retention_period)
+          @start_time = args[:start_time] if args.key?(:start_time)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
       # Metadata for the long-running operation from the CloneDatabase request.
       class GoogleFirestoreAdminV1CloneDatabaseMetadata
         include Google::Apis::Core::Hashable
@@ -1731,6 +1802,27 @@ module Google
         end
       end
       
+      # The change stream is scoped to a collection group. Only events associated with
+      # the given collection group are visible to the Change Stream. Only a single
+      # change stream can be enabled per collection group.
+      class GoogleFirestoreAdminV1CollectionGroupScope
+        include Google::Apis::Core::Hashable
+      
+        # Required. The collection group name.
+        # Corresponds to the JSON property `collectionGroupId`
+        # @return [String]
+        attr_accessor :collection_group_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @collection_group_id = args[:collection_group_id] if args.key?(:collection_group_id)
+        end
+      end
+      
       # Metadata related to the create database operation.
       class GoogleFirestoreAdminV1CreateDatabaseMetadata
         include Google::Apis::Core::Hashable
@@ -1851,7 +1943,7 @@ module Google
       
         # Optional. The Firestore API data access mode to use for this database. If not
         # set on write: - the default value is DATA_ACCESS_MODE_DISABLED for Enterprise
-        # Edition. - the default value is DATA_ACCESS_MODE_ENABLED for Standard Edition.
+        # edition. - the default value is DATA_ACCESS_MODE_ENABLED for Standard edition.
         # Corresponds to the JSON property `firestoreDataAccessMode`
         # @return [String]
         attr_accessor :firestore_data_access_mode
@@ -1886,8 +1978,8 @@ module Google
       
         # Optional. The MongoDB compatible API data access mode to use for this database.
         # If not set on write, the default value is DATA_ACCESS_MODE_ENABLED for
-        # Enterprise Edition. The value is always DATA_ACCESS_MODE_DISABLED for Standard
-        # Edition.
+        # Enterprise edition. The value is always DATA_ACCESS_MODE_DISABLED for Standard
+        # edition.
         # Corresponds to the JSON property `mongodbCompatibleDataAccessMode`
         # @return [String]
         attr_accessor :mongodb_compatible_data_access_mode
@@ -1986,6 +2078,21 @@ module Google
         end
       end
       
+      # The change stream is scoped to the entire database. All events in the database
+      # are visible to the Change Stream. One Database scope Change Stream is allowed
+      # per database.
+      class GoogleFirestoreAdminV1DatabaseScope
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Metadata related to the delete database operation.
       class GoogleFirestoreAdminV1DeleteDatabaseMetadata
         include Google::Apis::Core::Hashable
@@ -2457,7 +2564,11 @@ module Google
       end
       
       # Cloud Firestore indexes enable simple and complex queries against documents in
-      # a database.
+      # a database. In Standard edition databases, single-field indexes are managed
+      # using the google.firestore.admin.v1.Field resource, and composite indexes are
+      # managed using the google.firestore.admin.v1.Index resource. In Enterprise
+      # edition databases, both single-field and composite indexes are managed using
+      # the google.firestore.admin.v1.Index resource.
       class GoogleFirestoreAdminV1Index
         include Google::Apis::Core::Hashable
       
@@ -2471,14 +2582,13 @@ module Google
         # @return [String]
         attr_accessor :density
       
-        # The fields supported by this index. For composite indexes, this requires a
-        # minimum of 2 and a maximum of 100 fields. The last field entry is always for
-        # the field path `__name__`. If, on creation, `__name__` was not specified as
-        # the last field, it will be added automatically with the same direction as that
-        # of the last field defined. If the final field in a composite index is not
-        # directional, the `__name__` will be ordered ASCENDING (unless explicitly
-        # specified). For single field indexes, this will always be exactly one entry
-        # with a field path equal to the field path of the associated field.
+        # The fields supported by this index. At most 100 fields may be specified. In
+        # Standard edition databases only: - At least 2 fields must be specified. - The
+        # last field entry is always for the field path `__name__`. If, on creation, `
+        # __name__` was not specified as the last field, it will be added automatically
+        # with the same direction as that of the last field defined. If the final field
+        # in the index is not directional, the `__name__` will be ordered ASCENDING (
+        # unless explicitly specified).
         # Corresponds to the JSON property `fields`
         # @return [Array<Google::Apis::FirestoreV1::GoogleFirestoreAdminV1IndexField>]
         attr_accessor :fields
@@ -2494,10 +2604,11 @@ module Google
         attr_accessor :multikey
         alias_method :multikey?, :multikey
       
-        # Output only. A server defined name for this index. The form of this name for
-        # composite indexes will be: `projects/`project_id`/databases/`database_id`/
-        # collectionGroups/`collection_id`/indexes/`composite_index_id`` For single
-        # field indexes, this field will be empty.
+        # A server-defined name for this index. Output only. When used in the google.
+        # firestore.admin.v1.Index resource, the value is of the form: `projects/`
+        # project_id`/databases/`database_id`/collectionGroups/`collection_id`/indexes/`
+        # index_id`` When used in the google.firestore.admin.v1.Field resource, the
+        # value is empty.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -2610,7 +2721,11 @@ module Google
         attr_accessor :change_type
       
         # Cloud Firestore indexes enable simple and complex queries against documents in
-        # a database.
+        # a database. In Standard edition databases, single-field indexes are managed
+        # using the google.firestore.admin.v1.Field resource, and composite indexes are
+        # managed using the google.firestore.admin.v1.Index resource. In Enterprise
+        # edition databases, both single-field and composite indexes are managed using
+        # the google.firestore.admin.v1.Index resource.
         # Corresponds to the JSON property `index`
         # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Index]
         attr_accessor :index
@@ -2775,6 +2890,25 @@ module Google
         end
       end
       
+      # Response to FirestoreAdmin.ListChangeStreams.
+      class GoogleFirestoreAdminV1ListChangeStreamsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The list of change streams.
+        # Corresponds to the JSON property `changeStreams`
+        # @return [Array<Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ChangeStream>]
+        attr_accessor :change_streams
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @change_streams = args[:change_streams] if args.key?(:change_streams)
+        end
+      end
+      
       # The list of databases for a project.
       class GoogleFirestoreAdminV1ListDatabasesResponse
         include Google::Apis::Core::Hashable
@@ -3347,12 +3481,31 @@ module Google
       class GoogleFirestoreAdminV1UpdateDatabaseMetadata
         include Google::Apis::Core::Hashable
       
+        # The time this operation completed. Will be unset if operation still in
+        # progress.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # The time this operation started.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        # The state of the operation.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @start_time = args[:start_time] if args.key?(:start_time)
+          @state = args[:state] if args.key?(:state)
         end
       end
       
@@ -3614,7 +3767,7 @@ module Google
         # @return [String]
         attr_accessor :read_time
       
-        # Options for a server request.
+        # Options for a request.
         # Corresponds to the JSON property `requestOptions`
         # @return [Google::Apis::FirestoreV1::RequestOptions]
         attr_accessor :request_options
@@ -3727,7 +3880,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :remove_target
       
-        # Options for a server request.
+        # Options for a request.
         # Corresponds to the JSON property `requestOptions`
         # @return [Google::Apis::FirestoreV1::RequestOptions]
         attr_accessor :request_options
@@ -3935,7 +4088,7 @@ module Google
         # @return [String]
         attr_accessor :read_time
       
-        # Options for a server request.
+        # Options for a request.
         # Corresponds to the JSON property `requestOptions`
         # @return [Google::Apis::FirestoreV1::RequestOptions]
         attr_accessor :request_options
@@ -4168,11 +4321,31 @@ module Google
         end
       end
       
-      # Options for a server request.
+      # Options for a request.
       class RequestOptions
         include Google::Apis::Core::Hashable
       
-        # Optional. The request tags for the request.
+        # Optional. The request tags for the request. Request tags are user-provided
+        # strings used for usage monitoring, cost management, and observability. Callers
+        # can associate custom application context (such as component, microservice,
+        # feature name, or operation type) with database requests. These tags are
+        # collected and aggregated in usage and monitoring reports, allowing billable
+        # operations and usage metrics to be sliced and analyzed by tag. These tags *
+        # only* show up in monitoring and are visible in administrative operations (such
+        # as usage reports). They do not affect data storage, query semantics, or
+        # request execution. Cardinality and Best Practices: - Request tags are most
+        # effective when using a bounded set of distinct values (e.g., fewer than 100
+        # distinct tags across an entire database). Using a large number of distinct
+        # tags may result in tags being omitted from top usage dashboards. - Use
+        # structured identifiers (for example: `app=cart`, `env=prod`, `service=checkout`
+        # ) and avoid high-cardinality values such as UUIDs, request IDs, timestamps,
+        # user IDs, or document keys. - Do not include sensitive data or personally
+        # identifiable information (PII) in request tags, as they show up in
+        # administrative monitoring. The tags are processed as follows: - Leading and
+        # trailing whitespace is trimmed. - Empty tags (after trimming) are filtered out.
+        # - Truncated to a maximum of 510 characters. - Deduplicated within the same
+        # request. - Limited to a maximum of 50 tags per request (excess tags are
+        # silently discarded).
         # Corresponds to the JSON property `requestTags`
         # @return [Array<String>]
         attr_accessor :request_tags
@@ -4191,7 +4364,7 @@ module Google
       class RollbackRequest
         include Google::Apis::Core::Hashable
       
-        # Options for a server request.
+        # Options for a request.
         # Corresponds to the JSON property `requestOptions`
         # @return [Google::Apis::FirestoreV1::RequestOptions]
         attr_accessor :request_options
@@ -4234,7 +4407,7 @@ module Google
         # @return [String]
         attr_accessor :read_time
       
-        # Options for a server request.
+        # Options for a request.
         # Corresponds to the JSON property `requestOptions`
         # @return [Google::Apis::FirestoreV1::RequestOptions]
         attr_accessor :request_options
@@ -4332,7 +4505,7 @@ module Google
         # @return [String]
         attr_accessor :read_time
       
-        # Options for a server request.
+        # Options for a request.
         # Corresponds to the JSON property `requestOptions`
         # @return [Google::Apis::FirestoreV1::RequestOptions]
         attr_accessor :request_options
@@ -4878,8 +5051,10 @@ module Google
         attr_accessor :boolean_value
         alias_method :boolean_value?, :boolean_value
       
-        # A bytes value. Must not exceed 1 MiB - 89 bytes. Only the first 1,500 bytes
-        # are considered by queries.
+        # A bytes value. In Standard edition databases: * The value must not exceed 1
+        # MiB - 89 bytes. * Only the first 1,500 bytes are considered by queries. In
+        # Enterprise edition databases, there is no limit on the size of the value.
+        # However, it is still subject to document and index entry size limits.
         # Corresponds to the JSON property `bytesValue`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -4939,9 +5114,11 @@ module Google
         # @return [String]
         attr_accessor :reference_value
       
-        # A string value. The string, represented as UTF-8, must not exceed 1 MiB - 89
-        # bytes. Only the first 1,500 bytes of the UTF-8 representation are considered
-        # by queries.
+        # A string value. In Standard edition databases: * The string, represented as
+        # UTF-8, must not exceed 1 MiB - 89 bytes. * Only the first 1,500 bytes of the
+        # UTF-8 representation are considered by queries. In Enterprise edition
+        # databases, there is no limit on the size of the value. However, it is still
+        # subject to document and index entry size limits.
         # Corresponds to the JSON property `stringValue`
         # @return [String]
         attr_accessor :string_value
@@ -5052,7 +5229,7 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Options for a server request.
+        # Options for a request.
         # Corresponds to the JSON property `requestOptions`
         # @return [Google::Apis::FirestoreV1::RequestOptions]
         attr_accessor :request_options

data/lib/google/apis/firestore_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module FirestoreV1
       # Version of the google-apis-firestore_v1 gem
-      GEM_VERSION = "0.97.0"
+      GEM_VERSION = "0.99.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.19.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20260702"
+      REVISION = "20260818"
     end
   end
 end

data/lib/google/apis/firestore_v1/representations.rb

@@ -286,6 +286,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleFirestoreAdminV1ChangeStream
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleFirestoreAdminV1CloneDatabaseMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -304,6 +310,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleFirestoreAdminV1CollectionGroupScope
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleFirestoreAdminV1CreateDatabaseMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -328,6 +340,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleFirestoreAdminV1DatabaseScope
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleFirestoreAdminV1DeleteDatabaseMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -448,6 +466,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleFirestoreAdminV1ListChangeStreamsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleFirestoreAdminV1ListDatabasesResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1298,6 +1322,22 @@ module Google
         end
       end
       
+      class GoogleFirestoreAdminV1ChangeStream
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :collection_group_scope, as: 'collectionGroupScope', class: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1CollectionGroupScope, decorator: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1CollectionGroupScope::Representation
+      
+          property :create_time, as: 'createTime'
+          property :database_scope, as: 'databaseScope', class: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1DatabaseScope, decorator: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1DatabaseScope::Representation
+      
+          property :etag, as: 'etag'
+          property :name, as: 'name'
+          property :retention_period, as: 'retentionPeriod'
+          property :start_time, as: 'startTime'
+          property :update_time, as: 'updateTime'
+        end
+      end
+      
       class GoogleFirestoreAdminV1CloneDatabaseMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1332,6 +1372,13 @@ module Google
         end
       end
       
+      class GoogleFirestoreAdminV1CollectionGroupScope
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :collection_group_id, as: 'collectionGroupId'
+        end
+      end
+      
       class GoogleFirestoreAdminV1CreateDatabaseMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1383,6 +1430,12 @@ module Google
         end
       end
       
+      class GoogleFirestoreAdminV1DatabaseScope
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class GoogleFirestoreAdminV1DeleteDatabaseMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1595,6 +1648,14 @@ module Google
         end
       end
       
+      class GoogleFirestoreAdminV1ListChangeStreamsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :change_streams, as: 'changeStreams', class: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ChangeStream, decorator: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ChangeStream::Representation
+      
+        end
+      end
+      
       class GoogleFirestoreAdminV1ListDatabasesResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1774,6 +1835,9 @@ module Google
       class GoogleFirestoreAdminV1UpdateDatabaseMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :end_time, as: 'endTime'
+          property :start_time, as: 'startTime'
+          property :state, as: 'state'
         end
       end
       

data/lib/google/apis/firestore_v1/service.rb

@@ -597,6 +597,144 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates a new change stream for the database.
+        # @param [String] parent
+        #   Required. The parent database to create the change stream for. Format is `
+        #   projects/`project`/databases/`database``.
+        # @param [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ChangeStream] google_firestore_admin_v1_change_stream_object
+        # @param [String] change_stream_id
+        #   Required. The ID to use for the change stream, which will become the final
+        #   component of the change stream's resource name. This value should be 4-63
+        #   characters. Valid characters are lowercase letters, numbers, and hyphens. The
+        #   first character must be a letter, and the last character must be a letter or a
+        #   number.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ChangeStream] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ChangeStream]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def create_project_database_change_stream(parent, google_firestore_admin_v1_change_stream_object = nil, change_stream_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/changeStreams', options)
+          command.request_representation = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ChangeStream::Representation
+          command.request_object = google_firestore_admin_v1_change_stream_object
+          command.response_representation = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ChangeStream::Representation
+          command.response_class = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ChangeStream
+          command.params['parent'] = parent unless parent.nil?
+          command.query['changeStreamId'] = change_stream_id unless change_stream_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes a change stream.
+        # @param [String] name
+        #   Required. The name of the change stream to delete. Format is `projects/`
+        #   project`/databases/`database`/changeStreams/`change_stream``.
+        # @param [String] etag
+        #   Optional. The etag of the change stream to delete. If this is not the current
+        #   etag of the change stream, the deletion will fail.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::FirestoreV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirestoreV1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_project_database_change_stream(name, etag: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::FirestoreV1::Empty::Representation
+          command.response_class = Google::Apis::FirestoreV1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['etag'] = etag unless etag.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets information about a change stream.
+        # @param [String] name
+        #   Required. The name of the change stream to retrieve. Format is `projects/`
+        #   project`/databases/`database`/changeStreams/`change_stream``.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ChangeStream] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ChangeStream]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_database_change_stream(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ChangeStream::Representation
+          command.response_class = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ChangeStream
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists all change streams in a database.
+        # @param [String] parent
+        #   Required. The parent database to list change streams from. Format is `projects/
+        #   `project`/databases/`database``.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ListChangeStreamsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ListChangeStreamsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_project_database_change_streams(parent, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/changeStreams', options)
+          command.response_representation = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ListChangeStreamsResponse::Representation
+          command.response_class = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ListChangeStreamsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets the metadata and configuration for a Field.
         # @param [String] name
         #   Required. A name of the form `projects/`project_id`/databases/`database_id`/
@@ -1030,7 +1168,27 @@ module Google
         #   The list of field paths in the mask. See Document.fields for a field path
         #   syntax reference.
         # @param [Array<String>, String] request_options_request_tags
-        #   Optional. The request tags for the request.
+        #   Optional. The request tags for the request. Request tags are user-provided
+        #   strings used for usage monitoring, cost management, and observability. Callers
+        #   can associate custom application context (such as component, microservice,
+        #   feature name, or operation type) with database requests. These tags are
+        #   collected and aggregated in usage and monitoring reports, allowing billable
+        #   operations and usage metrics to be sliced and analyzed by tag. These tags *
+        #   only* show up in monitoring and are visible in administrative operations (such
+        #   as usage reports). They do not affect data storage, query semantics, or
+        #   request execution. Cardinality and Best Practices: - Request tags are most
+        #   effective when using a bounded set of distinct values (e.g., fewer than 100
+        #   distinct tags across an entire database). Using a large number of distinct
+        #   tags may result in tags being omitted from top usage dashboards. - Use
+        #   structured identifiers (for example: `app=cart`, `env=prod`, `service=checkout`
+        #   ) and avoid high-cardinality values such as UUIDs, request IDs, timestamps,
+        #   user IDs, or document keys. - Do not include sensitive data or personally
+        #   identifiable information (PII) in request tags, as they show up in
+        #   administrative monitoring. The tags are processed as follows: - Leading and
+        #   trailing whitespace is trimmed. - Empty tags (after trimming) are filtered out.
+        #   - Truncated to a maximum of 510 characters. - Deduplicated within the same
+        #   request. - Limited to a maximum of 50 tags per request (excess tags are
+        #   silently discarded).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1075,7 +1233,27 @@ module Google
         #   When set, the target document must exist and have been last updated at that
         #   time. Timestamp must be microsecond aligned.
         # @param [Array<String>, String] request_options_request_tags
-        #   Optional. The request tags for the request.
+        #   Optional. The request tags for the request. Request tags are user-provided
+        #   strings used for usage monitoring, cost management, and observability. Callers
+        #   can associate custom application context (such as component, microservice,
+        #   feature name, or operation type) with database requests. These tags are
+        #   collected and aggregated in usage and monitoring reports, allowing billable
+        #   operations and usage metrics to be sliced and analyzed by tag. These tags *
+        #   only* show up in monitoring and are visible in administrative operations (such
+        #   as usage reports). They do not affect data storage, query semantics, or
+        #   request execution. Cardinality and Best Practices: - Request tags are most
+        #   effective when using a bounded set of distinct values (e.g., fewer than 100
+        #   distinct tags across an entire database). Using a large number of distinct
+        #   tags may result in tags being omitted from top usage dashboards. - Use
+        #   structured identifiers (for example: `app=cart`, `env=prod`, `service=checkout`
+        #   ) and avoid high-cardinality values such as UUIDs, request IDs, timestamps,
+        #   user IDs, or document keys. - Do not include sensitive data or personally
+        #   identifiable information (PII) in request tags, as they show up in
+        #   administrative monitoring. The tags are processed as follows: - Leading and
+        #   trailing whitespace is trimmed. - Empty tags (after trimming) are filtered out.
+        #   - Truncated to a maximum of 510 characters. - Deduplicated within the same
+        #   request. - Limited to a maximum of 50 tags per request (excess tags are
+        #   silently discarded).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1153,7 +1331,27 @@ module Google
         #   Recovery is enabled, can additionally be a whole minute timestamp within the
         #   past 7 days.
         # @param [Array<String>, String] request_options_request_tags
-        #   Optional. The request tags for the request.
+        #   Optional. The request tags for the request. Request tags are user-provided
+        #   strings used for usage monitoring, cost management, and observability. Callers
+        #   can associate custom application context (such as component, microservice,
+        #   feature name, or operation type) with database requests. These tags are
+        #   collected and aggregated in usage and monitoring reports, allowing billable
+        #   operations and usage metrics to be sliced and analyzed by tag. These tags *
+        #   only* show up in monitoring and are visible in administrative operations (such
+        #   as usage reports). They do not affect data storage, query semantics, or
+        #   request execution. Cardinality and Best Practices: - Request tags are most
+        #   effective when using a bounded set of distinct values (e.g., fewer than 100
+        #   distinct tags across an entire database). Using a large number of distinct
+        #   tags may result in tags being omitted from top usage dashboards. - Use
+        #   structured identifiers (for example: `app=cart`, `env=prod`, `service=checkout`
+        #   ) and avoid high-cardinality values such as UUIDs, request IDs, timestamps,
+        #   user IDs, or document keys. - Do not include sensitive data or personally
+        #   identifiable information (PII) in request tags, as they show up in
+        #   administrative monitoring. The tags are processed as follows: - Leading and
+        #   trailing whitespace is trimmed. - Empty tags (after trimming) are filtered out.
+        #   - Truncated to a maximum of 510 characters. - Deduplicated within the same
+        #   request. - Limited to a maximum of 50 tags per request (excess tags are
+        #   silently discarded).
         # @param [String] transaction
         #   Reads the document in a transaction.
         # @param [String] fields
@@ -1226,7 +1424,27 @@ module Google
         #   nested immediately under the parent. Requests with `recursive` may not specify
         #   `show_missing`.
         # @param [Array<String>, String] request_options_request_tags
-        #   Optional. The request tags for the request.
+        #   Optional. The request tags for the request. Request tags are user-provided
+        #   strings used for usage monitoring, cost management, and observability. Callers
+        #   can associate custom application context (such as component, microservice,
+        #   feature name, or operation type) with database requests. These tags are
+        #   collected and aggregated in usage and monitoring reports, allowing billable
+        #   operations and usage metrics to be sliced and analyzed by tag. These tags *
+        #   only* show up in monitoring and are visible in administrative operations (such
+        #   as usage reports). They do not affect data storage, query semantics, or
+        #   request execution. Cardinality and Best Practices: - Request tags are most
+        #   effective when using a bounded set of distinct values (e.g., fewer than 100
+        #   distinct tags across an entire database). Using a large number of distinct
+        #   tags may result in tags being omitted from top usage dashboards. - Use
+        #   structured identifiers (for example: `app=cart`, `env=prod`, `service=checkout`
+        #   ) and avoid high-cardinality values such as UUIDs, request IDs, timestamps,
+        #   user IDs, or document keys. - Do not include sensitive data or personally
+        #   identifiable information (PII) in request tags, as they show up in
+        #   administrative monitoring. The tags are processed as follows: - Leading and
+        #   trailing whitespace is trimmed. - Empty tags (after trimming) are filtered out.
+        #   - Truncated to a maximum of 510 characters. - Deduplicated within the same
+        #   request. - Limited to a maximum of 50 tags per request (excess tags are
+        #   silently discarded).
         # @param [Boolean] show_missing
         #   If the list should show missing documents. A document is missing if it does
         #   not exist, but there are sub-documents nested underneath it. When true, such
@@ -1347,7 +1565,27 @@ module Google
         #   nested immediately under the parent. Requests with `recursive` may not specify
         #   `show_missing`.
         # @param [Array<String>, String] request_options_request_tags
-        #   Optional. The request tags for the request.
+        #   Optional. The request tags for the request. Request tags are user-provided
+        #   strings used for usage monitoring, cost management, and observability. Callers
+        #   can associate custom application context (such as component, microservice,
+        #   feature name, or operation type) with database requests. These tags are
+        #   collected and aggregated in usage and monitoring reports, allowing billable
+        #   operations and usage metrics to be sliced and analyzed by tag. These tags *
+        #   only* show up in monitoring and are visible in administrative operations (such
+        #   as usage reports). They do not affect data storage, query semantics, or
+        #   request execution. Cardinality and Best Practices: - Request tags are most
+        #   effective when using a bounded set of distinct values (e.g., fewer than 100
+        #   distinct tags across an entire database). Using a large number of distinct
+        #   tags may result in tags being omitted from top usage dashboards. - Use
+        #   structured identifiers (for example: `app=cart`, `env=prod`, `service=checkout`
+        #   ) and avoid high-cardinality values such as UUIDs, request IDs, timestamps,
+        #   user IDs, or document keys. - Do not include sensitive data or personally
+        #   identifiable information (PII) in request tags, as they show up in
+        #   administrative monitoring. The tags are processed as follows: - Leading and
+        #   trailing whitespace is trimmed. - Empty tags (after trimming) are filtered out.
+        #   - Truncated to a maximum of 510 characters. - Deduplicated within the same
+        #   request. - Limited to a maximum of 50 tags per request (excess tags are
+        #   silently discarded).
         # @param [Boolean] show_missing
         #   If the list should show missing documents. A document is missing if it does
         #   not exist, but there are sub-documents nested underneath it. When true, such
@@ -1480,7 +1718,27 @@ module Google
         #   The list of field paths in the mask. See Document.fields for a field path
         #   syntax reference.
         # @param [Array<String>, String] request_options_request_tags
-        #   Optional. The request tags for the request.
+        #   Optional. The request tags for the request. Request tags are user-provided
+        #   strings used for usage monitoring, cost management, and observability. Callers
+        #   can associate custom application context (such as component, microservice,
+        #   feature name, or operation type) with database requests. These tags are
+        #   collected and aggregated in usage and monitoring reports, allowing billable
+        #   operations and usage metrics to be sliced and analyzed by tag. These tags *
+        #   only* show up in monitoring and are visible in administrative operations (such
+        #   as usage reports). They do not affect data storage, query semantics, or
+        #   request execution. Cardinality and Best Practices: - Request tags are most
+        #   effective when using a bounded set of distinct values (e.g., fewer than 100
+        #   distinct tags across an entire database). Using a large number of distinct
+        #   tags may result in tags being omitted from top usage dashboards. - Use
+        #   structured identifiers (for example: `app=cart`, `env=prod`, `service=checkout`
+        #   ) and avoid high-cardinality values such as UUIDs, request IDs, timestamps,
+        #   user IDs, or document keys. - Do not include sensitive data or personally
+        #   identifiable information (PII) in request tags, as they show up in
+        #   administrative monitoring. The tags are processed as follows: - Leading and
+        #   trailing whitespace is trimmed. - Empty tags (after trimming) are filtered out.
+        #   - Truncated to a maximum of 510 characters. - Deduplicated within the same
+        #   request. - Limited to a maximum of 50 tags per request (excess tags are
+        #   silently discarded).
         # @param [Array<String>, String] update_mask_field_paths
         #   The list of field paths in the mask. See Document.fields for a field path
         #   syntax reference.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-firestore_v1
 version: !ruby/object:Gem::Version
-  version: 0.97.0
+  version: 0.99.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-firestore_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-firestore_v1/v0.97.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-firestore_v1/v0.99.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-firestore_v1
 rdoc_options: []
 require_paths: