google-cloud-talent-v4 1.0.1 → 1.1.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -152,8 +152,28 @@ module Google
152
152
  endpoint: @config.endpoint,
153
153
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
154
154
  universe_domain: @config.universe_domain,
155
- credentials: credentials
155
+ credentials: credentials,
156
+ logger: @config.logger
156
157
  )
158
+
159
+ @event_service_stub.logger(stub: true)&.info do |entry|
160
+ entry.set_system_name
161
+ entry.set_service
162
+ entry.message = "Created client for #{entry.service}"
163
+ entry.set_credentials_fields credentials
164
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
165
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
166
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
167
+ end
168
+ end
169
+
170
+ ##
171
+ # The logger used for request/response debug logging.
172
+ #
173
+ # @return [Logger]
174
+ #
175
+ def logger
176
+ @event_service_stub.logger
157
177
  end
158
178
 
159
179
  # Service calls
@@ -243,7 +263,6 @@ module Google
243
263
 
244
264
  @event_service_stub.create_client_event request, options do |result, operation|
245
265
  yield result, operation if block_given?
246
- return result
247
266
  end
248
267
  rescue ::Gapic::Rest::Error => e
249
268
  raise ::Google::Cloud::Error.from_error(e)
@@ -323,6 +342,11 @@ module Google
323
342
  # default endpoint URL. The default value of nil uses the environment
324
343
  # universe (usually the default "googleapis.com" universe).
325
344
  # @return [::String,nil]
345
+ # @!attribute [rw] logger
346
+ # A custom logger to use for request/response debug logging, or the value
347
+ # `:default` (the default) to construct a default logger, or `nil` to
348
+ # explicitly disable logging.
349
+ # @return [::Logger,:default,nil]
326
350
  #
327
351
  class Configuration
328
352
  extend ::Gapic::Config
@@ -344,6 +368,7 @@ module Google
344
368
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
345
369
  config_attr :quota_project, nil, ::String, nil
346
370
  config_attr :universe_domain, nil, ::String, nil
371
+ config_attr :logger, :default, ::Logger, nil, :default
347
372
 
348
373
  # @private
349
374
  def initialize parent_config = nil
@@ -30,7 +30,8 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
33
+ # @private
34
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
34
35
  # These require statements are intentionally placed here to initialize
35
36
  # the REST modules only when it's required.
36
37
  require "gapic/rest"
@@ -40,7 +41,9 @@ module Google
40
41
  universe_domain: universe_domain,
41
42
  credentials: credentials,
42
43
  numeric_enums: true,
43
- raise_faraday_errors: false
44
+ service_name: self.class,
45
+ raise_faraday_errors: false,
46
+ logger: logger
44
47
  end
45
48
 
46
49
  ##
@@ -61,6 +64,15 @@ module Google
61
64
  @client_stub.endpoint
62
65
  end
63
66
 
67
+ ##
68
+ # The logger used for request/response debug logging.
69
+ #
70
+ # @return [Logger]
71
+ #
72
+ def logger stub: false
73
+ stub ? @client_stub.stub_logger : @client_stub.logger
74
+ end
75
+
64
76
  ##
65
77
  # Baseline implementation for the create_client_event REST call
66
78
  #
@@ -87,16 +99,18 @@ module Google
87
99
 
88
100
  response = @client_stub.make_http_request(
89
101
  verb,
90
- uri: uri,
91
- body: body || "",
92
- params: query_string_params,
102
+ uri: uri,
103
+ body: body || "",
104
+ params: query_string_params,
105
+ method_name: "create_client_event",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::Talent::V4::ClientEvent.decode_json response.body, ignore_unknown_fields: true
97
-
98
- yield result, operation if block_given?
99
- result
110
+ catch :response do
111
+ yield result, operation if block_given?
112
+ result
113
+ end
100
114
  end
101
115
 
102
116
  ##
@@ -191,8 +191,19 @@ module Google
191
191
  universe_domain: @config.universe_domain,
192
192
  channel_args: @config.channel_args,
193
193
  interceptors: @config.interceptors,
194
- channel_pool_config: @config.channel_pool
194
+ channel_pool_config: @config.channel_pool,
195
+ logger: @config.logger
195
196
  )
197
+
198
+ @job_service_stub.stub_logger&.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
196
207
  end
197
208
 
198
209
  ##
@@ -202,6 +213,15 @@ module Google
202
213
  #
203
214
  attr_reader :operations_client
204
215
 
216
+ ##
217
+ # The logger used for request/response debug logging.
218
+ #
219
+ # @return [Logger]
220
+ #
221
+ def logger
222
+ @job_service_stub.logger
223
+ end
224
+
205
225
  # Service calls
206
226
 
207
227
  ##
@@ -292,7 +312,6 @@ module Google
292
312
 
293
313
  @job_service_stub.call_rpc :create_job, request, options: options do |response, operation|
294
314
  yield response, operation if block_given?
295
- return response
296
315
  end
297
316
  rescue ::GRPC::BadStatus => e
298
317
  raise ::Google::Cloud::Error.from_error(e)
@@ -392,7 +411,7 @@ module Google
392
411
  @job_service_stub.call_rpc :batch_create_jobs, request, options: options do |response, operation|
393
412
  response = ::Gapic::Operation.new response, @operations_client, options: options
394
413
  yield response, operation if block_given?
395
- return response
414
+ throw :response, response
396
415
  end
397
416
  rescue ::GRPC::BadStatus => e
398
417
  raise ::Google::Cloud::Error.from_error(e)
@@ -483,7 +502,6 @@ module Google
483
502
 
484
503
  @job_service_stub.call_rpc :get_job, request, options: options do |response, operation|
485
504
  yield response, operation if block_given?
486
- return response
487
505
  end
488
506
  rescue ::GRPC::BadStatus => e
489
507
  raise ::Google::Cloud::Error.from_error(e)
@@ -582,7 +600,6 @@ module Google
582
600
 
583
601
  @job_service_stub.call_rpc :update_job, request, options: options do |response, operation|
584
602
  yield response, operation if block_given?
585
- return response
586
603
  end
587
604
  rescue ::GRPC::BadStatus => e
588
605
  raise ::Google::Cloud::Error.from_error(e)
@@ -699,7 +716,7 @@ module Google
699
716
  @job_service_stub.call_rpc :batch_update_jobs, request, options: options do |response, operation|
700
717
  response = ::Gapic::Operation.new response, @operations_client, options: options
701
718
  yield response, operation if block_given?
702
- return response
719
+ throw :response, response
703
720
  end
704
721
  rescue ::GRPC::BadStatus => e
705
722
  raise ::Google::Cloud::Error.from_error(e)
@@ -792,7 +809,6 @@ module Google
792
809
 
793
810
  @job_service_stub.call_rpc :delete_job, request, options: options do |response, operation|
794
811
  yield response, operation if block_given?
795
- return response
796
812
  end
797
813
  rescue ::GRPC::BadStatus => e
798
814
  raise ::Google::Cloud::Error.from_error(e)
@@ -898,7 +914,7 @@ module Google
898
914
  @job_service_stub.call_rpc :batch_delete_jobs, request, options: options do |response, operation|
899
915
  response = ::Gapic::Operation.new response, @operations_client, options: options
900
916
  yield response, operation if block_given?
901
- return response
917
+ throw :response, response
902
918
  end
903
919
  rescue ::GRPC::BadStatus => e
904
920
  raise ::Google::Cloud::Error.from_error(e)
@@ -1032,7 +1048,7 @@ module Google
1032
1048
  @job_service_stub.call_rpc :list_jobs, request, options: options do |response, operation|
1033
1049
  response = ::Gapic::PagedEnumerable.new @job_service_stub, :list_jobs, request, response, operation, options
1034
1050
  yield response, operation if block_given?
1035
- return response
1051
+ throw :response, response
1036
1052
  end
1037
1053
  rescue ::GRPC::BadStatus => e
1038
1054
  raise ::Google::Cloud::Error.from_error(e)
@@ -1394,7 +1410,6 @@ module Google
1394
1410
 
1395
1411
  @job_service_stub.call_rpc :search_jobs, request, options: options do |response, operation|
1396
1412
  yield response, operation if block_given?
1397
- return response
1398
1413
  end
1399
1414
  rescue ::GRPC::BadStatus => e
1400
1415
  raise ::Google::Cloud::Error.from_error(e)
@@ -1761,7 +1776,6 @@ module Google
1761
1776
 
1762
1777
  @job_service_stub.call_rpc :search_jobs_for_alert, request, options: options do |response, operation|
1763
1778
  yield response, operation if block_given?
1764
- return response
1765
1779
  end
1766
1780
  rescue ::GRPC::BadStatus => e
1767
1781
  raise ::Google::Cloud::Error.from_error(e)
@@ -1850,6 +1864,11 @@ module Google
1850
1864
  # default endpoint URL. The default value of nil uses the environment
1851
1865
  # universe (usually the default "googleapis.com" universe).
1852
1866
  # @return [::String,nil]
1867
+ # @!attribute [rw] logger
1868
+ # A custom logger to use for request/response debug logging, or the value
1869
+ # `:default` (the default) to construct a default logger, or `nil` to
1870
+ # explicitly disable logging.
1871
+ # @return [::Logger,:default,nil]
1853
1872
  #
1854
1873
  class Configuration
1855
1874
  extend ::Gapic::Config
@@ -1874,6 +1893,7 @@ module Google
1874
1893
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1875
1894
  config_attr :quota_project, nil, ::String, nil
1876
1895
  config_attr :universe_domain, nil, ::String, nil
1896
+ config_attr :logger, :default, ::Logger, nil, :default
1877
1897
 
1878
1898
  # @private
1879
1899
  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)
@@ -688,6 +679,11 @@ module Google
688
679
  # default endpoint URL. The default value of nil uses the environment
689
680
  # universe (usually the default "googleapis.com" universe).
690
681
  # @return [::String,nil]
682
+ # @!attribute [rw] logger
683
+ # A custom logger to use for request/response debug logging, or the value
684
+ # `:default` (the default) to construct a default logger, or `nil` to
685
+ # explicitly disable logging.
686
+ # @return [::Logger,:default,nil]
691
687
  #
692
688
  class Configuration
693
689
  extend ::Gapic::Config
@@ -712,6 +708,7 @@ module Google
712
708
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
713
709
  config_attr :quota_project, nil, ::String, nil
714
710
  config_attr :universe_domain, nil, ::String, nil
711
+ config_attr :logger, :default, ::Logger, nil, :default
715
712
 
716
713
  # @private
717
714
  def initialize parent_config = nil
@@ -184,8 +184,19 @@ module Google
184
184
  endpoint: @config.endpoint,
185
185
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
186
186
  universe_domain: @config.universe_domain,
187
- credentials: credentials
187
+ credentials: credentials,
188
+ logger: @config.logger
188
189
  )
190
+
191
+ @job_service_stub.logger(stub: true)&.info do |entry|
192
+ entry.set_system_name
193
+ entry.set_service
194
+ entry.message = "Created client for #{entry.service}"
195
+ entry.set_credentials_fields credentials
196
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
197
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
198
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
199
+ end
189
200
  end
190
201
 
191
202
  ##
@@ -195,6 +206,15 @@ module Google
195
206
  #
196
207
  attr_reader :operations_client
197
208
 
209
+ ##
210
+ # The logger used for request/response debug logging.
211
+ #
212
+ # @return [Logger]
213
+ #
214
+ def logger
215
+ @job_service_stub.logger
216
+ end
217
+
198
218
  # Service calls
199
219
 
200
220
  ##
@@ -278,7 +298,6 @@ module Google
278
298
 
279
299
  @job_service_stub.create_job request, options do |result, operation|
280
300
  yield result, operation if block_given?
281
- return result
282
301
  end
283
302
  rescue ::Gapic::Rest::Error => e
284
303
  raise ::Google::Cloud::Error.from_error(e)
@@ -371,7 +390,7 @@ module Google
371
390
  @job_service_stub.batch_create_jobs request, options do |result, operation|
372
391
  result = ::Gapic::Operation.new result, @operations_client, options: options
373
392
  yield result, operation if block_given?
374
- return result
393
+ throw :response, result
375
394
  end
376
395
  rescue ::Gapic::Rest::Error => e
377
396
  raise ::Google::Cloud::Error.from_error(e)
@@ -455,7 +474,6 @@ module Google
455
474
 
456
475
  @job_service_stub.get_job request, options do |result, operation|
457
476
  yield result, operation if block_given?
458
- return result
459
477
  end
460
478
  rescue ::Gapic::Rest::Error => e
461
479
  raise ::Google::Cloud::Error.from_error(e)
@@ -547,7 +565,6 @@ module Google
547
565
 
548
566
  @job_service_stub.update_job request, options do |result, operation|
549
567
  yield result, operation if block_given?
550
- return result
551
568
  end
552
569
  rescue ::Gapic::Rest::Error => e
553
570
  raise ::Google::Cloud::Error.from_error(e)
@@ -657,7 +674,7 @@ module Google
657
674
  @job_service_stub.batch_update_jobs request, options do |result, operation|
658
675
  result = ::Gapic::Operation.new result, @operations_client, options: options
659
676
  yield result, operation if block_given?
660
- return result
677
+ throw :response, result
661
678
  end
662
679
  rescue ::Gapic::Rest::Error => e
663
680
  raise ::Google::Cloud::Error.from_error(e)
@@ -743,7 +760,6 @@ module Google
743
760
 
744
761
  @job_service_stub.delete_job request, options do |result, operation|
745
762
  yield result, operation if block_given?
746
- return result
747
763
  end
748
764
  rescue ::Gapic::Rest::Error => e
749
765
  raise ::Google::Cloud::Error.from_error(e)
@@ -842,7 +858,7 @@ module Google
842
858
  @job_service_stub.batch_delete_jobs request, options do |result, operation|
843
859
  result = ::Gapic::Operation.new result, @operations_client, options: options
844
860
  yield result, operation if block_given?
845
- return result
861
+ throw :response, result
846
862
  end
847
863
  rescue ::Gapic::Rest::Error => e
848
864
  raise ::Google::Cloud::Error.from_error(e)
@@ -969,7 +985,7 @@ module Google
969
985
  @job_service_stub.list_jobs request, options do |result, operation|
970
986
  result = ::Gapic::Rest::PagedEnumerable.new @job_service_stub, :list_jobs, "jobs", request, result, options
971
987
  yield result, operation if block_given?
972
- return result
988
+ throw :response, result
973
989
  end
974
990
  rescue ::Gapic::Rest::Error => e
975
991
  raise ::Google::Cloud::Error.from_error(e)
@@ -1324,7 +1340,6 @@ module Google
1324
1340
 
1325
1341
  @job_service_stub.search_jobs request, options do |result, operation|
1326
1342
  yield result, operation if block_given?
1327
- return result
1328
1343
  end
1329
1344
  rescue ::Gapic::Rest::Error => e
1330
1345
  raise ::Google::Cloud::Error.from_error(e)
@@ -1684,7 +1699,6 @@ module Google
1684
1699
 
1685
1700
  @job_service_stub.search_jobs_for_alert request, options do |result, operation|
1686
1701
  yield result, operation if block_given?
1687
- return result
1688
1702
  end
1689
1703
  rescue ::Gapic::Rest::Error => e
1690
1704
  raise ::Google::Cloud::Error.from_error(e)
@@ -1764,6 +1778,11 @@ module Google
1764
1778
  # default endpoint URL. The default value of nil uses the environment
1765
1779
  # universe (usually the default "googleapis.com" universe).
1766
1780
  # @return [::String,nil]
1781
+ # @!attribute [rw] logger
1782
+ # A custom logger to use for request/response debug logging, or the value
1783
+ # `:default` (the default) to construct a default logger, or `nil` to
1784
+ # explicitly disable logging.
1785
+ # @return [::Logger,:default,nil]
1767
1786
  #
1768
1787
  class Configuration
1769
1788
  extend ::Gapic::Config
@@ -1785,6 +1804,7 @@ module Google
1785
1804
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1786
1805
  config_attr :quota_project, nil, ::String, nil
1787
1806
  config_attr :universe_domain, nil, ::String, nil
1807
+ config_attr :logger, :default, ::Logger, nil, :default
1788
1808
 
1789
1809
  # @private
1790
1810
  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)
@@ -543,6 +534,11 @@ module Google
543
534
  # default endpoint URL. The default value of nil uses the environment
544
535
  # universe (usually the default "googleapis.com" universe).
545
536
  # @return [::String,nil]
537
+ # @!attribute [rw] logger
538
+ # A custom logger to use for request/response debug logging, or the value
539
+ # `:default` (the default) to construct a default logger, or `nil` to
540
+ # explicitly disable logging.
541
+ # @return [::Logger,:default,nil]
546
542
  #
547
543
  class Configuration
548
544
  extend ::Gapic::Config
@@ -564,6 +560,7 @@ module Google
564
560
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
565
561
  config_attr :quota_project, nil, ::String, nil
566
562
  config_attr :universe_domain, nil, ::String, nil
563
+ config_attr :logger, :default, ::Logger, nil, :default
567
564
 
568
565
  # @private
569
566
  def initialize parent_config = nil
@@ -683,16 +680,18 @@ module Google
683
680
 
684
681
  response = @client_stub.make_http_request(
685
682
  verb,
686
- uri: uri,
687
- body: body || "",
688
- params: query_string_params,
683
+ uri: uri,
684
+ body: body || "",
685
+ params: query_string_params,
686
+ method_name: "list_operations",
689
687
  options: options
690
688
  )
691
689
  operation = ::Gapic::Rest::TransportOperation.new response
692
690
  result = ::Google::Longrunning::ListOperationsResponse.decode_json response.body, ignore_unknown_fields: true
693
-
694
- yield result, operation if block_given?
695
- result
691
+ catch :response do
692
+ yield result, operation if block_given?
693
+ result
694
+ end
696
695
  end
697
696
 
698
697
  ##
@@ -721,16 +720,18 @@ module Google
721
720
 
722
721
  response = @client_stub.make_http_request(
723
722
  verb,
724
- uri: uri,
725
- body: body || "",
726
- params: query_string_params,
723
+ uri: uri,
724
+ body: body || "",
725
+ params: query_string_params,
726
+ method_name: "get_operation",
727
727
  options: options
728
728
  )
729
729
  operation = ::Gapic::Rest::TransportOperation.new response
730
730
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
731
-
732
- yield result, operation if block_given?
733
- result
731
+ catch :response do
732
+ yield result, operation if block_given?
733
+ result
734
+ end
734
735
  end
735
736
 
736
737
  ##
@@ -759,16 +760,18 @@ module Google
759
760
 
760
761
  response = @client_stub.make_http_request(
761
762
  verb,
762
- uri: uri,
763
- body: body || "",
764
- params: query_string_params,
763
+ uri: uri,
764
+ body: body || "",
765
+ params: query_string_params,
766
+ method_name: "delete_operation",
765
767
  options: options
766
768
  )
767
769
  operation = ::Gapic::Rest::TransportOperation.new response
768
770
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
769
-
770
- yield result, operation if block_given?
771
- result
771
+ catch :response do
772
+ yield result, operation if block_given?
773
+ result
774
+ end
772
775
  end
773
776
 
774
777
  ##
@@ -797,16 +800,18 @@ module Google
797
800
 
798
801
  response = @client_stub.make_http_request(
799
802
  verb,
800
- uri: uri,
801
- body: body || "",
802
- params: query_string_params,
803
+ uri: uri,
804
+ body: body || "",
805
+ params: query_string_params,
806
+ method_name: "cancel_operation",
803
807
  options: options
804
808
  )
805
809
  operation = ::Gapic::Rest::TransportOperation.new response
806
810
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
807
-
808
- yield result, operation if block_given?
809
- result
811
+ catch :response do
812
+ yield result, operation if block_given?
813
+ result
814
+ end
810
815
  end
811
816
 
812
817
  ##