google-cloud-retail-v2 1.1.0 → 1.3.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.
Files changed (55) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +31 -21
  3. data/lib/google/cloud/retail/v2/analytics_service/client.rb +36 -2
  4. data/lib/google/cloud/retail/v2/analytics_service/operations.rb +19 -15
  5. data/lib/google/cloud/retail/v2/analytics_service/rest/client.rb +36 -2
  6. data/lib/google/cloud/retail/v2/analytics_service/rest/operations.rb +50 -38
  7. data/lib/google/cloud/retail/v2/analytics_service/rest/service_stub.rb +22 -8
  8. data/lib/google/cloud/retail/v2/catalog_service/client.rb +36 -12
  9. data/lib/google/cloud/retail/v2/catalog_service/rest/client.rb +36 -12
  10. data/lib/google/cloud/retail/v2/catalog_service/rest/service_stub.rb +102 -68
  11. data/lib/google/cloud/retail/v2/completion_service/client.rb +36 -3
  12. data/lib/google/cloud/retail/v2/completion_service/operations.rb +19 -15
  13. data/lib/google/cloud/retail/v2/completion_service/rest/client.rb +36 -3
  14. data/lib/google/cloud/retail/v2/completion_service/rest/operations.rb +50 -38
  15. data/lib/google/cloud/retail/v2/completion_service/rest/service_stub.rb +30 -14
  16. data/lib/google/cloud/retail/v2/control_service/client.rb +36 -6
  17. data/lib/google/cloud/retail/v2/control_service/rest/client.rb +36 -6
  18. data/lib/google/cloud/retail/v2/control_service/rest/service_stub.rb +54 -32
  19. data/lib/google/cloud/retail/v2/generative_question_service/client.rb +35 -6
  20. data/lib/google/cloud/retail/v2/generative_question_service/rest/client.rb +35 -6
  21. data/lib/google/cloud/retail/v2/generative_question_service/rest/service_stub.rb +54 -32
  22. data/lib/google/cloud/retail/v2/model_service/client.rb +38 -9
  23. data/lib/google/cloud/retail/v2/model_service/operations.rb +19 -15
  24. data/lib/google/cloud/retail/v2/model_service/rest/client.rb +38 -9
  25. data/lib/google/cloud/retail/v2/model_service/rest/operations.rb +50 -38
  26. data/lib/google/cloud/retail/v2/model_service/rest/service_stub.rb +78 -50
  27. data/lib/google/cloud/retail/v2/prediction_service/client.rb +35 -2
  28. data/lib/google/cloud/retail/v2/prediction_service/rest/client.rb +35 -2
  29. data/lib/google/cloud/retail/v2/prediction_service/rest/service_stub.rb +22 -8
  30. data/lib/google/cloud/retail/v2/product_service/client.rb +43 -13
  31. data/lib/google/cloud/retail/v2/product_service/operations.rb +19 -15
  32. data/lib/google/cloud/retail/v2/product_service/rest/client.rb +43 -13
  33. data/lib/google/cloud/retail/v2/product_service/rest/operations.rb +50 -38
  34. data/lib/google/cloud/retail/v2/product_service/rest/service_stub.rb +110 -74
  35. data/lib/google/cloud/retail/v2/search_service/client.rb +36 -2
  36. data/lib/google/cloud/retail/v2/search_service/rest/client.rb +35 -2
  37. data/lib/google/cloud/retail/v2/search_service/rest/service_stub.rb +22 -8
  38. data/lib/google/cloud/retail/v2/serving_config_service/client.rb +36 -8
  39. data/lib/google/cloud/retail/v2/serving_config_service/rest/client.rb +36 -8
  40. data/lib/google/cloud/retail/v2/serving_config_service/rest/service_stub.rb +70 -44
  41. data/lib/google/cloud/retail/v2/user_event_service/client.rb +38 -6
  42. data/lib/google/cloud/retail/v2/user_event_service/operations.rb +19 -15
  43. data/lib/google/cloud/retail/v2/user_event_service/rest/client.rb +38 -6
  44. data/lib/google/cloud/retail/v2/user_event_service/rest/operations.rb +50 -38
  45. data/lib/google/cloud/retail/v2/user_event_service/rest/service_stub.rb +54 -32
  46. data/lib/google/cloud/retail/v2/version.rb +1 -1
  47. data/proto_docs/google/api/client.rb +39 -0
  48. data/proto_docs/google/cloud/retail/v2/common.rb +28 -0
  49. data/proto_docs/google/cloud/retail/v2/export_config.rb +4 -0
  50. data/proto_docs/google/cloud/retail/v2/import_config.rb +12 -0
  51. data/proto_docs/google/cloud/retail/v2/product.rb +4 -0
  52. data/proto_docs/google/cloud/retail/v2/search_service.rb +12 -0
  53. data/proto_docs/google/longrunning/operations.rb +23 -14
  54. data/proto_docs/google/protobuf/struct.rb +12 -0
  55. metadata +6 -9
@@ -176,14 +176,26 @@ module Google
176
176
  universe_domain: @config.universe_domain,
177
177
  channel_args: @config.channel_args,
178
178
  interceptors: @config.interceptors,
179
- channel_pool_config: @config.channel_pool
179
+ channel_pool_config: @config.channel_pool,
180
+ logger: @config.logger
180
181
  )
181
182
 
183
+ @product_service_stub.stub_logger&.info do |entry|
184
+ entry.set_system_name
185
+ entry.set_service
186
+ entry.message = "Created client for #{entry.service}"
187
+ entry.set_credentials_fields credentials
188
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
189
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
190
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
191
+ end
192
+
182
193
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
183
194
  config.credentials = credentials
184
195
  config.quota_project = @quota_project_id
185
196
  config.endpoint = @product_service_stub.endpoint
186
197
  config.universe_domain = @product_service_stub.universe_domain
198
+ config.logger = @product_service_stub.logger if config.respond_to? :logger=
187
199
  end
188
200
  end
189
201
 
@@ -201,6 +213,15 @@ module Google
201
213
  #
202
214
  attr_reader :location_client
203
215
 
216
+ ##
217
+ # The logger used for request/response debug logging.
218
+ #
219
+ # @return [Logger]
220
+ #
221
+ def logger
222
+ @product_service_stub.logger
223
+ end
224
+
204
225
  # Service calls
205
226
 
206
227
  ##
@@ -302,7 +323,6 @@ module Google
302
323
 
303
324
  @product_service_stub.call_rpc :create_product, request, options: options do |response, operation|
304
325
  yield response, operation if block_given?
305
- return response
306
326
  end
307
327
  rescue ::GRPC::BadStatus => e
308
328
  raise ::Google::Cloud::Error.from_error(e)
@@ -397,7 +417,6 @@ module Google
397
417
 
398
418
  @product_service_stub.call_rpc :get_product, request, options: options do |response, operation|
399
419
  yield response, operation if block_given?
400
- return response
401
420
  end
402
421
  rescue ::GRPC::BadStatus => e
403
422
  raise ::Google::Cloud::Error.from_error(e)
@@ -559,7 +578,7 @@ module Google
559
578
  @product_service_stub.call_rpc :list_products, request, options: options do |response, operation|
560
579
  response = ::Gapic::PagedEnumerable.new @product_service_stub, :list_products, request, response, operation, options
561
580
  yield response, operation if block_given?
562
- return response
581
+ throw :response, response
563
582
  end
564
583
  rescue ::GRPC::BadStatus => e
565
584
  raise ::Google::Cloud::Error.from_error(e)
@@ -671,7 +690,6 @@ module Google
671
690
 
672
691
  @product_service_stub.call_rpc :update_product, request, options: options do |response, operation|
673
692
  yield response, operation if block_given?
674
- return response
675
693
  end
676
694
  rescue ::GRPC::BadStatus => e
677
695
  raise ::Google::Cloud::Error.from_error(e)
@@ -777,7 +795,6 @@ module Google
777
795
 
778
796
  @product_service_stub.call_rpc :delete_product, request, options: options do |response, operation|
779
797
  yield response, operation if block_given?
780
- return response
781
798
  end
782
799
  rescue ::GRPC::BadStatus => e
783
800
  raise ::Google::Cloud::Error.from_error(e)
@@ -933,7 +950,7 @@ module Google
933
950
  @product_service_stub.call_rpc :purge_products, request, options: options do |response, operation|
934
951
  response = ::Gapic::Operation.new response, @operations_client, options: options
935
952
  yield response, operation if block_given?
936
- return response
953
+ throw :response, response
937
954
  end
938
955
  rescue ::GRPC::BadStatus => e
939
956
  raise ::Google::Cloud::Error.from_error(e)
@@ -1068,7 +1085,7 @@ module Google
1068
1085
  @product_service_stub.call_rpc :import_products, request, options: options do |response, operation|
1069
1086
  response = ::Gapic::Operation.new response, @operations_client, options: options
1070
1087
  yield response, operation if block_given?
1071
- return response
1088
+ throw :response, response
1072
1089
  end
1073
1090
  rescue ::GRPC::BadStatus => e
1074
1091
  raise ::Google::Cloud::Error.from_error(e)
@@ -1286,7 +1303,7 @@ module Google
1286
1303
  @product_service_stub.call_rpc :set_inventory, request, options: options do |response, operation|
1287
1304
  response = ::Gapic::Operation.new response, @operations_client, options: options
1288
1305
  yield response, operation if block_given?
1289
- return response
1306
+ throw :response, response
1290
1307
  end
1291
1308
  rescue ::GRPC::BadStatus => e
1292
1309
  raise ::Google::Cloud::Error.from_error(e)
@@ -1463,7 +1480,7 @@ module Google
1463
1480
  @product_service_stub.call_rpc :add_fulfillment_places, request, options: options do |response, operation|
1464
1481
  response = ::Gapic::Operation.new response, @operations_client, options: options
1465
1482
  yield response, operation if block_given?
1466
- return response
1483
+ throw :response, response
1467
1484
  end
1468
1485
  rescue ::GRPC::BadStatus => e
1469
1486
  raise ::Google::Cloud::Error.from_error(e)
@@ -1635,7 +1652,7 @@ module Google
1635
1652
  @product_service_stub.call_rpc :remove_fulfillment_places, request, options: options do |response, operation|
1636
1653
  response = ::Gapic::Operation.new response, @operations_client, options: options
1637
1654
  yield response, operation if block_given?
1638
- return response
1655
+ throw :response, response
1639
1656
  end
1640
1657
  rescue ::GRPC::BadStatus => e
1641
1658
  raise ::Google::Cloud::Error.from_error(e)
@@ -1792,7 +1809,7 @@ module Google
1792
1809
  @product_service_stub.call_rpc :add_local_inventories, request, options: options do |response, operation|
1793
1810
  response = ::Gapic::Operation.new response, @operations_client, options: options
1794
1811
  yield response, operation if block_given?
1795
- return response
1812
+ throw :response, response
1796
1813
  end
1797
1814
  rescue ::GRPC::BadStatus => e
1798
1815
  raise ::Google::Cloud::Error.from_error(e)
@@ -1931,7 +1948,7 @@ module Google
1931
1948
  @product_service_stub.call_rpc :remove_local_inventories, request, options: options do |response, operation|
1932
1949
  response = ::Gapic::Operation.new response, @operations_client, options: options
1933
1950
  yield response, operation if block_given?
1934
- return response
1951
+ throw :response, response
1935
1952
  end
1936
1953
  rescue ::GRPC::BadStatus => e
1937
1954
  raise ::Google::Cloud::Error.from_error(e)
@@ -1981,6 +1998,13 @@ module Google
1981
1998
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1982
1999
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1983
2000
  # * (`nil`) indicating no credentials
2001
+ #
2002
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
2003
+ # external source for authentication to Google Cloud, you must validate it before
2004
+ # providing it to a Google API client library. Providing an unvalidated credential
2005
+ # configuration to Google APIs can compromise the security of your systems and data.
2006
+ # For more information, refer to [Validate credential configurations from external
2007
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
1984
2008
  # @return [::Object]
1985
2009
  # @!attribute [rw] scope
1986
2010
  # The OAuth scopes
@@ -2020,6 +2044,11 @@ module Google
2020
2044
  # default endpoint URL. The default value of nil uses the environment
2021
2045
  # universe (usually the default "googleapis.com" universe).
2022
2046
  # @return [::String,nil]
2047
+ # @!attribute [rw] logger
2048
+ # A custom logger to use for request/response debug logging, or the value
2049
+ # `:default` (the default) to construct a default logger, or `nil` to
2050
+ # explicitly disable logging.
2051
+ # @return [::Logger,:default,nil]
2023
2052
  #
2024
2053
  class Configuration
2025
2054
  extend ::Gapic::Config
@@ -2044,6 +2073,7 @@ module Google
2044
2073
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
2045
2074
  config_attr :quota_project, nil, ::String, nil
2046
2075
  config_attr :universe_domain, nil, ::String, nil
2076
+ config_attr :logger, :default, ::Logger, nil, :default
2047
2077
 
2048
2078
  # @private
2049
2079
  def initialize parent_config = nil
@@ -124,14 +124,6 @@ module Google
124
124
  # Lists operations that match the specified filter in the request. If the
125
125
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
126
126
  #
127
- # NOTE: the `name` binding allows API services to override the binding
128
- # to use different resource name schemes, such as `users/*/operations`. To
129
- # override the binding, API services can add a binding such as
130
- # `"/v1/{name=users/*}/operations"` to their service configuration.
131
- # For backwards compatibility, the default name includes the operations
132
- # collection id, however overriding users must ensure the name binding
133
- # is the parent resource, without the operations collection id.
134
- #
135
127
  # @overload list_operations(request, options = nil)
136
128
  # Pass arguments to `list_operations` via a request object, either of type
137
129
  # {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -221,7 +213,7 @@ module Google
221
213
  wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
222
214
  response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
223
215
  yield response, operation if block_given?
224
- return response
216
+ throw :response, response
225
217
  end
226
218
  rescue ::GRPC::BadStatus => e
227
219
  raise ::Google::Cloud::Error.from_error(e)
@@ -317,7 +309,7 @@ module Google
317
309
  @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
318
310
  response = ::Gapic::Operation.new response, @operations_client, options: options
319
311
  yield response, operation if block_given?
320
- return response
312
+ throw :response, response
321
313
  end
322
314
  rescue ::GRPC::BadStatus => e
323
315
  raise ::Google::Cloud::Error.from_error(e)
@@ -406,7 +398,6 @@ module Google
406
398
 
407
399
  @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
408
400
  yield response, operation if block_given?
409
- return response
410
401
  end
411
402
  rescue ::GRPC::BadStatus => e
412
403
  raise ::Google::Cloud::Error.from_error(e)
@@ -421,8 +412,9 @@ module Google
421
412
  # other methods to check whether the cancellation succeeded or whether the
422
413
  # operation completed despite cancellation. On successful cancellation,
423
414
  # the operation is not deleted; instead, it becomes an operation with
424
- # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
425
- # corresponding to `Code.CANCELLED`.
415
+ # an {::Google::Longrunning::Operation#error Operation.error} value with a
416
+ # {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
417
+ # `Code.CANCELLED`.
426
418
  #
427
419
  # @overload cancel_operation(request, options = nil)
428
420
  # Pass arguments to `cancel_operation` via a request object, either of type
@@ -501,7 +493,6 @@ module Google
501
493
 
502
494
  @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
503
495
  yield response, operation if block_given?
504
- return response
505
496
  end
506
497
  rescue ::GRPC::BadStatus => e
507
498
  raise ::Google::Cloud::Error.from_error(e)
@@ -599,7 +590,7 @@ module Google
599
590
  @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
600
591
  response = ::Gapic::Operation.new response, @operations_client, options: options
601
592
  yield response, operation if block_given?
602
- return response
593
+ throw :response, response
603
594
  end
604
595
  rescue ::GRPC::BadStatus => e
605
596
  raise ::Google::Cloud::Error.from_error(e)
@@ -649,6 +640,13 @@ module Google
649
640
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
650
641
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
651
642
  # * (`nil`) indicating no credentials
643
+ #
644
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
645
+ # external source for authentication to Google Cloud, you must validate it before
646
+ # providing it to a Google API client library. Providing an unvalidated credential
647
+ # configuration to Google APIs can compromise the security of your systems and data.
648
+ # For more information, refer to [Validate credential configurations from external
649
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
652
650
  # @return [::Object]
653
651
  # @!attribute [rw] scope
654
652
  # The OAuth scopes
@@ -688,6 +686,11 @@ module Google
688
686
  # default endpoint URL. The default value of nil uses the environment
689
687
  # universe (usually the default "googleapis.com" universe).
690
688
  # @return [::String,nil]
689
+ # @!attribute [rw] logger
690
+ # A custom logger to use for request/response debug logging, or the value
691
+ # `:default` (the default) to construct a default logger, or `nil` to
692
+ # explicitly disable logging.
693
+ # @return [::Logger,:default,nil]
691
694
  #
692
695
  class Configuration
693
696
  extend ::Gapic::Config
@@ -712,6 +715,7 @@ module Google
712
715
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
713
716
  config_attr :quota_project, nil, ::String, nil
714
717
  config_attr :universe_domain, nil, ::String, nil
718
+ config_attr :logger, :default, ::Logger, nil, :default
715
719
 
716
720
  # @private
717
721
  def initialize parent_config = nil
@@ -169,14 +169,26 @@ module Google
169
169
  endpoint: @config.endpoint,
170
170
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
171
171
  universe_domain: @config.universe_domain,
172
- credentials: credentials
172
+ credentials: credentials,
173
+ logger: @config.logger
173
174
  )
174
175
 
176
+ @product_service_stub.logger(stub: true)&.info do |entry|
177
+ entry.set_system_name
178
+ entry.set_service
179
+ entry.message = "Created client for #{entry.service}"
180
+ entry.set_credentials_fields credentials
181
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
182
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
183
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
184
+ end
185
+
175
186
  @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
176
187
  config.credentials = credentials
177
188
  config.quota_project = @quota_project_id
178
189
  config.endpoint = @product_service_stub.endpoint
179
190
  config.universe_domain = @product_service_stub.universe_domain
191
+ config.logger = @product_service_stub.logger if config.respond_to? :logger=
180
192
  end
181
193
  end
182
194
 
@@ -194,6 +206,15 @@ module Google
194
206
  #
195
207
  attr_reader :location_client
196
208
 
209
+ ##
210
+ # The logger used for request/response debug logging.
211
+ #
212
+ # @return [Logger]
213
+ #
214
+ def logger
215
+ @product_service_stub.logger
216
+ end
217
+
197
218
  # Service calls
198
219
 
199
220
  ##
@@ -288,7 +309,6 @@ module Google
288
309
 
289
310
  @product_service_stub.create_product request, options do |result, operation|
290
311
  yield result, operation if block_given?
291
- return result
292
312
  end
293
313
  rescue ::Gapic::Rest::Error => e
294
314
  raise ::Google::Cloud::Error.from_error(e)
@@ -376,7 +396,6 @@ module Google
376
396
 
377
397
  @product_service_stub.get_product request, options do |result, operation|
378
398
  yield result, operation if block_given?
379
- return result
380
399
  end
381
400
  rescue ::Gapic::Rest::Error => e
382
401
  raise ::Google::Cloud::Error.from_error(e)
@@ -531,7 +550,7 @@ module Google
531
550
  @product_service_stub.list_products request, options do |result, operation|
532
551
  result = ::Gapic::Rest::PagedEnumerable.new @product_service_stub, :list_products, "products", request, result, options
533
552
  yield result, operation if block_given?
534
- return result
553
+ throw :response, result
535
554
  end
536
555
  rescue ::Gapic::Rest::Error => e
537
556
  raise ::Google::Cloud::Error.from_error(e)
@@ -636,7 +655,6 @@ module Google
636
655
 
637
656
  @product_service_stub.update_product request, options do |result, operation|
638
657
  yield result, operation if block_given?
639
- return result
640
658
  end
641
659
  rescue ::Gapic::Rest::Error => e
642
660
  raise ::Google::Cloud::Error.from_error(e)
@@ -735,7 +753,6 @@ module Google
735
753
 
736
754
  @product_service_stub.delete_product request, options do |result, operation|
737
755
  yield result, operation if block_given?
738
- return result
739
756
  end
740
757
  rescue ::Gapic::Rest::Error => e
741
758
  raise ::Google::Cloud::Error.from_error(e)
@@ -884,7 +901,7 @@ module Google
884
901
  @product_service_stub.purge_products request, options do |result, operation|
885
902
  result = ::Gapic::Operation.new result, @operations_client, options: options
886
903
  yield result, operation if block_given?
887
- return result
904
+ throw :response, result
888
905
  end
889
906
  rescue ::Gapic::Rest::Error => e
890
907
  raise ::Google::Cloud::Error.from_error(e)
@@ -1012,7 +1029,7 @@ module Google
1012
1029
  @product_service_stub.import_products request, options do |result, operation|
1013
1030
  result = ::Gapic::Operation.new result, @operations_client, options: options
1014
1031
  yield result, operation if block_given?
1015
- return result
1032
+ throw :response, result
1016
1033
  end
1017
1034
  rescue ::Gapic::Rest::Error => e
1018
1035
  raise ::Google::Cloud::Error.from_error(e)
@@ -1223,7 +1240,7 @@ module Google
1223
1240
  @product_service_stub.set_inventory request, options do |result, operation|
1224
1241
  result = ::Gapic::Operation.new result, @operations_client, options: options
1225
1242
  yield result, operation if block_given?
1226
- return result
1243
+ throw :response, result
1227
1244
  end
1228
1245
  rescue ::Gapic::Rest::Error => e
1229
1246
  raise ::Google::Cloud::Error.from_error(e)
@@ -1393,7 +1410,7 @@ module Google
1393
1410
  @product_service_stub.add_fulfillment_places request, options do |result, operation|
1394
1411
  result = ::Gapic::Operation.new result, @operations_client, options: options
1395
1412
  yield result, operation if block_given?
1396
- return result
1413
+ throw :response, result
1397
1414
  end
1398
1415
  rescue ::Gapic::Rest::Error => e
1399
1416
  raise ::Google::Cloud::Error.from_error(e)
@@ -1558,7 +1575,7 @@ module Google
1558
1575
  @product_service_stub.remove_fulfillment_places request, options do |result, operation|
1559
1576
  result = ::Gapic::Operation.new result, @operations_client, options: options
1560
1577
  yield result, operation if block_given?
1561
- return result
1578
+ throw :response, result
1562
1579
  end
1563
1580
  rescue ::Gapic::Rest::Error => e
1564
1581
  raise ::Google::Cloud::Error.from_error(e)
@@ -1708,7 +1725,7 @@ module Google
1708
1725
  @product_service_stub.add_local_inventories request, options do |result, operation|
1709
1726
  result = ::Gapic::Operation.new result, @operations_client, options: options
1710
1727
  yield result, operation if block_given?
1711
- return result
1728
+ throw :response, result
1712
1729
  end
1713
1730
  rescue ::Gapic::Rest::Error => e
1714
1731
  raise ::Google::Cloud::Error.from_error(e)
@@ -1840,7 +1857,7 @@ module Google
1840
1857
  @product_service_stub.remove_local_inventories request, options do |result, operation|
1841
1858
  result = ::Gapic::Operation.new result, @operations_client, options: options
1842
1859
  yield result, operation if block_given?
1843
- return result
1860
+ throw :response, result
1844
1861
  end
1845
1862
  rescue ::Gapic::Rest::Error => e
1846
1863
  raise ::Google::Cloud::Error.from_error(e)
@@ -1888,6 +1905,13 @@ module Google
1888
1905
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1889
1906
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1890
1907
  # * (`nil`) indicating no credentials
1908
+ #
1909
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
1910
+ # external source for authentication to Google Cloud, you must validate it before
1911
+ # providing it to a Google API client library. Providing an unvalidated credential
1912
+ # configuration to Google APIs can compromise the security of your systems and data.
1913
+ # For more information, refer to [Validate credential configurations from external
1914
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
1891
1915
  # @return [::Object]
1892
1916
  # @!attribute [rw] scope
1893
1917
  # The OAuth scopes
@@ -1920,6 +1944,11 @@ module Google
1920
1944
  # default endpoint URL. The default value of nil uses the environment
1921
1945
  # universe (usually the default "googleapis.com" universe).
1922
1946
  # @return [::String,nil]
1947
+ # @!attribute [rw] logger
1948
+ # A custom logger to use for request/response debug logging, or the value
1949
+ # `:default` (the default) to construct a default logger, or `nil` to
1950
+ # explicitly disable logging.
1951
+ # @return [::Logger,:default,nil]
1923
1952
  #
1924
1953
  class Configuration
1925
1954
  extend ::Gapic::Config
@@ -1941,6 +1970,7 @@ module Google
1941
1970
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1942
1971
  config_attr :quota_project, nil, ::String, nil
1943
1972
  config_attr :universe_domain, nil, ::String, nil
1973
+ config_attr :logger, :default, ::Logger, nil, :default
1944
1974
 
1945
1975
  # @private
1946
1976
  def initialize parent_config = nil
@@ -115,14 +115,6 @@ module Google
115
115
  # Lists operations that match the specified filter in the request. If the
116
116
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
117
117
  #
118
- # NOTE: the `name` binding allows API services to override the binding
119
- # to use different resource name schemes, such as `users/*/operations`. To
120
- # override the binding, API services can add a binding such as
121
- # `"/v1/{name=users/*}/operations"` to their service configuration.
122
- # For backwards compatibility, the default name includes the operations
123
- # collection id, however overriding users must ensure the name binding
124
- # is the parent resource, without the operations collection id.
125
- #
126
118
  # @overload list_operations(request, options = nil)
127
119
  # Pass arguments to `list_operations` via a request object, either of type
128
120
  # {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -204,7 +196,7 @@ module Google
204
196
  @operations_stub.list_operations request, options do |result, operation|
205
197
  result = ::Gapic::Rest::PagedEnumerable.new @operations_stub, :list_operations, "operations", request, result, options
206
198
  yield result, operation if block_given?
207
- return result
199
+ throw :response, result
208
200
  end
209
201
  rescue ::Gapic::Rest::Error => e
210
202
  raise ::Google::Cloud::Error.from_error(e)
@@ -293,7 +285,7 @@ module Google
293
285
  @operations_stub.get_operation request, options do |result, operation|
294
286
  result = ::Gapic::Operation.new result, @operations_client, options: options
295
287
  yield result, operation if block_given?
296
- return result
288
+ throw :response, result
297
289
  end
298
290
  rescue ::Gapic::Rest::Error => e
299
291
  raise ::Google::Cloud::Error.from_error(e)
@@ -375,7 +367,6 @@ module Google
375
367
 
376
368
  @operations_stub.delete_operation request, options do |result, operation|
377
369
  yield result, operation if block_given?
378
- return result
379
370
  end
380
371
  rescue ::Gapic::Rest::Error => e
381
372
  raise ::Google::Cloud::Error.from_error(e)
@@ -390,8 +381,9 @@ module Google
390
381
  # other methods to check whether the cancellation succeeded or whether the
391
382
  # operation completed despite cancellation. On successful cancellation,
392
383
  # the operation is not deleted; instead, it becomes an operation with
393
- # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
394
- # corresponding to `Code.CANCELLED`.
384
+ # an {::Google::Longrunning::Operation#error Operation.error} value with a
385
+ # {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
386
+ # `Code.CANCELLED`.
395
387
  #
396
388
  # @overload cancel_operation(request, options = nil)
397
389
  # Pass arguments to `cancel_operation` via a request object, either of type
@@ -463,7 +455,6 @@ module Google
463
455
 
464
456
  @operations_stub.cancel_operation request, options do |result, operation|
465
457
  yield result, operation if block_given?
466
- return result
467
458
  end
468
459
  rescue ::Gapic::Rest::Error => e
469
460
  raise ::Google::Cloud::Error.from_error(e)
@@ -511,6 +502,13 @@ module Google
511
502
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
512
503
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
513
504
  # * (`nil`) indicating no credentials
505
+ #
506
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
507
+ # external source for authentication to Google Cloud, you must validate it before
508
+ # providing it to a Google API client library. Providing an unvalidated credential
509
+ # configuration to Google APIs can compromise the security of your systems and data.
510
+ # For more information, refer to [Validate credential configurations from external
511
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
514
512
  # @return [::Object]
515
513
  # @!attribute [rw] scope
516
514
  # The OAuth scopes
@@ -543,6 +541,11 @@ module Google
543
541
  # default endpoint URL. The default value of nil uses the environment
544
542
  # universe (usually the default "googleapis.com" universe).
545
543
  # @return [::String,nil]
544
+ # @!attribute [rw] logger
545
+ # A custom logger to use for request/response debug logging, or the value
546
+ # `:default` (the default) to construct a default logger, or `nil` to
547
+ # explicitly disable logging.
548
+ # @return [::Logger,:default,nil]
546
549
  #
547
550
  class Configuration
548
551
  extend ::Gapic::Config
@@ -564,6 +567,7 @@ module Google
564
567
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
565
568
  config_attr :quota_project, nil, ::String, nil
566
569
  config_attr :universe_domain, nil, ::String, nil
570
+ config_attr :logger, :default, ::Logger, nil, :default
567
571
 
568
572
  # @private
569
573
  def initialize parent_config = nil
@@ -683,16 +687,18 @@ module Google
683
687
 
684
688
  response = @client_stub.make_http_request(
685
689
  verb,
686
- uri: uri,
687
- body: body || "",
688
- params: query_string_params,
690
+ uri: uri,
691
+ body: body || "",
692
+ params: query_string_params,
693
+ method_name: "list_operations",
689
694
  options: options
690
695
  )
691
696
  operation = ::Gapic::Rest::TransportOperation.new response
692
697
  result = ::Google::Longrunning::ListOperationsResponse.decode_json response.body, ignore_unknown_fields: true
693
-
694
- yield result, operation if block_given?
695
- result
698
+ catch :response do
699
+ yield result, operation if block_given?
700
+ result
701
+ end
696
702
  end
697
703
 
698
704
  ##
@@ -721,16 +727,18 @@ module Google
721
727
 
722
728
  response = @client_stub.make_http_request(
723
729
  verb,
724
- uri: uri,
725
- body: body || "",
726
- params: query_string_params,
730
+ uri: uri,
731
+ body: body || "",
732
+ params: query_string_params,
733
+ method_name: "get_operation",
727
734
  options: options
728
735
  )
729
736
  operation = ::Gapic::Rest::TransportOperation.new response
730
737
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
731
-
732
- yield result, operation if block_given?
733
- result
738
+ catch :response do
739
+ yield result, operation if block_given?
740
+ result
741
+ end
734
742
  end
735
743
 
736
744
  ##
@@ -759,16 +767,18 @@ module Google
759
767
 
760
768
  response = @client_stub.make_http_request(
761
769
  verb,
762
- uri: uri,
763
- body: body || "",
764
- params: query_string_params,
770
+ uri: uri,
771
+ body: body || "",
772
+ params: query_string_params,
773
+ method_name: "delete_operation",
765
774
  options: options
766
775
  )
767
776
  operation = ::Gapic::Rest::TransportOperation.new response
768
777
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
769
-
770
- yield result, operation if block_given?
771
- result
778
+ catch :response do
779
+ yield result, operation if block_given?
780
+ result
781
+ end
772
782
  end
773
783
 
774
784
  ##
@@ -797,16 +807,18 @@ module Google
797
807
 
798
808
  response = @client_stub.make_http_request(
799
809
  verb,
800
- uri: uri,
801
- body: body || "",
802
- params: query_string_params,
810
+ uri: uri,
811
+ body: body || "",
812
+ params: query_string_params,
813
+ method_name: "cancel_operation",
803
814
  options: options
804
815
  )
805
816
  operation = ::Gapic::Rest::TransportOperation.new response
806
817
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
807
-
808
- yield result, operation if block_given?
809
- result
818
+ catch :response do
819
+ yield result, operation if block_given?
820
+ result
821
+ end
810
822
  end
811
823
 
812
824
  ##