google-apis-firestore_v1beta1 0.20.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a965c08f5271e30bdb8848359387af64fcbbfada9598c4d9f333db03a0dd42ac
-  data.tar.gz: b160d815fb1143384a5ab23a4881f69bc17b40b2bdfec6ef013e1515c36d3038
+  metadata.gz: 1954a96f973cfce28e51638052d6a7090b5bdef4a24b90e311e55866daea4013
+  data.tar.gz: df33636af2eeb0bae963286ed9df23095efac3f76f49a3a064b8313f2ca57ab3
 SHA512:
-  metadata.gz: fae237aaf6521534f40a5be6d7102f6e2c506c6efed19a4783bcbe40883b1ed57d4cd62b3964386cf4b7ee3e495a2d3cb391cf8eb060e77b52f78653f4c69769
-  data.tar.gz: 2d5dedebea489c4269e780f5ffb39b14e54bf346b82878f78a30afd44371b3f02e0796bd8cfa6618eafb351238479acd1707deeea5b034fe64290e0bd883f44d
+  metadata.gz: 5f889d8ca25c59e1fea3a16c9bf8d8f7d73bba4dae976e342dadc7a6a04446d52a380f12343d8f9cfc6642e454061a04682b016d9f4411a5d257b8894a102925
+  data.tar.gz: 6cce54f7bf4bec90ba770f257d87fff6932ffcf37d5c5bffbc9cf3a330b3335d396718244b852f34b3374d2d7877c0b5fc1694a57059cc4ba9069aeba64d55b5

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release history for google-apis-firestore_v1beta1
 
+### v0.21.0 (2022-09-22)
+
+* Regenerated from discovery document revision 20220915
+* Regenerated using generator version 0.10.0
+
 ### v0.20.0 (2022-09-10)
 
 * Regenerated from discovery document revision 20220831

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

@@ -22,6 +22,62 @@ module Google
   module Apis
     module FirestoreV1beta1
       
+      # Defines a aggregation that produces a single result.
+      class Aggregation
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Optional name of the field to store the result of the aggregation
+        # into. If not provided, Firestore will pick a default name following the format
+        # `field_`. For example: ``` AGGREGATE COUNT_UP_TO(1) AS count_up_to_1,
+        # COUNT_UP_TO(2), COUNT_UP_TO(3) AS count_up_to_3, COUNT_UP_TO(4) OVER ( ... ); `
+        # `` becomes: ``` AGGREGATE COUNT_UP_TO(1) AS count_up_to_1, COUNT_UP_TO(2) AS
+        # field_1, COUNT_UP_TO(3) AS count_up_to_3, COUNT_UP_TO(4) AS field_2 OVER ( ...
+        # ); ``` Requires: * Must be unique across all aggregation aliases. * Conform to
+        # document field name limitations.
+        # Corresponds to the JSON property `alias`
+        # @return [String]
+        attr_accessor :alias
+      
+        # Count of documents that match the query. The `COUNT(*)` aggregation function
+        # operates on the entire document so it does not require a field reference.
+        # Corresponds to the JSON property `count`
+        # @return [Google::Apis::FirestoreV1beta1::Count]
+        attr_accessor :count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @alias = args[:alias] if args.key?(:alias)
+          @count = args[:count] if args.key?(:count)
+        end
+      end
+      
+      # The result of a single bucket from a Firestore aggregation query. The keys of `
+      # aggregate_fields` are the same for all results in an aggregation query, unlike
+      # document queries which can have different fields present for each result.
+      class AggregationResult
+        include Google::Apis::Core::Hashable
+      
+        # The result of the aggregation functions, ex: `COUNT(*) AS total_docs`. The key
+        # is the alias assigned to the aggregation function on input and the size of
+        # this map equals the number of aggregation functions in the query.
+        # Corresponds to the JSON property `aggregateFields`
+        # @return [Hash<String,Google::Apis::FirestoreV1beta1::Value>]
+        attr_accessor :aggregate_fields
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @aggregate_fields = args[:aggregate_fields] if args.key?(:aggregate_fields)
+        end
+      end
+      
       # An array value.
       class ArrayValue
         include Google::Apis::Core::Hashable
@@ -334,6 +390,30 @@ module Google
         end
       end
       
+      # Count of documents that match the query. The `COUNT(*)` aggregation function
+      # operates on the entire document so it does not require a field reference.
+      class Count
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Optional constraint on the maximum number of documents to count.
+        # This provides a way to set an upper bound on the number of documents to scan,
+        # limiting latency and cost. Unspecified is interpreted as no bound. High-Level
+        # Example: ``` AGGREGATE COUNT_UP_TO(1000) OVER ( SELECT * FROM k ); ```
+        # Requires: * Must be greater than zero when present.
+        # Corresponds to the JSON property `upTo`
+        # @return [Fixnum]
+        attr_accessor :up_to
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @up_to = args[:up_to] if args.key?(:up_to)
+        end
+      end
+      
       # A position in a query result set.
       class Cursor
         include Google::Apis::Core::Hashable
@@ -1700,6 +1780,81 @@ module Google
         end
       end
       
+      # The request for Firestore.RunAggregationQuery.
+      class RunAggregationQueryRequest
+        include Google::Apis::Core::Hashable
+      
+        # Options for creating a new transaction.
+        # Corresponds to the JSON property `newTransaction`
+        # @return [Google::Apis::FirestoreV1beta1::TransactionOptions]
+        attr_accessor :new_transaction
+      
+        # Executes the query at the given timestamp. Requires: * Cannot be more than 270
+        # seconds in the past.
+        # Corresponds to the JSON property `readTime`
+        # @return [String]
+        attr_accessor :read_time
+      
+        # Firestore query for running an aggregation over a StructuredQuery.
+        # Corresponds to the JSON property `structuredAggregationQuery`
+        # @return [Google::Apis::FirestoreV1beta1::StructuredAggregationQuery]
+        attr_accessor :structured_aggregation_query
+      
+        # Run the aggregation within an already active transaction. The value here is
+        # the opaque transaction ID to execute the query in.
+        # Corresponds to the JSON property `transaction`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :transaction
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @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)
+          @transaction = args[:transaction] if args.key?(:transaction)
+        end
+      end
+      
+      # The response for Firestore.RunAggregationQuery.
+      class RunAggregationQueryResponse
+        include Google::Apis::Core::Hashable
+      
+        # The time at which the aggregate value is valid for.
+        # Corresponds to the JSON property `readTime`
+        # @return [String]
+        attr_accessor :read_time
+      
+        # The result of a single bucket from a Firestore aggregation query. The keys of `
+        # aggregate_fields` are the same for all results in an aggregation query, unlike
+        # document queries which can have different fields present for each result.
+        # Corresponds to the JSON property `result`
+        # @return [Google::Apis::FirestoreV1beta1::AggregationResult]
+        attr_accessor :result
+      
+        # 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`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :transaction
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @read_time = args[:read_time] if args.key?(:read_time)
+          @result = args[:result] if args.key?(:result)
+          @transaction = args[:transaction] if args.key?(:transaction)
+        end
+      end
+      
       # The request for Firestore.RunQuery.
       class RunQueryRequest
         include Google::Apis::Core::Hashable
@@ -1832,6 +1987,33 @@ module Google
         end
       end
       
+      # Firestore query for running an aggregation over a StructuredQuery.
+      class StructuredAggregationQuery
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Series of aggregations to apply over the results of the `
+        # structured_query`. Requires: * A minimum of one and maximum of five
+        # aggregations per query.
+        # Corresponds to the JSON property `aggregations`
+        # @return [Array<Google::Apis::FirestoreV1beta1::Aggregation>]
+        attr_accessor :aggregations
+      
+        # A Firestore query.
+        # Corresponds to the JSON property `structuredQuery`
+        # @return [Google::Apis::FirestoreV1beta1::StructuredQuery]
+        attr_accessor :structured_query
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @aggregations = args[:aggregations] if args.key?(:aggregations)
+          @structured_query = args[:structured_query] if args.key?(:structured_query)
+        end
+      end
+      
       # A Firestore query.
       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.20.0"
+      GEM_VERSION = "0.21.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.9.0"
+      GENERATOR_VERSION = "0.10.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20220831"
+      REVISION = "20220915"
     end
   end
 end

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

@@ -22,6 +22,18 @@ module Google
   module Apis
     module FirestoreV1beta1
       
+      class Aggregation
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AggregationResult
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ArrayValue
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -88,6 +100,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Count
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Cursor
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -346,6 +364,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RunAggregationQueryRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class RunAggregationQueryResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class RunQueryRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -364,6 +394,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class StructuredAggregationQuery
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class StructuredQuery
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -424,6 +460,23 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Aggregation
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :alias, as: 'alias'
+          property :count, as: 'count', class: Google::Apis::FirestoreV1beta1::Count, decorator: Google::Apis::FirestoreV1beta1::Count::Representation
+      
+        end
+      end
+      
+      class AggregationResult
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :aggregate_fields, as: 'aggregateFields', class: Google::Apis::FirestoreV1beta1::Value, decorator: Google::Apis::FirestoreV1beta1::Value::Representation
+      
+        end
+      end
+      
       class ArrayValue
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -525,6 +578,13 @@ module Google
         end
       end
       
+      class Count
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :up_to, :numeric_string => true, as: 'upTo'
+        end
+      end
+      
       class Cursor
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -928,6 +988,28 @@ module Google
         end
       end
       
+      class RunAggregationQueryRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :new_transaction, as: 'newTransaction', class: Google::Apis::FirestoreV1beta1::TransactionOptions, decorator: Google::Apis::FirestoreV1beta1::TransactionOptions::Representation
+      
+          property :read_time, as: 'readTime'
+          property :structured_aggregation_query, as: 'structuredAggregationQuery', class: Google::Apis::FirestoreV1beta1::StructuredAggregationQuery, decorator: Google::Apis::FirestoreV1beta1::StructuredAggregationQuery::Representation
+      
+          property :transaction, :base64 => true, as: 'transaction'
+        end
+      end
+      
+      class RunAggregationQueryResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :read_time, as: 'readTime'
+          property :result, as: 'result', class: Google::Apis::FirestoreV1beta1::AggregationResult, decorator: Google::Apis::FirestoreV1beta1::AggregationResult::Representation
+      
+          property :transaction, :base64 => true, as: 'transaction'
+        end
+      end
+      
       class RunQueryRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -961,6 +1043,16 @@ module Google
         end
       end
       
+      class StructuredAggregationQuery
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :aggregations, as: 'aggregations', class: Google::Apis::FirestoreV1beta1::Aggregation, decorator: Google::Apis::FirestoreV1beta1::Aggregation::Representation
+      
+          property :structured_query, as: 'structuredQuery', class: Google::Apis::FirestoreV1beta1::StructuredQuery, decorator: Google::Apis::FirestoreV1beta1::StructuredQuery::Representation
+      
+        end
+      end
+      
       class StructuredQuery
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -717,6 +717,47 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Runs an aggregation query. Rather than producing Document results like
+        # Firestore.RunQuery, this API allows running an aggregation to produce a series
+        # of AggregationResult server-side. High-Level Example: ``` -- Return the number
+        # of documents in table given a filter. SELECT COUNT(*) FROM ( SELECT * FROM k
+        # where a = true ); ```
+        # @param [String] parent
+        #   Required. The parent resource name. In the format: `projects/`project_id`/
+        #   databases/`database_id`/documents` or `projects/`project_id`/databases/`
+        #   database_id`/documents/`document_path``. For example: `projects/my-project/
+        #   databases/my-database/documents` or `projects/my-project/databases/my-database/
+        #   documents/chatrooms/my-chatroom`
+        # @param [Google::Apis::FirestoreV1beta1::RunAggregationQueryRequest] run_aggregation_query_request_object
+        # @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::FirestoreV1beta1::RunAggregationQueryResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirestoreV1beta1::RunAggregationQueryResponse]
+        #
+        # @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 run_document_aggregation_query(parent, run_aggregation_query_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta1/{+parent}:runAggregationQuery', options)
+          command.request_representation = Google::Apis::FirestoreV1beta1::RunAggregationQueryRequest::Representation
+          command.request_object = run_aggregation_query_request_object
+          command.response_representation = Google::Apis::FirestoreV1beta1::RunAggregationQueryResponse::Representation
+          command.response_class = Google::Apis::FirestoreV1beta1::RunAggregationQueryResponse
+          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
+        
         # Runs a query.
         # @param [String] parent
         #   Required. The parent resource name. In the format: `projects/`project_id`/

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-firestore_v1beta1
 version: !ruby/object:Gem::Version
-  version: 0.20.0
+  version: 0.21.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-09-12 00:00:00.000000000 Z
+date: 2022-09-26 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.7'
+        version: 0.9.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: 0.9.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.20.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-firestore_v1beta1/v0.21.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-firestore_v1beta1
 post_install_message: 
 rdoc_options: []