google-cloud-dialogflow-v2 1.4.0 → 1.5.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (89) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +30 -20
  3. data/lib/google/cloud/dialogflow/v2/agents/client.rb +33 -10
  4. data/lib/google/cloud/dialogflow/v2/agents/operations.rb +12 -15
  5. data/lib/google/cloud/dialogflow/v2/agents/rest/client.rb +33 -10
  6. data/lib/google/cloud/dialogflow/v2/agents/rest/operations.rb +43 -38
  7. data/lib/google/cloud/dialogflow/v2/agents/rest/service_stub.rb +86 -56
  8. data/lib/google/cloud/dialogflow/v2/answer_records/client.rb +29 -3
  9. data/lib/google/cloud/dialogflow/v2/answer_records/rest/client.rb +29 -3
  10. data/lib/google/cloud/dialogflow/v2/answer_records/rest/service_stub.rb +30 -14
  11. data/lib/google/cloud/dialogflow/v2/contexts/client.rb +29 -7
  12. data/lib/google/cloud/dialogflow/v2/contexts/rest/client.rb +29 -7
  13. data/lib/google/cloud/dialogflow/v2/contexts/rest/service_stub.rb +62 -38
  14. data/lib/google/cloud/dialogflow/v2/conversation_datasets/client.rb +32 -6
  15. data/lib/google/cloud/dialogflow/v2/conversation_datasets/operations.rb +12 -15
  16. data/lib/google/cloud/dialogflow/v2/conversation_datasets/rest/client.rb +32 -6
  17. data/lib/google/cloud/dialogflow/v2/conversation_datasets/rest/operations.rb +43 -38
  18. data/lib/google/cloud/dialogflow/v2/conversation_datasets/rest/service_stub.rb +54 -32
  19. data/lib/google/cloud/dialogflow/v2/conversation_models/client.rb +35 -10
  20. data/lib/google/cloud/dialogflow/v2/conversation_models/operations.rb +12 -15
  21. data/lib/google/cloud/dialogflow/v2/conversation_models/rest/client.rb +35 -10
  22. data/lib/google/cloud/dialogflow/v2/conversation_models/rest/operations.rb +43 -38
  23. data/lib/google/cloud/dialogflow/v2/conversation_models/rest/service_stub.rb +86 -56
  24. data/lib/google/cloud/dialogflow/v2/conversation_profile_services_pb.rb +6 -2
  25. data/lib/google/cloud/dialogflow/v2/conversation_profiles/client.rb +37 -10
  26. data/lib/google/cloud/dialogflow/v2/conversation_profiles/operations.rb +12 -15
  27. data/lib/google/cloud/dialogflow/v2/conversation_profiles/rest/client.rb +37 -10
  28. data/lib/google/cloud/dialogflow/v2/conversation_profiles/rest/operations.rb +43 -38
  29. data/lib/google/cloud/dialogflow/v2/conversation_profiles/rest/service_stub.rb +70 -44
  30. data/lib/google/cloud/dialogflow/v2/conversations/client.rb +30 -10
  31. data/lib/google/cloud/dialogflow/v2/conversations/rest/client.rb +30 -10
  32. data/lib/google/cloud/dialogflow/v2/conversations/rest/service_stub.rb +86 -56
  33. data/lib/google/cloud/dialogflow/v2/documents/client.rb +35 -9
  34. data/lib/google/cloud/dialogflow/v2/documents/operations.rb +12 -15
  35. data/lib/google/cloud/dialogflow/v2/documents/rest/client.rb +35 -9
  36. data/lib/google/cloud/dialogflow/v2/documents/rest/operations.rb +43 -38
  37. data/lib/google/cloud/dialogflow/v2/documents/rest/service_stub.rb +78 -50
  38. data/lib/google/cloud/dialogflow/v2/encryption_spec_service/client.rb +29 -3
  39. data/lib/google/cloud/dialogflow/v2/encryption_spec_service/operations.rb +12 -15
  40. data/lib/google/cloud/dialogflow/v2/encryption_spec_service/rest/client.rb +29 -3
  41. data/lib/google/cloud/dialogflow/v2/encryption_spec_service/rest/operations.rb +43 -38
  42. data/lib/google/cloud/dialogflow/v2/encryption_spec_service/rest/service_stub.rb +30 -14
  43. data/lib/google/cloud/dialogflow/v2/entity_types/client.rb +34 -11
  44. data/lib/google/cloud/dialogflow/v2/entity_types/operations.rb +12 -15
  45. data/lib/google/cloud/dialogflow/v2/entity_types/rest/client.rb +34 -11
  46. data/lib/google/cloud/dialogflow/v2/entity_types/rest/operations.rb +43 -38
  47. data/lib/google/cloud/dialogflow/v2/entity_types/rest/service_stub.rb +94 -62
  48. data/lib/google/cloud/dialogflow/v2/environments/client.rb +30 -7
  49. data/lib/google/cloud/dialogflow/v2/environments/rest/client.rb +30 -7
  50. data/lib/google/cloud/dialogflow/v2/environments/rest/service_stub.rb +62 -38
  51. data/lib/google/cloud/dialogflow/v2/fulfillments/client.rb +28 -3
  52. data/lib/google/cloud/dialogflow/v2/fulfillments/rest/client.rb +28 -3
  53. data/lib/google/cloud/dialogflow/v2/fulfillments/rest/service_stub.rb +30 -14
  54. data/lib/google/cloud/dialogflow/v2/generators/client.rb +29 -6
  55. data/lib/google/cloud/dialogflow/v2/generators/rest/client.rb +29 -6
  56. data/lib/google/cloud/dialogflow/v2/generators/rest/service_stub.rb +54 -32
  57. data/lib/google/cloud/dialogflow/v2/intent_pb.rb +1 -1
  58. data/lib/google/cloud/dialogflow/v2/intents/client.rb +31 -8
  59. data/lib/google/cloud/dialogflow/v2/intents/operations.rb +12 -15
  60. data/lib/google/cloud/dialogflow/v2/intents/rest/client.rb +31 -8
  61. data/lib/google/cloud/dialogflow/v2/intents/rest/operations.rb +43 -38
  62. data/lib/google/cloud/dialogflow/v2/intents/rest/service_stub.rb +70 -44
  63. data/lib/google/cloud/dialogflow/v2/knowledge_bases/client.rb +29 -6
  64. data/lib/google/cloud/dialogflow/v2/knowledge_bases/rest/client.rb +29 -6
  65. data/lib/google/cloud/dialogflow/v2/knowledge_bases/rest/service_stub.rb +54 -32
  66. data/lib/google/cloud/dialogflow/v2/participants/client.rb +29 -11
  67. data/lib/google/cloud/dialogflow/v2/participants/rest/client.rb +29 -10
  68. data/lib/google/cloud/dialogflow/v2/participants/rest/service_stub.rb +86 -56
  69. data/lib/google/cloud/dialogflow/v2/session_entity_types/client.rb +29 -6
  70. data/lib/google/cloud/dialogflow/v2/session_entity_types/rest/client.rb +29 -6
  71. data/lib/google/cloud/dialogflow/v2/session_entity_types/rest/service_stub.rb +54 -32
  72. data/lib/google/cloud/dialogflow/v2/sessions/client.rb +28 -3
  73. data/lib/google/cloud/dialogflow/v2/sessions/rest/client.rb +28 -2
  74. data/lib/google/cloud/dialogflow/v2/sessions/rest/service_stub.rb +22 -8
  75. data/lib/google/cloud/dialogflow/v2/version.rb +1 -1
  76. data/lib/google/cloud/dialogflow/v2/versions/client.rb +29 -6
  77. data/lib/google/cloud/dialogflow/v2/versions/rest/client.rb +29 -6
  78. data/lib/google/cloud/dialogflow/v2/versions/rest/service_stub.rb +54 -32
  79. data/proto_docs/google/api/client.rb +19 -0
  80. data/proto_docs/google/cloud/dialogflow/v2/answer_record.rb +3 -2
  81. data/proto_docs/google/cloud/dialogflow/v2/audio_config.rb +2 -2
  82. data/proto_docs/google/cloud/dialogflow/v2/conversation.rb +10 -6
  83. data/proto_docs/google/cloud/dialogflow/v2/conversation_dataset.rb +2 -2
  84. data/proto_docs/google/cloud/dialogflow/v2/conversation_profile.rb +7 -4
  85. data/proto_docs/google/cloud/dialogflow/v2/intent.rb +1 -1
  86. data/proto_docs/google/cloud/dialogflow/v2/participant.rb +10 -8
  87. data/proto_docs/google/cloud/dialogflow/v2/session.rb +12 -10
  88. data/proto_docs/google/longrunning/operations.rb +19 -14
  89. metadata +5 -5
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 9cea2fe8da22ccfcf2e715b29a7c81901d743a24706898e18c5a52af16f55158
4
- data.tar.gz: 36cfa8593169804d3982ba54628bfdd2e360f385f2c924ef45aa3b423332e35b
3
+ metadata.gz: eb5ef771b0d36925cd693a2771d4b14c2ff661f572a8a0c3190e24944da57257
4
+ data.tar.gz: b132c901e0172d946d41888688fd2621e6c4062f69234eab54cae29c7a6d2f52
5
5
  SHA512:
6
- metadata.gz: 3c3c61d6f852236b58116348c1e2ecff3251e0a2e267627bd2b3d227f2a67a7efab98d86d6aa0338eb9499d7d6fd370d9679f4e04610212d87be54cbcd848f3d
7
- data.tar.gz: f0ea1f2b3ce062afb13e18b93508803cd23076e3f724b585d1e96e4fe17cc229052e3ea2e7cbd91fde8086ea1c811428effc17a5a5f44ad66f2f9bd1708d6dd0
6
+ metadata.gz: 299886075fd50eece0bd60aa09f9751acd96fbb150666435a0e10e2dc4f39764754030f619fa55757aef7b025900c22ebe57808cfa461998b329639ae2cfaf29
7
+ data.tar.gz: 1cf1dd43265a13accb7281d46cb130ebafc5ad152b028c17cc89f7f1e3181aa19bce3a49beec17703197e90bd2071405124dbd6978fd6abd458503904d6ae8c8
data/README.md CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/dialogflow)
44
44
  for general usage information.
45
45
 
46
- ## Enabling Logging
47
-
48
- To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
- or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
51
- that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
- and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
53
-
54
- Configuring a Ruby stdlib logger:
46
+ ## Debug Logging
47
+
48
+ This library comes with opt-in Debug Logging that can help you troubleshoot
49
+ your application's integration with the API. When logging is activated, key
50
+ events such as requests and responses, along with data payloads and metadata
51
+ such as headers and client configuration, are logged to the standard error
52
+ stream.
53
+
54
+ **WARNING:** Client Library Debug Logging includes your data payloads in
55
+ plaintext, which could include sensitive data such as PII for yourself or your
56
+ customers, private keys, or other security data that could be compromising if
57
+ leaked. Always practice good data hygiene with your application logs, and follow
58
+ the principle of least access. Google also recommends that Client Library Debug
59
+ Logging be enabled only temporarily during active debugging, and not used
60
+ permanently in production.
61
+
62
+ To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
63
+ to the value `all`. Alternatively, you can set the value to a comma-delimited
64
+ list of client library gem names. This will select the default logging behavior,
65
+ which writes logs to the standard error stream. On a local workstation, this may
66
+ result in logs appearing on the console. When running on a Google Cloud hosting
67
+ service such as [Google Cloud Run](https://cloud.google.com/run), this generally
68
+ results in logs appearing alongside your application logs in the
69
+ [Google Cloud Logging](https://cloud.google.com/logging/) service.
70
+
71
+ You can customize logging by modifying the `logger` configuration when
72
+ constructing a client object. For example:
55
73
 
56
74
  ```ruby
75
+ require "google/cloud/dialogflow/v2"
57
76
  require "logger"
58
77
 
59
- module MyLogger
60
- LOGGER = Logger.new $stderr, level: Logger::WARN
61
- def logger
62
- LOGGER
63
- end
64
- end
65
-
66
- # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
67
- module GRPC
68
- extend MyLogger
78
+ client = ::Google::Cloud::Dialogflow::V2::Agents::Client.new do |config|
79
+ config.logger = Logger.new "my-app.log"
69
80
  end
70
81
  ```
71
82
 
72
-
73
83
  ## Google Cloud Samples
74
84
 
75
85
  To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
@@ -170,14 +170,26 @@ module Google
170
170
  universe_domain: @config.universe_domain,
171
171
  channel_args: @config.channel_args,
172
172
  interceptors: @config.interceptors,
173
- channel_pool_config: @config.channel_pool
173
+ channel_pool_config: @config.channel_pool,
174
+ logger: @config.logger
174
175
  )
175
176
 
177
+ @agents_stub.stub_logger&.info do |entry|
178
+ entry.set_system_name
179
+ entry.set_service
180
+ entry.message = "Created client for #{entry.service}"
181
+ entry.set_credentials_fields credentials
182
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
183
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
184
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
185
+ end
186
+
176
187
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
177
188
  config.credentials = credentials
178
189
  config.quota_project = @quota_project_id
179
190
  config.endpoint = @agents_stub.endpoint
180
191
  config.universe_domain = @agents_stub.universe_domain
192
+ config.logger = @agents_stub.logger if config.respond_to? :logger=
181
193
  end
182
194
  end
183
195
 
@@ -195,6 +207,15 @@ module Google
195
207
  #
196
208
  attr_reader :location_client
197
209
 
210
+ ##
211
+ # The logger used for request/response debug logging.
212
+ #
213
+ # @return [Logger]
214
+ #
215
+ def logger
216
+ @agents_stub.logger
217
+ end
218
+
198
219
  # Service calls
199
220
 
200
221
  ##
@@ -278,7 +299,6 @@ module Google
278
299
 
279
300
  @agents_stub.call_rpc :get_agent, request, options: options do |response, operation|
280
301
  yield response, operation if block_given?
281
- return response
282
302
  end
283
303
  rescue ::GRPC::BadStatus => e
284
304
  raise ::Google::Cloud::Error.from_error(e)
@@ -370,7 +390,6 @@ module Google
370
390
 
371
391
  @agents_stub.call_rpc :set_agent, request, options: options do |response, operation|
372
392
  yield response, operation if block_given?
373
- return response
374
393
  end
375
394
  rescue ::GRPC::BadStatus => e
376
395
  raise ::Google::Cloud::Error.from_error(e)
@@ -457,7 +476,6 @@ module Google
457
476
 
458
477
  @agents_stub.call_rpc :delete_agent, request, options: options do |response, operation|
459
478
  yield response, operation if block_given?
460
- return response
461
479
  end
462
480
  rescue ::GRPC::BadStatus => e
463
481
  raise ::Google::Cloud::Error.from_error(e)
@@ -560,7 +578,7 @@ module Google
560
578
  @agents_stub.call_rpc :search_agents, request, options: options do |response, operation|
561
579
  response = ::Gapic::PagedEnumerable.new @agents_stub, :search_agents, request, response, operation, options
562
580
  yield response, operation if block_given?
563
- return response
581
+ throw :response, response
564
582
  end
565
583
  rescue ::GRPC::BadStatus => e
566
584
  raise ::Google::Cloud::Error.from_error(e)
@@ -668,7 +686,7 @@ module Google
668
686
  @agents_stub.call_rpc :train_agent, request, options: options do |response, operation|
669
687
  response = ::Gapic::Operation.new response, @operations_client, options: options
670
688
  yield response, operation if block_given?
671
- return response
689
+ throw :response, response
672
690
  end
673
691
  rescue ::GRPC::BadStatus => e
674
692
  raise ::Google::Cloud::Error.from_error(e)
@@ -783,7 +801,7 @@ module Google
783
801
  @agents_stub.call_rpc :export_agent, request, options: options do |response, operation|
784
802
  response = ::Gapic::Operation.new response, @operations_client, options: options
785
803
  yield response, operation if block_given?
786
- return response
804
+ throw :response, response
787
805
  end
788
806
  rescue ::GRPC::BadStatus => e
789
807
  raise ::Google::Cloud::Error.from_error(e)
@@ -915,7 +933,7 @@ module Google
915
933
  @agents_stub.call_rpc :import_agent, request, options: options do |response, operation|
916
934
  response = ::Gapic::Operation.new response, @operations_client, options: options
917
935
  yield response, operation if block_given?
918
- return response
936
+ throw :response, response
919
937
  end
920
938
  rescue ::GRPC::BadStatus => e
921
939
  raise ::Google::Cloud::Error.from_error(e)
@@ -1045,7 +1063,7 @@ module Google
1045
1063
  @agents_stub.call_rpc :restore_agent, request, options: options do |response, operation|
1046
1064
  response = ::Gapic::Operation.new response, @operations_client, options: options
1047
1065
  yield response, operation if block_given?
1048
- return response
1066
+ throw :response, response
1049
1067
  end
1050
1068
  rescue ::GRPC::BadStatus => e
1051
1069
  raise ::Google::Cloud::Error.from_error(e)
@@ -1139,7 +1157,6 @@ module Google
1139
1157
 
1140
1158
  @agents_stub.call_rpc :get_validation_result, request, options: options do |response, operation|
1141
1159
  yield response, operation if block_given?
1142
- return response
1143
1160
  end
1144
1161
  rescue ::GRPC::BadStatus => e
1145
1162
  raise ::Google::Cloud::Error.from_error(e)
@@ -1228,6 +1245,11 @@ module Google
1228
1245
  # default endpoint URL. The default value of nil uses the environment
1229
1246
  # universe (usually the default "googleapis.com" universe).
1230
1247
  # @return [::String,nil]
1248
+ # @!attribute [rw] logger
1249
+ # A custom logger to use for request/response debug logging, or the value
1250
+ # `:default` (the default) to construct a default logger, or `nil` to
1251
+ # explicitly disable logging.
1252
+ # @return [::Logger,:default,nil]
1231
1253
  #
1232
1254
  class Configuration
1233
1255
  extend ::Gapic::Config
@@ -1252,6 +1274,7 @@ module Google
1252
1274
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1253
1275
  config_attr :quota_project, nil, ::String, nil
1254
1276
  config_attr :universe_domain, nil, ::String, nil
1277
+ config_attr :logger, :default, ::Logger, nil, :default
1255
1278
 
1256
1279
  # @private
1257
1280
  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
@@ -163,15 +163,27 @@ module Google
163
163
  endpoint: @config.endpoint,
164
164
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
165
165
  universe_domain: @config.universe_domain,
166
- credentials: credentials
166
+ credentials: credentials,
167
+ logger: @config.logger
167
168
  )
168
169
 
170
+ @agents_stub.logger(stub: true)&.info do |entry|
171
+ entry.set_system_name
172
+ entry.set_service
173
+ entry.message = "Created client for #{entry.service}"
174
+ entry.set_credentials_fields credentials
175
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
176
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
177
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
178
+ end
179
+
169
180
  @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
170
181
  config.credentials = credentials
171
182
  config.quota_project = @quota_project_id
172
183
  config.endpoint = @agents_stub.endpoint
173
184
  config.universe_domain = @agents_stub.universe_domain
174
185
  config.bindings_override = @config.bindings_override
186
+ config.logger = @agents_stub.logger if config.respond_to? :logger=
175
187
  end
176
188
  end
177
189
 
@@ -189,6 +201,15 @@ module Google
189
201
  #
190
202
  attr_reader :location_client
191
203
 
204
+ ##
205
+ # The logger used for request/response debug logging.
206
+ #
207
+ # @return [Logger]
208
+ #
209
+ def logger
210
+ @agents_stub.logger
211
+ end
212
+
192
213
  # Service calls
193
214
 
194
215
  ##
@@ -265,7 +286,6 @@ module Google
265
286
 
266
287
  @agents_stub.get_agent request, options do |result, operation|
267
288
  yield result, operation if block_given?
268
- return result
269
289
  end
270
290
  rescue ::Gapic::Rest::Error => e
271
291
  raise ::Google::Cloud::Error.from_error(e)
@@ -350,7 +370,6 @@ module Google
350
370
 
351
371
  @agents_stub.set_agent request, options do |result, operation|
352
372
  yield result, operation if block_given?
353
- return result
354
373
  end
355
374
  rescue ::Gapic::Rest::Error => e
356
375
  raise ::Google::Cloud::Error.from_error(e)
@@ -430,7 +449,6 @@ module Google
430
449
 
431
450
  @agents_stub.delete_agent request, options do |result, operation|
432
451
  yield result, operation if block_given?
433
- return result
434
452
  end
435
453
  rescue ::Gapic::Rest::Error => e
436
454
  raise ::Google::Cloud::Error.from_error(e)
@@ -526,7 +544,7 @@ module Google
526
544
  @agents_stub.search_agents request, options do |result, operation|
527
545
  result = ::Gapic::Rest::PagedEnumerable.new @agents_stub, :search_agents, "agents", request, result, options
528
546
  yield result, operation if block_given?
529
- return result
547
+ throw :response, result
530
548
  end
531
549
  rescue ::Gapic::Rest::Error => e
532
550
  raise ::Google::Cloud::Error.from_error(e)
@@ -627,7 +645,7 @@ module Google
627
645
  @agents_stub.train_agent request, options do |result, operation|
628
646
  result = ::Gapic::Operation.new result, @operations_client, options: options
629
647
  yield result, operation if block_given?
630
- return result
648
+ throw :response, result
631
649
  end
632
650
  rescue ::Gapic::Rest::Error => e
633
651
  raise ::Google::Cloud::Error.from_error(e)
@@ -735,7 +753,7 @@ module Google
735
753
  @agents_stub.export_agent request, options do |result, operation|
736
754
  result = ::Gapic::Operation.new result, @operations_client, options: options
737
755
  yield result, operation if block_given?
738
- return result
756
+ throw :response, result
739
757
  end
740
758
  rescue ::Gapic::Rest::Error => e
741
759
  raise ::Google::Cloud::Error.from_error(e)
@@ -860,7 +878,7 @@ module Google
860
878
  @agents_stub.import_agent request, options do |result, operation|
861
879
  result = ::Gapic::Operation.new result, @operations_client, options: options
862
880
  yield result, operation if block_given?
863
- return result
881
+ throw :response, result
864
882
  end
865
883
  rescue ::Gapic::Rest::Error => e
866
884
  raise ::Google::Cloud::Error.from_error(e)
@@ -983,7 +1001,7 @@ module Google
983
1001
  @agents_stub.restore_agent request, options do |result, operation|
984
1002
  result = ::Gapic::Operation.new result, @operations_client, options: options
985
1003
  yield result, operation if block_given?
986
- return result
1004
+ throw :response, result
987
1005
  end
988
1006
  rescue ::Gapic::Rest::Error => e
989
1007
  raise ::Google::Cloud::Error.from_error(e)
@@ -1070,7 +1088,6 @@ module Google
1070
1088
 
1071
1089
  @agents_stub.get_validation_result request, options do |result, operation|
1072
1090
  yield result, operation if block_given?
1073
- return result
1074
1091
  end
1075
1092
  rescue ::Gapic::Rest::Error => e
1076
1093
  raise ::Google::Cloud::Error.from_error(e)
@@ -1150,6 +1167,11 @@ module Google
1150
1167
  # default endpoint URL. The default value of nil uses the environment
1151
1168
  # universe (usually the default "googleapis.com" universe).
1152
1169
  # @return [::String,nil]
1170
+ # @!attribute [rw] logger
1171
+ # A custom logger to use for request/response debug logging, or the value
1172
+ # `:default` (the default) to construct a default logger, or `nil` to
1173
+ # explicitly disable logging.
1174
+ # @return [::Logger,:default,nil]
1153
1175
  #
1154
1176
  class Configuration
1155
1177
  extend ::Gapic::Config
@@ -1178,6 +1200,7 @@ module Google
1178
1200
  # by the host service.
1179
1201
  # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
1180
1202
  config_attr :bindings_override, {}, ::Hash, nil
1203
+ config_attr :logger, :default, ::Logger, nil, :default
1181
1204
 
1182
1205
  # @private
1183
1206
  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
  ##