google-cloud-datastore-v1 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bce4adc08222050a5cd91ebe7fb5682dc14923137451cfee856feab22847a84a
-  data.tar.gz: 14943719fad88e1d8ced850cd73f4b00a152082f50f1c8d4bc27312c9a62482f
+  metadata.gz: 40547a8a273560ebb8959396340c4d8d1fa1aefc09d754c4aef44a39c53ae048
+  data.tar.gz: 12a520f6ff7e6778b1e0e55c1c32aae8d05fcae861c6d945d9c173de8ac31a6e
 SHA512:
-  metadata.gz: 0c54259e5a7eafc81e52c8f72f0a5aca0060f68937b5ed618ba5b71bb2e2f057d2f0b83ee3be4a0a21f0aa094719524a78c1c05d358190b401dff9937c997719
-  data.tar.gz: eb4168dc576d1beb42637ec9e61452974d3c1650a089674c922c78b45cf46cab2f8743c6c71c6aeb4d35adfb0eaad07b0005e4e1fa426be26a5ecb5bb7b422c2
+  metadata.gz: 4689deec549b20ba89de52c5eeee5e29b8643ad3097bd0f893c3aa818a7449e3f3c4d4b75d2be09bc6d0f846896329edf03d731b0097e999de92efe4f4b8b03c
+  data.tar.gz: '0389d04daf27d7ca7eac240e6027f9885d5f9df81f409c521ccd63052369bbd2f14f5416680fa0ad669eb226670a0d7e8c849be0c52b1046f92037f802094f09'

data/README.md

@@ -86,7 +86,7 @@ To browse ready to use code samples check [Google Cloud Samples](https://cloud.g
 
 ## Supported Ruby Versions
 
-This library is supported on Ruby 2.7+.
+This library is supported on Ruby 3.0+.
 
 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

data/lib/google/cloud/datastore/v1/datastore/client.rb

@@ -352,8 +352,12 @@ module Google
             #     The options for this query.
             #   @param query [::Google::Cloud::Datastore::V1::Query, ::Hash]
             #     The query to run.
+            #
+            #     Note: The following fields are mutually exclusive: `query`, `gql_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             #   @param gql_query [::Google::Cloud::Datastore::V1::GqlQuery, ::Hash]
             #     The GQL query to run. This query must be a non-aggregation query.
+            #
+            #     Note: The following fields are mutually exclusive: `gql_query`, `query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             #   @param property_mask [::Google::Cloud::Datastore::V1::PropertyMask, ::Hash]
             #     The properties to return.
             #     This field must not be set for a projection query.
@@ -465,8 +469,12 @@ module Google
             #     The options for this query.
             #   @param aggregation_query [::Google::Cloud::Datastore::V1::AggregationQuery, ::Hash]
             #     The query to run.
+            #
+            #     Note: The following fields are mutually exclusive: `aggregation_query`, `gql_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             #   @param gql_query [::Google::Cloud::Datastore::V1::GqlQuery, ::Hash]
             #     The GQL query to run. This query must be an aggregation query.
+            #
+            #     Note: The following fields are mutually exclusive: `gql_query`, `aggregation_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             #   @param explain_options [::Google::Cloud::Datastore::V1::ExplainOptions, ::Hash]
             #     Optional. Explain options for the query. If set, additional query
             #     statistics will be returned. If not, only query results will be returned.
@@ -665,11 +673,15 @@ module Google
             #     The identifier of the transaction associated with the commit. A
             #     transaction identifier is returned by a call to
             #     {::Google::Cloud::Datastore::V1::Datastore::Client#begin_transaction Datastore.BeginTransaction}.
+            #
+            #     Note: The following fields are mutually exclusive: `transaction`, `single_use_transaction`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             #   @param single_use_transaction [::Google::Cloud::Datastore::V1::TransactionOptions, ::Hash]
             #     Options for beginning a new transaction for this request.
             #     The transaction is committed when the request completes. If specified,
             #     {::Google::Cloud::Datastore::V1::TransactionOptions TransactionOptions.mode} must be
             #     {::Google::Cloud::Datastore::V1::TransactionOptions::ReadWrite TransactionOptions.ReadWrite}.
+            #
+            #     Note: The following fields are mutually exclusive: `single_use_transaction`, `transaction`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             #   @param mutations [::Array<::Google::Cloud::Datastore::V1::Mutation, ::Hash>]
             #     The mutations to perform.
             #
@@ -1086,6 +1098,13 @@ module Google
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials
+            #
+            #   Warning: If you accept a credential configuration (JSON file or Hash) from an
+            #   external source for authentication to Google Cloud, you must validate it before
+            #   providing it to a Google API client library. Providing an unvalidated credential
+            #   configuration to Google APIs can compromise the security of your systems and data.
+            #   For more information, refer to [Validate credential configurations from external
+            #   sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
             #   @return [::Object]
             # @!attribute [rw] scope
             #   The OAuth scopes

data/lib/google/cloud/datastore/v1/datastore/rest/client.rb

@@ -335,8 +335,12 @@ module Google
               #     The options for this query.
               #   @param query [::Google::Cloud::Datastore::V1::Query, ::Hash]
               #     The query to run.
+              #
+              #     Note: The following fields are mutually exclusive: `query`, `gql_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
               #   @param gql_query [::Google::Cloud::Datastore::V1::GqlQuery, ::Hash]
               #     The GQL query to run. This query must be a non-aggregation query.
+              #
+              #     Note: The following fields are mutually exclusive: `gql_query`, `query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
               #   @param property_mask [::Google::Cloud::Datastore::V1::PropertyMask, ::Hash]
               #     The properties to return.
               #     This field must not be set for a projection query.
@@ -438,8 +442,12 @@ module Google
               #     The options for this query.
               #   @param aggregation_query [::Google::Cloud::Datastore::V1::AggregationQuery, ::Hash]
               #     The query to run.
+              #
+              #     Note: The following fields are mutually exclusive: `aggregation_query`, `gql_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
               #   @param gql_query [::Google::Cloud::Datastore::V1::GqlQuery, ::Hash]
               #     The GQL query to run. This query must be an aggregation query.
+              #
+              #     Note: The following fields are mutually exclusive: `gql_query`, `aggregation_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
               #   @param explain_options [::Google::Cloud::Datastore::V1::ExplainOptions, ::Hash]
               #     Optional. Explain options for the query. If set, additional query
               #     statistics will be returned. If not, only query results will be returned.
@@ -618,11 +626,15 @@ module Google
               #     The identifier of the transaction associated with the commit. A
               #     transaction identifier is returned by a call to
               #     {::Google::Cloud::Datastore::V1::Datastore::Rest::Client#begin_transaction Datastore.BeginTransaction}.
+              #
+              #     Note: The following fields are mutually exclusive: `transaction`, `single_use_transaction`. If a field in that set is populated, all other fields in the set will automatically be cleared.
               #   @param single_use_transaction [::Google::Cloud::Datastore::V1::TransactionOptions, ::Hash]
               #     Options for beginning a new transaction for this request.
               #     The transaction is committed when the request completes. If specified,
               #     {::Google::Cloud::Datastore::V1::TransactionOptions TransactionOptions.mode} must be
               #     {::Google::Cloud::Datastore::V1::TransactionOptions::ReadWrite TransactionOptions.ReadWrite}.
+              #
+              #     Note: The following fields are mutually exclusive: `single_use_transaction`, `transaction`. If a field in that set is populated, all other fields in the set will automatically be cleared.
               #   @param mutations [::Array<::Google::Cloud::Datastore::V1::Mutation, ::Hash>]
               #     The mutations to perform.
               #
@@ -997,6 +1009,13 @@ module Google
               #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
               #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
               #    *  (`nil`) indicating no credentials
+              #
+              #   Warning: If you accept a credential configuration (JSON file or Hash) from an
+              #   external source for authentication to Google Cloud, you must validate it before
+              #   providing it to a Google API client library. Providing an unvalidated credential
+              #   configuration to Google APIs can compromise the security of your systems and data.
+              #   For more information, refer to [Validate credential configurations from external
+              #   sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
               #   @return [::Object]
               # @!attribute [rw] scope
               #   The OAuth scopes

data/lib/google/cloud/datastore/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Datastore
       module V1
-        VERSION = "1.2.0"
+        VERSION = "1.3.0"
       end
     end
   end

data/proto_docs/google/datastore/v1/datastore.rb

@@ -105,9 +105,13 @@ module Google
         # @!attribute [rw] query
         #   @return [::Google::Cloud::Datastore::V1::Query]
         #     The query to run.
+        #
+        #     Note: The following fields are mutually exclusive: `query`, `gql_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] gql_query
         #   @return [::Google::Cloud::Datastore::V1::GqlQuery]
         #     The GQL query to run. This query must be a non-aggregation query.
+        #
+        #     Note: The following fields are mutually exclusive: `gql_query`, `query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] property_mask
         #   @return [::Google::Cloud::Datastore::V1::PropertyMask]
         #     The properties to return.
@@ -174,9 +178,13 @@ module Google
         # @!attribute [rw] aggregation_query
         #   @return [::Google::Cloud::Datastore::V1::AggregationQuery]
         #     The query to run.
+        #
+        #     Note: The following fields are mutually exclusive: `aggregation_query`, `gql_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] gql_query
         #   @return [::Google::Cloud::Datastore::V1::GqlQuery]
         #     The GQL query to run. This query must be an aggregation query.
+        #
+        #     Note: The following fields are mutually exclusive: `gql_query`, `aggregation_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] explain_options
         #   @return [::Google::Cloud::Datastore::V1::ExplainOptions]
         #     Optional. Explain options for the query. If set, additional query
@@ -287,12 +295,16 @@ module Google
         #     The identifier of the transaction associated with the commit. A
         #     transaction identifier is returned by a call to
         #     {::Google::Cloud::Datastore::V1::Datastore::Client#begin_transaction Datastore.BeginTransaction}.
+        #
+        #     Note: The following fields are mutually exclusive: `transaction`, `single_use_transaction`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] single_use_transaction
         #   @return [::Google::Cloud::Datastore::V1::TransactionOptions]
         #     Options for beginning a new transaction for this request.
         #     The transaction is committed when the request completes. If specified,
         #     {::Google::Cloud::Datastore::V1::TransactionOptions TransactionOptions.mode} must be
         #     {::Google::Cloud::Datastore::V1::TransactionOptions::ReadWrite TransactionOptions.ReadWrite}.
+        #
+        #     Note: The following fields are mutually exclusive: `single_use_transaction`, `transaction`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] mutations
         #   @return [::Array<::Google::Cloud::Datastore::V1::Mutation>]
         #     The mutations to perform.
@@ -407,28 +419,40 @@ module Google
         #   @return [::Google::Cloud::Datastore::V1::Entity]
         #     The entity to insert. The entity must not already exist.
         #     The entity key's final path element may be incomplete.
+        #
+        #     Note: The following fields are mutually exclusive: `insert`, `update`, `upsert`, `delete`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] update
         #   @return [::Google::Cloud::Datastore::V1::Entity]
         #     The entity to update. The entity must already exist.
         #     Must have a complete key path.
+        #
+        #     Note: The following fields are mutually exclusive: `update`, `insert`, `upsert`, `delete`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] upsert
         #   @return [::Google::Cloud::Datastore::V1::Entity]
         #     The entity to upsert. The entity may or may not already exist.
         #     The entity key's final path element may be incomplete.
+        #
+        #     Note: The following fields are mutually exclusive: `upsert`, `insert`, `update`, `delete`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] delete
         #   @return [::Google::Cloud::Datastore::V1::Key]
         #     The key of the entity to delete. The entity may or may not already exist.
         #     Must have a complete key path and must not be reserved/read-only.
+        #
+        #     Note: The following fields are mutually exclusive: `delete`, `insert`, `update`, `upsert`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] base_version
         #   @return [::Integer]
         #     The version of the entity that this mutation is being applied
         #     to. If this does not match the current version on the server, the
         #     mutation conflicts.
+        #
+        #     Note: The following fields are mutually exclusive: `base_version`, `update_time`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] update_time
         #   @return [::Google::Protobuf::Timestamp]
         #     The update time of the entity that this mutation is being applied
         #     to. If this does not match the current update time on the server, the
         #     mutation conflicts.
+        #
+        #     Note: The following fields are mutually exclusive: `update_time`, `base_version`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] conflict_resolution_strategy
         #   @return [::Google::Cloud::Datastore::V1::Mutation::ConflictResolutionStrategy]
         #     The strategy to use when a conflict is detected. Defaults to
@@ -482,6 +506,8 @@ module Google
         # @!attribute [rw] set_to_server_value
         #   @return [::Google::Cloud::Datastore::V1::PropertyTransform::ServerValue]
         #     Sets the property to the given server value.
+        #
+        #     Note: The following fields are mutually exclusive: `set_to_server_value`, `increment`, `maximum`, `minimum`, `append_missing_elements`, `remove_all_from_array`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] increment
         #   @return [::Google::Cloud::Datastore::V1::Value]
         #     Adds the given value to the property's current value.
@@ -494,6 +520,8 @@ module Google
         #     representation of double values follows IEEE 754 semantics.
         #     If there is positive/negative integer overflow, the property is resolved
         #     to the largest magnitude positive/negative integer.
+        #
+        #     Note: The following fields are mutually exclusive: `increment`, `set_to_server_value`, `maximum`, `minimum`, `append_missing_elements`, `remove_all_from_array`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] maximum
         #   @return [::Google::Cloud::Datastore::V1::Value]
         #     Sets the property to the maximum of its current value and the given
@@ -509,6 +537,8 @@ module Google
         #     0, 0.0, and -0.0 are all zero. The maximum of a zero stored value and
         #     zero input value is always the stored value.
         #     The maximum of any numeric value x and NaN is NaN.
+        #
+        #     Note: The following fields are mutually exclusive: `maximum`, `set_to_server_value`, `increment`, `minimum`, `append_missing_elements`, `remove_all_from_array`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] minimum
         #   @return [::Google::Cloud::Datastore::V1::Value]
         #     Sets the property to the minimum of its current value and the given
@@ -524,6 +554,8 @@ module Google
         #     and -0.0 are all zero. The minimum of a zero stored value and zero input
         #     value is always the stored value. The minimum of any numeric value x and
         #     NaN is NaN.
+        #
+        #     Note: The following fields are mutually exclusive: `minimum`, `set_to_server_value`, `increment`, `maximum`, `append_missing_elements`, `remove_all_from_array`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] append_missing_elements
         #   @return [::Google::Cloud::Datastore::V1::ArrayValue]
         #     Appends the given elements in order if they are not already present in
@@ -538,6 +570,8 @@ module Google
         #     be considered.
         #
         #     The corresponding transform result will be the null value.
+        #
+        #     Note: The following fields are mutually exclusive: `append_missing_elements`, `set_to_server_value`, `increment`, `maximum`, `minimum`, `remove_all_from_array`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] remove_all_from_array
         #   @return [::Google::Cloud::Datastore::V1::ArrayValue]
         #     Removes all of the given elements from the array in the property.
@@ -550,6 +584,8 @@ module Google
         #     This will remove all equivalent values if there are duplicates.
         #
         #     The corresponding transform result will be the null value.
+        #
+        #     Note: The following fields are mutually exclusive: `remove_all_from_array`, `set_to_server_value`, `increment`, `maximum`, `minimum`, `append_missing_elements`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class PropertyTransform
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -625,11 +661,15 @@ module Google
         # @!attribute [rw] read_consistency
         #   @return [::Google::Cloud::Datastore::V1::ReadOptions::ReadConsistency]
         #     The non-transactional read consistency to use.
+        #
+        #     Note: The following fields are mutually exclusive: `read_consistency`, `transaction`, `new_transaction`, `read_time`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] transaction
         #   @return [::String]
         #     The identifier of the transaction in which to read. A
         #     transaction identifier is returned by a call to
         #     {::Google::Cloud::Datastore::V1::Datastore::Client#begin_transaction Datastore.BeginTransaction}.
+        #
+        #     Note: The following fields are mutually exclusive: `transaction`, `read_consistency`, `new_transaction`, `read_time`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] new_transaction
         #   @return [::Google::Cloud::Datastore::V1::TransactionOptions]
         #     Options for beginning a new transaction for this request.
@@ -639,6 +679,8 @@ module Google
         #     {::Google::Cloud::Datastore::V1::LookupResponse#transaction LookupResponse.transaction}
         #     or
         #     {::Google::Cloud::Datastore::V1::RunQueryResponse#transaction RunQueryResponse.transaction}.
+        #
+        #     Note: The following fields are mutually exclusive: `new_transaction`, `read_consistency`, `transaction`, `read_time`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] read_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Reads entities as they were at the given time. This value is only
@@ -647,6 +689,8 @@ module Google
         #     This must be a 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.
+        #
+        #     Note: The following fields are mutually exclusive: `read_time`, `read_consistency`, `transaction`, `new_transaction`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class ReadOptions
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -674,9 +718,13 @@ module Google
         # @!attribute [rw] read_write
         #   @return [::Google::Cloud::Datastore::V1::TransactionOptions::ReadWrite]
         #     The transaction should allow both reads and writes.
+        #
+        #     Note: The following fields are mutually exclusive: `read_write`, `read_only`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] read_only
         #   @return [::Google::Cloud::Datastore::V1::TransactionOptions::ReadOnly]
         #     The transaction should only allow reads.
+        #
+        #     Note: The following fields are mutually exclusive: `read_only`, `read_write`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class TransactionOptions
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/datastore/v1/entity.rb

@@ -108,6 +108,8 @@ module Google
           #
           #     Never equal to zero. Values less than zero are discouraged and may not
           #     be supported in the future.
+          #
+          #     Note: The following fields are mutually exclusive: `id`, `name`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] name
           #   @return [::String]
           #     The name of the entity.
@@ -119,6 +121,8 @@ module Google
           #     Must be valid UTF-8 bytes. Legacy values that are not valid UTF-8 are
           #     encoded as `__bytes<X>__` where `<X>` is the base-64 encoding of the
           #     bytes.
+          #
+          #     Note: The following fields are mutually exclusive: `name`, `id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class PathElement
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -141,37 +145,55 @@ module Google
         # @!attribute [rw] null_value
         #   @return [::Google::Protobuf::NullValue]
         #     A null value.
+        #
+        #     Note: The following fields are mutually exclusive: `null_value`, `boolean_value`, `integer_value`, `double_value`, `timestamp_value`, `key_value`, `string_value`, `blob_value`, `geo_point_value`, `entity_value`, `array_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] boolean_value
         #   @return [::Boolean]
         #     A boolean value.
+        #
+        #     Note: The following fields are mutually exclusive: `boolean_value`, `null_value`, `integer_value`, `double_value`, `timestamp_value`, `key_value`, `string_value`, `blob_value`, `geo_point_value`, `entity_value`, `array_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] integer_value
         #   @return [::Integer]
         #     An integer value.
+        #
+        #     Note: The following fields are mutually exclusive: `integer_value`, `null_value`, `boolean_value`, `double_value`, `timestamp_value`, `key_value`, `string_value`, `blob_value`, `geo_point_value`, `entity_value`, `array_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] double_value
         #   @return [::Float]
         #     A double value.
+        #
+        #     Note: The following fields are mutually exclusive: `double_value`, `null_value`, `boolean_value`, `integer_value`, `timestamp_value`, `key_value`, `string_value`, `blob_value`, `geo_point_value`, `entity_value`, `array_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] timestamp_value
         #   @return [::Google::Protobuf::Timestamp]
         #     A timestamp value.
         #     When stored in the Datastore, precise only to microseconds;
         #     any additional precision is rounded down.
+        #
+        #     Note: The following fields are mutually exclusive: `timestamp_value`, `null_value`, `boolean_value`, `integer_value`, `double_value`, `key_value`, `string_value`, `blob_value`, `geo_point_value`, `entity_value`, `array_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] key_value
         #   @return [::Google::Cloud::Datastore::V1::Key]
         #     A key value.
+        #
+        #     Note: The following fields are mutually exclusive: `key_value`, `null_value`, `boolean_value`, `integer_value`, `double_value`, `timestamp_value`, `string_value`, `blob_value`, `geo_point_value`, `entity_value`, `array_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] string_value
         #   @return [::String]
         #     A UTF-8 encoded string value.
         #     When `exclude_from_indexes` is false (it is indexed) , may have at most
         #     1500 bytes. Otherwise, may be set to at most 1,000,000 bytes.
+        #
+        #     Note: The following fields are mutually exclusive: `string_value`, `null_value`, `boolean_value`, `integer_value`, `double_value`, `timestamp_value`, `key_value`, `blob_value`, `geo_point_value`, `entity_value`, `array_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] blob_value
         #   @return [::String]
         #     A blob value.
         #     May have at most 1,000,000 bytes.
         #     When `exclude_from_indexes` is false, may have at most 1500 bytes.
         #     In JSON requests, must be base64-encoded.
+        #
+        #     Note: The following fields are mutually exclusive: `blob_value`, `null_value`, `boolean_value`, `integer_value`, `double_value`, `timestamp_value`, `key_value`, `string_value`, `geo_point_value`, `entity_value`, `array_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] geo_point_value
         #   @return [::Google::Type::LatLng]
         #     A geo point value representing a point on the surface of Earth.
+        #
+        #     Note: The following fields are mutually exclusive: `geo_point_value`, `null_value`, `boolean_value`, `integer_value`, `double_value`, `timestamp_value`, `key_value`, `string_value`, `blob_value`, `entity_value`, `array_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] entity_value
         #   @return [::Google::Cloud::Datastore::V1::Entity]
         #     An entity value.
@@ -179,12 +201,16 @@ module Google
         #     - May have no key.
         #     - May have a key with an incomplete key path.
         #     - May have a reserved/read-only key.
+        #
+        #     Note: The following fields are mutually exclusive: `entity_value`, `null_value`, `boolean_value`, `integer_value`, `double_value`, `timestamp_value`, `key_value`, `string_value`, `blob_value`, `geo_point_value`, `array_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] array_value
         #   @return [::Google::Cloud::Datastore::V1::ArrayValue]
         #     An array value.
         #     Cannot contain another array value.
         #     A `Value` instance that sets field `array_value` must not set fields
         #     `meaning` or `exclude_from_indexes`.
+        #
+        #     Note: The following fields are mutually exclusive: `array_value`, `null_value`, `boolean_value`, `integer_value`, `double_value`, `timestamp_value`, `key_value`, `string_value`, `blob_value`, `geo_point_value`, `entity_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] meaning
         #   @return [::Integer]
         #     The `meaning` field should only be populated for backwards compatibility.

data/proto_docs/google/datastore/v1/query.rb

@@ -164,12 +164,18 @@ module Google
           # @!attribute [rw] count
           #   @return [::Google::Cloud::Datastore::V1::AggregationQuery::Aggregation::Count]
           #     Count aggregator.
+          #
+          #     Note: The following fields are mutually exclusive: `count`, `sum`, `avg`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] sum
           #   @return [::Google::Cloud::Datastore::V1::AggregationQuery::Aggregation::Sum]
           #     Sum aggregator.
+          #
+          #     Note: The following fields are mutually exclusive: `sum`, `count`, `avg`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] avg
           #   @return [::Google::Cloud::Datastore::V1::AggregationQuery::Aggregation::Avg]
           #     Average aggregator.
+          #
+          #     Note: The following fields are mutually exclusive: `avg`, `count`, `sum`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] alias
           #   @return [::String]
           #     Optional. Optional name of the property to store the result of the
@@ -353,9 +359,13 @@ module Google
         # @!attribute [rw] composite_filter
         #   @return [::Google::Cloud::Datastore::V1::CompositeFilter]
         #     A composite filter.
+        #
+        #     Note: The following fields are mutually exclusive: `composite_filter`, `property_filter`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] property_filter
         #   @return [::Google::Cloud::Datastore::V1::PropertyFilter]
         #     A filter on a property.
+        #
+        #     Note: The following fields are mutually exclusive: `property_filter`, `composite_filter`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class Filter
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -584,10 +594,14 @@ module Google
         # @!attribute [rw] value
         #   @return [::Google::Cloud::Datastore::V1::Value]
         #     A value parameter.
+        #
+        #     Note: The following fields are mutually exclusive: `value`, `cursor`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] cursor
         #   @return [::String]
         #     A query cursor. Query cursors are returned in query
         #     result batches.
+        #
+        #     Note: The following fields are mutually exclusive: `cursor`, `value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class GqlQueryParameter
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/struct.rb

@@ -53,21 +53,33 @@ module Google
     # @!attribute [rw] null_value
     #   @return [::Google::Protobuf::NullValue]
     #     Represents a null value.
+    #
+    #     Note: The following fields are mutually exclusive: `null_value`, `number_value`, `string_value`, `bool_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     # @!attribute [rw] number_value
     #   @return [::Float]
     #     Represents a double value.
+    #
+    #     Note: The following fields are mutually exclusive: `number_value`, `null_value`, `string_value`, `bool_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     # @!attribute [rw] string_value
     #   @return [::String]
     #     Represents a string value.
+    #
+    #     Note: The following fields are mutually exclusive: `string_value`, `null_value`, `number_value`, `bool_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     # @!attribute [rw] bool_value
     #   @return [::Boolean]
     #     Represents a boolean value.
+    #
+    #     Note: The following fields are mutually exclusive: `bool_value`, `null_value`, `number_value`, `string_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     # @!attribute [rw] struct_value
     #   @return [::Google::Protobuf::Struct]
     #     Represents a structured value.
+    #
+    #     Note: The following fields are mutually exclusive: `struct_value`, `null_value`, `number_value`, `string_value`, `bool_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     # @!attribute [rw] list_value
     #   @return [::Google::Protobuf::ListValue]
     #     Represents a repeated `Value`.
+    #
+    #     Note: The following fields are mutually exclusive: `list_value`, `null_value`, `number_value`, `string_value`, `bool_value`, `struct_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
     class Value
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-datastore-v1
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Google LLC
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-12-10 00:00:00.000000000 Z
+date: 2025-01-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +15,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.24.0
+        version: 0.25.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +25,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.24.0
+        version: 0.25.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -93,7 +92,6 @@ homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -101,15 +99,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.23
-signing_key: 
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Accesses the schemaless NoSQL database to provide fully managed, robust,
   scalable storage for your application.