google-cloud-discovery_engine-v1beta 0.16.0 → 0.17.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (85) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +30 -20
  3. data/lib/google/cloud/discovery_engine/v1beta/completion_service/client.rb +32 -7
  4. data/lib/google/cloud/discovery_engine/v1beta/completion_service/operations.rb +12 -15
  5. data/lib/google/cloud/discovery_engine/v1beta/completion_service/rest/client.rb +32 -7
  6. data/lib/google/cloud/discovery_engine/v1beta/completion_service/rest/operations.rb +43 -38
  7. data/lib/google/cloud/discovery_engine/v1beta/completion_service/rest/service_stub.rb +62 -38
  8. data/lib/google/cloud/discovery_engine/v1beta/control_service/client.rb +29 -6
  9. data/lib/google/cloud/discovery_engine/v1beta/control_service/rest/client.rb +29 -6
  10. data/lib/google/cloud/discovery_engine/v1beta/control_service/rest/service_stub.rb +54 -32
  11. data/lib/google/cloud/discovery_engine/v1beta/conversational_search_service/client.rb +30 -14
  12. data/lib/google/cloud/discovery_engine/v1beta/conversational_search_service/rest/client.rb +30 -14
  13. data/lib/google/cloud/discovery_engine/v1beta/conversational_search_service/rest/service_stub.rb +118 -80
  14. data/lib/google/cloud/discovery_engine/v1beta/data_store_service/client.rb +31 -6
  15. data/lib/google/cloud/discovery_engine/v1beta/data_store_service/operations.rb +12 -15
  16. data/lib/google/cloud/discovery_engine/v1beta/data_store_service/rest/client.rb +31 -6
  17. data/lib/google/cloud/discovery_engine/v1beta/data_store_service/rest/operations.rb +43 -38
  18. data/lib/google/cloud/discovery_engine/v1beta/data_store_service/rest/service_stub.rb +54 -32
  19. data/lib/google/cloud/discovery_engine/v1beta/document_service/client.rb +31 -9
  20. data/lib/google/cloud/discovery_engine/v1beta/document_service/operations.rb +12 -15
  21. data/lib/google/cloud/discovery_engine/v1beta/document_service/rest/client.rb +31 -9
  22. data/lib/google/cloud/discovery_engine/v1beta/document_service/rest/operations.rb +43 -38
  23. data/lib/google/cloud/discovery_engine/v1beta/document_service/rest/service_stub.rb +78 -50
  24. data/lib/google/cloud/discovery_engine/v1beta/engine_service/client.rb +32 -9
  25. data/lib/google/cloud/discovery_engine/v1beta/engine_service/operations.rb +12 -15
  26. data/lib/google/cloud/discovery_engine/v1beta/engine_service/rest/client.rb +32 -9
  27. data/lib/google/cloud/discovery_engine/v1beta/engine_service/rest/operations.rb +43 -38
  28. data/lib/google/cloud/discovery_engine/v1beta/engine_service/rest/service_stub.rb +78 -50
  29. data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/client.rb +31 -5
  30. data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/operations.rb +12 -15
  31. data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/rest/client.rb +31 -5
  32. data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/rest/operations.rb +43 -38
  33. data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/rest/service_stub.rb +46 -26
  34. data/lib/google/cloud/discovery_engine/v1beta/grounded_generation_service/client.rb +28 -4
  35. data/lib/google/cloud/discovery_engine/v1beta/grounded_generation_service/rest/client.rb +28 -3
  36. data/lib/google/cloud/discovery_engine/v1beta/grounded_generation_service/rest/service_stub.rb +30 -14
  37. data/lib/google/cloud/discovery_engine/v1beta/project_service/client.rb +29 -2
  38. data/lib/google/cloud/discovery_engine/v1beta/project_service/operations.rb +12 -15
  39. data/lib/google/cloud/discovery_engine/v1beta/project_service/rest/client.rb +29 -2
  40. data/lib/google/cloud/discovery_engine/v1beta/project_service/rest/operations.rb +43 -38
  41. data/lib/google/cloud/discovery_engine/v1beta/project_service/rest/service_stub.rb +22 -8
  42. data/lib/google/cloud/discovery_engine/v1beta/rank_service/client.rb +28 -2
  43. data/lib/google/cloud/discovery_engine/v1beta/rank_service/rest/client.rb +28 -2
  44. data/lib/google/cloud/discovery_engine/v1beta/rank_service/rest/service_stub.rb +22 -8
  45. data/lib/google/cloud/discovery_engine/v1beta/recommendation_service/client.rb +28 -2
  46. data/lib/google/cloud/discovery_engine/v1beta/recommendation_service/rest/client.rb +28 -2
  47. data/lib/google/cloud/discovery_engine/v1beta/recommendation_service/rest/service_stub.rb +22 -8
  48. data/lib/google/cloud/discovery_engine/v1beta/sample_query_service/client.rb +30 -7
  49. data/lib/google/cloud/discovery_engine/v1beta/sample_query_service/operations.rb +12 -15
  50. data/lib/google/cloud/discovery_engine/v1beta/sample_query_service/rest/client.rb +30 -7
  51. data/lib/google/cloud/discovery_engine/v1beta/sample_query_service/rest/operations.rb +43 -38
  52. data/lib/google/cloud/discovery_engine/v1beta/sample_query_service/rest/service_stub.rb +62 -38
  53. data/lib/google/cloud/discovery_engine/v1beta/sample_query_set_service/client.rb +29 -6
  54. data/lib/google/cloud/discovery_engine/v1beta/sample_query_set_service/rest/client.rb +29 -6
  55. data/lib/google/cloud/discovery_engine/v1beta/sample_query_set_service/rest/service_stub.rb +54 -32
  56. data/lib/google/cloud/discovery_engine/v1beta/schema_service/client.rb +32 -6
  57. data/lib/google/cloud/discovery_engine/v1beta/schema_service/operations.rb +12 -15
  58. data/lib/google/cloud/discovery_engine/v1beta/schema_service/rest/client.rb +32 -6
  59. data/lib/google/cloud/discovery_engine/v1beta/schema_service/rest/operations.rb +43 -38
  60. data/lib/google/cloud/discovery_engine/v1beta/schema_service/rest/service_stub.rb +54 -32
  61. data/lib/google/cloud/discovery_engine/v1beta/search_service/client.rb +30 -3
  62. data/lib/google/cloud/discovery_engine/v1beta/search_service/rest/client.rb +28 -3
  63. data/lib/google/cloud/discovery_engine/v1beta/search_service/rest/service_stub.rb +30 -14
  64. data/lib/google/cloud/discovery_engine/v1beta/search_tuning_service/client.rb +29 -3
  65. data/lib/google/cloud/discovery_engine/v1beta/search_tuning_service/operations.rb +12 -15
  66. data/lib/google/cloud/discovery_engine/v1beta/search_tuning_service/rest/client.rb +29 -3
  67. data/lib/google/cloud/discovery_engine/v1beta/search_tuning_service/rest/operations.rb +43 -38
  68. data/lib/google/cloud/discovery_engine/v1beta/search_tuning_service/rest/service_stub.rb +30 -14
  69. data/lib/google/cloud/discovery_engine/v1beta/serving_config_service/client.rb +29 -4
  70. data/lib/google/cloud/discovery_engine/v1beta/serving_config_service/rest/client.rb +29 -4
  71. data/lib/google/cloud/discovery_engine/v1beta/serving_config_service/rest/service_stub.rb +38 -20
  72. data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/client.rb +40 -16
  73. data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/operations.rb +12 -15
  74. data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/rest/client.rb +40 -16
  75. data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/rest/operations.rb +43 -38
  76. data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/rest/service_stub.rb +134 -92
  77. data/lib/google/cloud/discovery_engine/v1beta/user_event_service/client.rb +30 -5
  78. data/lib/google/cloud/discovery_engine/v1beta/user_event_service/operations.rb +12 -15
  79. data/lib/google/cloud/discovery_engine/v1beta/user_event_service/rest/client.rb +30 -5
  80. data/lib/google/cloud/discovery_engine/v1beta/user_event_service/rest/operations.rb +43 -38
  81. data/lib/google/cloud/discovery_engine/v1beta/user_event_service/rest/service_stub.rb +46 -26
  82. data/lib/google/cloud/discovery_engine/v1beta/version.rb +1 -1
  83. data/proto_docs/google/api/client.rb +19 -0
  84. data/proto_docs/google/longrunning/operations.rb +19 -14
  85. metadata +5 -5
@@ -165,14 +165,26 @@ module Google
165
165
  universe_domain: @config.universe_domain,
166
166
  channel_args: @config.channel_args,
167
167
  interceptors: @config.interceptors,
168
- channel_pool_config: @config.channel_pool
168
+ channel_pool_config: @config.channel_pool,
169
+ logger: @config.logger
169
170
  )
170
171
 
172
+ @site_search_engine_service_stub.stub_logger&.info do |entry|
173
+ entry.set_system_name
174
+ entry.set_service
175
+ entry.message = "Created client for #{entry.service}"
176
+ entry.set_credentials_fields credentials
177
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
178
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
179
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
180
+ end
181
+
171
182
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
172
183
  config.credentials = credentials
173
184
  config.quota_project = @quota_project_id
174
185
  config.endpoint = @site_search_engine_service_stub.endpoint
175
186
  config.universe_domain = @site_search_engine_service_stub.universe_domain
187
+ config.logger = @site_search_engine_service_stub.logger if config.respond_to? :logger=
176
188
  end
177
189
  end
178
190
 
@@ -190,6 +202,15 @@ module Google
190
202
  #
191
203
  attr_reader :location_client
192
204
 
205
+ ##
206
+ # The logger used for request/response debug logging.
207
+ #
208
+ # @return [Logger]
209
+ #
210
+ def logger
211
+ @site_search_engine_service_stub.logger
212
+ end
213
+
193
214
  # Service calls
194
215
 
195
216
  ##
@@ -280,7 +301,6 @@ module Google
280
301
 
281
302
  @site_search_engine_service_stub.call_rpc :get_site_search_engine, request, options: options do |response, operation|
282
303
  yield response, operation if block_given?
283
- return response
284
304
  end
285
305
  rescue ::GRPC::BadStatus => e
286
306
  raise ::Google::Cloud::Error.from_error(e)
@@ -379,7 +399,7 @@ module Google
379
399
  @site_search_engine_service_stub.call_rpc :create_target_site, request, options: options do |response, operation|
380
400
  response = ::Gapic::Operation.new response, @operations_client, options: options
381
401
  yield response, operation if block_given?
382
- return response
402
+ throw :response, response
383
403
  end
384
404
  rescue ::GRPC::BadStatus => e
385
405
  raise ::Google::Cloud::Error.from_error(e)
@@ -480,7 +500,7 @@ module Google
480
500
  @site_search_engine_service_stub.call_rpc :batch_create_target_sites, request, options: options do |response, operation|
481
501
  response = ::Gapic::Operation.new response, @operations_client, options: options
482
502
  yield response, operation if block_given?
483
- return response
503
+ throw :response, response
484
504
  end
485
505
  rescue ::GRPC::BadStatus => e
486
506
  raise ::Google::Cloud::Error.from_error(e)
@@ -576,7 +596,6 @@ module Google
576
596
 
577
597
  @site_search_engine_service_stub.call_rpc :get_target_site, request, options: options do |response, operation|
578
598
  yield response, operation if block_given?
579
- return response
580
599
  end
581
600
  rescue ::GRPC::BadStatus => e
582
601
  raise ::Google::Cloud::Error.from_error(e)
@@ -676,7 +695,7 @@ module Google
676
695
  @site_search_engine_service_stub.call_rpc :update_target_site, request, options: options do |response, operation|
677
696
  response = ::Gapic::Operation.new response, @operations_client, options: options
678
697
  yield response, operation if block_given?
679
- return response
698
+ throw :response, response
680
699
  end
681
700
  rescue ::GRPC::BadStatus => e
682
701
  raise ::Google::Cloud::Error.from_error(e)
@@ -780,7 +799,7 @@ module Google
780
799
  @site_search_engine_service_stub.call_rpc :delete_target_site, request, options: options do |response, operation|
781
800
  response = ::Gapic::Operation.new response, @operations_client, options: options
782
801
  yield response, operation if block_given?
783
- return response
802
+ throw :response, response
784
803
  end
785
804
  rescue ::GRPC::BadStatus => e
786
805
  raise ::Google::Cloud::Error.from_error(e)
@@ -890,7 +909,7 @@ module Google
890
909
  @site_search_engine_service_stub.call_rpc :list_target_sites, request, options: options do |response, operation|
891
910
  response = ::Gapic::PagedEnumerable.new @site_search_engine_service_stub, :list_target_sites, request, response, operation, options
892
911
  yield response, operation if block_given?
893
- return response
912
+ throw :response, response
894
913
  end
895
914
  rescue ::GRPC::BadStatus => e
896
915
  raise ::Google::Cloud::Error.from_error(e)
@@ -990,7 +1009,7 @@ module Google
990
1009
  @site_search_engine_service_stub.call_rpc :create_sitemap, request, options: options do |response, operation|
991
1010
  response = ::Gapic::Operation.new response, @operations_client, options: options
992
1011
  yield response, operation if block_given?
993
- return response
1012
+ throw :response, response
994
1013
  end
995
1014
  rescue ::GRPC::BadStatus => e
996
1015
  raise ::Google::Cloud::Error.from_error(e)
@@ -1093,7 +1112,7 @@ module Google
1093
1112
  @site_search_engine_service_stub.call_rpc :delete_sitemap, request, options: options do |response, operation|
1094
1113
  response = ::Gapic::Operation.new response, @operations_client, options: options
1095
1114
  yield response, operation if block_given?
1096
- return response
1115
+ throw :response, response
1097
1116
  end
1098
1117
  rescue ::GRPC::BadStatus => e
1099
1118
  raise ::Google::Cloud::Error.from_error(e)
@@ -1188,7 +1207,6 @@ module Google
1188
1207
 
1189
1208
  @site_search_engine_service_stub.call_rpc :fetch_sitemaps, request, options: options do |response, operation|
1190
1209
  yield response, operation if block_given?
1191
- return response
1192
1210
  end
1193
1211
  rescue ::GRPC::BadStatus => e
1194
1212
  raise ::Google::Cloud::Error.from_error(e)
@@ -1285,7 +1303,7 @@ module Google
1285
1303
  @site_search_engine_service_stub.call_rpc :enable_advanced_site_search, request, options: options do |response, operation|
1286
1304
  response = ::Gapic::Operation.new response, @operations_client, options: options
1287
1305
  yield response, operation if block_given?
1288
- return response
1306
+ throw :response, response
1289
1307
  end
1290
1308
  rescue ::GRPC::BadStatus => e
1291
1309
  raise ::Google::Cloud::Error.from_error(e)
@@ -1382,7 +1400,7 @@ module Google
1382
1400
  @site_search_engine_service_stub.call_rpc :disable_advanced_site_search, request, options: options do |response, operation|
1383
1401
  response = ::Gapic::Operation.new response, @operations_client, options: options
1384
1402
  yield response, operation if block_given?
1385
- return response
1403
+ throw :response, response
1386
1404
  end
1387
1405
  rescue ::GRPC::BadStatus => e
1388
1406
  raise ::Google::Cloud::Error.from_error(e)
@@ -1488,7 +1506,7 @@ module Google
1488
1506
  @site_search_engine_service_stub.call_rpc :recrawl_uris, request, options: options do |response, operation|
1489
1507
  response = ::Gapic::Operation.new response, @operations_client, options: options
1490
1508
  yield response, operation if block_given?
1491
- return response
1509
+ throw :response, response
1492
1510
  end
1493
1511
  rescue ::GRPC::BadStatus => e
1494
1512
  raise ::Google::Cloud::Error.from_error(e)
@@ -1585,7 +1603,7 @@ module Google
1585
1603
  @site_search_engine_service_stub.call_rpc :batch_verify_target_sites, request, options: options do |response, operation|
1586
1604
  response = ::Gapic::Operation.new response, @operations_client, options: options
1587
1605
  yield response, operation if block_given?
1588
- return response
1606
+ throw :response, response
1589
1607
  end
1590
1608
  rescue ::GRPC::BadStatus => e
1591
1609
  raise ::Google::Cloud::Error.from_error(e)
@@ -1693,7 +1711,7 @@ module Google
1693
1711
  @site_search_engine_service_stub.call_rpc :fetch_domain_verification_status, request, options: options do |response, operation|
1694
1712
  response = ::Gapic::PagedEnumerable.new @site_search_engine_service_stub, :fetch_domain_verification_status, request, response, operation, options
1695
1713
  yield response, operation if block_given?
1696
- return response
1714
+ throw :response, response
1697
1715
  end
1698
1716
  rescue ::GRPC::BadStatus => e
1699
1717
  raise ::Google::Cloud::Error.from_error(e)
@@ -1782,6 +1800,11 @@ module Google
1782
1800
  # default endpoint URL. The default value of nil uses the environment
1783
1801
  # universe (usually the default "googleapis.com" universe).
1784
1802
  # @return [::String,nil]
1803
+ # @!attribute [rw] logger
1804
+ # A custom logger to use for request/response debug logging, or the value
1805
+ # `:default` (the default) to construct a default logger, or `nil` to
1806
+ # explicitly disable logging.
1807
+ # @return [::Logger,:default,nil]
1785
1808
  #
1786
1809
  class Configuration
1787
1810
  extend ::Gapic::Config
@@ -1806,6 +1829,7 @@ module Google
1806
1829
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1807
1830
  config_attr :quota_project, nil, ::String, nil
1808
1831
  config_attr :universe_domain, nil, ::String, nil
1832
+ config_attr :logger, :default, ::Logger, nil, :default
1809
1833
 
1810
1834
  # @private
1811
1835
  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
@@ -158,14 +158,26 @@ module Google
158
158
  endpoint: @config.endpoint,
159
159
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
160
160
  universe_domain: @config.universe_domain,
161
- credentials: credentials
161
+ credentials: credentials,
162
+ logger: @config.logger
162
163
  )
163
164
 
165
+ @site_search_engine_service_stub.logger(stub: true)&.info do |entry|
166
+ entry.set_system_name
167
+ entry.set_service
168
+ entry.message = "Created client for #{entry.service}"
169
+ entry.set_credentials_fields credentials
170
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
171
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
172
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
173
+ end
174
+
164
175
  @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
165
176
  config.credentials = credentials
166
177
  config.quota_project = @quota_project_id
167
178
  config.endpoint = @site_search_engine_service_stub.endpoint
168
179
  config.universe_domain = @site_search_engine_service_stub.universe_domain
180
+ config.logger = @site_search_engine_service_stub.logger if config.respond_to? :logger=
169
181
  end
170
182
  end
171
183
 
@@ -183,6 +195,15 @@ module Google
183
195
  #
184
196
  attr_reader :location_client
185
197
 
198
+ ##
199
+ # The logger used for request/response debug logging.
200
+ #
201
+ # @return [Logger]
202
+ #
203
+ def logger
204
+ @site_search_engine_service_stub.logger
205
+ end
206
+
186
207
  # Service calls
187
208
 
188
209
  ##
@@ -266,7 +287,6 @@ module Google
266
287
 
267
288
  @site_search_engine_service_stub.get_site_search_engine request, options do |result, operation|
268
289
  yield result, operation if block_given?
269
- return result
270
290
  end
271
291
  rescue ::Gapic::Rest::Error => e
272
292
  raise ::Google::Cloud::Error.from_error(e)
@@ -358,7 +378,7 @@ module Google
358
378
  @site_search_engine_service_stub.create_target_site request, options do |result, operation|
359
379
  result = ::Gapic::Operation.new result, @operations_client, options: options
360
380
  yield result, operation if block_given?
361
- return result
381
+ throw :response, result
362
382
  end
363
383
  rescue ::Gapic::Rest::Error => e
364
384
  raise ::Google::Cloud::Error.from_error(e)
@@ -452,7 +472,7 @@ module Google
452
472
  @site_search_engine_service_stub.batch_create_target_sites request, options do |result, operation|
453
473
  result = ::Gapic::Operation.new result, @operations_client, options: options
454
474
  yield result, operation if block_given?
455
- return result
475
+ throw :response, result
456
476
  end
457
477
  rescue ::Gapic::Rest::Error => e
458
478
  raise ::Google::Cloud::Error.from_error(e)
@@ -541,7 +561,6 @@ module Google
541
561
 
542
562
  @site_search_engine_service_stub.get_target_site request, options do |result, operation|
543
563
  yield result, operation if block_given?
544
- return result
545
564
  end
546
565
  rescue ::Gapic::Rest::Error => e
547
566
  raise ::Google::Cloud::Error.from_error(e)
@@ -634,7 +653,7 @@ module Google
634
653
  @site_search_engine_service_stub.update_target_site request, options do |result, operation|
635
654
  result = ::Gapic::Operation.new result, @operations_client, options: options
636
655
  yield result, operation if block_given?
637
- return result
656
+ throw :response, result
638
657
  end
639
658
  rescue ::Gapic::Rest::Error => e
640
659
  raise ::Google::Cloud::Error.from_error(e)
@@ -731,7 +750,7 @@ module Google
731
750
  @site_search_engine_service_stub.delete_target_site request, options do |result, operation|
732
751
  result = ::Gapic::Operation.new result, @operations_client, options: options
733
752
  yield result, operation if block_given?
734
- return result
753
+ throw :response, result
735
754
  end
736
755
  rescue ::Gapic::Rest::Error => e
737
756
  raise ::Google::Cloud::Error.from_error(e)
@@ -834,7 +853,7 @@ module Google
834
853
  @site_search_engine_service_stub.list_target_sites request, options do |result, operation|
835
854
  result = ::Gapic::Rest::PagedEnumerable.new @site_search_engine_service_stub, :list_target_sites, "target_sites", request, result, options
836
855
  yield result, operation if block_given?
837
- return result
856
+ throw :response, result
838
857
  end
839
858
  rescue ::Gapic::Rest::Error => e
840
859
  raise ::Google::Cloud::Error.from_error(e)
@@ -927,7 +946,7 @@ module Google
927
946
  @site_search_engine_service_stub.create_sitemap request, options do |result, operation|
928
947
  result = ::Gapic::Operation.new result, @operations_client, options: options
929
948
  yield result, operation if block_given?
930
- return result
949
+ throw :response, result
931
950
  end
932
951
  rescue ::Gapic::Rest::Error => e
933
952
  raise ::Google::Cloud::Error.from_error(e)
@@ -1023,7 +1042,7 @@ module Google
1023
1042
  @site_search_engine_service_stub.delete_sitemap request, options do |result, operation|
1024
1043
  result = ::Gapic::Operation.new result, @operations_client, options: options
1025
1044
  yield result, operation if block_given?
1026
- return result
1045
+ throw :response, result
1027
1046
  end
1028
1047
  rescue ::Gapic::Rest::Error => e
1029
1048
  raise ::Google::Cloud::Error.from_error(e)
@@ -1111,7 +1130,6 @@ module Google
1111
1130
 
1112
1131
  @site_search_engine_service_stub.fetch_sitemaps request, options do |result, operation|
1113
1132
  yield result, operation if block_given?
1114
- return result
1115
1133
  end
1116
1134
  rescue ::Gapic::Rest::Error => e
1117
1135
  raise ::Google::Cloud::Error.from_error(e)
@@ -1201,7 +1219,7 @@ module Google
1201
1219
  @site_search_engine_service_stub.enable_advanced_site_search request, options do |result, operation|
1202
1220
  result = ::Gapic::Operation.new result, @operations_client, options: options
1203
1221
  yield result, operation if block_given?
1204
- return result
1222
+ throw :response, result
1205
1223
  end
1206
1224
  rescue ::Gapic::Rest::Error => e
1207
1225
  raise ::Google::Cloud::Error.from_error(e)
@@ -1291,7 +1309,7 @@ module Google
1291
1309
  @site_search_engine_service_stub.disable_advanced_site_search request, options do |result, operation|
1292
1310
  result = ::Gapic::Operation.new result, @operations_client, options: options
1293
1311
  yield result, operation if block_given?
1294
- return result
1312
+ throw :response, result
1295
1313
  end
1296
1314
  rescue ::Gapic::Rest::Error => e
1297
1315
  raise ::Google::Cloud::Error.from_error(e)
@@ -1390,7 +1408,7 @@ module Google
1390
1408
  @site_search_engine_service_stub.recrawl_uris request, options do |result, operation|
1391
1409
  result = ::Gapic::Operation.new result, @operations_client, options: options
1392
1410
  yield result, operation if block_given?
1393
- return result
1411
+ throw :response, result
1394
1412
  end
1395
1413
  rescue ::Gapic::Rest::Error => e
1396
1414
  raise ::Google::Cloud::Error.from_error(e)
@@ -1480,7 +1498,7 @@ module Google
1480
1498
  @site_search_engine_service_stub.batch_verify_target_sites request, options do |result, operation|
1481
1499
  result = ::Gapic::Operation.new result, @operations_client, options: options
1482
1500
  yield result, operation if block_given?
1483
- return result
1501
+ throw :response, result
1484
1502
  end
1485
1503
  rescue ::Gapic::Rest::Error => e
1486
1504
  raise ::Google::Cloud::Error.from_error(e)
@@ -1581,7 +1599,7 @@ module Google
1581
1599
  @site_search_engine_service_stub.fetch_domain_verification_status request, options do |result, operation|
1582
1600
  result = ::Gapic::Rest::PagedEnumerable.new @site_search_engine_service_stub, :fetch_domain_verification_status, "target_sites", request, result, options
1583
1601
  yield result, operation if block_given?
1584
- return result
1602
+ throw :response, result
1585
1603
  end
1586
1604
  rescue ::Gapic::Rest::Error => e
1587
1605
  raise ::Google::Cloud::Error.from_error(e)
@@ -1661,6 +1679,11 @@ module Google
1661
1679
  # default endpoint URL. The default value of nil uses the environment
1662
1680
  # universe (usually the default "googleapis.com" universe).
1663
1681
  # @return [::String,nil]
1682
+ # @!attribute [rw] logger
1683
+ # A custom logger to use for request/response debug logging, or the value
1684
+ # `:default` (the default) to construct a default logger, or `nil` to
1685
+ # explicitly disable logging.
1686
+ # @return [::Logger,:default,nil]
1664
1687
  #
1665
1688
  class Configuration
1666
1689
  extend ::Gapic::Config
@@ -1682,6 +1705,7 @@ module Google
1682
1705
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1683
1706
  config_attr :quota_project, nil, ::String, nil
1684
1707
  config_attr :universe_domain, nil, ::String, nil
1708
+ config_attr :logger, :default, ::Logger, nil, :default
1685
1709
 
1686
1710
  # @private
1687
1711
  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
  ##