google-apis-firestore_v1beta1 0.33.0 → 0.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aae0a232d8df396c19747bd0ac8281cf3f1fd9410248df8048d2bfa7d434a836
-  data.tar.gz: f39e0fc8f076b8a5daef6db65d65c2a03122841f9425ec05ba0a045396d45360
+  metadata.gz: b4d34f15128455e19009638af9112b57e8ab1b0483c0f2b0ff8e0ee18b2feba9
+  data.tar.gz: 212f987fb0b5784daa9831818ff5d1c155d0cee71d992acda0f4beb5defcdea3
 SHA512:
-  metadata.gz: 6e0ce11834d12fce8a486a61f54684b85f8442d3936d59d200bde2c40da5e82791443f2b6b3d69d7a499f9b16632ecb6cab0a49e6c230462052356a7fdc63fe6
-  data.tar.gz: 0e5530f782c77ec5a24f7ff153cb4d1232c3eac7f33159741b2f9c3c7908ba211a2d909c862a9619083a258d73792bcd15cda0b3c885591b6bd8dd21a987aec1
+  metadata.gz: 42fcf5102ac480640ec44bfbfb345e36e1a00898afed5d5919a16e12a13715e0558d94f2648fd202aa8782df179be8a97780a50712c24fcd91a7129a71d2372f
+  data.tar.gz: c78638b01e53786c97aaed1fa6c1634a731c7ba1db5de08bd5deca2bc892128b095561de7fbd145d659d842f948bdad939023192f51cab0a4e2b7df04afdac8e

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Release history for google-apis-firestore_v1beta1
 
+### v0.35.0 (2024-01-23)
+
+* Regenerated from discovery document revision 20240117
+* Regenerated using generator version 0.13.0
+
+### v0.34.0 (2023-10-08)
+
+* Regenerated from discovery document revision 20231002
+
 ### v0.33.0 (2023-09-10)
 
 * Regenerated from discovery document revision 20230905

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

@@ -588,7 +588,21 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
-        # 
+        # The document's fields. The map keys represent field names. Field names
+        # matching the regular expression `__.*__` are reserved. Reserved field names
+        # are forbidden except in certain documented contexts. The field names,
+        # represented as UTF-8, must not exceed 1,500 bytes and cannot be empty. Field
+        # paths may be used in other contexts to refer to structured fields defined here.
+        # For `map_value`, the field path is represented by a dot-delimited (`.`)
+        # string of segments. Each segment is either a simple field name (defined below)
+        # or a quoted field name. For example, the structured field `"foo" : ` map_value:
+        # ` "x&y" : ` string_value: "hello" ```` would be represented by the field path
+        # `` foo.`x&y` ``. A simple field name contains only characters `a` to `z`, `A`
+        # to `Z`, `0` to `9`, or `_`, and must not start with `0` to `9`. For example, `
+        # foo_bar_17`. A quoted field name starts and ends with `` ` `` and may contain
+        # any character. Some characters, including `` ` ``, must be escaped using a `\`.
+        # For example, `` `x&y` `` represents `x&y` and `` `bak\`tik` `` represents ``
+        # bak`tik ``.
         # Corresponds to the JSON property `fields`
         # @return [Hash<String,Google::Apis::FirestoreV1beta1::Value>]
         attr_accessor :fields
@@ -1833,7 +1847,8 @@ module Google
         # @return [String]
         attr_accessor :read_time
       
-        # A Firestore query.
+        # 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
         # Corresponds to the JSON property `structuredQuery`
         # @return [Google::Apis::FirestoreV1beta1::StructuredQuery]
         attr_accessor :structured_query
@@ -1871,7 +1886,8 @@ module Google
         # PartitionQuery request returns partition cursors A and B, running the
         # following three queries will return the entire result set of the original
         # query: * query, end_at A * query, start_at A, end_at B * query, start_at B An
-        # empty result may indicate that the query has too few results to be partitioned.
+        # empty result may indicate that the query has too few results to be partitioned,
+        # or that the query is not yet supported for partitioning.
         # Corresponds to the JSON property `partitions`
         # @return [Array<Google::Apis::FirestoreV1beta1::Cursor>]
         attr_accessor :partitions
@@ -1935,6 +1951,27 @@ module Google
         end
       end
       
+      # Plan for the query.
+      class QueryPlan
+        include Google::Apis::Core::Hashable
+      
+        # Planning phase information for the query. It will include: ` "indexes_used": [
+        # `"query_scope": "Collection", "properties": "(foo ASC, __name__ ASC)"`, `"
+        # query_scope": "Collection", "properties": "(bar ASC, __name__ ASC)"` ] `
+        # Corresponds to the JSON property `planInfo`
+        # @return [Hash<String,Object>]
+        attr_accessor :plan_info
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @plan_info = args[:plan_info] if args.key?(:plan_info)
+        end
+      end
+      
       # A target specified by a query.
       class QueryTarget
         include Google::Apis::Core::Hashable
@@ -1948,7 +1985,8 @@ module Google
         # @return [String]
         attr_accessor :parent
       
-        # A Firestore query.
+        # 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
         # Corresponds to the JSON property `structuredQuery`
         # @return [Google::Apis::FirestoreV1beta1::StructuredQuery]
         attr_accessor :structured_query
@@ -2007,6 +2045,35 @@ module Google
         end
       end
       
+      # Planning and execution statistics for the query.
+      class ResultSetStats
+        include Google::Apis::Core::Hashable
+      
+        # Plan for the query.
+        # Corresponds to the JSON property `queryPlan`
+        # @return [Google::Apis::FirestoreV1beta1::QueryPlan]
+        attr_accessor :query_plan
+      
+        # Aggregated statistics from the execution of the query. This will only be
+        # present when the request specifies `PROFILE` mode. For example, a query will
+        # return the statistics including: ` "results_returned": "20", "
+        # documents_scanned": "20", "indexes_entries_scanned": "10050", "
+        # total_execution_time": "100.7 msecs" `
+        # Corresponds to the JSON property `queryStats`
+        # @return [Hash<String,Object>]
+        attr_accessor :query_stats
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @query_plan = args[:query_plan] if args.key?(:query_plan)
+          @query_stats = args[:query_stats] if args.key?(:query_stats)
+        end
+      end
+      
       # The request for Firestore.Rollback.
       class RollbackRequest
         include Google::Apis::Core::Hashable
@@ -2031,6 +2098,13 @@ module Google
       class RunAggregationQueryRequest
         include Google::Apis::Core::Hashable
       
+        # Optional. The mode in which the query request is processed. This field is
+        # optional, and when not provided, it defaults to `NORMAL` mode where no
+        # additional statistics will be returned with the query results.
+        # Corresponds to the JSON property `mode`
+        # @return [String]
+        attr_accessor :mode
+      
         # Options for creating a new transaction.
         # Corresponds to the JSON property `newTransaction`
         # @return [Google::Apis::FirestoreV1beta1::TransactionOptions]
@@ -2061,6 +2135,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @mode = args[:mode] if args.key?(:mode)
           @new_transaction = args[:new_transaction] if args.key?(:new_transaction)
           @read_time = args[:read_time] if args.key?(:read_time)
           @structured_aggregation_query = args[:structured_aggregation_query] if args.key?(:structured_aggregation_query)
@@ -2088,6 +2163,11 @@ module Google
         # @return [Google::Apis::FirestoreV1beta1::AggregationResult]
         attr_accessor :result
       
+        # Planning and execution statistics for the query.
+        # Corresponds to the JSON property `stats`
+        # @return [Google::Apis::FirestoreV1beta1::ResultSetStats]
+        attr_accessor :stats
+      
         # The transaction that was started as part of this request. Only present on the
         # first response when the request requested to start a new transaction.
         # Corresponds to the JSON property `transaction`
@@ -2103,6 +2183,7 @@ module Google
         def update!(**args)
           @read_time = args[:read_time] if args.key?(:read_time)
           @result = args[:result] if args.key?(:result)
+          @stats = args[:stats] if args.key?(:stats)
           @transaction = args[:transaction] if args.key?(:transaction)
         end
       end
@@ -2111,6 +2192,13 @@ module Google
       class RunQueryRequest
         include Google::Apis::Core::Hashable
       
+        # Optional. The mode in which the query request is processed. This field is
+        # optional, and when not provided, it defaults to `NORMAL` mode where no
+        # additional statistics will be returned with the query results.
+        # Corresponds to the JSON property `mode`
+        # @return [String]
+        attr_accessor :mode
+      
         # Options for creating a new transaction.
         # Corresponds to the JSON property `newTransaction`
         # @return [Google::Apis::FirestoreV1beta1::TransactionOptions]
@@ -2123,7 +2211,8 @@ module Google
         # @return [String]
         attr_accessor :read_time
       
-        # A Firestore query.
+        # 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
         # Corresponds to the JSON property `structuredQuery`
         # @return [Google::Apis::FirestoreV1beta1::StructuredQuery]
         attr_accessor :structured_query
@@ -2141,6 +2230,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @mode = args[:mode] if args.key?(:mode)
           @new_transaction = args[:new_transaction] if args.key?(:new_transaction)
           @read_time = args[:read_time] if args.key?(:read_time)
           @structured_query = args[:structured_query] if args.key?(:structured_query)
@@ -2179,6 +2269,11 @@ module Google
         # @return [Fixnum]
         attr_accessor :skipped_results
       
+        # Planning and execution statistics for the query.
+        # Corresponds to the JSON property `stats`
+        # @return [Google::Apis::FirestoreV1beta1::ResultSetStats]
+        attr_accessor :stats
+      
         # The transaction that was started as part of this request. Can only be set in
         # the first response, and only if RunQueryRequest.new_transaction was set in the
         # request. If set, no other fields will be set in this response.
@@ -2197,6 +2292,7 @@ module Google
           @done = args[:done] if args.key?(:done)
           @read_time = args[:read_time] if args.key?(:read_time)
           @skipped_results = args[:skipped_results] if args.key?(:skipped_results)
+          @stats = args[:stats] if args.key?(:stats)
           @transaction = args[:transaction] if args.key?(:transaction)
         end
       end
@@ -2251,7 +2347,8 @@ module Google
         # @return [Array<Google::Apis::FirestoreV1beta1::Aggregation>]
         attr_accessor :aggregations
       
-        # A Firestore query.
+        # 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
         # Corresponds to the JSON property `structuredQuery`
         # @return [Google::Apis::FirestoreV1beta1::StructuredQuery]
         attr_accessor :structured_query
@@ -2267,7 +2364,8 @@ module Google
         end
       end
       
-      # A Firestore query.
+      # 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
       class StructuredQuery
         include Google::Apis::Core::Hashable
       

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.33.0"
+      GEM_VERSION = "0.35.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.12.0"
+      GENERATOR_VERSION = "0.13.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230905"
+      REVISION = "20240117"
     end
   end
 end

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

@@ -382,6 +382,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class QueryPlan
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class QueryTarget
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -400,6 +406,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ResultSetStats
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class RollbackRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1070,6 +1082,13 @@ module Google
         end
       end
       
+      class QueryPlan
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :plan_info, as: 'planInfo'
+        end
+      end
+      
       class QueryTarget
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1093,6 +1112,15 @@ module Google
         end
       end
       
+      class ResultSetStats
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :query_plan, as: 'queryPlan', class: Google::Apis::FirestoreV1beta1::QueryPlan, decorator: Google::Apis::FirestoreV1beta1::QueryPlan::Representation
+      
+          hash :query_stats, as: 'queryStats'
+        end
+      end
+      
       class RollbackRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1103,6 +1131,7 @@ module Google
       class RunAggregationQueryRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :mode, as: 'mode'
           property :new_transaction, as: 'newTransaction', class: Google::Apis::FirestoreV1beta1::TransactionOptions, decorator: Google::Apis::FirestoreV1beta1::TransactionOptions::Representation
       
           property :read_time, as: 'readTime'
@@ -1118,6 +1147,8 @@ module Google
           property :read_time, as: 'readTime'
           property :result, as: 'result', class: Google::Apis::FirestoreV1beta1::AggregationResult, decorator: Google::Apis::FirestoreV1beta1::AggregationResult::Representation
       
+          property :stats, as: 'stats', class: Google::Apis::FirestoreV1beta1::ResultSetStats, decorator: Google::Apis::FirestoreV1beta1::ResultSetStats::Representation
+      
           property :transaction, :base64 => true, as: 'transaction'
         end
       end
@@ -1125,6 +1156,7 @@ module Google
       class RunQueryRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :mode, as: 'mode'
           property :new_transaction, as: 'newTransaction', class: Google::Apis::FirestoreV1beta1::TransactionOptions, decorator: Google::Apis::FirestoreV1beta1::TransactionOptions::Representation
       
           property :read_time, as: 'readTime'
@@ -1142,6 +1174,8 @@ module Google
           property :done, as: 'done'
           property :read_time, as: 'readTime'
           property :skipped_results, as: 'skippedResults'
+          property :stats, as: 'stats', class: Google::Apis::FirestoreV1beta1::ResultSetStats, decorator: Google::Apis::FirestoreV1beta1::ResultSetStats::Representation
+      
           property :transaction, :base64 => true, as: 'transaction'
         end
       end

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

@@ -33,6 +33,8 @@ module Google
       #
       # @see https://cloud.google.com/firestore
       class FirestoreService < Google::Apis::Core::BaseService
+        DEFAULT_ENDPOINT_TEMPLATE = "https://firestore.$UNIVERSE_DOMAIN$/"
+
         # @return [String]
         #  API key. Your API key identifies your project and provides you with API access,
         #  quota, and reports. Required unless you provide an OAuth 2.0 token.
@@ -44,7 +46,7 @@ module Google
         attr_accessor :quota_user
 
         def initialize
-          super('https://firestore.googleapis.com/', '',
+          super(DEFAULT_ENDPOINT_TEMPLATE, '',
                 client_name: 'google-apis-firestore_v1beta1',
                 client_version: Google::Apis::FirestoreV1beta1::GEM_VERSION)
           @batch_path = 'batch'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-firestore_v1beta1
 version: !ruby/object:Gem::Version
-  version: 0.33.0
+  version: 0.35.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-10 00:00:00.000000000 Z
+date: 2024-01-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.12.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.12.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -58,7 +58,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.33.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-firestore_v1beta1/v0.35.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-firestore_v1beta1
 post_install_message: 
 rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.3
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Cloud Firestore API V1beta1