google-cloud-dialogflow-cx-v3 1.2.0 → 1.3.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (71) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +30 -20
  3. data/lib/google/cloud/dialogflow/cx/v3/agents/client.rb +31 -12
  4. data/lib/google/cloud/dialogflow/cx/v3/agents/operations.rb +12 -15
  5. data/lib/google/cloud/dialogflow/cx/v3/agents/rest/client.rb +31 -12
  6. data/lib/google/cloud/dialogflow/cx/v3/agents/rest/operations.rb +43 -38
  7. data/lib/google/cloud/dialogflow/cx/v3/agents/rest/service_stub.rb +102 -68
  8. data/lib/google/cloud/dialogflow/cx/v3/changelogs/client.rb +29 -3
  9. data/lib/google/cloud/dialogflow/cx/v3/changelogs/rest/client.rb +29 -3
  10. data/lib/google/cloud/dialogflow/cx/v3/changelogs/rest/service_stub.rb +30 -14
  11. data/lib/google/cloud/dialogflow/cx/v3/deployments/client.rb +29 -3
  12. data/lib/google/cloud/dialogflow/cx/v3/deployments/rest/client.rb +29 -3
  13. data/lib/google/cloud/dialogflow/cx/v3/deployments/rest/service_stub.rb +30 -14
  14. data/lib/google/cloud/dialogflow/cx/v3/entity_types/client.rb +31 -8
  15. data/lib/google/cloud/dialogflow/cx/v3/entity_types/operations.rb +12 -15
  16. data/lib/google/cloud/dialogflow/cx/v3/entity_types/rest/client.rb +31 -8
  17. data/lib/google/cloud/dialogflow/cx/v3/entity_types/rest/operations.rb +43 -38
  18. data/lib/google/cloud/dialogflow/cx/v3/entity_types/rest/service_stub.rb +70 -44
  19. data/lib/google/cloud/dialogflow/cx/v3/environments/client.rb +35 -10
  20. data/lib/google/cloud/dialogflow/cx/v3/environments/operations.rb +12 -15
  21. data/lib/google/cloud/dialogflow/cx/v3/environments/rest/client.rb +35 -10
  22. data/lib/google/cloud/dialogflow/cx/v3/environments/rest/operations.rb +43 -38
  23. data/lib/google/cloud/dialogflow/cx/v3/environments/rest/service_stub.rb +86 -56
  24. data/lib/google/cloud/dialogflow/cx/v3/experiments/client.rb +29 -8
  25. data/lib/google/cloud/dialogflow/cx/v3/experiments/rest/client.rb +29 -8
  26. data/lib/google/cloud/dialogflow/cx/v3/experiments/rest/service_stub.rb +70 -44
  27. data/lib/google/cloud/dialogflow/cx/v3/flows/client.rb +32 -11
  28. data/lib/google/cloud/dialogflow/cx/v3/flows/operations.rb +12 -15
  29. data/lib/google/cloud/dialogflow/cx/v3/flows/rest/client.rb +32 -11
  30. data/lib/google/cloud/dialogflow/cx/v3/flows/rest/operations.rb +43 -38
  31. data/lib/google/cloud/dialogflow/cx/v3/flows/rest/service_stub.rb +94 -62
  32. data/lib/google/cloud/dialogflow/cx/v3/generators/client.rb +29 -6
  33. data/lib/google/cloud/dialogflow/cx/v3/generators/rest/client.rb +29 -6
  34. data/lib/google/cloud/dialogflow/cx/v3/generators/rest/service_stub.rb +54 -32
  35. data/lib/google/cloud/dialogflow/cx/v3/intents/client.rb +31 -8
  36. data/lib/google/cloud/dialogflow/cx/v3/intents/operations.rb +12 -15
  37. data/lib/google/cloud/dialogflow/cx/v3/intents/rest/client.rb +31 -8
  38. data/lib/google/cloud/dialogflow/cx/v3/intents/rest/operations.rb +43 -38
  39. data/lib/google/cloud/dialogflow/cx/v3/intents/rest/service_stub.rb +70 -44
  40. data/lib/google/cloud/dialogflow/cx/v3/pages/client.rb +29 -6
  41. data/lib/google/cloud/dialogflow/cx/v3/pages/rest/client.rb +29 -6
  42. data/lib/google/cloud/dialogflow/cx/v3/pages/rest/service_stub.rb +54 -32
  43. data/lib/google/cloud/dialogflow/cx/v3/security_settings_service/client.rb +29 -6
  44. data/lib/google/cloud/dialogflow/cx/v3/security_settings_service/rest/client.rb +29 -6
  45. data/lib/google/cloud/dialogflow/cx/v3/security_settings_service/rest/service_stub.rb +54 -32
  46. data/lib/google/cloud/dialogflow/cx/v3/session_entity_types/client.rb +29 -6
  47. data/lib/google/cloud/dialogflow/cx/v3/session_entity_types/rest/client.rb +29 -6
  48. data/lib/google/cloud/dialogflow/cx/v3/session_entity_types/rest/service_stub.rb +54 -32
  49. data/lib/google/cloud/dialogflow/cx/v3/sessions/client.rb +28 -7
  50. data/lib/google/cloud/dialogflow/cx/v3/sessions/rest/client.rb +28 -5
  51. data/lib/google/cloud/dialogflow/cx/v3/sessions/rest/service_stub.rb +47 -26
  52. data/lib/google/cloud/dialogflow/cx/v3/test_cases/client.rb +34 -13
  53. data/lib/google/cloud/dialogflow/cx/v3/test_cases/operations.rb +12 -15
  54. data/lib/google/cloud/dialogflow/cx/v3/test_cases/rest/client.rb +34 -13
  55. data/lib/google/cloud/dialogflow/cx/v3/test_cases/rest/operations.rb +43 -38
  56. data/lib/google/cloud/dialogflow/cx/v3/test_cases/rest/service_stub.rb +110 -74
  57. data/lib/google/cloud/dialogflow/cx/v3/transition_route_groups/client.rb +29 -6
  58. data/lib/google/cloud/dialogflow/cx/v3/transition_route_groups/rest/client.rb +29 -6
  59. data/lib/google/cloud/dialogflow/cx/v3/transition_route_groups/rest/service_stub.rb +54 -32
  60. data/lib/google/cloud/dialogflow/cx/v3/version.rb +1 -1
  61. data/lib/google/cloud/dialogflow/cx/v3/versions/client.rb +31 -8
  62. data/lib/google/cloud/dialogflow/cx/v3/versions/operations.rb +12 -15
  63. data/lib/google/cloud/dialogflow/cx/v3/versions/rest/client.rb +31 -8
  64. data/lib/google/cloud/dialogflow/cx/v3/versions/rest/operations.rb +43 -38
  65. data/lib/google/cloud/dialogflow/cx/v3/versions/rest/service_stub.rb +70 -44
  66. data/lib/google/cloud/dialogflow/cx/v3/webhooks/client.rb +29 -6
  67. data/lib/google/cloud/dialogflow/cx/v3/webhooks/rest/client.rb +29 -6
  68. data/lib/google/cloud/dialogflow/cx/v3/webhooks/rest/service_stub.rb +54 -32
  69. data/proto_docs/google/api/client.rb +19 -0
  70. data/proto_docs/google/longrunning/operations.rb +19 -14
  71. metadata +5 -5
@@ -164,14 +164,26 @@ module Google
164
164
  universe_domain: @config.universe_domain,
165
165
  channel_args: @config.channel_args,
166
166
  interceptors: @config.interceptors,
167
- channel_pool_config: @config.channel_pool
167
+ channel_pool_config: @config.channel_pool,
168
+ logger: @config.logger
168
169
  )
169
170
 
171
+ @experiments_stub.stub_logger&.info do |entry|
172
+ entry.set_system_name
173
+ entry.set_service
174
+ entry.message = "Created client for #{entry.service}"
175
+ entry.set_credentials_fields credentials
176
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
177
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
178
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
179
+ end
180
+
170
181
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
171
182
  config.credentials = credentials
172
183
  config.quota_project = @quota_project_id
173
184
  config.endpoint = @experiments_stub.endpoint
174
185
  config.universe_domain = @experiments_stub.universe_domain
186
+ config.logger = @experiments_stub.logger if config.respond_to? :logger=
175
187
  end
176
188
  end
177
189
 
@@ -182,6 +194,15 @@ module Google
182
194
  #
183
195
  attr_reader :location_client
184
196
 
197
+ ##
198
+ # The logger used for request/response debug logging.
199
+ #
200
+ # @return [Logger]
201
+ #
202
+ def logger
203
+ @experiments_stub.logger
204
+ end
205
+
185
206
  # Service calls
186
207
 
187
208
  ##
@@ -277,7 +298,7 @@ module Google
277
298
  @experiments_stub.call_rpc :list_experiments, request, options: options do |response, operation|
278
299
  response = ::Gapic::PagedEnumerable.new @experiments_stub, :list_experiments, request, response, operation, options
279
300
  yield response, operation if block_given?
280
- return response
301
+ throw :response, response
281
302
  end
282
303
  rescue ::GRPC::BadStatus => e
283
304
  raise ::Google::Cloud::Error.from_error(e)
@@ -366,7 +387,6 @@ module Google
366
387
 
367
388
  @experiments_stub.call_rpc :get_experiment, request, options: options do |response, operation|
368
389
  yield response, operation if block_given?
369
- return response
370
390
  end
371
391
  rescue ::GRPC::BadStatus => e
372
392
  raise ::Google::Cloud::Error.from_error(e)
@@ -457,7 +477,6 @@ module Google
457
477
 
458
478
  @experiments_stub.call_rpc :create_experiment, request, options: options do |response, operation|
459
479
  yield response, operation if block_given?
460
- return response
461
480
  end
462
481
  rescue ::GRPC::BadStatus => e
463
482
  raise ::Google::Cloud::Error.from_error(e)
@@ -546,7 +565,6 @@ module Google
546
565
 
547
566
  @experiments_stub.call_rpc :update_experiment, request, options: options do |response, operation|
548
567
  yield response, operation if block_given?
549
- return response
550
568
  end
551
569
  rescue ::GRPC::BadStatus => e
552
570
  raise ::Google::Cloud::Error.from_error(e)
@@ -635,7 +653,6 @@ module Google
635
653
 
636
654
  @experiments_stub.call_rpc :delete_experiment, request, options: options do |response, operation|
637
655
  yield response, operation if block_given?
638
- return response
639
656
  end
640
657
  rescue ::GRPC::BadStatus => e
641
658
  raise ::Google::Cloud::Error.from_error(e)
@@ -725,7 +742,6 @@ module Google
725
742
 
726
743
  @experiments_stub.call_rpc :start_experiment, request, options: options do |response, operation|
727
744
  yield response, operation if block_given?
728
- return response
729
745
  end
730
746
  rescue ::GRPC::BadStatus => e
731
747
  raise ::Google::Cloud::Error.from_error(e)
@@ -814,7 +830,6 @@ module Google
814
830
 
815
831
  @experiments_stub.call_rpc :stop_experiment, request, options: options do |response, operation|
816
832
  yield response, operation if block_given?
817
- return response
818
833
  end
819
834
  rescue ::GRPC::BadStatus => e
820
835
  raise ::Google::Cloud::Error.from_error(e)
@@ -903,6 +918,11 @@ module Google
903
918
  # default endpoint URL. The default value of nil uses the environment
904
919
  # universe (usually the default "googleapis.com" universe).
905
920
  # @return [::String,nil]
921
+ # @!attribute [rw] logger
922
+ # A custom logger to use for request/response debug logging, or the value
923
+ # `:default` (the default) to construct a default logger, or `nil` to
924
+ # explicitly disable logging.
925
+ # @return [::Logger,:default,nil]
906
926
  #
907
927
  class Configuration
908
928
  extend ::Gapic::Config
@@ -927,6 +947,7 @@ module Google
927
947
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
928
948
  config_attr :quota_project, nil, ::String, nil
929
949
  config_attr :universe_domain, nil, ::String, nil
950
+ config_attr :logger, :default, ::Logger, nil, :default
930
951
 
931
952
  # @private
932
953
  def initialize parent_config = nil
@@ -157,15 +157,27 @@ module Google
157
157
  endpoint: @config.endpoint,
158
158
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
159
159
  universe_domain: @config.universe_domain,
160
- credentials: credentials
160
+ credentials: credentials,
161
+ logger: @config.logger
161
162
  )
162
163
 
164
+ @experiments_stub.logger(stub: true)&.info do |entry|
165
+ entry.set_system_name
166
+ entry.set_service
167
+ entry.message = "Created client for #{entry.service}"
168
+ entry.set_credentials_fields credentials
169
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
170
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
171
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
172
+ end
173
+
163
174
  @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
164
175
  config.credentials = credentials
165
176
  config.quota_project = @quota_project_id
166
177
  config.endpoint = @experiments_stub.endpoint
167
178
  config.universe_domain = @experiments_stub.universe_domain
168
179
  config.bindings_override = @config.bindings_override
180
+ config.logger = @experiments_stub.logger if config.respond_to? :logger=
169
181
  end
170
182
  end
171
183
 
@@ -176,6 +188,15 @@ module Google
176
188
  #
177
189
  attr_reader :location_client
178
190
 
191
+ ##
192
+ # The logger used for request/response debug logging.
193
+ #
194
+ # @return [Logger]
195
+ #
196
+ def logger
197
+ @experiments_stub.logger
198
+ end
199
+
179
200
  # Service calls
180
201
 
181
202
  ##
@@ -264,7 +285,7 @@ module Google
264
285
  @experiments_stub.list_experiments request, options do |result, operation|
265
286
  result = ::Gapic::Rest::PagedEnumerable.new @experiments_stub, :list_experiments, "experiments", request, result, options
266
287
  yield result, operation if block_given?
267
- return result
288
+ throw :response, result
268
289
  end
269
290
  rescue ::Gapic::Rest::Error => e
270
291
  raise ::Google::Cloud::Error.from_error(e)
@@ -346,7 +367,6 @@ module Google
346
367
 
347
368
  @experiments_stub.get_experiment request, options do |result, operation|
348
369
  yield result, operation if block_given?
349
- return result
350
370
  end
351
371
  rescue ::Gapic::Rest::Error => e
352
372
  raise ::Google::Cloud::Error.from_error(e)
@@ -430,7 +450,6 @@ module Google
430
450
 
431
451
  @experiments_stub.create_experiment request, options do |result, operation|
432
452
  yield result, operation if block_given?
433
- return result
434
453
  end
435
454
  rescue ::Gapic::Rest::Error => e
436
455
  raise ::Google::Cloud::Error.from_error(e)
@@ -512,7 +531,6 @@ module Google
512
531
 
513
532
  @experiments_stub.update_experiment request, options do |result, operation|
514
533
  yield result, operation if block_given?
515
- return result
516
534
  end
517
535
  rescue ::Gapic::Rest::Error => e
518
536
  raise ::Google::Cloud::Error.from_error(e)
@@ -594,7 +612,6 @@ module Google
594
612
 
595
613
  @experiments_stub.delete_experiment request, options do |result, operation|
596
614
  yield result, operation if block_given?
597
- return result
598
615
  end
599
616
  rescue ::Gapic::Rest::Error => e
600
617
  raise ::Google::Cloud::Error.from_error(e)
@@ -677,7 +694,6 @@ module Google
677
694
 
678
695
  @experiments_stub.start_experiment request, options do |result, operation|
679
696
  yield result, operation if block_given?
680
- return result
681
697
  end
682
698
  rescue ::Gapic::Rest::Error => e
683
699
  raise ::Google::Cloud::Error.from_error(e)
@@ -759,7 +775,6 @@ module Google
759
775
 
760
776
  @experiments_stub.stop_experiment request, options do |result, operation|
761
777
  yield result, operation if block_given?
762
- return result
763
778
  end
764
779
  rescue ::Gapic::Rest::Error => e
765
780
  raise ::Google::Cloud::Error.from_error(e)
@@ -839,6 +854,11 @@ module Google
839
854
  # default endpoint URL. The default value of nil uses the environment
840
855
  # universe (usually the default "googleapis.com" universe).
841
856
  # @return [::String,nil]
857
+ # @!attribute [rw] logger
858
+ # A custom logger to use for request/response debug logging, or the value
859
+ # `:default` (the default) to construct a default logger, or `nil` to
860
+ # explicitly disable logging.
861
+ # @return [::Logger,:default,nil]
842
862
  #
843
863
  class Configuration
844
864
  extend ::Gapic::Config
@@ -867,6 +887,7 @@ module Google
867
887
  # by the host service.
868
888
  # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
869
889
  config_attr :bindings_override, {}, ::Hash, nil
890
+ config_attr :logger, :default, ::Logger, nil, :default
870
891
 
871
892
  # @private
872
893
  def initialize parent_config = nil
@@ -31,7 +31,8 @@ module Google
31
31
  # including transcoding, making the REST call, and deserialing the response.
32
32
  #
33
33
  class ServiceStub
34
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
34
+ # @private
35
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
35
36
  # These require statements are intentionally placed here to initialize
36
37
  # the REST modules only when it's required.
37
38
  require "gapic/rest"
@@ -41,7 +42,9 @@ module Google
41
42
  universe_domain: universe_domain,
42
43
  credentials: credentials,
43
44
  numeric_enums: true,
44
- raise_faraday_errors: false
45
+ service_name: self.class,
46
+ raise_faraday_errors: false,
47
+ logger: logger
45
48
  end
46
49
 
47
50
  ##
@@ -62,6 +65,15 @@ module Google
62
65
  @client_stub.endpoint
63
66
  end
64
67
 
68
+ ##
69
+ # The logger used for request/response debug logging.
70
+ #
71
+ # @return [Logger]
72
+ #
73
+ def logger stub: false
74
+ stub ? @client_stub.stub_logger : @client_stub.logger
75
+ end
76
+
65
77
  ##
66
78
  # Baseline implementation for the list_experiments REST call
67
79
  #
@@ -88,16 +100,18 @@ module Google
88
100
 
89
101
  response = @client_stub.make_http_request(
90
102
  verb,
91
- uri: uri,
92
- body: body || "",
93
- params: query_string_params,
103
+ uri: uri,
104
+ body: body || "",
105
+ params: query_string_params,
106
+ method_name: "list_experiments",
94
107
  options: options
95
108
  )
96
109
  operation = ::Gapic::Rest::TransportOperation.new response
97
110
  result = ::Google::Cloud::Dialogflow::CX::V3::ListExperimentsResponse.decode_json response.body, ignore_unknown_fields: true
98
-
99
- yield result, operation if block_given?
100
- result
111
+ catch :response do
112
+ yield result, operation if block_given?
113
+ result
114
+ end
101
115
  end
102
116
 
103
117
  ##
@@ -126,16 +140,18 @@ module Google
126
140
 
127
141
  response = @client_stub.make_http_request(
128
142
  verb,
129
- uri: uri,
130
- body: body || "",
131
- params: query_string_params,
143
+ uri: uri,
144
+ body: body || "",
145
+ params: query_string_params,
146
+ method_name: "get_experiment",
132
147
  options: options
133
148
  )
134
149
  operation = ::Gapic::Rest::TransportOperation.new response
135
150
  result = ::Google::Cloud::Dialogflow::CX::V3::Experiment.decode_json response.body, ignore_unknown_fields: true
136
-
137
- yield result, operation if block_given?
138
- result
151
+ catch :response do
152
+ yield result, operation if block_given?
153
+ result
154
+ end
139
155
  end
140
156
 
141
157
  ##
@@ -164,16 +180,18 @@ module Google
164
180
 
165
181
  response = @client_stub.make_http_request(
166
182
  verb,
167
- uri: uri,
168
- body: body || "",
169
- params: query_string_params,
183
+ uri: uri,
184
+ body: body || "",
185
+ params: query_string_params,
186
+ method_name: "create_experiment",
170
187
  options: options
171
188
  )
172
189
  operation = ::Gapic::Rest::TransportOperation.new response
173
190
  result = ::Google::Cloud::Dialogflow::CX::V3::Experiment.decode_json response.body, ignore_unknown_fields: true
174
-
175
- yield result, operation if block_given?
176
- result
191
+ catch :response do
192
+ yield result, operation if block_given?
193
+ result
194
+ end
177
195
  end
178
196
 
179
197
  ##
@@ -202,16 +220,18 @@ module Google
202
220
 
203
221
  response = @client_stub.make_http_request(
204
222
  verb,
205
- uri: uri,
206
- body: body || "",
207
- params: query_string_params,
223
+ uri: uri,
224
+ body: body || "",
225
+ params: query_string_params,
226
+ method_name: "update_experiment",
208
227
  options: options
209
228
  )
210
229
  operation = ::Gapic::Rest::TransportOperation.new response
211
230
  result = ::Google::Cloud::Dialogflow::CX::V3::Experiment.decode_json response.body, ignore_unknown_fields: true
212
-
213
- yield result, operation if block_given?
214
- result
231
+ catch :response do
232
+ yield result, operation if block_given?
233
+ result
234
+ end
215
235
  end
216
236
 
217
237
  ##
@@ -240,16 +260,18 @@ module Google
240
260
 
241
261
  response = @client_stub.make_http_request(
242
262
  verb,
243
- uri: uri,
244
- body: body || "",
245
- params: query_string_params,
263
+ uri: uri,
264
+ body: body || "",
265
+ params: query_string_params,
266
+ method_name: "delete_experiment",
246
267
  options: options
247
268
  )
248
269
  operation = ::Gapic::Rest::TransportOperation.new response
249
270
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
250
-
251
- yield result, operation if block_given?
252
- result
271
+ catch :response do
272
+ yield result, operation if block_given?
273
+ result
274
+ end
253
275
  end
254
276
 
255
277
  ##
@@ -278,16 +300,18 @@ module Google
278
300
 
279
301
  response = @client_stub.make_http_request(
280
302
  verb,
281
- uri: uri,
282
- body: body || "",
283
- params: query_string_params,
303
+ uri: uri,
304
+ body: body || "",
305
+ params: query_string_params,
306
+ method_name: "start_experiment",
284
307
  options: options
285
308
  )
286
309
  operation = ::Gapic::Rest::TransportOperation.new response
287
310
  result = ::Google::Cloud::Dialogflow::CX::V3::Experiment.decode_json response.body, ignore_unknown_fields: true
288
-
289
- yield result, operation if block_given?
290
- result
311
+ catch :response do
312
+ yield result, operation if block_given?
313
+ result
314
+ end
291
315
  end
292
316
 
293
317
  ##
@@ -316,16 +340,18 @@ module Google
316
340
 
317
341
  response = @client_stub.make_http_request(
318
342
  verb,
319
- uri: uri,
320
- body: body || "",
321
- params: query_string_params,
343
+ uri: uri,
344
+ body: body || "",
345
+ params: query_string_params,
346
+ method_name: "stop_experiment",
322
347
  options: options
323
348
  )
324
349
  operation = ::Gapic::Rest::TransportOperation.new response
325
350
  result = ::Google::Cloud::Dialogflow::CX::V3::Experiment.decode_json response.body, ignore_unknown_fields: true
326
-
327
- yield result, operation if block_given?
328
- result
351
+ catch :response do
352
+ yield result, operation if block_given?
353
+ result
354
+ end
329
355
  end
330
356
 
331
357
  ##
@@ -171,14 +171,26 @@ module Google
171
171
  universe_domain: @config.universe_domain,
172
172
  channel_args: @config.channel_args,
173
173
  interceptors: @config.interceptors,
174
- channel_pool_config: @config.channel_pool
174
+ channel_pool_config: @config.channel_pool,
175
+ logger: @config.logger
175
176
  )
176
177
 
178
+ @flows_stub.stub_logger&.info do |entry|
179
+ entry.set_system_name
180
+ entry.set_service
181
+ entry.message = "Created client for #{entry.service}"
182
+ entry.set_credentials_fields credentials
183
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
184
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
185
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
186
+ end
187
+
177
188
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
178
189
  config.credentials = credentials
179
190
  config.quota_project = @quota_project_id
180
191
  config.endpoint = @flows_stub.endpoint
181
192
  config.universe_domain = @flows_stub.universe_domain
193
+ config.logger = @flows_stub.logger if config.respond_to? :logger=
182
194
  end
183
195
  end
184
196
 
@@ -196,6 +208,15 @@ module Google
196
208
  #
197
209
  attr_reader :location_client
198
210
 
211
+ ##
212
+ # The logger used for request/response debug logging.
213
+ #
214
+ # @return [Logger]
215
+ #
216
+ def logger
217
+ @flows_stub.logger
218
+ end
219
+
199
220
  # Service calls
200
221
 
201
222
  ##
@@ -298,7 +319,6 @@ module Google
298
319
 
299
320
  @flows_stub.call_rpc :create_flow, request, options: options do |response, operation|
300
321
  yield response, operation if block_given?
301
- return response
302
322
  end
303
323
  rescue ::GRPC::BadStatus => e
304
324
  raise ::Google::Cloud::Error.from_error(e)
@@ -397,7 +417,6 @@ module Google
397
417
 
398
418
  @flows_stub.call_rpc :delete_flow, 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)
@@ -508,7 +527,7 @@ module Google
508
527
  @flows_stub.call_rpc :list_flows, request, options: options do |response, operation|
509
528
  response = ::Gapic::PagedEnumerable.new @flows_stub, :list_flows, request, response, operation, options
510
529
  yield response, operation if block_given?
511
- return response
530
+ throw :response, response
512
531
  end
513
532
  rescue ::GRPC::BadStatus => e
514
533
  raise ::Google::Cloud::Error.from_error(e)
@@ -610,7 +629,6 @@ module Google
610
629
 
611
630
  @flows_stub.call_rpc :get_flow, request, options: options do |response, operation|
612
631
  yield response, operation if block_given?
613
- return response
614
632
  end
615
633
  rescue ::GRPC::BadStatus => e
616
634
  raise ::Google::Cloud::Error.from_error(e)
@@ -716,7 +734,6 @@ module Google
716
734
 
717
735
  @flows_stub.call_rpc :update_flow, request, options: options do |response, operation|
718
736
  yield response, operation if block_given?
719
- return response
720
737
  end
721
738
  rescue ::GRPC::BadStatus => e
722
739
  raise ::Google::Cloud::Error.from_error(e)
@@ -826,7 +843,7 @@ module Google
826
843
  @flows_stub.call_rpc :train_flow, request, options: options do |response, operation|
827
844
  response = ::Gapic::Operation.new response, @operations_client, options: options
828
845
  yield response, operation if block_given?
829
- return response
846
+ throw :response, response
830
847
  end
831
848
  rescue ::GRPC::BadStatus => e
832
849
  raise ::Google::Cloud::Error.from_error(e)
@@ -918,7 +935,6 @@ module Google
918
935
 
919
936
  @flows_stub.call_rpc :validate_flow, request, options: options do |response, operation|
920
937
  yield response, operation if block_given?
921
- return response
922
938
  end
923
939
  rescue ::GRPC::BadStatus => e
924
940
  raise ::Google::Cloud::Error.from_error(e)
@@ -1009,7 +1025,6 @@ module Google
1009
1025
 
1010
1026
  @flows_stub.call_rpc :get_flow_validation_result, request, options: options do |response, operation|
1011
1027
  yield response, operation if block_given?
1012
- return response
1013
1028
  end
1014
1029
  rescue ::GRPC::BadStatus => e
1015
1030
  raise ::Google::Cloud::Error.from_error(e)
@@ -1134,7 +1149,7 @@ module Google
1134
1149
  @flows_stub.call_rpc :import_flow, request, options: options do |response, operation|
1135
1150
  response = ::Gapic::Operation.new response, @operations_client, options: options
1136
1151
  yield response, operation if block_given?
1137
- return response
1152
+ throw :response, response
1138
1153
  end
1139
1154
  rescue ::GRPC::BadStatus => e
1140
1155
  raise ::Google::Cloud::Error.from_error(e)
@@ -1255,7 +1270,7 @@ module Google
1255
1270
  @flows_stub.call_rpc :export_flow, request, options: options do |response, operation|
1256
1271
  response = ::Gapic::Operation.new response, @operations_client, options: options
1257
1272
  yield response, operation if block_given?
1258
- return response
1273
+ throw :response, response
1259
1274
  end
1260
1275
  rescue ::GRPC::BadStatus => e
1261
1276
  raise ::Google::Cloud::Error.from_error(e)
@@ -1344,6 +1359,11 @@ module Google
1344
1359
  # default endpoint URL. The default value of nil uses the environment
1345
1360
  # universe (usually the default "googleapis.com" universe).
1346
1361
  # @return [::String,nil]
1362
+ # @!attribute [rw] logger
1363
+ # A custom logger to use for request/response debug logging, or the value
1364
+ # `:default` (the default) to construct a default logger, or `nil` to
1365
+ # explicitly disable logging.
1366
+ # @return [::Logger,:default,nil]
1347
1367
  #
1348
1368
  class Configuration
1349
1369
  extend ::Gapic::Config
@@ -1368,6 +1388,7 @@ module Google
1368
1388
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1369
1389
  config_attr :quota_project, nil, ::String, nil
1370
1390
  config_attr :universe_domain, nil, ::String, nil
1391
+ config_attr :logger, :default, ::Logger, nil, :default
1371
1392
 
1372
1393
  # @private
1373
1394
  def initialize parent_config = nil
@@ -125,14 +125,6 @@ module Google
125
125
  # Lists operations that match the specified filter in the request. If the
126
126
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
127
127
  #
128
- # NOTE: the `name` binding allows API services to override the binding
129
- # to use different resource name schemes, such as `users/*/operations`. To
130
- # override the binding, API services can add a binding such as
131
- # `"/v1/{name=users/*}/operations"` to their service configuration.
132
- # For backwards compatibility, the default name includes the operations
133
- # collection id, however overriding users must ensure the name binding
134
- # is the parent resource, without the operations collection id.
135
- #
136
128
  # @overload list_operations(request, options = nil)
137
129
  # Pass arguments to `list_operations` via a request object, either of type
138
130
  # {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -222,7 +214,7 @@ module Google
222
214
  wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
223
215
  response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
224
216
  yield response, operation if block_given?
225
- return response
217
+ throw :response, response
226
218
  end
227
219
  rescue ::GRPC::BadStatus => e
228
220
  raise ::Google::Cloud::Error.from_error(e)
@@ -318,7 +310,7 @@ module Google
318
310
  @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
319
311
  response = ::Gapic::Operation.new response, @operations_client, options: options
320
312
  yield response, operation if block_given?
321
- return response
313
+ throw :response, response
322
314
  end
323
315
  rescue ::GRPC::BadStatus => e
324
316
  raise ::Google::Cloud::Error.from_error(e)
@@ -407,7 +399,6 @@ module Google
407
399
 
408
400
  @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
409
401
  yield response, operation if block_given?
410
- return response
411
402
  end
412
403
  rescue ::GRPC::BadStatus => e
413
404
  raise ::Google::Cloud::Error.from_error(e)
@@ -422,8 +413,9 @@ module Google
422
413
  # other methods to check whether the cancellation succeeded or whether the
423
414
  # operation completed despite cancellation. On successful cancellation,
424
415
  # the operation is not deleted; instead, it becomes an operation with
425
- # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
426
- # corresponding to `Code.CANCELLED`.
416
+ # an {::Google::Longrunning::Operation#error Operation.error} value with a
417
+ # {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
418
+ # `Code.CANCELLED`.
427
419
  #
428
420
  # @overload cancel_operation(request, options = nil)
429
421
  # Pass arguments to `cancel_operation` via a request object, either of type
@@ -502,7 +494,6 @@ module Google
502
494
 
503
495
  @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
504
496
  yield response, operation if block_given?
505
- return response
506
497
  end
507
498
  rescue ::GRPC::BadStatus => e
508
499
  raise ::Google::Cloud::Error.from_error(e)
@@ -600,7 +591,7 @@ module Google
600
591
  @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
601
592
  response = ::Gapic::Operation.new response, @operations_client, options: options
602
593
  yield response, operation if block_given?
603
- return response
594
+ throw :response, response
604
595
  end
605
596
  rescue ::GRPC::BadStatus => e
606
597
  raise ::Google::Cloud::Error.from_error(e)
@@ -689,6 +680,11 @@ module Google
689
680
  # default endpoint URL. The default value of nil uses the environment
690
681
  # universe (usually the default "googleapis.com" universe).
691
682
  # @return [::String,nil]
683
+ # @!attribute [rw] logger
684
+ # A custom logger to use for request/response debug logging, or the value
685
+ # `:default` (the default) to construct a default logger, or `nil` to
686
+ # explicitly disable logging.
687
+ # @return [::Logger,:default,nil]
692
688
  #
693
689
  class Configuration
694
690
  extend ::Gapic::Config
@@ -713,6 +709,7 @@ module Google
713
709
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
714
710
  config_attr :quota_project, nil, ::String, nil
715
711
  config_attr :universe_domain, nil, ::String, nil
712
+ config_attr :logger, :default, ::Logger, nil, :default
716
713
 
717
714
  # @private
718
715
  def initialize parent_config = nil