google-apis-datastore_v1 0.35.0 → 0.37.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 07063e5ba6a5c4331f9d395f89386b19495c68a32d5b74324f9414ee2f284e69
-  data.tar.gz: 2000b971db7bfc246b5d1655ca9387879ecafd5a2e31d626c6fa3a0a948235e6
+  metadata.gz: 3c07043cc9f904f59fb22d7ffcd7aaf45263282db0a248745da43eb9b7c7825b
+  data.tar.gz: cafd8e29e105379561e0e5d30d2871a945e41674a29bcfeb1b8b0d85142a8d86
 SHA512:
-  metadata.gz: 7d81283c6cc78d1f63b8197bab8ea36cad7afb959cd68a2abc6b9ad93dd97c26ec790ec93f39734cc10a1ca632993d8ebe9f24ff0bc070a888e5c88b92b597f4
-  data.tar.gz: d6a8b4e37c8d1ea2fe8a7a4c331c902deb071d2e3bc94d8691390079548442574228f64c91e7a6509f245b29bdcf5f33df49217f5e6bd78357d3cca4c2284012
+  metadata.gz: 7b972004199f31fc1e51e0391083a9a733164d142887db6c6fd628c6c4ada8de475beacbb43876f20d625e3a5838567f464cfa60c8256c8e1ee319003eb1ce9e
+  data.tar.gz: 24889dd35b04a98256154d513277af5bf271dc553f3f70e011a146970b1ad5352e8cb444efd52ddb244680b1783eecb9f91662367d56bb5def175692d74d1a72

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Release history for google-apis-datastore_v1
 
+### v0.37.0 (2024-03-24)
+
+* Regenerated from discovery document revision 20240317
+* Regenerated using generator version 0.14.0
+
+### v0.36.0 (2024-02-23)
+
+* Regenerated from discovery document revision 20240215
+
 ### v0.35.0 (2024-02-18)
 
 * Regenerated from discovery document revision 20240208

data/OVERVIEW.md

@@ -83,9 +83,9 @@ The [product documentation](https://cloud.google.com/datastore/) may provide gui
 
 ## Supported Ruby versions
 
-This library is supported on Ruby 2.5+.
+This library is supported on Ruby 2.7+.
 
-Google provides official support for Ruby versions that are actively supported by Ruby Core -- that is, Ruby versions that are either in normal maintenance or in security maintenance, and not end of life. Currently, this means Ruby 2.5 and later. Older versions of Ruby _may_ still work, but are unsupported and not recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby support schedule.
+Google provides official support for Ruby versions that are actively supported by Ruby Core -- that is, Ruby versions that are either in normal maintenance or in security maintenance, and not end of life. Older versions of Ruby _may_ still work, but are unsupported and not recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby support schedule.
 
 ## License
 

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

@@ -539,6 +539,73 @@ module Google
         end
       end
       
+      # Execution statistics for the query.
+      class ExecutionStats
+        include Google::Apis::Core::Hashable
+      
+        # Debugging statistics from the execution of the query. Note that the debugging
+        # stats are subject to change as Firestore evolves. It could include: ` "
+        # indexes_entries_scanned": "1000", "documents_scanned": "20", "billing_details"
+        # : ` "documents_billable": "20", "index_entries_billable": "1000", "
+        # min_query_cost": "0" ` `
+        # Corresponds to the JSON property `debugStats`
+        # @return [Hash<String,Object>]
+        attr_accessor :debug_stats
+      
+        # Total time to execute the query in the backend.
+        # Corresponds to the JSON property `executionDuration`
+        # @return [String]
+        attr_accessor :execution_duration
+      
+        # Total billable read operations.
+        # Corresponds to the JSON property `readOperations`
+        # @return [Fixnum]
+        attr_accessor :read_operations
+      
+        # Total number of results returned, including documents, projections,
+        # aggregation results, keys.
+        # Corresponds to the JSON property `resultsReturned`
+        # @return [Fixnum]
+        attr_accessor :results_returned
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @debug_stats = args[:debug_stats] if args.key?(:debug_stats)
+          @execution_duration = args[:execution_duration] if args.key?(:execution_duration)
+          @read_operations = args[:read_operations] if args.key?(:read_operations)
+          @results_returned = args[:results_returned] if args.key?(:results_returned)
+        end
+      end
+      
+      # Explain metrics for the query.
+      class ExplainMetrics
+        include Google::Apis::Core::Hashable
+      
+        # Execution statistics for the query.
+        # Corresponds to the JSON property `executionStats`
+        # @return [Google::Apis::DatastoreV1::ExecutionStats]
+        attr_accessor :execution_stats
+      
+        # Planning phase information for the query.
+        # Corresponds to the JSON property `planSummary`
+        # @return [Google::Apis::DatastoreV1::PlanSummary]
+        attr_accessor :plan_summary
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @execution_stats = args[:execution_stats] if args.key?(:execution_stats)
+          @plan_summary = args[:plan_summary] if args.key?(:plan_summary)
+        end
+      end
+      
       # Explain options for the query.
       class ExplainOptions
         include Google::Apis::Core::Hashable
@@ -1675,6 +1742,12 @@ module Google
         # @return [Array<Google::Apis::DatastoreV1::Key>]
         attr_accessor :keys
       
+        # The set of arbitrarily nested property paths used to restrict an operation to
+        # only a subset of properties in an entity.
+        # Corresponds to the JSON property `propertyMask`
+        # @return [Google::Apis::DatastoreV1::PropertyMask]
+        attr_accessor :property_mask
+      
         # The options shared by read requests.
         # Corresponds to the JSON property `readOptions`
         # @return [Google::Apis::DatastoreV1::ReadOptions]
@@ -1688,6 +1761,7 @@ module Google
         def update!(**args)
           @database_id = args[:database_id] if args.key?(:database_id)
           @keys = args[:keys] if args.key?(:keys)
+          @property_mask = args[:property_mask] if args.key?(:property_mask)
           @read_options = args[:read_options] if args.key?(:read_options)
         end
       end
@@ -1765,6 +1839,12 @@ module Google
         # @return [Google::Apis::DatastoreV1::Entity]
         attr_accessor :insert
       
+        # The set of arbitrarily nested property paths used to restrict an operation to
+        # only a subset of properties in an entity.
+        # Corresponds to the JSON property `propertyMask`
+        # @return [Google::Apis::DatastoreV1::PropertyMask]
+        attr_accessor :property_mask
+      
         # A Datastore data object. Must not exceed 1 MiB - 4 bytes.
         # Corresponds to the JSON property `update`
         # @return [Google::Apis::DatastoreV1::Entity]
@@ -1790,6 +1870,7 @@ module Google
           @base_version = args[:base_version] if args.key?(:base_version)
           @delete = args[:delete] if args.key?(:delete)
           @insert = args[:insert] if args.key?(:insert)
+          @property_mask = args[:property_mask] if args.key?(:property_mask)
           @update = args[:update] if args.key?(:update)
           @update_time = args[:update_time] if args.key?(:update_time)
           @upsert = args[:upsert] if args.key?(:upsert)
@@ -1929,6 +2010,27 @@ module Google
         end
       end
       
+      # Planning phase information for the query.
+      class PlanSummary
+        include Google::Apis::Core::Hashable
+      
+        # The indexes selected for the query. For example: [ `"query_scope": "Collection"
+        # , "properties": "(foo ASC, __name__ ASC)"`, `"query_scope": "Collection", "
+        # properties": "(bar ASC, __name__ ASC)"` ]
+        # Corresponds to the JSON property `indexesUsed`
+        # @return [Array<Hash<String,Object>>]
+        attr_accessor :indexes_used
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @indexes_used = args[:indexes_used] if args.key?(:indexes_used)
+        end
+      end
+      
       # A representation of a property in a projection.
       class Projection
         include Google::Apis::Core::Hashable
@@ -1980,6 +2082,31 @@ module Google
         end
       end
       
+      # The set of arbitrarily nested property paths used to restrict an operation to
+      # only a subset of properties in an entity.
+      class PropertyMask
+        include Google::Apis::Core::Hashable
+      
+        # The paths to the properties covered by this mask. A path is a list of property
+        # names separated by dots (`.`), for example `foo.bar` means the property `bar`
+        # inside the entity property `foo` inside the entity associated with this path.
+        # If a property name contains a dot `.` or a backslash `\`, then that name must
+        # be escaped. A path must not be empty, and may not reference a value inside an
+        # array value.
+        # Corresponds to the JSON property `paths`
+        # @return [Array<String>]
+        attr_accessor :paths
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @paths = args[:paths] if args.key?(:paths)
+        end
+      end
+      
       # The desired order for a specific property.
       class PropertyOrder
         include Google::Apis::Core::Hashable
@@ -2415,6 +2542,11 @@ module Google
         # @return [Google::Apis::DatastoreV1::AggregationResultBatch]
         attr_accessor :batch
       
+        # Explain metrics for the query.
+        # Corresponds to the JSON property `explainMetrics`
+        # @return [Google::Apis::DatastoreV1::ExplainMetrics]
+        attr_accessor :explain_metrics
+      
         # Datastore query for running an aggregation over a Query.
         # Corresponds to the JSON property `query`
         # @return [Google::Apis::DatastoreV1::AggregationQuery]
@@ -2435,6 +2567,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @batch = args[:batch] if args.key?(:batch)
+          @explain_metrics = args[:explain_metrics] if args.key?(:explain_metrics)
           @query = args[:query] if args.key?(:query)
           @transaction = args[:transaction] if args.key?(:transaction)
         end
@@ -2474,6 +2607,12 @@ module Google
         # @return [Google::Apis::DatastoreV1::PartitionId]
         attr_accessor :partition_id
       
+        # The set of arbitrarily nested property paths used to restrict an operation to
+        # only a subset of properties in an entity.
+        # Corresponds to the JSON property `propertyMask`
+        # @return [Google::Apis::DatastoreV1::PropertyMask]
+        attr_accessor :property_mask
+      
         # A query for entities.
         # Corresponds to the JSON property `query`
         # @return [Google::Apis::DatastoreV1::Query]
@@ -2494,6 +2633,7 @@ module Google
           @explain_options = args[:explain_options] if args.key?(:explain_options)
           @gql_query = args[:gql_query] if args.key?(:gql_query)
           @partition_id = args[:partition_id] if args.key?(:partition_id)
+          @property_mask = args[:property_mask] if args.key?(:property_mask)
           @query = args[:query] if args.key?(:query)
           @read_options = args[:read_options] if args.key?(:read_options)
         end
@@ -2508,6 +2648,11 @@ module Google
         # @return [Google::Apis::DatastoreV1::QueryResultBatch]
         attr_accessor :batch
       
+        # Explain metrics for the query.
+        # Corresponds to the JSON property `explainMetrics`
+        # @return [Google::Apis::DatastoreV1::ExplainMetrics]
+        attr_accessor :explain_metrics
+      
         # A query for entities.
         # Corresponds to the JSON property `query`
         # @return [Google::Apis::DatastoreV1::Query]
@@ -2528,6 +2673,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @batch = args[:batch] if args.key?(:batch)
+          @explain_metrics = args[:explain_metrics] if args.key?(:explain_metrics)
           @query = args[:query] if args.key?(:query)
           @transaction = args[:transaction] if args.key?(:transaction)
         end

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DatastoreV1
       # Version of the google-apis-datastore_v1 gem
-      GEM_VERSION = "0.35.0"
+      GEM_VERSION = "0.37.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.13.1"
+      GENERATOR_VERSION = "0.14.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240208"
+      REVISION = "20240317"
     end
   end
 end

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

@@ -124,6 +124,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ExecutionStats
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ExplainMetrics
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ExplainOptions
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -352,6 +364,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class PlanSummary
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Projection
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -364,6 +382,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class PropertyMask
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class PropertyOrder
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -635,6 +659,26 @@ module Google
         end
       end
       
+      class ExecutionStats
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :debug_stats, as: 'debugStats'
+          property :execution_duration, as: 'executionDuration'
+          property :read_operations, :numeric_string => true, as: 'readOperations'
+          property :results_returned, :numeric_string => true, as: 'resultsReturned'
+        end
+      end
+      
+      class ExplainMetrics
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :execution_stats, as: 'executionStats', class: Google::Apis::DatastoreV1::ExecutionStats, decorator: Google::Apis::DatastoreV1::ExecutionStats::Representation
+      
+          property :plan_summary, as: 'planSummary', class: Google::Apis::DatastoreV1::PlanSummary, decorator: Google::Apis::DatastoreV1::PlanSummary::Representation
+      
+        end
+      end
+      
       class ExplainOptions
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -954,6 +998,8 @@ module Google
           property :database_id, as: 'databaseId'
           collection :keys, as: 'keys', class: Google::Apis::DatastoreV1::Key, decorator: Google::Apis::DatastoreV1::Key::Representation
       
+          property :property_mask, as: 'propertyMask', class: Google::Apis::DatastoreV1::PropertyMask, decorator: Google::Apis::DatastoreV1::PropertyMask::Representation
+      
           property :read_options, as: 'readOptions', class: Google::Apis::DatastoreV1::ReadOptions, decorator: Google::Apis::DatastoreV1::ReadOptions::Representation
       
         end
@@ -981,6 +1027,8 @@ module Google
       
           property :insert, as: 'insert', class: Google::Apis::DatastoreV1::Entity, decorator: Google::Apis::DatastoreV1::Entity::Representation
       
+          property :property_mask, as: 'propertyMask', class: Google::Apis::DatastoreV1::PropertyMask, decorator: Google::Apis::DatastoreV1::PropertyMask::Representation
+      
           property :update, as: 'update', class: Google::Apis::DatastoreV1::Entity, decorator: Google::Apis::DatastoreV1::Entity::Representation
       
           property :update_time, as: 'updateTime'
@@ -1019,6 +1067,13 @@ module Google
         end
       end
       
+      class PlanSummary
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :indexes_used, as: 'indexesUsed'
+        end
+      end
+      
       class Projection
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1038,6 +1093,13 @@ module Google
         end
       end
       
+      class PropertyMask
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :paths, as: 'paths'
+        end
+      end
+      
       class PropertyOrder
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1165,6 +1227,8 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :batch, as: 'batch', class: Google::Apis::DatastoreV1::AggregationResultBatch, decorator: Google::Apis::DatastoreV1::AggregationResultBatch::Representation
       
+          property :explain_metrics, as: 'explainMetrics', class: Google::Apis::DatastoreV1::ExplainMetrics, decorator: Google::Apis::DatastoreV1::ExplainMetrics::Representation
+      
           property :query, as: 'query', class: Google::Apis::DatastoreV1::AggregationQuery, decorator: Google::Apis::DatastoreV1::AggregationQuery::Representation
       
           property :transaction, :base64 => true, as: 'transaction'
@@ -1181,6 +1245,8 @@ module Google
       
           property :partition_id, as: 'partitionId', class: Google::Apis::DatastoreV1::PartitionId, decorator: Google::Apis::DatastoreV1::PartitionId::Representation
       
+          property :property_mask, as: 'propertyMask', class: Google::Apis::DatastoreV1::PropertyMask, decorator: Google::Apis::DatastoreV1::PropertyMask::Representation
+      
           property :query, as: 'query', class: Google::Apis::DatastoreV1::Query, decorator: Google::Apis::DatastoreV1::Query::Representation
       
           property :read_options, as: 'readOptions', class: Google::Apis::DatastoreV1::ReadOptions, decorator: Google::Apis::DatastoreV1::ReadOptions::Representation
@@ -1193,6 +1259,8 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :batch, as: 'batch', class: Google::Apis::DatastoreV1::QueryResultBatch, decorator: Google::Apis::DatastoreV1::QueryResultBatch::Representation
       
+          property :explain_metrics, as: 'explainMetrics', class: Google::Apis::DatastoreV1::ExplainMetrics, decorator: Google::Apis::DatastoreV1::ExplainMetrics::Representation
+      
           property :query, as: 'query', class: Google::Apis::DatastoreV1::Query, decorator: Google::Apis::DatastoreV1::Query::Representation
       
           property :transaction, :base64 => true, as: 'transaction'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-datastore_v1
 version: !ruby/object:Gem::Version
-  version: 0.35.0
+  version: 0.37.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-02-18 00:00:00.000000000 Z
+date: 2024-03-24 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.12.0
+        version: 0.14.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.12.0
+        version: 0.14.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-datastore_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-datastore_v1/v0.35.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-datastore_v1/v0.37.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-datastore_v1
 post_install_message: 
 rdoc_options: []
@@ -68,14 +68,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.5.6
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Cloud Datastore API V1