google-apis-datastore_v1beta3 0.18.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cbbdc4e0f9445bf1c3e50b2a7ea2fd6bdbabaff68ca58979d9848745f790c27e
-  data.tar.gz: a635d44bdc5b67b04dd1c20f45bc16bc2352e6eef388be885ae280da8db73332
+  metadata.gz: 465d6cbf6ad4ba2c986b5061f97c991fcb70f5446a57dfd470d5bb6d0e6a7383
+  data.tar.gz: ca162872975b428ff2117d276ba732b19fe3bf33868c92f3400ef3cab7a17edf
 SHA512:
-  metadata.gz: 97d115039ea6c905a88d2b6b5604a8a2a04edad11774d30f9dec3730ac2060d6693de65a6d3caab817ae365542554ed094451f4db6577865c533b664745374c3
-  data.tar.gz: 1a5d4fd7bc296a899ad10e034b03b32b449f785d270e82dfef6ecb1ac6e60384fa6081f37c83568cf958ad9907ee6146af5290ec768eee453c52ad28312fb662
+  metadata.gz: ee3a4489f964e9458285f0427d62baadb901181414fed19d30f55c051783a2cc45aee70f861dbf13d13b607bd36f7c499dc65a6f53063149e9a9672b9e133412
+  data.tar.gz: 0be09401590209d6be3bbc67a85c8addc44bd98aa91a7494f129a2275dd936057b60adb38405c4900c970659a708a9446c798ec1257b294a1909de4749428ae2

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release history for google-apis-datastore_v1beta3
 
+### v0.19.0 (2022-10-27)
+
+* Regenerated from discovery document revision 20221018
+* Regenerated using generator version 0.11.0
+
 ### v0.18.0 (2022-09-22)
 
 * Regenerated using generator version 0.10.0

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

@@ -22,6 +22,124 @@ module Google
   module Apis
     module DatastoreV1beta3
       
+      # Defines a aggregation that produces a single result.
+      class Aggregation
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Optional name of the property to store the result of the aggregation.
+        # If not provided, Datastore will pick a default name following the format `
+        # property_`. 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
+        # property_1, COUNT_UP_TO(3) AS count_up_to_3, COUNT_UP_TO(4) AS property_2 OVER
+        # ( ... ); ``` Requires: * Must be unique across all aggregation aliases. *
+        # Conform to entity property name limitations.
+        # Corresponds to the JSON property `alias`
+        # @return [String]
+        attr_accessor :alias
+      
+        # Count of entities that match the query. The `COUNT(*)` aggregation function
+        # operates on the entire entity so it does not require a field reference.
+        # Corresponds to the JSON property `count`
+        # @return [Google::Apis::DatastoreV1beta3::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
+      
+      # Datastore query for running an aggregation over a Query.
+      class AggregationQuery
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Series of aggregations to apply over the results of the `
+        # nested_query`. Requires: * A minimum of one and maximum of five aggregations
+        # per query.
+        # Corresponds to the JSON property `aggregations`
+        # @return [Array<Google::Apis::DatastoreV1beta3::Aggregation>]
+        attr_accessor :aggregations
+      
+        # A query for entities.
+        # Corresponds to the JSON property `nestedQuery`
+        # @return [Google::Apis::DatastoreV1beta3::Query]
+        attr_accessor :nested_query
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @aggregations = args[:aggregations] if args.key?(:aggregations)
+          @nested_query = args[:nested_query] if args.key?(:nested_query)
+        end
+      end
+      
+      # The result of a single bucket from a Datastore aggregation query. The keys of `
+      # aggregate_properties` are the same for all results in an aggregation query,
+      # unlike entity 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_entities`. 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 `aggregateProperties`
+        # @return [Hash<String,Google::Apis::DatastoreV1beta3::Value>]
+        attr_accessor :aggregate_properties
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @aggregate_properties = args[:aggregate_properties] if args.key?(:aggregate_properties)
+        end
+      end
+      
+      # A batch of aggregation results produced by an aggregation query.
+      class AggregationResultBatch
+        include Google::Apis::Core::Hashable
+      
+        # The aggregation results for this batch.
+        # Corresponds to the JSON property `aggregationResults`
+        # @return [Array<Google::Apis::DatastoreV1beta3::AggregationResult>]
+        attr_accessor :aggregation_results
+      
+        # The state of the query after the current batch. Only COUNT(*) aggregations are
+        # supported in the initial launch. Therefore, expected result type is limited to
+        # `NO_MORE_RESULTS`.
+        # Corresponds to the JSON property `moreResults`
+        # @return [String]
+        attr_accessor :more_results
+      
+        # Read timestamp this batch was returned from. In a single transaction,
+        # subsequent query result batches for the same query can have a greater
+        # timestamp. Each batch's read timestamp is valid for all preceding batches.
+        # Corresponds to the JSON property `readTime`
+        # @return [String]
+        attr_accessor :read_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @aggregation_results = args[:aggregation_results] if args.key?(:aggregation_results)
+          @more_results = args[:more_results] if args.key?(:more_results)
+          @read_time = args[:read_time] if args.key?(:read_time)
+        end
+      end
+      
       # The request for Datastore.AllocateIds.
       class AllocateIdsRequest
         include Google::Apis::Core::Hashable
@@ -219,6 +337,31 @@ module Google
         end
       end
       
+      # Count of entities that match the query. The `COUNT(*)` aggregation function
+      # operates on the entire entity so it does not require a field reference.
+      class Count
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Optional constraint on the maximum number of entities to count. This
+        # provides a way to set an upper bound on the number of entities to scan,
+        # limiting latency and cost. Unspecified is interpreted as no bound. If a zero
+        # value is provided, a count result of zero should always be expected. High-
+        # Level Example: ``` AGGREGATE COUNT_UP_TO(1000) OVER ( SELECT * FROM k ); ```
+        # Requires: * Must be non-negative 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 Datastore data object. An entity is limited to 1 megabyte when stored. That
       # _roughly_ corresponds to a limit of 1 megabyte for the serialized form of this
       # message.
@@ -1755,6 +1898,77 @@ module Google
         end
       end
       
+      # The request for Datastore.RunAggregationQuery.
+      class RunAggregationQueryRequest
+        include Google::Apis::Core::Hashable
+      
+        # Datastore query for running an aggregation over a Query.
+        # Corresponds to the JSON property `aggregationQuery`
+        # @return [Google::Apis::DatastoreV1beta3::AggregationQuery]
+        attr_accessor :aggregation_query
+      
+        # A [GQL query](https://cloud.google.com/datastore/docs/apis/gql/gql_reference).
+        # Corresponds to the JSON property `gqlQuery`
+        # @return [Google::Apis::DatastoreV1beta3::GqlQuery]
+        attr_accessor :gql_query
+      
+        # A partition ID identifies a grouping of entities. The grouping is always by
+        # project and namespace, however the namespace ID may be empty. A partition ID
+        # contains several dimensions: project ID and namespace ID. Partition dimensions:
+        # - May be `""`. - Must be valid UTF-8 bytes. - Must have values that match
+        # regex `[A-Za-z\d\.\-_]`1,100`` If the value of any dimension matches regex `__.
+        # *__`, the partition is reserved/read-only. A reserved/read-only partition ID
+        # is forbidden in certain documented contexts. Foreign partition IDs (in which
+        # the project ID does not match the context project ID ) are discouraged. Reads
+        # and writes of foreign partition IDs may fail if the project is not in an
+        # active state.
+        # Corresponds to the JSON property `partitionId`
+        # @return [Google::Apis::DatastoreV1beta3::PartitionId]
+        attr_accessor :partition_id
+      
+        # The options shared by read requests.
+        # Corresponds to the JSON property `readOptions`
+        # @return [Google::Apis::DatastoreV1beta3::ReadOptions]
+        attr_accessor :read_options
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @aggregation_query = args[:aggregation_query] if args.key?(:aggregation_query)
+          @gql_query = args[:gql_query] if args.key?(:gql_query)
+          @partition_id = args[:partition_id] if args.key?(:partition_id)
+          @read_options = args[:read_options] if args.key?(:read_options)
+        end
+      end
+      
+      # The response for Datastore.RunAggregationQuery.
+      class RunAggregationQueryResponse
+        include Google::Apis::Core::Hashable
+      
+        # A batch of aggregation results produced by an aggregation query.
+        # Corresponds to the JSON property `batch`
+        # @return [Google::Apis::DatastoreV1beta3::AggregationResultBatch]
+        attr_accessor :batch
+      
+        # Datastore query for running an aggregation over a Query.
+        # Corresponds to the JSON property `query`
+        # @return [Google::Apis::DatastoreV1beta3::AggregationQuery]
+        attr_accessor :query
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @batch = args[:batch] if args.key?(:batch)
+          @query = args[:query] if args.key?(:query)
+        end
+      end
+      
       # The request for Datastore.RunQuery.
       class RunQueryRequest
         include Google::Apis::Core::Hashable

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DatastoreV1beta3
       # Version of the google-apis-datastore_v1beta3 gem
-      GEM_VERSION = "0.18.0"
+      GEM_VERSION = "0.19.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.10.0"
+      GENERATOR_VERSION = "0.11.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20220808"
+      REVISION = "20221018"
     end
   end
 end

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

@@ -22,6 +22,30 @@ module Google
   module Apis
     module DatastoreV1beta3
       
+      class Aggregation
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AggregationQuery
+        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 AggregationResultBatch
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AllocateIdsRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -70,6 +94,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 Entity
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -340,6 +370,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 +406,43 @@ 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::DatastoreV1beta3::Count, decorator: Google::Apis::DatastoreV1beta3::Count::Representation
+      
+        end
+      end
+      
+      class AggregationQuery
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :aggregations, as: 'aggregations', class: Google::Apis::DatastoreV1beta3::Aggregation, decorator: Google::Apis::DatastoreV1beta3::Aggregation::Representation
+      
+          property :nested_query, as: 'nestedQuery', class: Google::Apis::DatastoreV1beta3::Query, decorator: Google::Apis::DatastoreV1beta3::Query::Representation
+      
+        end
+      end
+      
+      class AggregationResult
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :aggregate_properties, as: 'aggregateProperties', class: Google::Apis::DatastoreV1beta3::Value, decorator: Google::Apis::DatastoreV1beta3::Value::Representation
+      
+        end
+      end
+      
+      class AggregationResultBatch
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :aggregation_results, as: 'aggregationResults', class: Google::Apis::DatastoreV1beta3::AggregationResult, decorator: Google::Apis::DatastoreV1beta3::AggregationResult::Representation
+      
+          property :more_results, as: 'moreResults'
+          property :read_time, as: 'readTime'
+        end
+      end
+      
       class AllocateIdsRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -432,6 +511,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 Entity
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -876,6 +962,30 @@ module Google
         end
       end
       
+      class RunAggregationQueryRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :aggregation_query, as: 'aggregationQuery', class: Google::Apis::DatastoreV1beta3::AggregationQuery, decorator: Google::Apis::DatastoreV1beta3::AggregationQuery::Representation
+      
+          property :gql_query, as: 'gqlQuery', class: Google::Apis::DatastoreV1beta3::GqlQuery, decorator: Google::Apis::DatastoreV1beta3::GqlQuery::Representation
+      
+          property :partition_id, as: 'partitionId', class: Google::Apis::DatastoreV1beta3::PartitionId, decorator: Google::Apis::DatastoreV1beta3::PartitionId::Representation
+      
+          property :read_options, as: 'readOptions', class: Google::Apis::DatastoreV1beta3::ReadOptions, decorator: Google::Apis::DatastoreV1beta3::ReadOptions::Representation
+      
+        end
+      end
+      
+      class RunAggregationQueryResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :batch, as: 'batch', class: Google::Apis::DatastoreV1beta3::AggregationResultBatch, decorator: Google::Apis::DatastoreV1beta3::AggregationResultBatch::Representation
+      
+          property :query, as: 'query', class: Google::Apis::DatastoreV1beta3::AggregationQuery, decorator: Google::Apis::DatastoreV1beta3::AggregationQuery::Representation
+      
+        end
+      end
+      
       class RunQueryRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -250,6 +250,39 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Runs an aggregation query.
+        # @param [String] project_id
+        #   Required. The ID of the project against which to make the request.
+        # @param [Google::Apis::DatastoreV1beta3::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::DatastoreV1beta3::RunAggregationQueryResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DatastoreV1beta3::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_project_aggregation_query(project_id, run_aggregation_query_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta3/projects/{projectId}:runAggregationQuery', options)
+          command.request_representation = Google::Apis::DatastoreV1beta3::RunAggregationQueryRequest::Representation
+          command.request_object = run_aggregation_query_request_object
+          command.response_representation = Google::Apis::DatastoreV1beta3::RunAggregationQueryResponse::Representation
+          command.response_class = Google::Apis::DatastoreV1beta3::RunAggregationQueryResponse
+          command.params['projectId'] = project_id unless project_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
+        
         # Queries for entities.
         # @param [String] project_id
         #   Required. The ID of the project against which to make the request.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-datastore_v1beta3
 version: !ruby/object:Gem::Version
-  version: 0.18.0
+  version: 0.19.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-09-26 00:00:00.000000000 Z
+date: 2022-10-31 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.9.0
+        version: 0.9.1
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.0
+        version: 0.9.1
     - - "<"
       - !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-datastore_v1beta3/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-datastore_v1beta3/v0.18.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-datastore_v1beta3/v0.19.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-datastore_v1beta3
 post_install_message: 
 rdoc_options: []