google-cloud-translate-v3 1.2.0 → 1.4.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.
@@ -191,15 +191,27 @@ module Google
191
191
  endpoint: @config.endpoint,
192
192
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
193
193
  universe_domain: @config.universe_domain,
194
- credentials: credentials
194
+ credentials: credentials,
195
+ logger: @config.logger
195
196
  )
196
197
 
198
+ @translation_service_stub.logger(stub: true)&.info do |entry|
199
+ entry.set_system_name
200
+ entry.set_service
201
+ entry.message = "Created client for #{entry.service}"
202
+ entry.set_credentials_fields credentials
203
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
204
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
205
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
206
+ end
207
+
197
208
  @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
198
209
  config.credentials = credentials
199
210
  config.quota_project = @quota_project_id
200
211
  config.endpoint = @translation_service_stub.endpoint
201
212
  config.universe_domain = @translation_service_stub.universe_domain
202
213
  config.bindings_override = @config.bindings_override
214
+ config.logger = @translation_service_stub.logger if config.respond_to? :logger=
203
215
  end
204
216
 
205
217
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Rest::Client.new do |config|
@@ -207,6 +219,7 @@ module Google
207
219
  config.quota_project = @quota_project_id
208
220
  config.endpoint = @translation_service_stub.endpoint
209
221
  config.universe_domain = @translation_service_stub.universe_domain
222
+ config.logger = @translation_service_stub.logger if config.respond_to? :logger=
210
223
  end
211
224
  end
212
225
 
@@ -231,6 +244,15 @@ module Google
231
244
  #
232
245
  attr_reader :iam_policy_client
233
246
 
247
+ ##
248
+ # The logger used for request/response debug logging.
249
+ #
250
+ # @return [Logger]
251
+ #
252
+ def logger
253
+ @translation_service_stub.logger
254
+ end
255
+
234
256
  # Service calls
235
257
 
236
258
  ##
@@ -370,7 +392,6 @@ module Google
370
392
 
371
393
  @translation_service_stub.translate_text request, options do |result, operation|
372
394
  yield result, operation if block_given?
373
- return result
374
395
  end
375
396
  rescue ::Gapic::Rest::Error => e
376
397
  raise ::Google::Cloud::Error.from_error(e)
@@ -463,7 +484,6 @@ module Google
463
484
 
464
485
  @translation_service_stub.romanize_text request, options do |result, operation|
465
486
  yield result, operation if block_given?
466
- return result
467
487
  end
468
488
  rescue ::Gapic::Rest::Error => e
469
489
  raise ::Google::Cloud::Error.from_error(e)
@@ -577,7 +597,6 @@ module Google
577
597
 
578
598
  @translation_service_stub.detect_language request, options do |result, operation|
579
599
  yield result, operation if block_given?
580
- return result
581
600
  end
582
601
  rescue ::Gapic::Rest::Error => e
583
602
  raise ::Google::Cloud::Error.from_error(e)
@@ -686,7 +705,6 @@ module Google
686
705
 
687
706
  @translation_service_stub.get_supported_languages request, options do |result, operation|
688
707
  yield result, operation if block_given?
689
- return result
690
708
  end
691
709
  rescue ::Gapic::Rest::Error => e
692
710
  raise ::Google::Cloud::Error.from_error(e)
@@ -838,7 +856,6 @@ module Google
838
856
 
839
857
  @translation_service_stub.translate_document request, options do |result, operation|
840
858
  yield result, operation if block_given?
841
- return result
842
859
  end
843
860
  rescue ::Gapic::Rest::Error => e
844
861
  raise ::Google::Cloud::Error.from_error(e)
@@ -981,7 +998,7 @@ module Google
981
998
  @translation_service_stub.batch_translate_text request, options do |result, operation|
982
999
  result = ::Gapic::Operation.new result, @operations_client, options: options
983
1000
  yield result, operation if block_given?
984
- return result
1001
+ throw :response, result
985
1002
  end
986
1003
  rescue ::Gapic::Rest::Error => e
987
1004
  raise ::Google::Cloud::Error.from_error(e)
@@ -1139,7 +1156,7 @@ module Google
1139
1156
  @translation_service_stub.batch_translate_document request, options do |result, operation|
1140
1157
  result = ::Gapic::Operation.new result, @operations_client, options: options
1141
1158
  yield result, operation if block_given?
1142
- return result
1159
+ throw :response, result
1143
1160
  end
1144
1161
  rescue ::Gapic::Rest::Error => e
1145
1162
  raise ::Google::Cloud::Error.from_error(e)
@@ -1229,7 +1246,7 @@ module Google
1229
1246
  @translation_service_stub.create_glossary request, options do |result, operation|
1230
1247
  result = ::Gapic::Operation.new result, @operations_client, options: options
1231
1248
  yield result, operation if block_given?
1232
- return result
1249
+ throw :response, result
1233
1250
  end
1234
1251
  rescue ::Gapic::Rest::Error => e
1235
1252
  raise ::Google::Cloud::Error.from_error(e)
@@ -1320,7 +1337,7 @@ module Google
1320
1337
  @translation_service_stub.update_glossary request, options do |result, operation|
1321
1338
  result = ::Gapic::Operation.new result, @operations_client, options: options
1322
1339
  yield result, operation if block_given?
1323
- return result
1340
+ throw :response, result
1324
1341
  end
1325
1342
  rescue ::Gapic::Rest::Error => e
1326
1343
  raise ::Google::Cloud::Error.from_error(e)
@@ -1430,7 +1447,7 @@ module Google
1430
1447
  @translation_service_stub.list_glossaries request, options do |result, operation|
1431
1448
  result = ::Gapic::Rest::PagedEnumerable.new @translation_service_stub, :list_glossaries, "glossaries", request, result, options
1432
1449
  yield result, operation if block_given?
1433
- return result
1450
+ throw :response, result
1434
1451
  end
1435
1452
  rescue ::Gapic::Rest::Error => e
1436
1453
  raise ::Google::Cloud::Error.from_error(e)
@@ -1510,7 +1527,6 @@ module Google
1510
1527
 
1511
1528
  @translation_service_stub.get_glossary request, options do |result, operation|
1512
1529
  yield result, operation if block_given?
1513
- return result
1514
1530
  end
1515
1531
  rescue ::Gapic::Rest::Error => e
1516
1532
  raise ::Google::Cloud::Error.from_error(e)
@@ -1599,7 +1615,7 @@ module Google
1599
1615
  @translation_service_stub.delete_glossary request, options do |result, operation|
1600
1616
  result = ::Gapic::Operation.new result, @operations_client, options: options
1601
1617
  yield result, operation if block_given?
1602
- return result
1618
+ throw :response, result
1603
1619
  end
1604
1620
  rescue ::Gapic::Rest::Error => e
1605
1621
  raise ::Google::Cloud::Error.from_error(e)
@@ -1678,7 +1694,6 @@ module Google
1678
1694
 
1679
1695
  @translation_service_stub.get_glossary_entry request, options do |result, operation|
1680
1696
  yield result, operation if block_given?
1681
- return result
1682
1697
  end
1683
1698
  rescue ::Gapic::Rest::Error => e
1684
1699
  raise ::Google::Cloud::Error.from_error(e)
@@ -1771,7 +1786,7 @@ module Google
1771
1786
  @translation_service_stub.list_glossary_entries request, options do |result, operation|
1772
1787
  result = ::Gapic::Rest::PagedEnumerable.new @translation_service_stub, :list_glossary_entries, "glossary_entries", request, result, options
1773
1788
  yield result, operation if block_given?
1774
- return result
1789
+ throw :response, result
1775
1790
  end
1776
1791
  rescue ::Gapic::Rest::Error => e
1777
1792
  raise ::Google::Cloud::Error.from_error(e)
@@ -1852,7 +1867,6 @@ module Google
1852
1867
 
1853
1868
  @translation_service_stub.create_glossary_entry request, options do |result, operation|
1854
1869
  yield result, operation if block_given?
1855
- return result
1856
1870
  end
1857
1871
  rescue ::Gapic::Rest::Error => e
1858
1872
  raise ::Google::Cloud::Error.from_error(e)
@@ -1931,7 +1945,6 @@ module Google
1931
1945
 
1932
1946
  @translation_service_stub.update_glossary_entry request, options do |result, operation|
1933
1947
  yield result, operation if block_given?
1934
- return result
1935
1948
  end
1936
1949
  rescue ::Gapic::Rest::Error => e
1937
1950
  raise ::Google::Cloud::Error.from_error(e)
@@ -2010,7 +2023,6 @@ module Google
2010
2023
 
2011
2024
  @translation_service_stub.delete_glossary_entry request, options do |result, operation|
2012
2025
  yield result, operation if block_given?
2013
- return result
2014
2026
  end
2015
2027
  rescue ::Gapic::Rest::Error => e
2016
2028
  raise ::Google::Cloud::Error.from_error(e)
@@ -2099,7 +2111,7 @@ module Google
2099
2111
  @translation_service_stub.create_dataset request, options do |result, operation|
2100
2112
  result = ::Gapic::Operation.new result, @operations_client, options: options
2101
2113
  yield result, operation if block_given?
2102
- return result
2114
+ throw :response, result
2103
2115
  end
2104
2116
  rescue ::Gapic::Rest::Error => e
2105
2117
  raise ::Google::Cloud::Error.from_error(e)
@@ -2178,7 +2190,6 @@ module Google
2178
2190
 
2179
2191
  @translation_service_stub.get_dataset request, options do |result, operation|
2180
2192
  yield result, operation if block_given?
2181
- return result
2182
2193
  end
2183
2194
  rescue ::Gapic::Rest::Error => e
2184
2195
  raise ::Google::Cloud::Error.from_error(e)
@@ -2270,7 +2281,7 @@ module Google
2270
2281
  @translation_service_stub.list_datasets request, options do |result, operation|
2271
2282
  result = ::Gapic::Rest::PagedEnumerable.new @translation_service_stub, :list_datasets, "datasets", request, result, options
2272
2283
  yield result, operation if block_given?
2273
- return result
2284
+ throw :response, result
2274
2285
  end
2275
2286
  rescue ::Gapic::Rest::Error => e
2276
2287
  raise ::Google::Cloud::Error.from_error(e)
@@ -2357,7 +2368,7 @@ module Google
2357
2368
  @translation_service_stub.delete_dataset request, options do |result, operation|
2358
2369
  result = ::Gapic::Operation.new result, @operations_client, options: options
2359
2370
  yield result, operation if block_given?
2360
- return result
2371
+ throw :response, result
2361
2372
  end
2362
2373
  rescue ::Gapic::Rest::Error => e
2363
2374
  raise ::Google::Cloud::Error.from_error(e)
@@ -2439,7 +2450,6 @@ module Google
2439
2450
 
2440
2451
  @translation_service_stub.create_adaptive_mt_dataset request, options do |result, operation|
2441
2452
  yield result, operation if block_given?
2442
- return result
2443
2453
  end
2444
2454
  rescue ::Gapic::Rest::Error => e
2445
2455
  raise ::Google::Cloud::Error.from_error(e)
@@ -2520,7 +2530,6 @@ module Google
2520
2530
 
2521
2531
  @translation_service_stub.delete_adaptive_mt_dataset request, options do |result, operation|
2522
2532
  yield result, operation if block_given?
2523
- return result
2524
2533
  end
2525
2534
  rescue ::Gapic::Rest::Error => e
2526
2535
  raise ::Google::Cloud::Error.from_error(e)
@@ -2600,7 +2609,6 @@ module Google
2600
2609
 
2601
2610
  @translation_service_stub.get_adaptive_mt_dataset request, options do |result, operation|
2602
2611
  yield result, operation if block_given?
2603
- return result
2604
2612
  end
2605
2613
  rescue ::Gapic::Rest::Error => e
2606
2614
  raise ::Google::Cloud::Error.from_error(e)
@@ -2697,7 +2705,7 @@ module Google
2697
2705
  @translation_service_stub.list_adaptive_mt_datasets request, options do |result, operation|
2698
2706
  result = ::Gapic::Rest::PagedEnumerable.new @translation_service_stub, :list_adaptive_mt_datasets, "adaptive_mt_datasets", request, result, options
2699
2707
  yield result, operation if block_given?
2700
- return result
2708
+ throw :response, result
2701
2709
  end
2702
2710
  rescue ::Gapic::Rest::Error => e
2703
2711
  raise ::Google::Cloud::Error.from_error(e)
@@ -2789,7 +2797,6 @@ module Google
2789
2797
 
2790
2798
  @translation_service_stub.adaptive_mt_translate request, options do |result, operation|
2791
2799
  yield result, operation if block_given?
2792
- return result
2793
2800
  end
2794
2801
  rescue ::Gapic::Rest::Error => e
2795
2802
  raise ::Google::Cloud::Error.from_error(e)
@@ -2869,7 +2876,6 @@ module Google
2869
2876
 
2870
2877
  @translation_service_stub.get_adaptive_mt_file request, options do |result, operation|
2871
2878
  yield result, operation if block_given?
2872
- return result
2873
2879
  end
2874
2880
  rescue ::Gapic::Rest::Error => e
2875
2881
  raise ::Google::Cloud::Error.from_error(e)
@@ -2949,7 +2955,6 @@ module Google
2949
2955
 
2950
2956
  @translation_service_stub.delete_adaptive_mt_file request, options do |result, operation|
2951
2957
  yield result, operation if block_given?
2952
- return result
2953
2958
  end
2954
2959
  rescue ::Gapic::Rest::Error => e
2955
2960
  raise ::Google::Cloud::Error.from_error(e)
@@ -2979,8 +2984,12 @@ module Google
2979
2984
  # `projects/{project-number-or-id}/locations/{location_id}/adaptiveMtDatasets/{dataset}`
2980
2985
  # @param file_input_source [::Google::Cloud::Translate::V3::FileInputSource, ::Hash]
2981
2986
  # Inline file source.
2987
+ #
2988
+ # Note: The following fields are mutually exclusive: `file_input_source`, `gcs_input_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
2982
2989
  # @param gcs_input_source [::Google::Cloud::Translate::V3::GcsInputSource, ::Hash]
2983
2990
  # Google Cloud Storage file source.
2991
+ #
2992
+ # Note: The following fields are mutually exclusive: `gcs_input_source`, `file_input_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
2984
2993
  # @yield [result, operation] Access the result along with the TransportOperation object
2985
2994
  # @yieldparam result [::Google::Cloud::Translate::V3::ImportAdaptiveMtFileResponse]
2986
2995
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -3034,7 +3043,6 @@ module Google
3034
3043
 
3035
3044
  @translation_service_stub.import_adaptive_mt_file request, options do |result, operation|
3036
3045
  yield result, operation if block_given?
3037
- return result
3038
3046
  end
3039
3047
  rescue ::Gapic::Rest::Error => e
3040
3048
  raise ::Google::Cloud::Error.from_error(e)
@@ -3128,7 +3136,7 @@ module Google
3128
3136
  @translation_service_stub.list_adaptive_mt_files request, options do |result, operation|
3129
3137
  result = ::Gapic::Rest::PagedEnumerable.new @translation_service_stub, :list_adaptive_mt_files, "adaptive_mt_files", request, result, options
3130
3138
  yield result, operation if block_given?
3131
- return result
3139
+ throw :response, result
3132
3140
  end
3133
3141
  rescue ::Gapic::Rest::Error => e
3134
3142
  raise ::Google::Cloud::Error.from_error(e)
@@ -3223,7 +3231,7 @@ module Google
3223
3231
  @translation_service_stub.list_adaptive_mt_sentences request, options do |result, operation|
3224
3232
  result = ::Gapic::Rest::PagedEnumerable.new @translation_service_stub, :list_adaptive_mt_sentences, "adaptive_mt_sentences", request, result, options
3225
3233
  yield result, operation if block_given?
3226
- return result
3234
+ throw :response, result
3227
3235
  end
3228
3236
  rescue ::Gapic::Rest::Error => e
3229
3237
  raise ::Google::Cloud::Error.from_error(e)
@@ -3313,7 +3321,7 @@ module Google
3313
3321
  @translation_service_stub.import_data request, options do |result, operation|
3314
3322
  result = ::Gapic::Operation.new result, @operations_client, options: options
3315
3323
  yield result, operation if block_given?
3316
- return result
3324
+ throw :response, result
3317
3325
  end
3318
3326
  rescue ::Gapic::Rest::Error => e
3319
3327
  raise ::Google::Cloud::Error.from_error(e)
@@ -3403,7 +3411,7 @@ module Google
3403
3411
  @translation_service_stub.export_data request, options do |result, operation|
3404
3412
  result = ::Gapic::Operation.new result, @operations_client, options: options
3405
3413
  yield result, operation if block_given?
3406
- return result
3414
+ throw :response, result
3407
3415
  end
3408
3416
  rescue ::Gapic::Rest::Error => e
3409
3417
  raise ::Google::Cloud::Error.from_error(e)
@@ -3499,7 +3507,7 @@ module Google
3499
3507
  @translation_service_stub.list_examples request, options do |result, operation|
3500
3508
  result = ::Gapic::Rest::PagedEnumerable.new @translation_service_stub, :list_examples, "examples", request, result, options
3501
3509
  yield result, operation if block_given?
3502
- return result
3510
+ throw :response, result
3503
3511
  end
3504
3512
  rescue ::Gapic::Rest::Error => e
3505
3513
  raise ::Google::Cloud::Error.from_error(e)
@@ -3589,7 +3597,7 @@ module Google
3589
3597
  @translation_service_stub.create_model request, options do |result, operation|
3590
3598
  result = ::Gapic::Operation.new result, @operations_client, options: options
3591
3599
  yield result, operation if block_given?
3592
- return result
3600
+ throw :response, result
3593
3601
  end
3594
3602
  rescue ::Gapic::Rest::Error => e
3595
3603
  raise ::Google::Cloud::Error.from_error(e)
@@ -3685,7 +3693,7 @@ module Google
3685
3693
  @translation_service_stub.list_models request, options do |result, operation|
3686
3694
  result = ::Gapic::Rest::PagedEnumerable.new @translation_service_stub, :list_models, "models", request, result, options
3687
3695
  yield result, operation if block_given?
3688
- return result
3696
+ throw :response, result
3689
3697
  end
3690
3698
  rescue ::Gapic::Rest::Error => e
3691
3699
  raise ::Google::Cloud::Error.from_error(e)
@@ -3764,7 +3772,6 @@ module Google
3764
3772
 
3765
3773
  @translation_service_stub.get_model request, options do |result, operation|
3766
3774
  yield result, operation if block_given?
3767
- return result
3768
3775
  end
3769
3776
  rescue ::Gapic::Rest::Error => e
3770
3777
  raise ::Google::Cloud::Error.from_error(e)
@@ -3851,7 +3858,7 @@ module Google
3851
3858
  @translation_service_stub.delete_model request, options do |result, operation|
3852
3859
  result = ::Gapic::Operation.new result, @operations_client, options: options
3853
3860
  yield result, operation if block_given?
3854
- return result
3861
+ throw :response, result
3855
3862
  end
3856
3863
  rescue ::Gapic::Rest::Error => e
3857
3864
  raise ::Google::Cloud::Error.from_error(e)
@@ -3899,6 +3906,13 @@ module Google
3899
3906
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
3900
3907
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
3901
3908
  # * (`nil`) indicating no credentials
3909
+ #
3910
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
3911
+ # external source for authentication to Google Cloud, you must validate it before
3912
+ # providing it to a Google API client library. Providing an unvalidated credential
3913
+ # configuration to Google APIs can compromise the security of your systems and data.
3914
+ # For more information, refer to [Validate credential configurations from external
3915
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
3902
3916
  # @return [::Object]
3903
3917
  # @!attribute [rw] scope
3904
3918
  # The OAuth scopes
@@ -3931,6 +3945,11 @@ module Google
3931
3945
  # default endpoint URL. The default value of nil uses the environment
3932
3946
  # universe (usually the default "googleapis.com" universe).
3933
3947
  # @return [::String,nil]
3948
+ # @!attribute [rw] logger
3949
+ # A custom logger to use for request/response debug logging, or the value
3950
+ # `:default` (the default) to construct a default logger, or `nil` to
3951
+ # explicitly disable logging.
3952
+ # @return [::Logger,:default,nil]
3934
3953
  #
3935
3954
  class Configuration
3936
3955
  extend ::Gapic::Config
@@ -3959,6 +3978,7 @@ module Google
3959
3978
  # by the host service.
3960
3979
  # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
3961
3980
  config_attr :bindings_override, {}, ::Hash, nil
3981
+ config_attr :logger, :default, ::Logger, nil, :default
3962
3982
 
3963
3983
  # @private
3964
3984
  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)
@@ -562,7 +553,7 @@ module Google
562
553
  @operations_stub.wait_operation request, options do |result, operation|
563
554
  result = ::Gapic::Operation.new result, @operations_client, options: options
564
555
  yield result, operation if block_given?
565
- return result
556
+ throw :response, result
566
557
  end
567
558
  rescue ::Gapic::Rest::Error => e
568
559
  raise ::Google::Cloud::Error.from_error(e)
@@ -610,6 +601,13 @@ module Google
610
601
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
611
602
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
612
603
  # * (`nil`) indicating no credentials
604
+ #
605
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
606
+ # external source for authentication to Google Cloud, you must validate it before
607
+ # providing it to a Google API client library. Providing an unvalidated credential
608
+ # configuration to Google APIs can compromise the security of your systems and data.
609
+ # For more information, refer to [Validate credential configurations from external
610
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
613
611
  # @return [::Object]
614
612
  # @!attribute [rw] scope
615
613
  # The OAuth scopes
@@ -642,6 +640,11 @@ module Google
642
640
  # default endpoint URL. The default value of nil uses the environment
643
641
  # universe (usually the default "googleapis.com" universe).
644
642
  # @return [::String,nil]
643
+ # @!attribute [rw] logger
644
+ # A custom logger to use for request/response debug logging, or the value
645
+ # `:default` (the default) to construct a default logger, or `nil` to
646
+ # explicitly disable logging.
647
+ # @return [::Logger,:default,nil]
645
648
  #
646
649
  class Configuration
647
650
  extend ::Gapic::Config
@@ -663,6 +666,7 @@ module Google
663
666
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
664
667
  config_attr :quota_project, nil, ::String, nil
665
668
  config_attr :universe_domain, nil, ::String, nil
669
+ config_attr :logger, :default, ::Logger, nil, :default
666
670
 
667
671
  # @private
668
672
  def initialize parent_config = nil
@@ -789,16 +793,18 @@ module Google
789
793
 
790
794
  response = @client_stub.make_http_request(
791
795
  verb,
792
- uri: uri,
793
- body: body || "",
794
- params: query_string_params,
796
+ uri: uri,
797
+ body: body || "",
798
+ params: query_string_params,
799
+ method_name: "list_operations",
795
800
  options: options
796
801
  )
797
802
  operation = ::Gapic::Rest::TransportOperation.new response
798
803
  result = ::Google::Longrunning::ListOperationsResponse.decode_json response.body, ignore_unknown_fields: true
799
-
800
- yield result, operation if block_given?
801
- result
804
+ catch :response do
805
+ yield result, operation if block_given?
806
+ result
807
+ end
802
808
  end
803
809
 
804
810
  ##
@@ -827,16 +833,18 @@ module Google
827
833
 
828
834
  response = @client_stub.make_http_request(
829
835
  verb,
830
- uri: uri,
831
- body: body || "",
832
- params: query_string_params,
836
+ uri: uri,
837
+ body: body || "",
838
+ params: query_string_params,
839
+ method_name: "get_operation",
833
840
  options: options
834
841
  )
835
842
  operation = ::Gapic::Rest::TransportOperation.new response
836
843
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
837
-
838
- yield result, operation if block_given?
839
- result
844
+ catch :response do
845
+ yield result, operation if block_given?
846
+ result
847
+ end
840
848
  end
841
849
 
842
850
  ##
@@ -865,16 +873,18 @@ module Google
865
873
 
866
874
  response = @client_stub.make_http_request(
867
875
  verb,
868
- uri: uri,
869
- body: body || "",
870
- params: query_string_params,
876
+ uri: uri,
877
+ body: body || "",
878
+ params: query_string_params,
879
+ method_name: "delete_operation",
871
880
  options: options
872
881
  )
873
882
  operation = ::Gapic::Rest::TransportOperation.new response
874
883
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
875
-
876
- yield result, operation if block_given?
877
- result
884
+ catch :response do
885
+ yield result, operation if block_given?
886
+ result
887
+ end
878
888
  end
879
889
 
880
890
  ##
@@ -903,16 +913,18 @@ module Google
903
913
 
904
914
  response = @client_stub.make_http_request(
905
915
  verb,
906
- uri: uri,
907
- body: body || "",
908
- params: query_string_params,
916
+ uri: uri,
917
+ body: body || "",
918
+ params: query_string_params,
919
+ method_name: "cancel_operation",
909
920
  options: options
910
921
  )
911
922
  operation = ::Gapic::Rest::TransportOperation.new response
912
923
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
913
-
914
- yield result, operation if block_given?
915
- result
924
+ catch :response do
925
+ yield result, operation if block_given?
926
+ result
927
+ end
916
928
  end
917
929
 
918
930
  ##
@@ -941,16 +953,18 @@ module Google
941
953
 
942
954
  response = @client_stub.make_http_request(
943
955
  verb,
944
- uri: uri,
945
- body: body || "",
946
- params: query_string_params,
956
+ uri: uri,
957
+ body: body || "",
958
+ params: query_string_params,
959
+ method_name: "wait_operation",
947
960
  options: options
948
961
  )
949
962
  operation = ::Gapic::Rest::TransportOperation.new response
950
963
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
951
-
952
- yield result, operation if block_given?
953
- result
964
+ catch :response do
965
+ yield result, operation if block_given?
966
+ result
967
+ end
954
968
  end
955
969
 
956
970
  ##