google-cloud-dialogflow-cx-v3 1.2.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 (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