google-cloud-domains-v1beta1 0.9.0 → 0.10.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 713a17b83d86fdd5902f64ff0a85fa0d1b023d2ed4dd48237bde552449174726
4
- data.tar.gz: bf8bd6564f81ab3795bf597acfc58eb33948593d993fbd3bc2d4abbc7fc8caf4
3
+ metadata.gz: 68ab7714ae9284075509637935ec0e7343cc845d8c5c0ced987bc0d83af0106b
4
+ data.tar.gz: 283c44561931f8118d0772c3bf3724d0484d35250e2873cc8e1aee2f4138b406
5
5
  SHA512:
6
- metadata.gz: 921725058d0097ffd4afe95f4b36a8ebf3399321fea77db3d738720f0d4a8a8ec034569fa468c62ba523dba041909f16acd956f6969eebc447d2989b10f1da35
7
- data.tar.gz: 3aa5938dca3d454369b319a1a00a86b9b57bbe078ba19a4eb77b7dd1980dd92b8a9ca77d8e3ee6ce24f5e1813b4caa2c2548117530c9dd0c0f9e6e3e332b34fd
6
+ metadata.gz: 184d41d2f9525fc7ceae8bd64afeac4460213d017b18a36a5210d2deaafee8f8d57326a40d51e728ad054a4bbef077b67819bd2c00201ba6391f03d9780bc344
7
+ data.tar.gz: 4087ba8a45d681de5ca1787d4ddd4db1c921d1e0aa9e1c5327243a248cd07f2bae7369f34f2aeabdb8c930eaad7df6dcf20a62d8290e58b453902d399413e760
data/README.md CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/domains)
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/domains/v1beta1"
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::Domains::V1beta1::Domains::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).
@@ -30,6 +30,9 @@ module Google
30
30
  # The Cloud Domains API enables management and configuration of domain names.
31
31
  #
32
32
  class Client
33
+ # @private
34
+ API_VERSION = ""
35
+
33
36
  # @private
34
37
  DEFAULT_ENDPOINT_TEMPLATE = "domains.$UNIVERSE_DOMAIN$"
35
38
 
@@ -161,8 +164,19 @@ module Google
161
164
  universe_domain: @config.universe_domain,
162
165
  channel_args: @config.channel_args,
163
166
  interceptors: @config.interceptors,
164
- channel_pool_config: @config.channel_pool
167
+ channel_pool_config: @config.channel_pool,
168
+ logger: @config.logger
165
169
  )
170
+
171
+ @domains_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
166
180
  end
167
181
 
168
182
  ##
@@ -172,6 +186,15 @@ module Google
172
186
  #
173
187
  attr_reader :operations_client
174
188
 
189
+ ##
190
+ # The logger used for request/response debug logging.
191
+ #
192
+ # @return [Logger]
193
+ #
194
+ def logger
195
+ @domains_stub.logger
196
+ end
197
+
175
198
  # Service calls
176
199
 
177
200
  ##
@@ -235,10 +258,11 @@ module Google
235
258
  # Customize the options with defaults
236
259
  metadata = @config.rpcs.search_domains.metadata.to_h
237
260
 
238
- # Set x-goog-api-client and x-goog-user-project headers
261
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
239
262
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
240
263
  lib_name: @config.lib_name, lib_version: @config.lib_version,
241
264
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
265
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
242
266
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
243
267
 
244
268
  header_params = {}
@@ -259,7 +283,6 @@ module Google
259
283
 
260
284
  @domains_stub.call_rpc :search_domains, request, options: options do |response, operation|
261
285
  yield response, operation if block_given?
262
- return response
263
286
  end
264
287
  rescue ::GRPC::BadStatus => e
265
288
  raise ::Google::Cloud::Error.from_error(e)
@@ -323,10 +346,11 @@ module Google
323
346
  # Customize the options with defaults
324
347
  metadata = @config.rpcs.retrieve_register_parameters.metadata.to_h
325
348
 
326
- # Set x-goog-api-client and x-goog-user-project headers
349
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
327
350
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
328
351
  lib_name: @config.lib_name, lib_version: @config.lib_version,
329
352
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
353
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
330
354
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
331
355
 
332
356
  header_params = {}
@@ -347,7 +371,6 @@ module Google
347
371
 
348
372
  @domains_stub.call_rpc :retrieve_register_parameters, request, options: options do |response, operation|
349
373
  yield response, operation if block_given?
350
- return response
351
374
  end
352
375
  rescue ::GRPC::BadStatus => e
353
376
  raise ::Google::Cloud::Error.from_error(e)
@@ -445,10 +468,11 @@ module Google
445
468
  # Customize the options with defaults
446
469
  metadata = @config.rpcs.register_domain.metadata.to_h
447
470
 
448
- # Set x-goog-api-client and x-goog-user-project headers
471
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
449
472
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
450
473
  lib_name: @config.lib_name, lib_version: @config.lib_version,
451
474
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
475
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
452
476
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
453
477
 
454
478
  header_params = {}
@@ -470,7 +494,7 @@ module Google
470
494
  @domains_stub.call_rpc :register_domain, request, options: options do |response, operation|
471
495
  response = ::Gapic::Operation.new response, @operations_client, options: options
472
496
  yield response, operation if block_given?
473
- return response
497
+ throw :response, response
474
498
  end
475
499
  rescue ::GRPC::BadStatus => e
476
500
  raise ::Google::Cloud::Error.from_error(e)
@@ -538,10 +562,11 @@ module Google
538
562
  # Customize the options with defaults
539
563
  metadata = @config.rpcs.retrieve_transfer_parameters.metadata.to_h
540
564
 
541
- # Set x-goog-api-client and x-goog-user-project headers
565
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
542
566
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
543
567
  lib_name: @config.lib_name, lib_version: @config.lib_version,
544
568
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
569
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
545
570
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
546
571
 
547
572
  header_params = {}
@@ -562,7 +587,6 @@ module Google
562
587
 
563
588
  @domains_stub.call_rpc :retrieve_transfer_parameters, request, options: options do |response, operation|
564
589
  yield response, operation if block_given?
565
- return response
566
590
  end
567
591
  rescue ::GRPC::BadStatus => e
568
592
  raise ::Google::Cloud::Error.from_error(e)
@@ -672,10 +696,11 @@ module Google
672
696
  # Customize the options with defaults
673
697
  metadata = @config.rpcs.transfer_domain.metadata.to_h
674
698
 
675
- # Set x-goog-api-client and x-goog-user-project headers
699
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
676
700
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
677
701
  lib_name: @config.lib_name, lib_version: @config.lib_version,
678
702
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
703
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
679
704
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
680
705
 
681
706
  header_params = {}
@@ -697,7 +722,7 @@ module Google
697
722
  @domains_stub.call_rpc :transfer_domain, request, options: options do |response, operation|
698
723
  response = ::Gapic::Operation.new response, @operations_client, options: options
699
724
  yield response, operation if block_given?
700
- return response
725
+ throw :response, response
701
726
  end
702
727
  rescue ::GRPC::BadStatus => e
703
728
  raise ::Google::Cloud::Error.from_error(e)
@@ -785,10 +810,11 @@ module Google
785
810
  # Customize the options with defaults
786
811
  metadata = @config.rpcs.list_registrations.metadata.to_h
787
812
 
788
- # Set x-goog-api-client and x-goog-user-project headers
813
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
789
814
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
790
815
  lib_name: @config.lib_name, lib_version: @config.lib_version,
791
816
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
817
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
792
818
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
793
819
 
794
820
  header_params = {}
@@ -810,7 +836,7 @@ module Google
810
836
  @domains_stub.call_rpc :list_registrations, request, options: options do |response, operation|
811
837
  response = ::Gapic::PagedEnumerable.new @domains_stub, :list_registrations, request, response, operation, options
812
838
  yield response, operation if block_given?
813
- return response
839
+ throw :response, response
814
840
  end
815
841
  rescue ::GRPC::BadStatus => e
816
842
  raise ::Google::Cloud::Error.from_error(e)
@@ -872,10 +898,11 @@ module Google
872
898
  # Customize the options with defaults
873
899
  metadata = @config.rpcs.get_registration.metadata.to_h
874
900
 
875
- # Set x-goog-api-client and x-goog-user-project headers
901
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
876
902
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
877
903
  lib_name: @config.lib_name, lib_version: @config.lib_version,
878
904
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
905
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
879
906
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
880
907
 
881
908
  header_params = {}
@@ -896,7 +923,6 @@ module Google
896
923
 
897
924
  @domains_stub.call_rpc :get_registration, request, options: options do |response, operation|
898
925
  yield response, operation if block_given?
899
- return response
900
926
  end
901
927
  rescue ::GRPC::BadStatus => e
902
928
  raise ::Google::Cloud::Error.from_error(e)
@@ -973,10 +999,11 @@ module Google
973
999
  # Customize the options with defaults
974
1000
  metadata = @config.rpcs.update_registration.metadata.to_h
975
1001
 
976
- # Set x-goog-api-client and x-goog-user-project headers
1002
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
977
1003
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
978
1004
  lib_name: @config.lib_name, lib_version: @config.lib_version,
979
1005
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
1006
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
980
1007
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
981
1008
 
982
1009
  header_params = {}
@@ -998,7 +1025,7 @@ module Google
998
1025
  @domains_stub.call_rpc :update_registration, request, options: options do |response, operation|
999
1026
  response = ::Gapic::Operation.new response, @operations_client, options: options
1000
1027
  yield response, operation if block_given?
1001
- return response
1028
+ throw :response, response
1002
1029
  end
1003
1030
  rescue ::GRPC::BadStatus => e
1004
1031
  raise ::Google::Cloud::Error.from_error(e)
@@ -1073,10 +1100,11 @@ module Google
1073
1100
  # Customize the options with defaults
1074
1101
  metadata = @config.rpcs.configure_management_settings.metadata.to_h
1075
1102
 
1076
- # Set x-goog-api-client and x-goog-user-project headers
1103
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1077
1104
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1078
1105
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1079
1106
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
1107
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1080
1108
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1081
1109
 
1082
1110
  header_params = {}
@@ -1098,7 +1126,7 @@ module Google
1098
1126
  @domains_stub.call_rpc :configure_management_settings, request, options: options do |response, operation|
1099
1127
  response = ::Gapic::Operation.new response, @operations_client, options: options
1100
1128
  yield response, operation if block_given?
1101
- return response
1129
+ throw :response, response
1102
1130
  end
1103
1131
  rescue ::GRPC::BadStatus => e
1104
1132
  raise ::Google::Cloud::Error.from_error(e)
@@ -1181,10 +1209,11 @@ module Google
1181
1209
  # Customize the options with defaults
1182
1210
  metadata = @config.rpcs.configure_dns_settings.metadata.to_h
1183
1211
 
1184
- # Set x-goog-api-client and x-goog-user-project headers
1212
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1185
1213
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1186
1214
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1187
1215
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
1216
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1188
1217
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1189
1218
 
1190
1219
  header_params = {}
@@ -1206,7 +1235,7 @@ module Google
1206
1235
  @domains_stub.call_rpc :configure_dns_settings, request, options: options do |response, operation|
1207
1236
  response = ::Gapic::Operation.new response, @operations_client, options: options
1208
1237
  yield response, operation if block_given?
1209
- return response
1238
+ throw :response, response
1210
1239
  end
1211
1240
  rescue ::GRPC::BadStatus => e
1212
1241
  raise ::Google::Cloud::Error.from_error(e)
@@ -1287,10 +1316,11 @@ module Google
1287
1316
  # Customize the options with defaults
1288
1317
  metadata = @config.rpcs.configure_contact_settings.metadata.to_h
1289
1318
 
1290
- # Set x-goog-api-client and x-goog-user-project headers
1319
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1291
1320
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1292
1321
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1293
1322
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
1323
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1294
1324
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1295
1325
 
1296
1326
  header_params = {}
@@ -1312,7 +1342,7 @@ module Google
1312
1342
  @domains_stub.call_rpc :configure_contact_settings, request, options: options do |response, operation|
1313
1343
  response = ::Gapic::Operation.new response, @operations_client, options: options
1314
1344
  yield response, operation if block_given?
1315
- return response
1345
+ throw :response, response
1316
1346
  end
1317
1347
  rescue ::GRPC::BadStatus => e
1318
1348
  raise ::Google::Cloud::Error.from_error(e)
@@ -1389,10 +1419,11 @@ module Google
1389
1419
  # Customize the options with defaults
1390
1420
  metadata = @config.rpcs.export_registration.metadata.to_h
1391
1421
 
1392
- # Set x-goog-api-client and x-goog-user-project headers
1422
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1393
1423
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1394
1424
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1395
1425
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
1426
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1396
1427
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1397
1428
 
1398
1429
  header_params = {}
@@ -1414,7 +1445,7 @@ module Google
1414
1445
  @domains_stub.call_rpc :export_registration, request, options: options do |response, operation|
1415
1446
  response = ::Gapic::Operation.new response, @operations_client, options: options
1416
1447
  yield response, operation if block_given?
1417
- return response
1448
+ throw :response, response
1418
1449
  end
1419
1450
  rescue ::GRPC::BadStatus => e
1420
1451
  raise ::Google::Cloud::Error.from_error(e)
@@ -1501,10 +1532,11 @@ module Google
1501
1532
  # Customize the options with defaults
1502
1533
  metadata = @config.rpcs.delete_registration.metadata.to_h
1503
1534
 
1504
- # Set x-goog-api-client and x-goog-user-project headers
1535
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1505
1536
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1506
1537
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1507
1538
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
1539
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1508
1540
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1509
1541
 
1510
1542
  header_params = {}
@@ -1526,7 +1558,7 @@ module Google
1526
1558
  @domains_stub.call_rpc :delete_registration, request, options: options do |response, operation|
1527
1559
  response = ::Gapic::Operation.new response, @operations_client, options: options
1528
1560
  yield response, operation if block_given?
1529
- return response
1561
+ throw :response, response
1530
1562
  end
1531
1563
  rescue ::GRPC::BadStatus => e
1532
1564
  raise ::Google::Cloud::Error.from_error(e)
@@ -1592,10 +1624,11 @@ module Google
1592
1624
  # Customize the options with defaults
1593
1625
  metadata = @config.rpcs.retrieve_authorization_code.metadata.to_h
1594
1626
 
1595
- # Set x-goog-api-client and x-goog-user-project headers
1627
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1596
1628
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1597
1629
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1598
1630
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
1631
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1599
1632
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1600
1633
 
1601
1634
  header_params = {}
@@ -1616,7 +1649,6 @@ module Google
1616
1649
 
1617
1650
  @domains_stub.call_rpc :retrieve_authorization_code, request, options: options do |response, operation|
1618
1651
  yield response, operation if block_given?
1619
- return response
1620
1652
  end
1621
1653
  rescue ::GRPC::BadStatus => e
1622
1654
  raise ::Google::Cloud::Error.from_error(e)
@@ -1681,10 +1713,11 @@ module Google
1681
1713
  # Customize the options with defaults
1682
1714
  metadata = @config.rpcs.reset_authorization_code.metadata.to_h
1683
1715
 
1684
- # Set x-goog-api-client and x-goog-user-project headers
1716
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1685
1717
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1686
1718
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1687
1719
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
1720
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1688
1721
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1689
1722
 
1690
1723
  header_params = {}
@@ -1705,7 +1738,6 @@ module Google
1705
1738
 
1706
1739
  @domains_stub.call_rpc :reset_authorization_code, request, options: options do |response, operation|
1707
1740
  yield response, operation if block_given?
1708
- return response
1709
1741
  end
1710
1742
  rescue ::GRPC::BadStatus => e
1711
1743
  raise ::Google::Cloud::Error.from_error(e)
@@ -1794,6 +1826,11 @@ module Google
1794
1826
  # default endpoint URL. The default value of nil uses the environment
1795
1827
  # universe (usually the default "googleapis.com" universe).
1796
1828
  # @return [::String,nil]
1829
+ # @!attribute [rw] logger
1830
+ # A custom logger to use for request/response debug logging, or the value
1831
+ # `:default` (the default) to construct a default logger, or `nil` to
1832
+ # explicitly disable logging.
1833
+ # @return [::Logger,:default,nil]
1797
1834
  #
1798
1835
  class Configuration
1799
1836
  extend ::Gapic::Config
@@ -1818,6 +1855,7 @@ module Google
1818
1855
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1819
1856
  config_attr :quota_project, nil, ::String, nil
1820
1857
  config_attr :universe_domain, nil, ::String, nil
1858
+ config_attr :logger, :default, ::Logger, nil, :default
1821
1859
 
1822
1860
  # @private
1823
1861
  def initialize parent_config = nil
@@ -26,6 +26,9 @@ module Google
26
26
  module Domains
27
27
  # Service that implements Longrunning Operations API.
28
28
  class Operations
29
+ # @private
30
+ API_VERSION = ""
31
+
29
32
  # @private
30
33
  DEFAULT_ENDPOINT_TEMPLATE = "domains.$UNIVERSE_DOMAIN$"
31
34
 
@@ -121,14 +124,6 @@ module Google
121
124
  # Lists operations that match the specified filter in the request. If the
122
125
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
123
126
  #
124
- # NOTE: the `name` binding allows API services to override the binding
125
- # to use different resource name schemes, such as `users/*/operations`. To
126
- # override the binding, API services can add a binding such as
127
- # `"/v1/{name=users/*}/operations"` to their service configuration.
128
- # For backwards compatibility, the default name includes the operations
129
- # collection id, however overriding users must ensure the name binding
130
- # is the parent resource, without the operations collection id.
131
- #
132
127
  # @overload list_operations(request, options = nil)
133
128
  # Pass arguments to `list_operations` via a request object, either of type
134
129
  # {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -191,10 +186,11 @@ module Google
191
186
  # Customize the options with defaults
192
187
  metadata = @config.rpcs.list_operations.metadata.to_h
193
188
 
194
- # Set x-goog-api-client and x-goog-user-project headers
189
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
195
190
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
196
191
  lib_name: @config.lib_name, lib_version: @config.lib_version,
197
192
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
193
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
198
194
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
199
195
 
200
196
  header_params = {}
@@ -217,7 +213,7 @@ module Google
217
213
  wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
218
214
  response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
219
215
  yield response, operation if block_given?
220
- return response
216
+ throw :response, response
221
217
  end
222
218
  rescue ::GRPC::BadStatus => e
223
219
  raise ::Google::Cloud::Error.from_error(e)
@@ -287,10 +283,11 @@ module Google
287
283
  # Customize the options with defaults
288
284
  metadata = @config.rpcs.get_operation.metadata.to_h
289
285
 
290
- # Set x-goog-api-client and x-goog-user-project headers
286
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
291
287
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
292
288
  lib_name: @config.lib_name, lib_version: @config.lib_version,
293
289
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
290
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
294
291
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
295
292
 
296
293
  header_params = {}
@@ -312,7 +309,7 @@ module Google
312
309
  @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
313
310
  response = ::Gapic::Operation.new response, @operations_client, options: options
314
311
  yield response, operation if block_given?
315
- return response
312
+ throw :response, response
316
313
  end
317
314
  rescue ::GRPC::BadStatus => e
318
315
  raise ::Google::Cloud::Error.from_error(e)
@@ -376,10 +373,11 @@ module Google
376
373
  # Customize the options with defaults
377
374
  metadata = @config.rpcs.delete_operation.metadata.to_h
378
375
 
379
- # Set x-goog-api-client and x-goog-user-project headers
376
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
380
377
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
381
378
  lib_name: @config.lib_name, lib_version: @config.lib_version,
382
379
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
380
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
383
381
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
384
382
 
385
383
  header_params = {}
@@ -400,7 +398,6 @@ module Google
400
398
 
401
399
  @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
402
400
  yield response, operation if block_given?
403
- return response
404
401
  end
405
402
  rescue ::GRPC::BadStatus => e
406
403
  raise ::Google::Cloud::Error.from_error(e)
@@ -415,8 +412,9 @@ module Google
415
412
  # other methods to check whether the cancellation succeeded or whether the
416
413
  # operation completed despite cancellation. On successful cancellation,
417
414
  # the operation is not deleted; instead, it becomes an operation with
418
- # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
419
- # 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`.
420
418
  #
421
419
  # @overload cancel_operation(request, options = nil)
422
420
  # Pass arguments to `cancel_operation` via a request object, either of type
@@ -470,10 +468,11 @@ module Google
470
468
  # Customize the options with defaults
471
469
  metadata = @config.rpcs.cancel_operation.metadata.to_h
472
470
 
473
- # Set x-goog-api-client and x-goog-user-project headers
471
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
474
472
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
475
473
  lib_name: @config.lib_name, lib_version: @config.lib_version,
476
474
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
475
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
477
476
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
478
477
 
479
478
  header_params = {}
@@ -494,7 +493,6 @@ module Google
494
493
 
495
494
  @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
496
495
  yield response, operation if block_given?
497
- return response
498
496
  end
499
497
  rescue ::GRPC::BadStatus => e
500
498
  raise ::Google::Cloud::Error.from_error(e)
@@ -574,10 +572,11 @@ module Google
574
572
  # Customize the options with defaults
575
573
  metadata = @config.rpcs.wait_operation.metadata.to_h
576
574
 
577
- # Set x-goog-api-client and x-goog-user-project headers
575
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
578
576
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
579
577
  lib_name: @config.lib_name, lib_version: @config.lib_version,
580
578
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION
579
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
581
580
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
582
581
 
583
582
  options.apply_defaults timeout: @config.rpcs.wait_operation.timeout,
@@ -591,7 +590,7 @@ module Google
591
590
  @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
592
591
  response = ::Gapic::Operation.new response, @operations_client, options: options
593
592
  yield response, operation if block_given?
594
- return response
593
+ throw :response, response
595
594
  end
596
595
  rescue ::GRPC::BadStatus => e
597
596
  raise ::Google::Cloud::Error.from_error(e)
@@ -680,6 +679,11 @@ module Google
680
679
  # default endpoint URL. The default value of nil uses the environment
681
680
  # universe (usually the default "googleapis.com" universe).
682
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]
683
687
  #
684
688
  class Configuration
685
689
  extend ::Gapic::Config
@@ -704,6 +708,7 @@ module Google
704
708
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
705
709
  config_attr :quota_project, nil, ::String, nil
706
710
  config_attr :universe_domain, nil, ::String, nil
711
+ config_attr :logger, :default, ::Logger, nil, :default
707
712
 
708
713
  # @private
709
714
  def initialize parent_config = nil