google-cloud-datastore-v1 1.6.0 → 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 3e5b4bb77567d20e5709f69918c9e6ec43a38d67ff9ac58b7f731452098ff741
4
- data.tar.gz: e1ea7cfcf3fe845adc989c878c61c306c38e7c52f00bfc91afc9f5d1f7fcad8f
3
+ metadata.gz: f71622f216fb165e052aa500344971afe05554f7772289272db88f538988c93d
4
+ data.tar.gz: 7fc026713aea142fd62902326e32ac1c9d8d433e395f420e69c2b07aa66634c1
5
5
  SHA512:
6
- metadata.gz: d15e5b83851dec839a56ccc643cc4593c7b814512d121cd81d27be511f639de936122358edcd0e9eed9735f3c945f18b8c2689434d0cf55cc2a07efdf5b3c219
7
- data.tar.gz: 238a78248dfdbf2a35d355cf55a202b185bef5ec7a75a340a076fe19a3a22fd26e92096df95d59be7e435642a0800ccf7b5183958be1f8dfd9997134791b6ba4
6
+ metadata.gz: cdd5a1d2de026d31b355fd0891e01ded831d8b9802c68f55579690e340a68a44f202069167628c18677025fa56f5154298092eace21adf4bdb0ce83a72319faf
7
+ data.tar.gz: e6bba969af319628baf9c99bf65ed83c377f3789ca816b639461f42f06d6b68b90cc1c95c3f7c6f3ae48406f0aa3548e9b0f62e2c84bb0be044050ef1a0893e7
data/README.md CHANGED
@@ -86,7 +86,7 @@ To browse ready to use code samples check [Google Cloud Samples](https://cloud.g
86
86
 
87
87
  ## Supported Ruby Versions
88
88
 
89
- This library is supported on Ruby 3.0+.
89
+ This library is supported on Ruby 3.2+.
90
90
 
91
91
  Google provides official support for Ruby versions that are actively supported
92
92
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
@@ -227,7 +227,7 @@ module Google
227
227
  # @param options [::Gapic::CallOptions, ::Hash]
228
228
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
229
229
  #
230
- # @overload lookup(project_id: nil, database_id: nil, read_options: nil, keys: nil, property_mask: nil)
230
+ # @overload lookup(project_id: nil, database_id: nil, read_options: nil, keys: nil, property_mask: nil, request_options: nil)
231
231
  # Pass arguments to `lookup` via keyword arguments. Note that at
232
232
  # least one keyword argument is required. To specify no parameters, or to keep all
233
233
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -250,6 +250,8 @@ module Google
250
250
  # mask, it will be absent from [LookupResponse.found.entity.properties][].
251
251
  #
252
252
  # The entity's key is always returned.
253
+ # @param request_options [::Google::Cloud::Datastore::V1::RequestOptions, ::Hash]
254
+ # Optional. The options for this request.
253
255
  #
254
256
  # @yield [response, operation] Access the result along with the RPC operation
255
257
  # @yieldparam response [::Google::Cloud::Datastore::V1::LookupResponse]
@@ -331,7 +333,7 @@ module Google
331
333
  # @param options [::Gapic::CallOptions, ::Hash]
332
334
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
333
335
  #
334
- # @overload run_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, query: nil, gql_query: nil, property_mask: nil, explain_options: nil)
336
+ # @overload run_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, query: nil, gql_query: nil, property_mask: nil, explain_options: nil, request_options: nil)
335
337
  # Pass arguments to `run_query` via keyword arguments. Note that at
336
338
  # least one keyword argument is required. To specify no parameters, or to keep all
337
339
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -367,6 +369,8 @@ module Google
367
369
  # @param explain_options [::Google::Cloud::Datastore::V1::ExplainOptions, ::Hash]
368
370
  # Optional. Explain options for the query. If set, additional query
369
371
  # statistics will be returned. If not, only query results will be returned.
372
+ # @param request_options [::Google::Cloud::Datastore::V1::RequestOptions, ::Hash]
373
+ # Optional. The options for this request.
370
374
  #
371
375
  # @yield [response, operation] Access the result along with the RPC operation
372
376
  # @yieldparam response [::Google::Cloud::Datastore::V1::RunQueryResponse]
@@ -448,7 +452,7 @@ module Google
448
452
  # @param options [::Gapic::CallOptions, ::Hash]
449
453
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
450
454
  #
451
- # @overload run_aggregation_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, aggregation_query: nil, gql_query: nil, explain_options: nil)
455
+ # @overload run_aggregation_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, aggregation_query: nil, gql_query: nil, explain_options: nil, request_options: nil)
452
456
  # Pass arguments to `run_aggregation_query` via keyword arguments. Note that at
453
457
  # least one keyword argument is required. To specify no parameters, or to keep all
454
458
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -478,6 +482,8 @@ module Google
478
482
  # @param explain_options [::Google::Cloud::Datastore::V1::ExplainOptions, ::Hash]
479
483
  # Optional. Explain options for the query. If set, additional query
480
484
  # statistics will be returned. If not, only query results will be returned.
485
+ # @param request_options [::Google::Cloud::Datastore::V1::RequestOptions, ::Hash]
486
+ # Optional. The options for this request.
481
487
  #
482
488
  # @yield [response, operation] Access the result along with the RPC operation
483
489
  # @yieldparam response [::Google::Cloud::Datastore::V1::RunAggregationQueryResponse]
@@ -559,7 +565,7 @@ module Google
559
565
  # @param options [::Gapic::CallOptions, ::Hash]
560
566
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
561
567
  #
562
- # @overload begin_transaction(project_id: nil, database_id: nil, transaction_options: nil)
568
+ # @overload begin_transaction(project_id: nil, database_id: nil, transaction_options: nil, request_options: nil)
563
569
  # Pass arguments to `begin_transaction` via keyword arguments. Note that at
564
570
  # least one keyword argument is required. To specify no parameters, or to keep all
565
571
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -573,6 +579,8 @@ module Google
573
579
  # database.
574
580
  # @param transaction_options [::Google::Cloud::Datastore::V1::TransactionOptions, ::Hash]
575
581
  # Options for a new transaction.
582
+ # @param request_options [::Google::Cloud::Datastore::V1::RequestOptions, ::Hash]
583
+ # Optional. The options for this request.
576
584
  #
577
585
  # @yield [response, operation] Access the result along with the RPC operation
578
586
  # @yieldparam response [::Google::Cloud::Datastore::V1::BeginTransactionResponse]
@@ -655,7 +663,7 @@ module Google
655
663
  # @param options [::Gapic::CallOptions, ::Hash]
656
664
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
657
665
  #
658
- # @overload commit(project_id: nil, database_id: nil, mode: nil, transaction: nil, single_use_transaction: nil, mutations: nil)
666
+ # @overload commit(project_id: nil, database_id: nil, mode: nil, transaction: nil, single_use_transaction: nil, mutations: nil, request_options: nil)
659
667
  # Pass arguments to `commit` via keyword arguments. Note that at
660
668
  # least one keyword argument is required. To specify no parameters, or to keep all
661
669
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -696,6 +704,8 @@ module Google
696
704
  #
697
705
  # When mode is `NON_TRANSACTIONAL`, no two mutations may affect a single
698
706
  # entity.
707
+ # @param request_options [::Google::Cloud::Datastore::V1::RequestOptions, ::Hash]
708
+ # Optional. The options for this request.
699
709
  #
700
710
  # @yield [response, operation] Access the result along with the RPC operation
701
711
  # @yieldparam response [::Google::Cloud::Datastore::V1::CommitResponse]
@@ -777,7 +787,7 @@ module Google
777
787
  # @param options [::Gapic::CallOptions, ::Hash]
778
788
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
779
789
  #
780
- # @overload rollback(project_id: nil, database_id: nil, transaction: nil)
790
+ # @overload rollback(project_id: nil, database_id: nil, transaction: nil, request_options: nil)
781
791
  # Pass arguments to `rollback` via keyword arguments. Note that at
782
792
  # least one keyword argument is required. To specify no parameters, or to keep all
783
793
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -792,6 +802,8 @@ module Google
792
802
  # @param transaction [::String]
793
803
  # Required. The transaction identifier, returned by a call to
794
804
  # {::Google::Cloud::Datastore::V1::Datastore::Client#begin_transaction Datastore.BeginTransaction}.
805
+ # @param request_options [::Google::Cloud::Datastore::V1::RequestOptions, ::Hash]
806
+ # Optional. The options for this request.
795
807
  #
796
808
  # @yield [response, operation] Access the result along with the RPC operation
797
809
  # @yieldparam response [::Google::Cloud::Datastore::V1::RollbackResponse]
@@ -874,7 +886,7 @@ module Google
874
886
  # @param options [::Gapic::CallOptions, ::Hash]
875
887
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
876
888
  #
877
- # @overload allocate_ids(project_id: nil, database_id: nil, keys: nil)
889
+ # @overload allocate_ids(project_id: nil, database_id: nil, keys: nil, request_options: nil)
878
890
  # Pass arguments to `allocate_ids` via keyword arguments. Note that at
879
891
  # least one keyword argument is required. To specify no parameters, or to keep all
880
892
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -889,6 +901,8 @@ module Google
889
901
  # @param keys [::Array<::Google::Cloud::Datastore::V1::Key, ::Hash>]
890
902
  # Required. A list of keys with incomplete key paths for which to allocate
891
903
  # IDs. No key may be reserved/read-only.
904
+ # @param request_options [::Google::Cloud::Datastore::V1::RequestOptions, ::Hash]
905
+ # Optional. The options for this request.
892
906
  #
893
907
  # @yield [response, operation] Access the result along with the RPC operation
894
908
  # @yieldparam response [::Google::Cloud::Datastore::V1::AllocateIdsResponse]
@@ -971,7 +985,7 @@ module Google
971
985
  # @param options [::Gapic::CallOptions, ::Hash]
972
986
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
973
987
  #
974
- # @overload reserve_ids(project_id: nil, database_id: nil, keys: nil)
988
+ # @overload reserve_ids(project_id: nil, database_id: nil, keys: nil, request_options: nil)
975
989
  # Pass arguments to `reserve_ids` via keyword arguments. Note that at
976
990
  # least one keyword argument is required. To specify no parameters, or to keep all
977
991
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -986,6 +1000,8 @@ module Google
986
1000
  # @param keys [::Array<::Google::Cloud::Datastore::V1::Key, ::Hash>]
987
1001
  # Required. A list of keys with complete key paths whose numeric IDs should
988
1002
  # not be auto-allocated.
1003
+ # @param request_options [::Google::Cloud::Datastore::V1::RequestOptions, ::Hash]
1004
+ # Optional. The options for this request.
989
1005
  #
990
1006
  # @yield [response, operation] Access the result along with the RPC operation
991
1007
  # @yieldparam response [::Google::Cloud::Datastore::V1::ReserveIdsResponse]
@@ -1150,6 +1166,7 @@ module Google
1150
1166
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
1151
1167
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
1152
1168
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
1169
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
1153
1170
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
1154
1171
  # trigger a retry.
1155
1172
  # @return [::Hash]
@@ -1233,6 +1250,7 @@ module Google
1233
1250
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
1234
1251
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
1235
1252
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
1253
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
1236
1254
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
1237
1255
  # trigger a retry.
1238
1256
  #
@@ -220,7 +220,7 @@ module Google
220
220
  # @param options [::Gapic::CallOptions, ::Hash]
221
221
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
222
222
  #
223
- # @overload lookup(project_id: nil, database_id: nil, read_options: nil, keys: nil, property_mask: nil)
223
+ # @overload lookup(project_id: nil, database_id: nil, read_options: nil, keys: nil, property_mask: nil, request_options: nil)
224
224
  # Pass arguments to `lookup` via keyword arguments. Note that at
225
225
  # least one keyword argument is required. To specify no parameters, or to keep all
226
226
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -243,6 +243,8 @@ module Google
243
243
  # mask, it will be absent from [LookupResponse.found.entity.properties][].
244
244
  #
245
245
  # The entity's key is always returned.
246
+ # @param request_options [::Google::Cloud::Datastore::V1::RequestOptions, ::Hash]
247
+ # Optional. The options for this request.
246
248
  # @yield [result, operation] Access the result along with the TransportOperation object
247
249
  # @yieldparam result [::Google::Cloud::Datastore::V1::LookupResponse]
248
250
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -314,7 +316,7 @@ module Google
314
316
  # @param options [::Gapic::CallOptions, ::Hash]
315
317
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
316
318
  #
317
- # @overload run_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, query: nil, gql_query: nil, property_mask: nil, explain_options: nil)
319
+ # @overload run_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, query: nil, gql_query: nil, property_mask: nil, explain_options: nil, request_options: nil)
318
320
  # Pass arguments to `run_query` via keyword arguments. Note that at
319
321
  # least one keyword argument is required. To specify no parameters, or to keep all
320
322
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -350,6 +352,8 @@ module Google
350
352
  # @param explain_options [::Google::Cloud::Datastore::V1::ExplainOptions, ::Hash]
351
353
  # Optional. Explain options for the query. If set, additional query
352
354
  # statistics will be returned. If not, only query results will be returned.
355
+ # @param request_options [::Google::Cloud::Datastore::V1::RequestOptions, ::Hash]
356
+ # Optional. The options for this request.
353
357
  # @yield [result, operation] Access the result along with the TransportOperation object
354
358
  # @yieldparam result [::Google::Cloud::Datastore::V1::RunQueryResponse]
355
359
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -421,7 +425,7 @@ module Google
421
425
  # @param options [::Gapic::CallOptions, ::Hash]
422
426
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
423
427
  #
424
- # @overload run_aggregation_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, aggregation_query: nil, gql_query: nil, explain_options: nil)
428
+ # @overload run_aggregation_query(project_id: nil, database_id: nil, partition_id: nil, read_options: nil, aggregation_query: nil, gql_query: nil, explain_options: nil, request_options: nil)
425
429
  # Pass arguments to `run_aggregation_query` via keyword arguments. Note that at
426
430
  # least one keyword argument is required. To specify no parameters, or to keep all
427
431
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -451,6 +455,8 @@ module Google
451
455
  # @param explain_options [::Google::Cloud::Datastore::V1::ExplainOptions, ::Hash]
452
456
  # Optional. Explain options for the query. If set, additional query
453
457
  # statistics will be returned. If not, only query results will be returned.
458
+ # @param request_options [::Google::Cloud::Datastore::V1::RequestOptions, ::Hash]
459
+ # Optional. The options for this request.
454
460
  # @yield [result, operation] Access the result along with the TransportOperation object
455
461
  # @yieldparam result [::Google::Cloud::Datastore::V1::RunAggregationQueryResponse]
456
462
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -522,7 +528,7 @@ module Google
522
528
  # @param options [::Gapic::CallOptions, ::Hash]
523
529
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
524
530
  #
525
- # @overload begin_transaction(project_id: nil, database_id: nil, transaction_options: nil)
531
+ # @overload begin_transaction(project_id: nil, database_id: nil, transaction_options: nil, request_options: nil)
526
532
  # Pass arguments to `begin_transaction` via keyword arguments. Note that at
527
533
  # least one keyword argument is required. To specify no parameters, or to keep all
528
534
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -536,6 +542,8 @@ module Google
536
542
  # database.
537
543
  # @param transaction_options [::Google::Cloud::Datastore::V1::TransactionOptions, ::Hash]
538
544
  # Options for a new transaction.
545
+ # @param request_options [::Google::Cloud::Datastore::V1::RequestOptions, ::Hash]
546
+ # Optional. The options for this request.
539
547
  # @yield [result, operation] Access the result along with the TransportOperation object
540
548
  # @yieldparam result [::Google::Cloud::Datastore::V1::BeginTransactionResponse]
541
549
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -608,7 +616,7 @@ module Google
608
616
  # @param options [::Gapic::CallOptions, ::Hash]
609
617
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
610
618
  #
611
- # @overload commit(project_id: nil, database_id: nil, mode: nil, transaction: nil, single_use_transaction: nil, mutations: nil)
619
+ # @overload commit(project_id: nil, database_id: nil, mode: nil, transaction: nil, single_use_transaction: nil, mutations: nil, request_options: nil)
612
620
  # Pass arguments to `commit` via keyword arguments. Note that at
613
621
  # least one keyword argument is required. To specify no parameters, or to keep all
614
622
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -649,6 +657,8 @@ module Google
649
657
  #
650
658
  # When mode is `NON_TRANSACTIONAL`, no two mutations may affect a single
651
659
  # entity.
660
+ # @param request_options [::Google::Cloud::Datastore::V1::RequestOptions, ::Hash]
661
+ # Optional. The options for this request.
652
662
  # @yield [result, operation] Access the result along with the TransportOperation object
653
663
  # @yieldparam result [::Google::Cloud::Datastore::V1::CommitResponse]
654
664
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -720,7 +730,7 @@ module Google
720
730
  # @param options [::Gapic::CallOptions, ::Hash]
721
731
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
722
732
  #
723
- # @overload rollback(project_id: nil, database_id: nil, transaction: nil)
733
+ # @overload rollback(project_id: nil, database_id: nil, transaction: nil, request_options: nil)
724
734
  # Pass arguments to `rollback` via keyword arguments. Note that at
725
735
  # least one keyword argument is required. To specify no parameters, or to keep all
726
736
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -735,6 +745,8 @@ module Google
735
745
  # @param transaction [::String]
736
746
  # Required. The transaction identifier, returned by a call to
737
747
  # {::Google::Cloud::Datastore::V1::Datastore::Rest::Client#begin_transaction Datastore.BeginTransaction}.
748
+ # @param request_options [::Google::Cloud::Datastore::V1::RequestOptions, ::Hash]
749
+ # Optional. The options for this request.
738
750
  # @yield [result, operation] Access the result along with the TransportOperation object
739
751
  # @yieldparam result [::Google::Cloud::Datastore::V1::RollbackResponse]
740
752
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -807,7 +819,7 @@ module Google
807
819
  # @param options [::Gapic::CallOptions, ::Hash]
808
820
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
809
821
  #
810
- # @overload allocate_ids(project_id: nil, database_id: nil, keys: nil)
822
+ # @overload allocate_ids(project_id: nil, database_id: nil, keys: nil, request_options: nil)
811
823
  # Pass arguments to `allocate_ids` via keyword arguments. Note that at
812
824
  # least one keyword argument is required. To specify no parameters, or to keep all
813
825
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -822,6 +834,8 @@ module Google
822
834
  # @param keys [::Array<::Google::Cloud::Datastore::V1::Key, ::Hash>]
823
835
  # Required. A list of keys with incomplete key paths for which to allocate
824
836
  # IDs. No key may be reserved/read-only.
837
+ # @param request_options [::Google::Cloud::Datastore::V1::RequestOptions, ::Hash]
838
+ # Optional. The options for this request.
825
839
  # @yield [result, operation] Access the result along with the TransportOperation object
826
840
  # @yieldparam result [::Google::Cloud::Datastore::V1::AllocateIdsResponse]
827
841
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -894,7 +908,7 @@ module Google
894
908
  # @param options [::Gapic::CallOptions, ::Hash]
895
909
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
896
910
  #
897
- # @overload reserve_ids(project_id: nil, database_id: nil, keys: nil)
911
+ # @overload reserve_ids(project_id: nil, database_id: nil, keys: nil, request_options: nil)
898
912
  # Pass arguments to `reserve_ids` via keyword arguments. Note that at
899
913
  # least one keyword argument is required. To specify no parameters, or to keep all
900
914
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -909,6 +923,8 @@ module Google
909
923
  # @param keys [::Array<::Google::Cloud::Datastore::V1::Key, ::Hash>]
910
924
  # Required. A list of keys with complete key paths whose numeric IDs should
911
925
  # not be auto-allocated.
926
+ # @param request_options [::Google::Cloud::Datastore::V1::RequestOptions, ::Hash]
927
+ # Optional. The options for this request.
912
928
  # @yield [result, operation] Access the result along with the TransportOperation object
913
929
  # @yieldparam result [::Google::Cloud::Datastore::V1::ReserveIdsResponse]
914
930
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1037,6 +1053,7 @@ module Google
1037
1053
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
1038
1054
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
1039
1055
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
1056
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
1040
1057
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
1041
1058
  # trigger a retry.
1042
1059
  # @return [::Hash]
@@ -1109,6 +1126,7 @@ module Google
1109
1126
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
1110
1127
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
1111
1128
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
1129
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
1112
1130
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
1113
1131
  # trigger a retry.
1114
1132
  #
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Datastore
23
23
  module V1
24
- VERSION = "1.6.0"
24
+ VERSION = "1.8.0"
25
25
  end
26
26
  end
27
27
  end
@@ -15,7 +15,7 @@ require 'google/datastore/v1/query_profile_pb'
15
15
  require 'google/protobuf/timestamp_pb'
16
16
 
17
17
 
18
- descriptor_data = "\n#google/datastore/v1/datastore.proto\x12\x13google.datastore.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x18google/api/routing.proto\x1a,google/datastore/v1/aggregation_result.proto\x1a google/datastore/v1/entity.proto\x1a\x1fgoogle/datastore/v1/query.proto\x1a\'google/datastore/v1/query_profile.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xdc\x01\n\rLookupRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x36\n\x0cread_options\x18\x01 \x01(\x0b\x32 .google.datastore.v1.ReadOptions\x12+\n\x04keys\x18\x03 \x03(\x0b\x32\x18.google.datastore.v1.KeyB\x03\xe0\x41\x02\x12\x38\n\rproperty_mask\x18\x05 \x01(\x0b\x32!.google.datastore.v1.PropertyMask\"\xe6\x01\n\x0eLookupResponse\x12\x30\n\x05\x66ound\x18\x01 \x03(\x0b\x32!.google.datastore.v1.EntityResult\x12\x32\n\x07missing\x18\x02 \x03(\x0b\x32!.google.datastore.v1.EntityResult\x12*\n\x08\x64\x65\x66\x65rred\x18\x03 \x03(\x0b\x32\x18.google.datastore.v1.Key\x12\x13\n\x0btransaction\x18\x05 \x01(\x0c\x12-\n\tread_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\x9b\x03\n\x0fRunQueryRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x36\n\x0cpartition_id\x18\x02 \x01(\x0b\x32 .google.datastore.v1.PartitionId\x12\x36\n\x0cread_options\x18\x01 \x01(\x0b\x32 .google.datastore.v1.ReadOptions\x12+\n\x05query\x18\x03 \x01(\x0b\x32\x1a.google.datastore.v1.QueryH\x00\x12\x32\n\tgql_query\x18\x07 \x01(\x0b\x32\x1d.google.datastore.v1.GqlQueryH\x00\x12\x38\n\rproperty_mask\x18\n \x01(\x0b\x32!.google.datastore.v1.PropertyMask\x12\x41\n\x0f\x65xplain_options\x18\x0c \x01(\x0b\x32#.google.datastore.v1.ExplainOptionsB\x03\xe0\x41\x01\x42\x0c\n\nquery_type\"\xc6\x01\n\x10RunQueryResponse\x12\x34\n\x05\x62\x61tch\x18\x01 \x01(\x0b\x32%.google.datastore.v1.QueryResultBatch\x12)\n\x05query\x18\x02 \x01(\x0b\x32\x1a.google.datastore.v1.Query\x12\x13\n\x0btransaction\x18\x05 \x01(\x0c\x12<\n\x0f\x65xplain_metrics\x18\t \x01(\x0b\x32#.google.datastore.v1.ExplainMetrics\"\x83\x03\n\x1aRunAggregationQueryRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x36\n\x0cpartition_id\x18\x02 \x01(\x0b\x32 .google.datastore.v1.PartitionId\x12\x36\n\x0cread_options\x18\x01 \x01(\x0b\x32 .google.datastore.v1.ReadOptions\x12\x42\n\x11\x61ggregation_query\x18\x03 \x01(\x0b\x32%.google.datastore.v1.AggregationQueryH\x00\x12\x32\n\tgql_query\x18\x07 \x01(\x0b\x32\x1d.google.datastore.v1.GqlQueryH\x00\x12\x41\n\x0f\x65xplain_options\x18\x0b \x01(\x0b\x32#.google.datastore.v1.ExplainOptionsB\x03\xe0\x41\x01\x42\x0c\n\nquery_type\"\xe2\x01\n\x1bRunAggregationQueryResponse\x12:\n\x05\x62\x61tch\x18\x01 \x01(\x0b\x32+.google.datastore.v1.AggregationResultBatch\x12\x34\n\x05query\x18\x02 \x01(\x0b\x32%.google.datastore.v1.AggregationQuery\x12\x13\n\x0btransaction\x18\x05 \x01(\x0c\x12<\n\x0f\x65xplain_metrics\x18\t \x01(\x0b\x32#.google.datastore.v1.ExplainMetrics\"\x8d\x01\n\x17\x42\x65ginTransactionRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x44\n\x13transaction_options\x18\n \x01(\x0b\x32\'.google.datastore.v1.TransactionOptions\"/\n\x18\x42\x65ginTransactionResponse\x12\x13\n\x0btransaction\x18\x01 \x01(\x0c\"Y\n\x0fRollbackRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x18\n\x0btransaction\x18\x01 \x01(\x0c\x42\x03\xe0\x41\x02\"\x12\n\x10RollbackResponse\"\xe8\x02\n\rCommitRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x35\n\x04mode\x18\x05 \x01(\x0e\x32\'.google.datastore.v1.CommitRequest.Mode\x12\x15\n\x0btransaction\x18\x01 \x01(\x0cH\x00\x12I\n\x16single_use_transaction\x18\n \x01(\x0b\x32\'.google.datastore.v1.TransactionOptionsH\x00\x12\x30\n\tmutations\x18\x06 \x03(\x0b\x32\x1d.google.datastore.v1.Mutation\"F\n\x04Mode\x12\x14\n\x10MODE_UNSPECIFIED\x10\x00\x12\x11\n\rTRANSACTIONAL\x10\x01\x12\x15\n\x11NON_TRANSACTIONAL\x10\x02\x42\x16\n\x14transaction_selector\"\x97\x01\n\x0e\x43ommitResponse\x12=\n\x10mutation_results\x18\x03 \x03(\x0b\x32#.google.datastore.v1.MutationResult\x12\x15\n\rindex_updates\x18\x04 \x01(\x05\x12/\n\x0b\x63ommit_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"o\n\x12\x41llocateIdsRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12+\n\x04keys\x18\x01 \x03(\x0b\x32\x18.google.datastore.v1.KeyB\x03\xe0\x41\x02\"=\n\x13\x41llocateIdsResponse\x12&\n\x04keys\x18\x01 \x03(\x0b\x32\x18.google.datastore.v1.Key\"n\n\x11ReserveIdsRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12+\n\x04keys\x18\x01 \x03(\x0b\x32\x18.google.datastore.v1.KeyB\x03\xe0\x41\x02\"\x14\n\x12ReserveIdsResponse\"\xf2\x04\n\x08Mutation\x12-\n\x06insert\x18\x04 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12-\n\x06update\x18\x05 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12-\n\x06upsert\x18\x06 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12*\n\x06\x64\x65lete\x18\x07 \x01(\x0b\x32\x18.google.datastore.v1.KeyH\x00\x12\x16\n\x0c\x62\x61se_version\x18\x08 \x01(\x03H\x01\x12\x31\n\x0bupdate_time\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x01\x12^\n\x1c\x63onflict_resolution_strategy\x18\n \x01(\x0e\x32\x38.google.datastore.v1.Mutation.ConflictResolutionStrategy\x12\x38\n\rproperty_mask\x18\t \x01(\x0b\x32!.google.datastore.v1.PropertyMask\x12H\n\x13property_transforms\x18\x0c \x03(\x0b\x32&.google.datastore.v1.PropertyTransformB\x03\xe0\x41\x01\"R\n\x1a\x43onflictResolutionStrategy\x12\x18\n\x14STRATEGY_UNSPECIFIED\x10\x00\x12\x10\n\x0cSERVER_VALUE\x10\x01\x12\x08\n\x04\x46\x41IL\x10\x03\x42\x0b\n\toperationB\x1d\n\x1b\x63onflict_detection_strategy\"\xe3\x03\n\x11PropertyTransform\x12\x15\n\x08property\x18\x01 \x01(\tB\x03\xe0\x41\x01\x12Q\n\x13set_to_server_value\x18\x02 \x01(\x0e\x32\x32.google.datastore.v1.PropertyTransform.ServerValueH\x00\x12/\n\tincrement\x18\x03 \x01(\x0b\x32\x1a.google.datastore.v1.ValueH\x00\x12-\n\x07maximum\x18\x04 \x01(\x0b\x32\x1a.google.datastore.v1.ValueH\x00\x12-\n\x07minimum\x18\x05 \x01(\x0b\x32\x1a.google.datastore.v1.ValueH\x00\x12\x42\n\x17\x61ppend_missing_elements\x18\x06 \x01(\x0b\x32\x1f.google.datastore.v1.ArrayValueH\x00\x12@\n\x15remove_all_from_array\x18\x07 \x01(\x0b\x32\x1f.google.datastore.v1.ArrayValueH\x00\"=\n\x0bServerValue\x12\x1c\n\x18SERVER_VALUE_UNSPECIFIED\x10\x00\x12\x10\n\x0cREQUEST_TIME\x10\x01\x42\x10\n\x0etransform_type\"\xfc\x01\n\x0eMutationResult\x12%\n\x03key\x18\x03 \x01(\x0b\x32\x18.google.datastore.v1.Key\x12\x0f\n\x07version\x18\x04 \x01(\x03\x12/\n\x0b\x63reate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x19\n\x11\x63onflict_detected\x18\x05 \x01(\x08\x12\x35\n\x11transform_results\x18\x08 \x03(\x0b\x32\x1a.google.datastore.v1.Value\"\x1d\n\x0cPropertyMask\x12\r\n\x05paths\x18\x01 \x03(\t\"\xca\x02\n\x0bReadOptions\x12L\n\x10read_consistency\x18\x01 \x01(\x0e\x32\x30.google.datastore.v1.ReadOptions.ReadConsistencyH\x00\x12\x15\n\x0btransaction\x18\x02 \x01(\x0cH\x00\x12\x42\n\x0fnew_transaction\x18\x03 \x01(\x0b\x32\'.google.datastore.v1.TransactionOptionsH\x00\x12/\n\tread_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\"M\n\x0fReadConsistency\x12 \n\x1cREAD_CONSISTENCY_UNSPECIFIED\x10\x00\x12\n\n\x06STRONG\x10\x01\x12\x0c\n\x08\x45VENTUAL\x10\x02\x42\x12\n\x10\x63onsistency_type\"\x92\x02\n\x12TransactionOptions\x12G\n\nread_write\x18\x01 \x01(\x0b\x32\x31.google.datastore.v1.TransactionOptions.ReadWriteH\x00\x12\x45\n\tread_only\x18\x02 \x01(\x0b\x32\x30.google.datastore.v1.TransactionOptions.ReadOnlyH\x00\x1a)\n\tReadWrite\x12\x1c\n\x14previous_transaction\x18\x01 \x01(\x0c\x1a\x39\n\x08ReadOnly\x12-\n\tread_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x06\n\x04mode2\xe1\r\n\tDatastore\x12\xc0\x01\n\x06Lookup\x12\".google.datastore.v1.LookupRequest\x1a#.google.datastore.v1.LookupResponse\"m\xda\x41\x1cproject_id,read_options,keys\x82\xd3\xe4\x93\x02%\" /v1/projects/{project_id}:lookup:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xa9\x01\n\x08RunQuery\x12$.google.datastore.v1.RunQueryRequest\x1a%.google.datastore.v1.RunQueryResponse\"P\x82\xd3\xe4\x93\x02\'\"\"/v1/projects/{project_id}:runQuery:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xd5\x01\n\x13RunAggregationQuery\x12/.google.datastore.v1.RunAggregationQueryRequest\x1a\x30.google.datastore.v1.RunAggregationQueryResponse\"[\x82\xd3\xe4\x93\x02\x32\"-/v1/projects/{project_id}:runAggregationQuery:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xd6\x01\n\x10\x42\x65ginTransaction\x12,.google.datastore.v1.BeginTransactionRequest\x1a-.google.datastore.v1.BeginTransactionResponse\"e\xda\x41\nproject_id\x82\xd3\xe4\x93\x02/\"*/v1/projects/{project_id}:beginTransaction:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xe6\x01\n\x06\x43ommit\x12\".google.datastore.v1.CommitRequest\x1a#.google.datastore.v1.CommitResponse\"\x92\x01\xda\x41%project_id,mode,transaction,mutations\xda\x41\x19project_id,mode,mutations\x82\xd3\xe4\x93\x02%\" /v1/projects/{project_id}:commit:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xc2\x01\n\x08Rollback\x12$.google.datastore.v1.RollbackRequest\x1a%.google.datastore.v1.RollbackResponse\"i\xda\x41\x16project_id,transaction\x82\xd3\xe4\x93\x02\'\"\"/v1/projects/{project_id}:rollback:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xc7\x01\n\x0b\x41llocateIds\x12\'.google.datastore.v1.AllocateIdsRequest\x1a(.google.datastore.v1.AllocateIdsResponse\"e\xda\x41\x0fproject_id,keys\x82\xd3\xe4\x93\x02*\"%/v1/projects/{project_id}:allocateIds:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xc3\x01\n\nReserveIds\x12&.google.datastore.v1.ReserveIdsRequest\x1a\'.google.datastore.v1.ReserveIdsResponse\"d\xda\x41\x0fproject_id,keys\x82\xd3\xe4\x93\x02)\"$/v1/projects/{project_id}:reserveIds:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x1av\xca\x41\x18\x64\x61tastore.googleapis.com\xd2\x41Xhttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/datastoreB\xbf\x01\n\x17\x63om.google.datastore.v1B\x0e\x44\x61tastoreProtoP\x01Z;cloud.google.com/go/datastore/apiv1/datastorepb;datastorepb\xaa\x02\x19Google.Cloud.Datastore.V1\xca\x02\x19Google\\Cloud\\Datastore\\V1\xea\x02\x1cGoogle::Cloud::Datastore::V1b\x06proto3"
18
+ descriptor_data = "\n#google/datastore/v1/datastore.proto\x12\x13google.datastore.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x18google/api/routing.proto\x1a,google/datastore/v1/aggregation_result.proto\x1a google/datastore/v1/entity.proto\x1a\x1fgoogle/datastore/v1/query.proto\x1a\'google/datastore/v1/query_profile.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\x9f\x02\n\rLookupRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x36\n\x0cread_options\x18\x01 \x01(\x0b\x32 .google.datastore.v1.ReadOptions\x12+\n\x04keys\x18\x03 \x03(\x0b\x32\x18.google.datastore.v1.KeyB\x03\xe0\x41\x02\x12\x38\n\rproperty_mask\x18\x05 \x01(\x0b\x32!.google.datastore.v1.PropertyMask\x12\x41\n\x0frequest_options\x18\n \x01(\x0b\x32#.google.datastore.v1.RequestOptionsB\x03\xe0\x41\x01\"\xe6\x01\n\x0eLookupResponse\x12\x30\n\x05\x66ound\x18\x01 \x03(\x0b\x32!.google.datastore.v1.EntityResult\x12\x32\n\x07missing\x18\x02 \x03(\x0b\x32!.google.datastore.v1.EntityResult\x12*\n\x08\x64\x65\x66\x65rred\x18\x03 \x03(\x0b\x32\x18.google.datastore.v1.Key\x12\x13\n\x0btransaction\x18\x05 \x01(\x0c\x12-\n\tread_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xde\x03\n\x0fRunQueryRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x36\n\x0cpartition_id\x18\x02 \x01(\x0b\x32 .google.datastore.v1.PartitionId\x12\x36\n\x0cread_options\x18\x01 \x01(\x0b\x32 .google.datastore.v1.ReadOptions\x12+\n\x05query\x18\x03 \x01(\x0b\x32\x1a.google.datastore.v1.QueryH\x00\x12\x32\n\tgql_query\x18\x07 \x01(\x0b\x32\x1d.google.datastore.v1.GqlQueryH\x00\x12\x38\n\rproperty_mask\x18\n \x01(\x0b\x32!.google.datastore.v1.PropertyMask\x12\x41\n\x0f\x65xplain_options\x18\x0c \x01(\x0b\x32#.google.datastore.v1.ExplainOptionsB\x03\xe0\x41\x01\x12\x41\n\x0frequest_options\x18\r \x01(\x0b\x32#.google.datastore.v1.RequestOptionsB\x03\xe0\x41\x01\x42\x0c\n\nquery_type\"\xc6\x01\n\x10RunQueryResponse\x12\x34\n\x05\x62\x61tch\x18\x01 \x01(\x0b\x32%.google.datastore.v1.QueryResultBatch\x12)\n\x05query\x18\x02 \x01(\x0b\x32\x1a.google.datastore.v1.Query\x12\x13\n\x0btransaction\x18\x05 \x01(\x0c\x12<\n\x0f\x65xplain_metrics\x18\t \x01(\x0b\x32#.google.datastore.v1.ExplainMetrics\"\xc6\x03\n\x1aRunAggregationQueryRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x36\n\x0cpartition_id\x18\x02 \x01(\x0b\x32 .google.datastore.v1.PartitionId\x12\x36\n\x0cread_options\x18\x01 \x01(\x0b\x32 .google.datastore.v1.ReadOptions\x12\x42\n\x11\x61ggregation_query\x18\x03 \x01(\x0b\x32%.google.datastore.v1.AggregationQueryH\x00\x12\x32\n\tgql_query\x18\x07 \x01(\x0b\x32\x1d.google.datastore.v1.GqlQueryH\x00\x12\x41\n\x0f\x65xplain_options\x18\x0b \x01(\x0b\x32#.google.datastore.v1.ExplainOptionsB\x03\xe0\x41\x01\x12\x41\n\x0frequest_options\x18\x0c \x01(\x0b\x32#.google.datastore.v1.RequestOptionsB\x03\xe0\x41\x01\x42\x0c\n\nquery_type\"\xe2\x01\n\x1bRunAggregationQueryResponse\x12:\n\x05\x62\x61tch\x18\x01 \x01(\x0b\x32+.google.datastore.v1.AggregationResultBatch\x12\x34\n\x05query\x18\x02 \x01(\x0b\x32%.google.datastore.v1.AggregationQuery\x12\x13\n\x0btransaction\x18\x05 \x01(\x0c\x12<\n\x0f\x65xplain_metrics\x18\t \x01(\x0b\x32#.google.datastore.v1.ExplainMetrics\"\xd0\x01\n\x17\x42\x65ginTransactionRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x44\n\x13transaction_options\x18\n \x01(\x0b\x32\'.google.datastore.v1.TransactionOptions\x12\x41\n\x0frequest_options\x18\x0b \x01(\x0b\x32#.google.datastore.v1.RequestOptionsB\x03\xe0\x41\x01\"/\n\x18\x42\x65ginTransactionResponse\x12\x13\n\x0btransaction\x18\x01 \x01(\x0c\"\x9c\x01\n\x0fRollbackRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x18\n\x0btransaction\x18\x01 \x01(\x0c\x42\x03\xe0\x41\x02\x12\x41\n\x0frequest_options\x18\n \x01(\x0b\x32#.google.datastore.v1.RequestOptionsB\x03\xe0\x41\x01\"\x12\n\x10RollbackResponse\"\xab\x03\n\rCommitRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12\x35\n\x04mode\x18\x05 \x01(\x0e\x32\'.google.datastore.v1.CommitRequest.Mode\x12\x15\n\x0btransaction\x18\x01 \x01(\x0cH\x00\x12I\n\x16single_use_transaction\x18\n \x01(\x0b\x32\'.google.datastore.v1.TransactionOptionsH\x00\x12\x30\n\tmutations\x18\x06 \x03(\x0b\x32\x1d.google.datastore.v1.Mutation\x12\x41\n\x0frequest_options\x18\x0b \x01(\x0b\x32#.google.datastore.v1.RequestOptionsB\x03\xe0\x41\x01\"F\n\x04Mode\x12\x14\n\x10MODE_UNSPECIFIED\x10\x00\x12\x11\n\rTRANSACTIONAL\x10\x01\x12\x15\n\x11NON_TRANSACTIONAL\x10\x02\x42\x16\n\x14transaction_selector\"\x97\x01\n\x0e\x43ommitResponse\x12=\n\x10mutation_results\x18\x03 \x03(\x0b\x32#.google.datastore.v1.MutationResult\x12\x15\n\rindex_updates\x18\x04 \x01(\x05\x12/\n\x0b\x63ommit_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xb2\x01\n\x12\x41llocateIdsRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12+\n\x04keys\x18\x01 \x03(\x0b\x32\x18.google.datastore.v1.KeyB\x03\xe0\x41\x02\x12\x41\n\x0frequest_options\x18\n \x01(\x0b\x32#.google.datastore.v1.RequestOptionsB\x03\xe0\x41\x01\"=\n\x13\x41llocateIdsResponse\x12&\n\x04keys\x18\x01 \x03(\x0b\x32\x18.google.datastore.v1.Key\"\xb1\x01\n\x11ReserveIdsRequest\x12\x17\n\nproject_id\x18\x08 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12+\n\x04keys\x18\x01 \x03(\x0b\x32\x18.google.datastore.v1.KeyB\x03\xe0\x41\x02\x12\x41\n\x0frequest_options\x18\n \x01(\x0b\x32#.google.datastore.v1.RequestOptionsB\x03\xe0\x41\x01\"\x14\n\x12ReserveIdsResponse\"\xf2\x04\n\x08Mutation\x12-\n\x06insert\x18\x04 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12-\n\x06update\x18\x05 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12-\n\x06upsert\x18\x06 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12*\n\x06\x64\x65lete\x18\x07 \x01(\x0b\x32\x18.google.datastore.v1.KeyH\x00\x12\x16\n\x0c\x62\x61se_version\x18\x08 \x01(\x03H\x01\x12\x31\n\x0bupdate_time\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x01\x12^\n\x1c\x63onflict_resolution_strategy\x18\n \x01(\x0e\x32\x38.google.datastore.v1.Mutation.ConflictResolutionStrategy\x12\x38\n\rproperty_mask\x18\t \x01(\x0b\x32!.google.datastore.v1.PropertyMask\x12H\n\x13property_transforms\x18\x0c \x03(\x0b\x32&.google.datastore.v1.PropertyTransformB\x03\xe0\x41\x01\"R\n\x1a\x43onflictResolutionStrategy\x12\x18\n\x14STRATEGY_UNSPECIFIED\x10\x00\x12\x10\n\x0cSERVER_VALUE\x10\x01\x12\x08\n\x04\x46\x41IL\x10\x03\x42\x0b\n\toperationB\x1d\n\x1b\x63onflict_detection_strategy\"\xe3\x03\n\x11PropertyTransform\x12\x15\n\x08property\x18\x01 \x01(\tB\x03\xe0\x41\x01\x12Q\n\x13set_to_server_value\x18\x02 \x01(\x0e\x32\x32.google.datastore.v1.PropertyTransform.ServerValueH\x00\x12/\n\tincrement\x18\x03 \x01(\x0b\x32\x1a.google.datastore.v1.ValueH\x00\x12-\n\x07maximum\x18\x04 \x01(\x0b\x32\x1a.google.datastore.v1.ValueH\x00\x12-\n\x07minimum\x18\x05 \x01(\x0b\x32\x1a.google.datastore.v1.ValueH\x00\x12\x42\n\x17\x61ppend_missing_elements\x18\x06 \x01(\x0b\x32\x1f.google.datastore.v1.ArrayValueH\x00\x12@\n\x15remove_all_from_array\x18\x07 \x01(\x0b\x32\x1f.google.datastore.v1.ArrayValueH\x00\"=\n\x0bServerValue\x12\x1c\n\x18SERVER_VALUE_UNSPECIFIED\x10\x00\x12\x10\n\x0cREQUEST_TIME\x10\x01\x42\x10\n\x0etransform_type\"\xfc\x01\n\x0eMutationResult\x12%\n\x03key\x18\x03 \x01(\x0b\x32\x18.google.datastore.v1.Key\x12\x0f\n\x07version\x18\x04 \x01(\x03\x12/\n\x0b\x63reate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x19\n\x11\x63onflict_detected\x18\x05 \x01(\x08\x12\x35\n\x11transform_results\x18\x08 \x03(\x0b\x32\x1a.google.datastore.v1.Value\"\x1d\n\x0cPropertyMask\x12\r\n\x05paths\x18\x01 \x03(\t\"\xca\x02\n\x0bReadOptions\x12L\n\x10read_consistency\x18\x01 \x01(\x0e\x32\x30.google.datastore.v1.ReadOptions.ReadConsistencyH\x00\x12\x15\n\x0btransaction\x18\x02 \x01(\x0cH\x00\x12\x42\n\x0fnew_transaction\x18\x03 \x01(\x0b\x32\'.google.datastore.v1.TransactionOptionsH\x00\x12/\n\tread_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\"M\n\x0fReadConsistency\x12 \n\x1cREAD_CONSISTENCY_UNSPECIFIED\x10\x00\x12\n\n\x06STRONG\x10\x01\x12\x0c\n\x08\x45VENTUAL\x10\x02\x42\x12\n\x10\x63onsistency_type\"\x92\x02\n\x12TransactionOptions\x12G\n\nread_write\x18\x01 \x01(\x0b\x32\x31.google.datastore.v1.TransactionOptions.ReadWriteH\x00\x12\x45\n\tread_only\x18\x02 \x01(\x0b\x32\x30.google.datastore.v1.TransactionOptions.ReadOnlyH\x00\x1a)\n\tReadWrite\x12\x1c\n\x14previous_transaction\x18\x01 \x01(\x0c\x1a\x39\n\x08ReadOnly\x12-\n\tread_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x06\n\x04mode\"+\n\x0eRequestOptions\x12\x19\n\x0crequest_tags\x18\x03 \x03(\tB\x03\xe0\x41\x01\x32\xe1\r\n\tDatastore\x12\xc0\x01\n\x06Lookup\x12\".google.datastore.v1.LookupRequest\x1a#.google.datastore.v1.LookupResponse\"m\xda\x41\x1cproject_id,read_options,keys\x82\xd3\xe4\x93\x02%\" /v1/projects/{project_id}:lookup:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xa9\x01\n\x08RunQuery\x12$.google.datastore.v1.RunQueryRequest\x1a%.google.datastore.v1.RunQueryResponse\"P\x82\xd3\xe4\x93\x02\'\"\"/v1/projects/{project_id}:runQuery:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xd5\x01\n\x13RunAggregationQuery\x12/.google.datastore.v1.RunAggregationQueryRequest\x1a\x30.google.datastore.v1.RunAggregationQueryResponse\"[\x82\xd3\xe4\x93\x02\x32\"-/v1/projects/{project_id}:runAggregationQuery:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xd6\x01\n\x10\x42\x65ginTransaction\x12,.google.datastore.v1.BeginTransactionRequest\x1a-.google.datastore.v1.BeginTransactionResponse\"e\xda\x41\nproject_id\x82\xd3\xe4\x93\x02/\"*/v1/projects/{project_id}:beginTransaction:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xe6\x01\n\x06\x43ommit\x12\".google.datastore.v1.CommitRequest\x1a#.google.datastore.v1.CommitResponse\"\x92\x01\xda\x41%project_id,mode,transaction,mutations\xda\x41\x19project_id,mode,mutations\x82\xd3\xe4\x93\x02%\" /v1/projects/{project_id}:commit:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xc2\x01\n\x08Rollback\x12$.google.datastore.v1.RollbackRequest\x1a%.google.datastore.v1.RollbackResponse\"i\xda\x41\x16project_id,transaction\x82\xd3\xe4\x93\x02\'\"\"/v1/projects/{project_id}:rollback:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xc7\x01\n\x0b\x41llocateIds\x12\'.google.datastore.v1.AllocateIdsRequest\x1a(.google.datastore.v1.AllocateIdsResponse\"e\xda\x41\x0fproject_id,keys\x82\xd3\xe4\x93\x02*\"%/v1/projects/{project_id}:allocateIds:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x12\xc3\x01\n\nReserveIds\x12&.google.datastore.v1.ReserveIdsRequest\x1a\'.google.datastore.v1.ReserveIdsResponse\"d\xda\x41\x0fproject_id,keys\x82\xd3\xe4\x93\x02)\"$/v1/projects/{project_id}:reserveIds:\x01*\x8a\xd3\xe4\x93\x02\x1d\x12\x0c\n\nproject_id\x12\r\n\x0b\x64\x61tabase_id\x1av\xca\x41\x18\x64\x61tastore.googleapis.com\xd2\x41Xhttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/datastoreB\xbf\x01\n\x17\x63om.google.datastore.v1B\x0e\x44\x61tastoreProtoP\x01Z;cloud.google.com/go/datastore/apiv1/datastorepb;datastorepb\xaa\x02\x19Google.Cloud.Datastore.V1\xca\x02\x19Google\\Cloud\\Datastore\\V1\xea\x02\x1cGoogle::Cloud::Datastore::V1b\x06proto3"
19
19
 
20
20
  pool = ::Google::Protobuf::DescriptorPool.generated_pool
21
21
  pool.add_serialized_file(descriptor_data)
@@ -52,6 +52,7 @@ module Google
52
52
  TransactionOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.TransactionOptions").msgclass
53
53
  TransactionOptions::ReadWrite = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.TransactionOptions.ReadWrite").msgclass
54
54
  TransactionOptions::ReadOnly = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.TransactionOptions.ReadOnly").msgclass
55
+ RequestOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.datastore.v1.RequestOptions").msgclass
55
56
  end
56
57
  end
57
58
  end
@@ -31,6 +31,8 @@ module Google
31
31
  # @!attribute [rw] selective_gapic_generation
32
32
  # @return [::Google::Api::SelectiveGapicGeneration]
33
33
  # Configuration for which RPCs should be generated in the GAPIC client.
34
+ #
35
+ # Note: This field should not be used in most cases.
34
36
  class CommonLanguageSettings
35
37
  include ::Google::Protobuf::MessageExts
36
38
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -141,9 +143,10 @@ module Google
141
143
  #
142
144
  # Example of a YAML configuration::
143
145
  #
144
- # publishing:
145
- # java_settings:
146
- # library_package: com.google.cloud.pubsub.v1
146
+ # publishing:
147
+ # library_settings:
148
+ # java_settings:
149
+ # library_package: com.google.cloud.pubsub.v1
147
150
  # @!attribute [rw] service_class_names
148
151
  # @return [::Google::Protobuf::Map{::String => ::String}]
149
152
  # Configure the Java class name to use instead of the service's for its
@@ -155,11 +158,11 @@ module Google
155
158
  #
156
159
  # Example of a YAML configuration::
157
160
  #
158
- # publishing:
159
- # java_settings:
160
- # service_class_names:
161
- # - google.pubsub.v1.Publisher: TopicAdmin
162
- # - google.pubsub.v1.Subscriber: SubscriptionAdmin
161
+ # publishing:
162
+ # java_settings:
163
+ # service_class_names:
164
+ # - google.pubsub.v1.Publisher: TopicAdmin
165
+ # - google.pubsub.v1.Subscriber: SubscriptionAdmin
163
166
  # @!attribute [rw] common
164
167
  # @return [::Google::Api::CommonLanguageSettings]
165
168
  # Some settings.
@@ -190,6 +193,20 @@ module Google
190
193
  # @!attribute [rw] common
191
194
  # @return [::Google::Api::CommonLanguageSettings]
192
195
  # Some settings.
196
+ # @!attribute [rw] library_package
197
+ # @return [::String]
198
+ # The package name to use in Php. Clobbers the php_namespace option
199
+ # set in the protobuf. This should be used **only** by APIs
200
+ # who have already set the language_settings.php.package_name" field
201
+ # in gapic.yaml. API teams should use the protobuf php_namespace option
202
+ # where possible.
203
+ #
204
+ # Example of a YAML configuration::
205
+ #
206
+ # publishing:
207
+ # library_settings:
208
+ # php_settings:
209
+ # library_package: Google\Cloud\PubSub\V1
193
210
  class PhpSettings
194
211
  include ::Google::Protobuf::MessageExts
195
212
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -318,10 +335,12 @@ module Google
318
335
  # service names and values are the name to be used for the service client
319
336
  # and call options.
320
337
  #
321
- # publishing:
322
- # go_settings:
323
- # renamed_services:
324
- # Publisher: TopicAdmin
338
+ # Example:
339
+ #
340
+ # publishing:
341
+ # go_settings:
342
+ # renamed_services:
343
+ # Publisher: TopicAdmin
325
344
  class GoSettings
326
345
  include ::Google::Protobuf::MessageExts
327
346
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -344,10 +363,10 @@ module Google
344
363
  #
345
364
  # Example:
346
365
  #
347
- # publishing:
348
- # method_settings:
349
- # - selector: google.storage.control.v2.StorageControl.CreateFolder
350
- # # method settings for CreateFolder...
366
+ # publishing:
367
+ # method_settings:
368
+ # - selector: google.storage.control.v2.StorageControl.CreateFolder
369
+ # # method settings for CreateFolder...
351
370
  # @!attribute [rw] long_running
352
371
  # @return [::Google::Api::MethodSettings::LongRunning]
353
372
  # Describes settings to use for long-running operations when generating
@@ -356,14 +375,14 @@ module Google
356
375
  #
357
376
  # Example of a YAML configuration::
358
377
  #
359
- # publishing:
360
- # method_settings:
361
- # - selector: google.cloud.speech.v2.Speech.BatchRecognize
362
- # long_running:
363
- # initial_poll_delay: 60s # 1 minute
364
- # poll_delay_multiplier: 1.5
365
- # max_poll_delay: 360s # 6 minutes
366
- # total_poll_timeout: 54000s # 90 minutes
378
+ # publishing:
379
+ # method_settings:
380
+ # - selector: google.cloud.speech.v2.Speech.BatchRecognize
381
+ # long_running:
382
+ # initial_poll_delay: 60s # 1 minute
383
+ # poll_delay_multiplier: 1.5
384
+ # max_poll_delay: 360s # 6 minutes
385
+ # total_poll_timeout: 54000s # 90 minutes
367
386
  # @!attribute [rw] auto_populated_fields
368
387
  # @return [::Array<::String>]
369
388
  # List of top-level fields of the request message, that should be
@@ -372,11 +391,24 @@ module Google
372
391
  #
373
392
  # Example of a YAML configuration:
374
393
  #
375
- # publishing:
376
- # method_settings:
377
- # - selector: google.example.v1.ExampleService.CreateExample
378
- # auto_populated_fields:
379
- # - request_id
394
+ # publishing:
395
+ # method_settings:
396
+ # - selector: google.example.v1.ExampleService.CreateExample
397
+ # auto_populated_fields:
398
+ # - request_id
399
+ # @!attribute [rw] batching
400
+ # @return [::Google::Api::BatchingConfigProto]
401
+ # Batching configuration for an API method in client libraries.
402
+ #
403
+ # Example of a YAML configuration:
404
+ #
405
+ # publishing:
406
+ # method_settings:
407
+ # - selector: google.example.v1.ExampleService.BatchCreateExample
408
+ # batching:
409
+ # element_count_threshold: 1000
410
+ # request_byte_threshold: 100000000
411
+ # delay_threshold_millis: 10
380
412
  class MethodSettings
381
413
  include ::Google::Protobuf::MessageExts
382
414
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -411,6 +443,8 @@ module Google
411
443
 
412
444
  # This message is used to configure the generation of a subset of the RPCs in
413
445
  # a service for client libraries.
446
+ #
447
+ # Note: This feature should not be used in most cases.
414
448
  # @!attribute [rw] methods
415
449
  # @return [::Array<::String>]
416
450
  # An allowlist of the fully qualified names of RPCs that should be included
@@ -428,6 +462,77 @@ module Google
428
462
  extend ::Google::Protobuf::MessageExts::ClassMethods
429
463
  end
430
464
 
465
+ # `BatchingConfigProto` defines the batching configuration for an API method.
466
+ # @!attribute [rw] thresholds
467
+ # @return [::Google::Api::BatchingSettingsProto]
468
+ # The thresholds which trigger a batched request to be sent.
469
+ # @!attribute [rw] batch_descriptor
470
+ # @return [::Google::Api::BatchingDescriptorProto]
471
+ # The request and response fields used in batching.
472
+ class BatchingConfigProto
473
+ include ::Google::Protobuf::MessageExts
474
+ extend ::Google::Protobuf::MessageExts::ClassMethods
475
+ end
476
+
477
+ # `BatchingSettingsProto` specifies a set of batching thresholds, each of
478
+ # which acts as a trigger to send a batch of messages as a request. At least
479
+ # one threshold must be positive nonzero.
480
+ # @!attribute [rw] element_count_threshold
481
+ # @return [::Integer]
482
+ # The number of elements of a field collected into a batch which, if
483
+ # exceeded, causes the batch to be sent.
484
+ # @!attribute [rw] request_byte_threshold
485
+ # @return [::Integer]
486
+ # The aggregated size of the batched field which, if exceeded, causes the
487
+ # batch to be sent. This size is computed by aggregating the sizes of the
488
+ # request field to be batched, not of the entire request message.
489
+ # @!attribute [rw] delay_threshold
490
+ # @return [::Google::Protobuf::Duration]
491
+ # The duration after which a batch should be sent, starting from the addition
492
+ # of the first message to that batch.
493
+ # @!attribute [rw] element_count_limit
494
+ # @return [::Integer]
495
+ # The maximum number of elements collected in a batch that could be accepted
496
+ # by server.
497
+ # @!attribute [rw] request_byte_limit
498
+ # @return [::Integer]
499
+ # The maximum size of the request that could be accepted by server.
500
+ # @!attribute [rw] flow_control_element_limit
501
+ # @return [::Integer]
502
+ # The maximum number of elements allowed by flow control.
503
+ # @!attribute [rw] flow_control_byte_limit
504
+ # @return [::Integer]
505
+ # The maximum size of data allowed by flow control.
506
+ # @!attribute [rw] flow_control_limit_exceeded_behavior
507
+ # @return [::Google::Api::FlowControlLimitExceededBehaviorProto]
508
+ # The behavior to take when the flow control limit is exceeded.
509
+ class BatchingSettingsProto
510
+ include ::Google::Protobuf::MessageExts
511
+ extend ::Google::Protobuf::MessageExts::ClassMethods
512
+ end
513
+
514
+ # `BatchingDescriptorProto` specifies the fields of the request message to be
515
+ # used for batching, and, optionally, the fields of the response message to be
516
+ # used for demultiplexing.
517
+ # @!attribute [rw] batched_field
518
+ # @return [::String]
519
+ # The repeated field in the request message to be aggregated by batching.
520
+ # @!attribute [rw] discriminator_fields
521
+ # @return [::Array<::String>]
522
+ # A list of the fields in the request message. Two requests will be batched
523
+ # together only if the values of every field specified in
524
+ # `request_discriminator_fields` is equal between the two requests.
525
+ # @!attribute [rw] subresponse_field
526
+ # @return [::String]
527
+ # Optional. When present, indicates the field in the response message to be
528
+ # used to demultiplex the response into multiple response messages, in
529
+ # correspondence with the multiple request messages originally batched
530
+ # together.
531
+ class BatchingDescriptorProto
532
+ include ::Google::Protobuf::MessageExts
533
+ extend ::Google::Protobuf::MessageExts::ClassMethods
534
+ end
535
+
431
536
  # The organization for which the client libraries are being published.
432
537
  # Affects the url where generated docs are published, etc.
433
538
  module ClientLibraryOrganization
@@ -469,5 +574,20 @@ module Google
469
574
  # Publish the library to package managers like nuget.org and npmjs.com.
470
575
  PACKAGE_MANAGER = 20
471
576
  end
577
+
578
+ # The behavior to take when the flow control limit is exceeded.
579
+ module FlowControlLimitExceededBehaviorProto
580
+ # Default behavior, system-defined.
581
+ UNSET_BEHAVIOR = 0
582
+
583
+ # Stop operation, raise error.
584
+ THROW_EXCEPTION = 1
585
+
586
+ # Pause operation until limit clears.
587
+ BLOCK = 2
588
+
589
+ # Continue operation, disregard limit.
590
+ IGNORE = 3
591
+ end
472
592
  end
473
593
  end
@@ -49,9 +49,13 @@ module Google
49
49
  # app_profile_id: profiles/prof_qux
50
50
  # }
51
51
  #
52
- # The routing header consists of one or multiple key-value pairs. Every key
53
- # and value must be percent-encoded, and joined together in the format of
54
- # `key1=value1&key2=value2`.
52
+ # The routing header consists of one or multiple key-value pairs. The order of
53
+ # the key-value pairs is undefined, the order of the `routing_parameters` in
54
+ # the `RoutingRule` only matters for the evaluation order of the path
55
+ # templates when `field` is the same. See the examples below for more details.
56
+ #
57
+ # Every key and value in the routing header must be percent-encoded,
58
+ # and joined together in the following format: `key1=value1&key2=value2`.
55
59
  # The examples below skip the percent-encoding for readability.
56
60
  #
57
61
  # Example 1
@@ -45,6 +45,9 @@ module Google
45
45
  # mask, it will be absent from [LookupResponse.found.entity.properties][].
46
46
  #
47
47
  # The entity's key is always returned.
48
+ # @!attribute [rw] request_options
49
+ # @return [::Google::Cloud::Datastore::V1::RequestOptions]
50
+ # Optional. The options for this request.
48
51
  class LookupRequest
49
52
  include ::Google::Protobuf::MessageExts
50
53
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -123,6 +126,9 @@ module Google
123
126
  # @return [::Google::Cloud::Datastore::V1::ExplainOptions]
124
127
  # Optional. Explain options for the query. If set, additional query
125
128
  # statistics will be returned. If not, only query results will be returned.
129
+ # @!attribute [rw] request_options
130
+ # @return [::Google::Cloud::Datastore::V1::RequestOptions]
131
+ # Optional. The options for this request.
126
132
  class RunQueryRequest
127
133
  include ::Google::Protobuf::MessageExts
128
134
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -132,7 +138,13 @@ module Google
132
138
  # {::Google::Cloud::Datastore::V1::Datastore::Client#run_query Datastore.RunQuery}.
133
139
  # @!attribute [rw] batch
134
140
  # @return [::Google::Cloud::Datastore::V1::QueryResultBatch]
135
- # A batch of query results (always present).
141
+ # A batch of query results. This is always present unless running a
142
+ # query under explain-only
143
+ # mode:
144
+ # {::Google::Cloud::Datastore::V1::RunQueryRequest#explain_options RunQueryRequest.explain_options}
145
+ # was provided and
146
+ # {::Google::Cloud::Datastore::V1::ExplainOptions#analyze ExplainOptions.analyze} was
147
+ # set to false.
136
148
  # @!attribute [rw] query
137
149
  # @return [::Google::Cloud::Datastore::V1::Query]
138
150
  # The parsed form of the `GqlQuery` from the request, if it was set.
@@ -189,6 +201,9 @@ module Google
189
201
  # @return [::Google::Cloud::Datastore::V1::ExplainOptions]
190
202
  # Optional. Explain options for the query. If set, additional query
191
203
  # statistics will be returned. If not, only query results will be returned.
204
+ # @!attribute [rw] request_options
205
+ # @return [::Google::Cloud::Datastore::V1::RequestOptions]
206
+ # Optional. The options for this request.
192
207
  class RunAggregationQueryRequest
193
208
  include ::Google::Protobuf::MessageExts
194
209
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -235,6 +250,9 @@ module Google
235
250
  # @!attribute [rw] transaction_options
236
251
  # @return [::Google::Cloud::Datastore::V1::TransactionOptions]
237
252
  # Options for a new transaction.
253
+ # @!attribute [rw] request_options
254
+ # @return [::Google::Cloud::Datastore::V1::RequestOptions]
255
+ # Optional. The options for this request.
238
256
  class BeginTransactionRequest
239
257
  include ::Google::Protobuf::MessageExts
240
258
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -264,6 +282,9 @@ module Google
264
282
  # @return [::String]
265
283
  # Required. The transaction identifier, returned by a call to
266
284
  # {::Google::Cloud::Datastore::V1::Datastore::Client#begin_transaction Datastore.BeginTransaction}.
285
+ # @!attribute [rw] request_options
286
+ # @return [::Google::Cloud::Datastore::V1::RequestOptions]
287
+ # Optional. The options for this request.
267
288
  class RollbackRequest
268
289
  include ::Google::Protobuf::MessageExts
269
290
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -320,6 +341,9 @@ module Google
320
341
  #
321
342
  # When mode is `NON_TRANSACTIONAL`, no two mutations may affect a single
322
343
  # entity.
344
+ # @!attribute [rw] request_options
345
+ # @return [::Google::Cloud::Datastore::V1::RequestOptions]
346
+ # Optional. The options for this request.
323
347
  class CommitRequest
324
348
  include ::Google::Protobuf::MessageExts
325
349
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -371,6 +395,9 @@ module Google
371
395
  # @return [::Array<::Google::Cloud::Datastore::V1::Key>]
372
396
  # Required. A list of keys with incomplete key paths for which to allocate
373
397
  # IDs. No key may be reserved/read-only.
398
+ # @!attribute [rw] request_options
399
+ # @return [::Google::Cloud::Datastore::V1::RequestOptions]
400
+ # Optional. The options for this request.
374
401
  class AllocateIdsRequest
375
402
  include ::Google::Protobuf::MessageExts
376
403
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -402,6 +429,9 @@ module Google
402
429
  # @return [::Array<::Google::Cloud::Datastore::V1::Key>]
403
430
  # Required. A list of keys with complete key paths whose numeric IDs should
404
431
  # not be auto-allocated.
432
+ # @!attribute [rw] request_options
433
+ # @return [::Google::Cloud::Datastore::V1::RequestOptions]
434
+ # Optional. The options for this request.
405
435
  class ReserveIdsRequest
406
436
  include ::Google::Protobuf::MessageExts
407
437
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -751,6 +781,20 @@ module Google
751
781
  extend ::Google::Protobuf::MessageExts::ClassMethods
752
782
  end
753
783
  end
784
+
785
+ # Options for a request.
786
+ # @!attribute [rw] request_tags
787
+ # @return [::Array<::String>]
788
+ # Optional. The request tags for the request.
789
+ # The tags are processed as follows:
790
+ # - Truncated to 510 characters.
791
+ # - Filtered out if empty.
792
+ # - Deduplicated.
793
+ # - Limited to 50 tags.
794
+ class RequestOptions
795
+ include ::Google::Protobuf::MessageExts
796
+ extend ::Google::Protobuf::MessageExts::ClassMethods
797
+ end
754
798
  end
755
799
  end
756
800
  end
@@ -517,8 +517,8 @@ module Google
517
517
  # affect the meaning of the distance threshold. Since DOT_PRODUCT distances
518
518
  # increase when the vectors are more similar, the comparison is inverted.
519
519
  #
520
- # For EUCLIDEAN, COSINE: WHERE distance <= distance_threshold
521
- # For DOT_PRODUCT: WHERE distance >= distance_threshold
520
+ # * For EUCLIDEAN, COSINE: WHERE distance <= distance_threshold
521
+ # * For DOT_PRODUCT: WHERE distance >= distance_threshold
522
522
  class FindNearest
523
523
  include ::Google::Protobuf::MessageExts
524
524
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -21,9 +21,9 @@ module Google
21
21
  module Type
22
22
  # An object that represents a latitude/longitude pair. This is expressed as a
23
23
  # pair of doubles to represent degrees latitude and degrees longitude. Unless
24
- # specified otherwise, this must conform to the
25
- # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
26
- # standard</a>. Values must be within normalized ranges.
24
+ # specified otherwise, this object must conform to the
25
+ # <a href="https://en.wikipedia.org/wiki/World_Geodetic_System#1984_version">
26
+ # WGS84 standard</a>. Values must be within normalized ranges.
27
27
  # @!attribute [rw] latitude
28
28
  # @return [::Float]
29
29
  # The latitude in degrees. It must be in the range [-90.0, +90.0].
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-datastore-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.6.0
4
+ version: 1.8.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
@@ -15,14 +15,14 @@ dependencies:
15
15
  requirements:
16
16
  - - "~>"
17
17
  - !ruby/object:Gem::Version
18
- version: '1.2'
18
+ version: '1.3'
19
19
  type: :runtime
20
20
  prerelease: false
21
21
  version_requirements: !ruby/object:Gem::Requirement
22
22
  requirements:
23
23
  - - "~>"
24
24
  - !ruby/object:Gem::Version
25
- version: '1.2'
25
+ version: '1.3'
26
26
  - !ruby/object:Gem::Dependency
27
27
  name: google-cloud-errors
28
28
  requirement: !ruby/object:Gem::Requirement