google-apis-firestore_v1beta1 0.54.0 → 0.56.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 555e8a4a8fb4ff8efcc9420646f4aa93cad25a5392a857d6c2e104f2c669f0cd
-  data.tar.gz: 1c67d79fb89424cfd528091a3ff1ce59da25f02d1331e955c262ae3b33a280b8
+  metadata.gz: 88fc6263869932e29144b5e0f58f73a8405051f8443babafadbd150a7846a628
+  data.tar.gz: c3725e69ee08704f2d268b950b360e8f8827f7434a986f03b6abaebc58cdbdb3
 SHA512:
-  metadata.gz: c360598486059444ac6812ddb448c579adbe164c2f2370f2763de72411fd5facc1c0ced6466fa1d2825c37bbdb2057a5955526db2bc157c5589d6e4b9230e49f
-  data.tar.gz: 76ba6654116ef1e3cf4cfad510b174876bcbea7092afa203522180a5ee7bdba584ed35002f21efbfa639f4a2af572ad68db3cdd87a437de6db52fb4dc81a2534
+  metadata.gz: c0ae552a0bef900666d6a4d0aa4c6700cdd567e6494f931b77cd1637734d75603fd1a31c07c2ac7e3f65d54508f20c535a0bbaa841c5296beea82ea3521248c1
+  data.tar.gz: 5e129a40feae70e69fbe4af777daf63fdeb96fffd5c3d360631e8704939462690b68bd1d55c1f9e685fce3f3b38c7f7ae89373e38680a8068f6c243c65804313

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-firestore_v1beta1
 
+### v0.56.0 (2026-08-30)
+
+* Regenerated from discovery document revision 20260818
+
+### v0.55.0 (2026-08-23)
+
+* Regenerated from discovery document revision 20260810
+
 ### v0.54.0 (2026-07-19)
 
 * Regenerated from discovery document revision 20260706

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

@@ -180,6 +180,11 @@ module Google
         # @return [String]
         attr_accessor :read_time
       
+        # Options for a request.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::FirestoreV1beta1::RequestOptions]
+        attr_accessor :request_options
+      
         # Reads documents in a transaction.
         # Corresponds to the JSON property `transaction`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -196,6 +201,7 @@ module Google
           @mask = args[:mask] if args.key?(:mask)
           @new_transaction = args[:new_transaction] if args.key?(:new_transaction)
           @read_time = args[:read_time] if args.key?(:read_time)
+          @request_options = args[:request_options] if args.key?(:request_options)
           @transaction = args[:transaction] if args.key?(:transaction)
         end
       end
@@ -252,6 +258,11 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
+        # Options for a request.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::FirestoreV1beta1::RequestOptions]
+        attr_accessor :request_options
+      
         # The writes to apply. Method does not apply writes atomically and does not
         # guarantee ordering. Each write succeeds or fails independently. You cannot
         # write to the same document more than once per request.
@@ -266,6 +277,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @labels = args[:labels] if args.key?(:labels)
+          @request_options = args[:request_options] if args.key?(:request_options)
           @writes = args[:writes] if args.key?(:writes)
         end
       end
@@ -306,6 +318,11 @@ module Google
         # @return [Google::Apis::FirestoreV1beta1::TransactionOptions]
         attr_accessor :options
       
+        # Options for a request.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::FirestoreV1beta1::RequestOptions]
+        attr_accessor :request_options
+      
         def initialize(**args)
            update!(**args)
         end
@@ -313,6 +330,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @options = args[:options] if args.key?(:options)
+          @request_options = args[:request_options] if args.key?(:request_options)
         end
       end
       
@@ -450,6 +468,11 @@ module Google
       class CommitRequest
         include Google::Apis::Core::Hashable
       
+        # Options for a request.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::FirestoreV1beta1::RequestOptions]
+        attr_accessor :request_options
+      
         # If set, applies all writes in this transaction, and commits it.
         # Corresponds to the JSON property `transaction`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -467,6 +490,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @request_options = args[:request_options] if args.key?(:request_options)
           @transaction = args[:transaction] if args.key?(:transaction)
           @writes = args[:writes] if args.key?(:writes)
         end
@@ -851,6 +875,11 @@ module Google
         # @return [String]
         attr_accessor :read_time
       
+        # Options for a request.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::FirestoreV1beta1::RequestOptions]
+        attr_accessor :request_options
+      
         # A Firestore query represented as an ordered list of operations / stages. This
         # is considered the top-level function which plans and executes a query. It is
         # logically equivalent to `query(stages, options)`, but prevents the client from
@@ -875,12 +904,13 @@ module Google
           @auto_commit_transaction = args[:auto_commit_transaction] if args.key?(:auto_commit_transaction)
           @new_transaction = args[:new_transaction] if args.key?(:new_transaction)
           @read_time = args[:read_time] if args.key?(:read_time)
+          @request_options = args[:request_options] if args.key?(:request_options)
           @structured_pipeline = args[:structured_pipeline] if args.key?(:structured_pipeline)
           @transaction = args[:transaction] if args.key?(:transaction)
         end
       end
       
-      # The response for Firestore.Execute.
+      # The response for Firestore.ExecutePipeline.
       class ExecutePipelineResponse
         include Google::Apis::Core::Hashable
       
@@ -1583,12 +1613,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
       
@@ -2080,6 +2129,11 @@ module Google
         # @return [String]
         attr_accessor :read_time
       
+        # Options for a request.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::FirestoreV1beta1::RequestOptions]
+        attr_accessor :request_options
+      
         def initialize(**args)
            update!(**args)
         end
@@ -2089,6 +2143,7 @@ module Google
           @page_size = args[:page_size] if args.key?(:page_size)
           @page_token = args[:page_token] if args.key?(:page_token)
           @read_time = args[:read_time] if args.key?(:read_time)
+          @request_options = args[:request_options] if args.key?(:request_options)
         end
       end
       
@@ -2162,6 +2217,11 @@ module Google
         # @return [Fixnum]
         attr_accessor :remove_target
       
+        # Options for a request.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::FirestoreV1beta1::RequestOptions]
+        attr_accessor :request_options
+      
         def initialize(**args)
            update!(**args)
         end
@@ -2171,6 +2231,7 @@ module Google
           @add_target = args[:add_target] if args.key?(:add_target)
           @labels = args[:labels] if args.key?(:labels)
           @remove_target = args[:remove_target] if args.key?(:remove_target)
+          @request_options = args[:request_options] if args.key?(:request_options)
         end
       end
       
@@ -2317,6 +2378,11 @@ module Google
         # @return [String]
         attr_accessor :read_time
       
+        # Options for a request.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::FirestoreV1beta1::RequestOptions]
+        attr_accessor :request_options
+      
         # A Firestore query. The query stages are executed in the following order: 1.
         # from 2. where 3. select 4. order_by + start_at + end_at 5. offset 6. limit 7.
         # find_nearest
@@ -2334,6 +2400,7 @@ module Google
           @page_token = args[:page_token] if args.key?(:page_token)
           @partition_count = args[:partition_count] if args.key?(:partition_count)
           @read_time = args[:read_time] if args.key?(:read_time)
+          @request_options = args[:request_options] if args.key?(:request_options)
           @structured_query = args[:structured_query] if args.key?(:structured_query)
         end
       end
@@ -2544,10 +2611,54 @@ module Google
         end
       end
       
+      # Options for a request.
+      class RequestOptions
+        include Google::Apis::Core::Hashable
+      
+        # 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
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @request_tags = args[:request_tags] if args.key?(:request_tags)
+        end
+      end
+      
       # The request for Firestore.Rollback.
       class RollbackRequest
         include Google::Apis::Core::Hashable
       
+        # Options for a request.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::FirestoreV1beta1::RequestOptions]
+        attr_accessor :request_options
+      
         # Required. The transaction to roll back.
         # Corresponds to the JSON property `transaction`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -2560,6 +2671,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @request_options = args[:request_options] if args.key?(:request_options)
           @transaction = args[:transaction] if args.key?(:transaction)
         end
       end
@@ -2585,6 +2697,11 @@ module Google
         # @return [String]
         attr_accessor :read_time
       
+        # Options for a request.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::FirestoreV1beta1::RequestOptions]
+        attr_accessor :request_options
+      
         # Firestore query for running an aggregation over a StructuredQuery.
         # Corresponds to the JSON property `structuredAggregationQuery`
         # @return [Google::Apis::FirestoreV1beta1::StructuredAggregationQuery]
@@ -2606,6 +2723,7 @@ module Google
           @explain_options = args[:explain_options] if args.key?(:explain_options)
           @new_transaction = args[:new_transaction] if args.key?(:new_transaction)
           @read_time = args[:read_time] if args.key?(:read_time)
+          @request_options = args[:request_options] if args.key?(:request_options)
           @structured_aggregation_query = args[:structured_aggregation_query] if args.key?(:structured_aggregation_query)
           @transaction = args[:transaction] if args.key?(:transaction)
         end
@@ -2677,6 +2795,11 @@ module Google
         # @return [String]
         attr_accessor :read_time
       
+        # Options for a request.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::FirestoreV1beta1::RequestOptions]
+        attr_accessor :request_options
+      
         # A Firestore query. The query stages are executed in the following order: 1.
         # from 2. where 3. select 4. order_by + start_at + end_at 5. offset 6. limit 7.
         # find_nearest
@@ -2700,6 +2823,7 @@ module Google
           @explain_options = args[:explain_options] if args.key?(:explain_options)
           @new_transaction = args[:new_transaction] if args.key?(:new_transaction)
           @read_time = args[:read_time] if args.key?(:read_time)
+          @request_options = args[:request_options] if args.key?(:request_options)
           @structured_query = args[:structured_query] if args.key?(:structured_query)
           @transaction = args[:transaction] if args.key?(:transaction)
         end
@@ -3217,8 +3341,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]
@@ -3278,9 +3404,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
@@ -3391,6 +3519,11 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
+        # Options for a request.
+        # Corresponds to the JSON property `requestOptions`
+        # @return [Google::Apis::FirestoreV1beta1::RequestOptions]
+        attr_accessor :request_options
+      
         # The ID of the write stream to resume. This may only be set in the first
         # message. When left empty, a new write stream will be created.
         # Corresponds to the JSON property `streamId`
@@ -3424,6 +3557,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @labels = args[:labels] if args.key?(:labels)
+          @request_options = args[:request_options] if args.key?(:request_options)
           @stream_id = args[:stream_id] if args.key?(:stream_id)
           @stream_token = args[:stream_token] if args.key?(:stream_token)
           @writes = args[:writes] if args.key?(:writes)

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module FirestoreV1beta1
       # Version of the google-apis-firestore_v1beta1 gem
-      GEM_VERSION = "0.54.0"
+      GEM_VERSION = "0.56.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 = "20260706"
+      REVISION = "20260818"
     end
   end
 end

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

@@ -478,6 +478,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RequestOptions
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class RollbackRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -644,6 +650,8 @@ module Google
           property :new_transaction, as: 'newTransaction', class: Google::Apis::FirestoreV1beta1::TransactionOptions, decorator: Google::Apis::FirestoreV1beta1::TransactionOptions::Representation
       
           property :read_time, as: 'readTime'
+          property :request_options, as: 'requestOptions', class: Google::Apis::FirestoreV1beta1::RequestOptions, decorator: Google::Apis::FirestoreV1beta1::RequestOptions::Representation
+      
           property :transaction, :base64 => true, as: 'transaction'
         end
       end
@@ -663,6 +671,8 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           hash :labels, as: 'labels'
+          property :request_options, as: 'requestOptions', class: Google::Apis::FirestoreV1beta1::RequestOptions, decorator: Google::Apis::FirestoreV1beta1::RequestOptions::Representation
+      
           collection :writes, as: 'writes', class: Google::Apis::FirestoreV1beta1::Write, decorator: Google::Apis::FirestoreV1beta1::Write::Representation
       
         end
@@ -683,6 +693,8 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :options, as: 'options', class: Google::Apis::FirestoreV1beta1::TransactionOptions, decorator: Google::Apis::FirestoreV1beta1::TransactionOptions::Representation
       
+          property :request_options, as: 'requestOptions', class: Google::Apis::FirestoreV1beta1::RequestOptions, decorator: Google::Apis::FirestoreV1beta1::RequestOptions::Representation
+      
         end
       end
       
@@ -721,6 +733,8 @@ module Google
       class CommitRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :request_options, as: 'requestOptions', class: Google::Apis::FirestoreV1beta1::RequestOptions, decorator: Google::Apis::FirestoreV1beta1::RequestOptions::Representation
+      
           property :transaction, :base64 => true, as: 'transaction'
           collection :writes, as: 'writes', class: Google::Apis::FirestoreV1beta1::Write, decorator: Google::Apis::FirestoreV1beta1::Write::Representation
       
@@ -836,6 +850,8 @@ module Google
           property :new_transaction, as: 'newTransaction', class: Google::Apis::FirestoreV1beta1::TransactionOptions, decorator: Google::Apis::FirestoreV1beta1::TransactionOptions::Representation
       
           property :read_time, as: 'readTime'
+          property :request_options, as: 'requestOptions', class: Google::Apis::FirestoreV1beta1::RequestOptions, decorator: Google::Apis::FirestoreV1beta1::RequestOptions::Representation
+      
           property :structured_pipeline, as: 'structuredPipeline', class: Google::Apis::FirestoreV1beta1::StructuredPipeline, decorator: Google::Apis::FirestoreV1beta1::StructuredPipeline::Representation
       
           property :transaction, :base64 => true, as: 'transaction'
@@ -1046,6 +1062,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
       
@@ -1183,6 +1202,8 @@ module Google
           property :page_size, as: 'pageSize'
           property :page_token, as: 'pageToken'
           property :read_time, as: 'readTime'
+          property :request_options, as: 'requestOptions', class: Google::Apis::FirestoreV1beta1::RequestOptions, decorator: Google::Apis::FirestoreV1beta1::RequestOptions::Representation
+      
         end
       end
       
@@ -1210,6 +1231,8 @@ module Google
       
           hash :labels, as: 'labels'
           property :remove_target, as: 'removeTarget'
+          property :request_options, as: 'requestOptions', class: Google::Apis::FirestoreV1beta1::RequestOptions, decorator: Google::Apis::FirestoreV1beta1::RequestOptions::Representation
+      
         end
       end
       
@@ -1253,6 +1276,8 @@ module Google
           property :page_token, as: 'pageToken'
           property :partition_count, :numeric_string => true, as: 'partitionCount'
           property :read_time, as: 'readTime'
+          property :request_options, as: 'requestOptions', class: Google::Apis::FirestoreV1beta1::RequestOptions, decorator: Google::Apis::FirestoreV1beta1::RequestOptions::Representation
+      
           property :structured_query, as: 'structuredQuery', class: Google::Apis::FirestoreV1beta1::StructuredQuery, decorator: Google::Apis::FirestoreV1beta1::StructuredQuery::Representation
       
         end
@@ -1322,9 +1347,18 @@ module Google
         end
       end
       
+      class RequestOptions
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :request_tags, as: 'requestTags'
+        end
+      end
+      
       class RollbackRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :request_options, as: 'requestOptions', class: Google::Apis::FirestoreV1beta1::RequestOptions, decorator: Google::Apis::FirestoreV1beta1::RequestOptions::Representation
+      
           property :transaction, :base64 => true, as: 'transaction'
         end
       end
@@ -1337,6 +1371,8 @@ module Google
           property :new_transaction, as: 'newTransaction', class: Google::Apis::FirestoreV1beta1::TransactionOptions, decorator: Google::Apis::FirestoreV1beta1::TransactionOptions::Representation
       
           property :read_time, as: 'readTime'
+          property :request_options, as: 'requestOptions', class: Google::Apis::FirestoreV1beta1::RequestOptions, decorator: Google::Apis::FirestoreV1beta1::RequestOptions::Representation
+      
           property :structured_aggregation_query, as: 'structuredAggregationQuery', class: Google::Apis::FirestoreV1beta1::StructuredAggregationQuery, decorator: Google::Apis::FirestoreV1beta1::StructuredAggregationQuery::Representation
       
           property :transaction, :base64 => true, as: 'transaction'
@@ -1363,6 +1399,8 @@ module Google
           property :new_transaction, as: 'newTransaction', class: Google::Apis::FirestoreV1beta1::TransactionOptions, decorator: Google::Apis::FirestoreV1beta1::TransactionOptions::Representation
       
           property :read_time, as: 'readTime'
+          property :request_options, as: 'requestOptions', class: Google::Apis::FirestoreV1beta1::RequestOptions, decorator: Google::Apis::FirestoreV1beta1::RequestOptions::Representation
+      
           property :structured_query, as: 'structuredQuery', class: Google::Apis::FirestoreV1beta1::StructuredQuery, decorator: Google::Apis::FirestoreV1beta1::StructuredQuery::Representation
       
           property :transaction, :base64 => true, as: 'transaction'
@@ -1546,6 +1584,8 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           hash :labels, as: 'labels'
+          property :request_options, as: 'requestOptions', class: Google::Apis::FirestoreV1beta1::RequestOptions, decorator: Google::Apis::FirestoreV1beta1::RequestOptions::Representation
+      
           property :stream_id, as: 'streamId'
           property :stream_token, :base64 => true, as: 'streamToken'
           collection :writes, as: 'writes', class: Google::Apis::FirestoreV1beta1::Write, decorator: Google::Apis::FirestoreV1beta1::Write::Representation

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

@@ -286,6 +286,28 @@ module Google
         # @param [Array<String>, String] mask_field_paths
         #   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. 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
@@ -303,7 +325,7 @@ module Google
         # @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_document_document(parent, collection_id, document_object = nil, document_id: nil, mask_field_paths: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def create_project_database_document_document(parent, collection_id, document_object = nil, document_id: nil, mask_field_paths: nil, request_options_request_tags: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:post, 'v1beta1/{+parent}/{collectionId}', options)
           command.request_representation = Google::Apis::FirestoreV1beta1::Document::Representation
           command.request_object = document_object
@@ -313,6 +335,7 @@ module Google
           command.params['collectionId'] = collection_id unless collection_id.nil?
           command.query['documentId'] = document_id unless document_id.nil?
           command.query['mask.fieldPaths'] = mask_field_paths unless mask_field_paths.nil?
+          command.query['requestOptions.requestTags'] = request_options_request_tags unless request_options_request_tags.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -328,6 +351,28 @@ module Google
         # @param [String] current_document_update_time
         #   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. 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
@@ -345,13 +390,14 @@ module Google
         # @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_document(name, current_document_exists: nil, current_document_update_time: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def delete_project_database_document(name, current_document_exists: nil, current_document_update_time: nil, request_options_request_tags: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:delete, 'v1beta1/{+name}', options)
           command.response_representation = Google::Apis::FirestoreV1beta1::Empty::Representation
           command.response_class = Google::Apis::FirestoreV1beta1::Empty
           command.params['name'] = name unless name.nil?
           command.query['currentDocument.exists'] = current_document_exists unless current_document_exists.nil?
           command.query['currentDocument.updateTime'] = current_document_update_time unless current_document_update_time.nil?
+          command.query['requestOptions.requestTags'] = request_options_request_tags unless request_options_request_tags.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -403,6 +449,28 @@ module Google
         #   microsecond precision timestamp within the past one hour, or if Point-in-Time
         #   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. 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
@@ -422,13 +490,14 @@ module Google
         # @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_document(name, mask_field_paths: nil, read_time: nil, transaction: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def get_project_database_document(name, mask_field_paths: nil, read_time: nil, request_options_request_tags: nil, transaction: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1beta1/{+name}', options)
           command.response_representation = Google::Apis::FirestoreV1beta1::Document::Representation
           command.response_class = Google::Apis::FirestoreV1beta1::Document
           command.params['name'] = name unless name.nil?
           command.query['mask.fieldPaths'] = mask_field_paths unless mask_field_paths.nil?
           command.query['readTime'] = read_time unless read_time.nil?
+          command.query['requestOptions.requestTags'] = request_options_request_tags unless request_options_request_tags.nil?
           command.query['transaction'] = transaction unless transaction.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -473,6 +542,28 @@ module Google
         #   This is optional, and when not provided, Firestore will only list documents
         #   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. 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
@@ -498,7 +589,7 @@ module Google
         # @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_documents(parent, collection_id, mask_field_paths: nil, order_by: nil, page_size: nil, page_token: nil, read_time: nil, recursive: nil, show_missing: nil, transaction: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_project_database_documents(parent, collection_id, mask_field_paths: nil, order_by: nil, page_size: nil, page_token: nil, read_time: nil, recursive: nil, request_options_request_tags: nil, show_missing: nil, transaction: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1beta1/{+parent}/{collectionId}', options)
           command.response_representation = Google::Apis::FirestoreV1beta1::ListDocumentsResponse::Representation
           command.response_class = Google::Apis::FirestoreV1beta1::ListDocumentsResponse
@@ -510,6 +601,7 @@ module Google
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['readTime'] = read_time unless read_time.nil?
           command.query['recursive'] = recursive unless recursive.nil?
+          command.query['requestOptions.requestTags'] = request_options_request_tags unless request_options_request_tags.nil?
           command.query['showMissing'] = show_missing unless show_missing.nil?
           command.query['transaction'] = transaction unless transaction.nil?
           command.query['fields'] = fields unless fields.nil?
@@ -591,6 +683,28 @@ module Google
         #   This is optional, and when not provided, Firestore will only list documents
         #   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. 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
@@ -616,7 +730,7 @@ module Google
         # @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_document_documents(parent, collection_id, mask_field_paths: nil, order_by: nil, page_size: nil, page_token: nil, read_time: nil, recursive: nil, show_missing: nil, transaction: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_project_database_document_documents(parent, collection_id, mask_field_paths: nil, order_by: nil, page_size: nil, page_token: nil, read_time: nil, recursive: nil, request_options_request_tags: nil, show_missing: nil, transaction: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1beta1/{+parent}/{collectionId}', options)
           command.response_representation = Google::Apis::FirestoreV1beta1::ListDocumentsResponse::Representation
           command.response_class = Google::Apis::FirestoreV1beta1::ListDocumentsResponse
@@ -628,6 +742,7 @@ module Google
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['readTime'] = read_time unless read_time.nil?
           command.query['recursive'] = recursive unless recursive.nil?
+          command.query['requestOptions.requestTags'] = request_options_request_tags unless request_options_request_tags.nil?
           command.query['showMissing'] = show_missing unless show_missing.nil?
           command.query['transaction'] = transaction unless transaction.nil?
           command.query['fields'] = fields unless fields.nil?
@@ -721,6 +836,28 @@ module Google
         # @param [Array<String>, String] mask_field_paths
         #   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. 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.
@@ -741,7 +878,7 @@ module Google
         # @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 patch_project_database_document(name, document_object = nil, current_document_exists: nil, current_document_update_time: nil, mask_field_paths: nil, update_mask_field_paths: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def patch_project_database_document(name, document_object = nil, current_document_exists: nil, current_document_update_time: nil, mask_field_paths: nil, request_options_request_tags: nil, update_mask_field_paths: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:patch, 'v1beta1/{+name}', options)
           command.request_representation = Google::Apis::FirestoreV1beta1::Document::Representation
           command.request_object = document_object
@@ -751,6 +888,7 @@ module Google
           command.query['currentDocument.exists'] = current_document_exists unless current_document_exists.nil?
           command.query['currentDocument.updateTime'] = current_document_update_time unless current_document_update_time.nil?
           command.query['mask.fieldPaths'] = mask_field_paths unless mask_field_paths.nil?
+          command.query['requestOptions.requestTags'] = request_options_request_tags unless request_options_request_tags.nil?
           command.query['updateMask.fieldPaths'] = update_mask_field_paths unless update_mask_field_paths.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-firestore_v1beta1
 version: !ruby/object:Gem::Version
-  version: 0.54.0
+  version: 0.56.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_v1beta1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-firestore_v1beta1/v0.54.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-firestore_v1beta1/v0.56.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-firestore_v1beta1
 rdoc_options: []
 require_paths: