google-cloud-domains-v1beta1 0.9.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -32,6 +32,9 @@ module Google
32
32
  # The Cloud Domains API enables management and configuration of domain names.
33
33
  #
34
34
  class Client
35
+ # @private
36
+ API_VERSION = ""
37
+
35
38
  # @private
36
39
  DEFAULT_ENDPOINT_TEMPLATE = "domains.$UNIVERSE_DOMAIN$"
37
40
 
@@ -154,8 +157,19 @@ module Google
154
157
  endpoint: @config.endpoint,
155
158
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
156
159
  universe_domain: @config.universe_domain,
157
- credentials: credentials
160
+ credentials: credentials,
161
+ logger: @config.logger
158
162
  )
163
+
164
+ @domains_stub.logger(stub: true)&.info do |entry|
165
+ entry.set_system_name
166
+ entry.set_service
167
+ entry.message = "Created client for #{entry.service}"
168
+ entry.set_credentials_fields credentials
169
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
170
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
171
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
172
+ end
159
173
  end
160
174
 
161
175
  ##
@@ -165,6 +179,15 @@ module Google
165
179
  #
166
180
  attr_reader :operations_client
167
181
 
182
+ ##
183
+ # The logger used for request/response debug logging.
184
+ #
185
+ # @return [Logger]
186
+ #
187
+ def logger
188
+ @domains_stub.logger
189
+ end
190
+
168
191
  # Service calls
169
192
 
170
193
  ##
@@ -227,12 +250,13 @@ module Google
227
250
  # Customize the options with defaults
228
251
  call_metadata = @config.rpcs.search_domains.metadata.to_h
229
252
 
230
- # Set x-goog-api-client and x-goog-user-project headers
253
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
231
254
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
232
255
  lib_name: @config.lib_name, lib_version: @config.lib_version,
233
256
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
234
257
  transports_version_send: [:rest]
235
258
 
259
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
236
260
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
237
261
 
238
262
  options.apply_defaults timeout: @config.rpcs.search_domains.timeout,
@@ -245,7 +269,6 @@ module Google
245
269
 
246
270
  @domains_stub.search_domains request, options do |result, operation|
247
271
  yield result, operation if block_given?
248
- return result
249
272
  end
250
273
  rescue ::Gapic::Rest::Error => e
251
274
  raise ::Google::Cloud::Error.from_error(e)
@@ -308,12 +331,13 @@ module Google
308
331
  # Customize the options with defaults
309
332
  call_metadata = @config.rpcs.retrieve_register_parameters.metadata.to_h
310
333
 
311
- # Set x-goog-api-client and x-goog-user-project headers
334
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
312
335
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
313
336
  lib_name: @config.lib_name, lib_version: @config.lib_version,
314
337
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
315
338
  transports_version_send: [:rest]
316
339
 
340
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
317
341
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
318
342
 
319
343
  options.apply_defaults timeout: @config.rpcs.retrieve_register_parameters.timeout,
@@ -326,7 +350,6 @@ module Google
326
350
 
327
351
  @domains_stub.retrieve_register_parameters request, options do |result, operation|
328
352
  yield result, operation if block_given?
329
- return result
330
353
  end
331
354
  rescue ::Gapic::Rest::Error => e
332
355
  raise ::Google::Cloud::Error.from_error(e)
@@ -423,12 +446,13 @@ module Google
423
446
  # Customize the options with defaults
424
447
  call_metadata = @config.rpcs.register_domain.metadata.to_h
425
448
 
426
- # Set x-goog-api-client and x-goog-user-project headers
449
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
427
450
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
428
451
  lib_name: @config.lib_name, lib_version: @config.lib_version,
429
452
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
430
453
  transports_version_send: [:rest]
431
454
 
455
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
432
456
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
433
457
 
434
458
  options.apply_defaults timeout: @config.rpcs.register_domain.timeout,
@@ -442,7 +466,7 @@ module Google
442
466
  @domains_stub.register_domain request, options do |result, operation|
443
467
  result = ::Gapic::Operation.new result, @operations_client, options: options
444
468
  yield result, operation if block_given?
445
- return result
469
+ throw :response, result
446
470
  end
447
471
  rescue ::Gapic::Rest::Error => e
448
472
  raise ::Google::Cloud::Error.from_error(e)
@@ -509,12 +533,13 @@ module Google
509
533
  # Customize the options with defaults
510
534
  call_metadata = @config.rpcs.retrieve_transfer_parameters.metadata.to_h
511
535
 
512
- # Set x-goog-api-client and x-goog-user-project headers
536
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
513
537
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
514
538
  lib_name: @config.lib_name, lib_version: @config.lib_version,
515
539
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
516
540
  transports_version_send: [:rest]
517
541
 
542
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
518
543
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
519
544
 
520
545
  options.apply_defaults timeout: @config.rpcs.retrieve_transfer_parameters.timeout,
@@ -527,7 +552,6 @@ module Google
527
552
 
528
553
  @domains_stub.retrieve_transfer_parameters request, options do |result, operation|
529
554
  yield result, operation if block_given?
530
- return result
531
555
  end
532
556
  rescue ::Gapic::Rest::Error => e
533
557
  raise ::Google::Cloud::Error.from_error(e)
@@ -636,12 +660,13 @@ module Google
636
660
  # Customize the options with defaults
637
661
  call_metadata = @config.rpcs.transfer_domain.metadata.to_h
638
662
 
639
- # Set x-goog-api-client and x-goog-user-project headers
663
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
640
664
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
641
665
  lib_name: @config.lib_name, lib_version: @config.lib_version,
642
666
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
643
667
  transports_version_send: [:rest]
644
668
 
669
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
645
670
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
646
671
 
647
672
  options.apply_defaults timeout: @config.rpcs.transfer_domain.timeout,
@@ -655,7 +680,7 @@ module Google
655
680
  @domains_stub.transfer_domain request, options do |result, operation|
656
681
  result = ::Gapic::Operation.new result, @operations_client, options: options
657
682
  yield result, operation if block_given?
658
- return result
683
+ throw :response, result
659
684
  end
660
685
  rescue ::Gapic::Rest::Error => e
661
686
  raise ::Google::Cloud::Error.from_error(e)
@@ -742,12 +767,13 @@ module Google
742
767
  # Customize the options with defaults
743
768
  call_metadata = @config.rpcs.list_registrations.metadata.to_h
744
769
 
745
- # Set x-goog-api-client and x-goog-user-project headers
770
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
746
771
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
747
772
  lib_name: @config.lib_name, lib_version: @config.lib_version,
748
773
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
749
774
  transports_version_send: [:rest]
750
775
 
776
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
751
777
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
752
778
 
753
779
  options.apply_defaults timeout: @config.rpcs.list_registrations.timeout,
@@ -761,7 +787,7 @@ module Google
761
787
  @domains_stub.list_registrations request, options do |result, operation|
762
788
  result = ::Gapic::Rest::PagedEnumerable.new @domains_stub, :list_registrations, "registrations", request, result, options
763
789
  yield result, operation if block_given?
764
- return result
790
+ throw :response, result
765
791
  end
766
792
  rescue ::Gapic::Rest::Error => e
767
793
  raise ::Google::Cloud::Error.from_error(e)
@@ -822,12 +848,13 @@ module Google
822
848
  # Customize the options with defaults
823
849
  call_metadata = @config.rpcs.get_registration.metadata.to_h
824
850
 
825
- # Set x-goog-api-client and x-goog-user-project headers
851
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
826
852
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
827
853
  lib_name: @config.lib_name, lib_version: @config.lib_version,
828
854
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
829
855
  transports_version_send: [:rest]
830
856
 
857
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
831
858
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
832
859
 
833
860
  options.apply_defaults timeout: @config.rpcs.get_registration.timeout,
@@ -840,7 +867,6 @@ module Google
840
867
 
841
868
  @domains_stub.get_registration request, options do |result, operation|
842
869
  yield result, operation if block_given?
843
- return result
844
870
  end
845
871
  rescue ::Gapic::Rest::Error => e
846
872
  raise ::Google::Cloud::Error.from_error(e)
@@ -916,12 +942,13 @@ module Google
916
942
  # Customize the options with defaults
917
943
  call_metadata = @config.rpcs.update_registration.metadata.to_h
918
944
 
919
- # Set x-goog-api-client and x-goog-user-project headers
945
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
920
946
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
921
947
  lib_name: @config.lib_name, lib_version: @config.lib_version,
922
948
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
923
949
  transports_version_send: [:rest]
924
950
 
951
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
925
952
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
926
953
 
927
954
  options.apply_defaults timeout: @config.rpcs.update_registration.timeout,
@@ -935,7 +962,7 @@ module Google
935
962
  @domains_stub.update_registration request, options do |result, operation|
936
963
  result = ::Gapic::Operation.new result, @operations_client, options: options
937
964
  yield result, operation if block_given?
938
- return result
965
+ throw :response, result
939
966
  end
940
967
  rescue ::Gapic::Rest::Error => e
941
968
  raise ::Google::Cloud::Error.from_error(e)
@@ -1009,12 +1036,13 @@ module Google
1009
1036
  # Customize the options with defaults
1010
1037
  call_metadata = @config.rpcs.configure_management_settings.metadata.to_h
1011
1038
 
1012
- # Set x-goog-api-client and x-goog-user-project headers
1039
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1013
1040
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1014
1041
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1015
1042
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
1016
1043
  transports_version_send: [:rest]
1017
1044
 
1045
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1018
1046
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1019
1047
 
1020
1048
  options.apply_defaults timeout: @config.rpcs.configure_management_settings.timeout,
@@ -1028,7 +1056,7 @@ module Google
1028
1056
  @domains_stub.configure_management_settings request, options do |result, operation|
1029
1057
  result = ::Gapic::Operation.new result, @operations_client, options: options
1030
1058
  yield result, operation if block_given?
1031
- return result
1059
+ throw :response, result
1032
1060
  end
1033
1061
  rescue ::Gapic::Rest::Error => e
1034
1062
  raise ::Google::Cloud::Error.from_error(e)
@@ -1110,12 +1138,13 @@ module Google
1110
1138
  # Customize the options with defaults
1111
1139
  call_metadata = @config.rpcs.configure_dns_settings.metadata.to_h
1112
1140
 
1113
- # Set x-goog-api-client and x-goog-user-project headers
1141
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1114
1142
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1115
1143
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1116
1144
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
1117
1145
  transports_version_send: [:rest]
1118
1146
 
1147
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1119
1148
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1120
1149
 
1121
1150
  options.apply_defaults timeout: @config.rpcs.configure_dns_settings.timeout,
@@ -1129,7 +1158,7 @@ module Google
1129
1158
  @domains_stub.configure_dns_settings request, options do |result, operation|
1130
1159
  result = ::Gapic::Operation.new result, @operations_client, options: options
1131
1160
  yield result, operation if block_given?
1132
- return result
1161
+ throw :response, result
1133
1162
  end
1134
1163
  rescue ::Gapic::Rest::Error => e
1135
1164
  raise ::Google::Cloud::Error.from_error(e)
@@ -1209,12 +1238,13 @@ module Google
1209
1238
  # Customize the options with defaults
1210
1239
  call_metadata = @config.rpcs.configure_contact_settings.metadata.to_h
1211
1240
 
1212
- # Set x-goog-api-client and x-goog-user-project headers
1241
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1213
1242
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1214
1243
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1215
1244
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
1216
1245
  transports_version_send: [:rest]
1217
1246
 
1247
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1218
1248
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1219
1249
 
1220
1250
  options.apply_defaults timeout: @config.rpcs.configure_contact_settings.timeout,
@@ -1228,7 +1258,7 @@ module Google
1228
1258
  @domains_stub.configure_contact_settings request, options do |result, operation|
1229
1259
  result = ::Gapic::Operation.new result, @operations_client, options: options
1230
1260
  yield result, operation if block_given?
1231
- return result
1261
+ throw :response, result
1232
1262
  end
1233
1263
  rescue ::Gapic::Rest::Error => e
1234
1264
  raise ::Google::Cloud::Error.from_error(e)
@@ -1304,12 +1334,13 @@ module Google
1304
1334
  # Customize the options with defaults
1305
1335
  call_metadata = @config.rpcs.export_registration.metadata.to_h
1306
1336
 
1307
- # Set x-goog-api-client and x-goog-user-project headers
1337
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1308
1338
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1309
1339
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1310
1340
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
1311
1341
  transports_version_send: [:rest]
1312
1342
 
1343
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1313
1344
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1314
1345
 
1315
1346
  options.apply_defaults timeout: @config.rpcs.export_registration.timeout,
@@ -1323,7 +1354,7 @@ module Google
1323
1354
  @domains_stub.export_registration request, options do |result, operation|
1324
1355
  result = ::Gapic::Operation.new result, @operations_client, options: options
1325
1356
  yield result, operation if block_given?
1326
- return result
1357
+ throw :response, result
1327
1358
  end
1328
1359
  rescue ::Gapic::Rest::Error => e
1329
1360
  raise ::Google::Cloud::Error.from_error(e)
@@ -1409,12 +1440,13 @@ module Google
1409
1440
  # Customize the options with defaults
1410
1441
  call_metadata = @config.rpcs.delete_registration.metadata.to_h
1411
1442
 
1412
- # Set x-goog-api-client and x-goog-user-project headers
1443
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1413
1444
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1414
1445
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1415
1446
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
1416
1447
  transports_version_send: [:rest]
1417
1448
 
1449
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1418
1450
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1419
1451
 
1420
1452
  options.apply_defaults timeout: @config.rpcs.delete_registration.timeout,
@@ -1428,7 +1460,7 @@ module Google
1428
1460
  @domains_stub.delete_registration request, options do |result, operation|
1429
1461
  result = ::Gapic::Operation.new result, @operations_client, options: options
1430
1462
  yield result, operation if block_given?
1431
- return result
1463
+ throw :response, result
1432
1464
  end
1433
1465
  rescue ::Gapic::Rest::Error => e
1434
1466
  raise ::Google::Cloud::Error.from_error(e)
@@ -1493,12 +1525,13 @@ module Google
1493
1525
  # Customize the options with defaults
1494
1526
  call_metadata = @config.rpcs.retrieve_authorization_code.metadata.to_h
1495
1527
 
1496
- # Set x-goog-api-client and x-goog-user-project headers
1528
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1497
1529
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1498
1530
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1499
1531
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
1500
1532
  transports_version_send: [:rest]
1501
1533
 
1534
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1502
1535
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1503
1536
 
1504
1537
  options.apply_defaults timeout: @config.rpcs.retrieve_authorization_code.timeout,
@@ -1511,7 +1544,6 @@ module Google
1511
1544
 
1512
1545
  @domains_stub.retrieve_authorization_code request, options do |result, operation|
1513
1546
  yield result, operation if block_given?
1514
- return result
1515
1547
  end
1516
1548
  rescue ::Gapic::Rest::Error => e
1517
1549
  raise ::Google::Cloud::Error.from_error(e)
@@ -1575,12 +1607,13 @@ module Google
1575
1607
  # Customize the options with defaults
1576
1608
  call_metadata = @config.rpcs.reset_authorization_code.metadata.to_h
1577
1609
 
1578
- # Set x-goog-api-client and x-goog-user-project headers
1610
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1579
1611
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1580
1612
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1581
1613
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
1582
1614
  transports_version_send: [:rest]
1583
1615
 
1616
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1584
1617
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1585
1618
 
1586
1619
  options.apply_defaults timeout: @config.rpcs.reset_authorization_code.timeout,
@@ -1593,7 +1626,6 @@ module Google
1593
1626
 
1594
1627
  @domains_stub.reset_authorization_code request, options do |result, operation|
1595
1628
  yield result, operation if block_given?
1596
- return result
1597
1629
  end
1598
1630
  rescue ::Gapic::Rest::Error => e
1599
1631
  raise ::Google::Cloud::Error.from_error(e)
@@ -1673,6 +1705,11 @@ module Google
1673
1705
  # default endpoint URL. The default value of nil uses the environment
1674
1706
  # universe (usually the default "googleapis.com" universe).
1675
1707
  # @return [::String,nil]
1708
+ # @!attribute [rw] logger
1709
+ # A custom logger to use for request/response debug logging, or the value
1710
+ # `:default` (the default) to construct a default logger, or `nil` to
1711
+ # explicitly disable logging.
1712
+ # @return [::Logger,:default,nil]
1676
1713
  #
1677
1714
  class Configuration
1678
1715
  extend ::Gapic::Config
@@ -1694,6 +1731,7 @@ module Google
1694
1731
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1695
1732
  config_attr :quota_project, nil, ::String, nil
1696
1733
  config_attr :universe_domain, nil, ::String, nil
1734
+ config_attr :logger, :default, ::Logger, nil, :default
1697
1735
 
1698
1736
  # @private
1699
1737
  def initialize parent_config = nil
@@ -26,6 +26,9 @@ module Google
26
26
  module Rest
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
 
@@ -112,14 +115,6 @@ module Google
112
115
  # Lists operations that match the specified filter in the request. If the
113
116
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
114
117
  #
115
- # NOTE: the `name` binding allows API services to override the binding
116
- # to use different resource name schemes, such as `users/*/operations`. To
117
- # override the binding, API services can add a binding such as
118
- # `"/v1/{name=users/*}/operations"` to their service configuration.
119
- # For backwards compatibility, the default name includes the operations
120
- # collection id, however overriding users must ensure the name binding
121
- # is the parent resource, without the operations collection id.
122
- #
123
118
  # @overload list_operations(request, options = nil)
124
119
  # Pass arguments to `list_operations` via a request object, either of type
125
120
  # {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -181,12 +176,13 @@ module Google
181
176
  # Customize the options with defaults
182
177
  call_metadata = @config.rpcs.list_operations.metadata.to_h
183
178
 
184
- # Set x-goog-api-client and x-goog-user-project headers
179
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
185
180
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
186
181
  lib_name: @config.lib_name, lib_version: @config.lib_version,
187
182
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
188
183
  transports_version_send: [:rest]
189
184
 
185
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
190
186
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
191
187
 
192
188
  options.apply_defaults timeout: @config.rpcs.list_operations.timeout,
@@ -200,7 +196,7 @@ module Google
200
196
  @operations_stub.list_operations request, options do |result, operation|
201
197
  result = ::Gapic::Rest::PagedEnumerable.new @operations_stub, :list_operations, "operations", request, result, options
202
198
  yield result, operation if block_given?
203
- return result
199
+ throw :response, result
204
200
  end
205
201
  rescue ::Gapic::Rest::Error => e
206
202
  raise ::Google::Cloud::Error.from_error(e)
@@ -269,12 +265,13 @@ module Google
269
265
  # Customize the options with defaults
270
266
  call_metadata = @config.rpcs.get_operation.metadata.to_h
271
267
 
272
- # Set x-goog-api-client and x-goog-user-project headers
268
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
273
269
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
274
270
  lib_name: @config.lib_name, lib_version: @config.lib_version,
275
271
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
276
272
  transports_version_send: [:rest]
277
273
 
274
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
278
275
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
279
276
 
280
277
  options.apply_defaults timeout: @config.rpcs.get_operation.timeout,
@@ -288,7 +285,7 @@ module Google
288
285
  @operations_stub.get_operation request, options do |result, operation|
289
286
  result = ::Gapic::Operation.new result, @operations_client, options: options
290
287
  yield result, operation if block_given?
291
- return result
288
+ throw :response, result
292
289
  end
293
290
  rescue ::Gapic::Rest::Error => e
294
291
  raise ::Google::Cloud::Error.from_error(e)
@@ -351,12 +348,13 @@ module Google
351
348
  # Customize the options with defaults
352
349
  call_metadata = @config.rpcs.delete_operation.metadata.to_h
353
350
 
354
- # Set x-goog-api-client and x-goog-user-project headers
351
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
355
352
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
356
353
  lib_name: @config.lib_name, lib_version: @config.lib_version,
357
354
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
358
355
  transports_version_send: [:rest]
359
356
 
357
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
360
358
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
361
359
 
362
360
  options.apply_defaults timeout: @config.rpcs.delete_operation.timeout,
@@ -369,7 +367,6 @@ module Google
369
367
 
370
368
  @operations_stub.delete_operation request, options do |result, operation|
371
369
  yield result, operation if block_given?
372
- return result
373
370
  end
374
371
  rescue ::Gapic::Rest::Error => e
375
372
  raise ::Google::Cloud::Error.from_error(e)
@@ -384,8 +381,9 @@ module Google
384
381
  # other methods to check whether the cancellation succeeded or whether the
385
382
  # operation completed despite cancellation. On successful cancellation,
386
383
  # the operation is not deleted; instead, it becomes an operation with
387
- # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
388
- # 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`.
389
387
  #
390
388
  # @overload cancel_operation(request, options = nil)
391
389
  # Pass arguments to `cancel_operation` via a request object, either of type
@@ -438,12 +436,13 @@ module Google
438
436
  # Customize the options with defaults
439
437
  call_metadata = @config.rpcs.cancel_operation.metadata.to_h
440
438
 
441
- # Set x-goog-api-client and x-goog-user-project headers
439
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
442
440
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
443
441
  lib_name: @config.lib_name, lib_version: @config.lib_version,
444
442
  gapic_version: ::Google::Cloud::Domains::V1beta1::VERSION,
445
443
  transports_version_send: [:rest]
446
444
 
445
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
447
446
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
448
447
 
449
448
  options.apply_defaults timeout: @config.rpcs.cancel_operation.timeout,
@@ -456,7 +455,6 @@ module Google
456
455
 
457
456
  @operations_stub.cancel_operation request, options do |result, operation|
458
457
  yield result, operation if block_given?
459
- return result
460
458
  end
461
459
  rescue ::Gapic::Rest::Error => e
462
460
  raise ::Google::Cloud::Error.from_error(e)
@@ -536,6 +534,11 @@ module Google
536
534
  # default endpoint URL. The default value of nil uses the environment
537
535
  # universe (usually the default "googleapis.com" universe).
538
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]
539
542
  #
540
543
  class Configuration
541
544
  extend ::Gapic::Config
@@ -557,6 +560,7 @@ module Google
557
560
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
558
561
  config_attr :quota_project, nil, ::String, nil
559
562
  config_attr :universe_domain, nil, ::String, nil
563
+ config_attr :logger, :default, ::Logger, nil, :default
560
564
 
561
565
  # @private
562
566
  def initialize parent_config = nil
@@ -676,16 +680,18 @@ module Google
676
680
 
677
681
  response = @client_stub.make_http_request(
678
682
  verb,
679
- uri: uri,
680
- body: body || "",
681
- params: query_string_params,
683
+ uri: uri,
684
+ body: body || "",
685
+ params: query_string_params,
686
+ method_name: "list_operations",
682
687
  options: options
683
688
  )
684
689
  operation = ::Gapic::Rest::TransportOperation.new response
685
690
  result = ::Google::Longrunning::ListOperationsResponse.decode_json response.body, ignore_unknown_fields: true
686
-
687
- yield result, operation if block_given?
688
- result
691
+ catch :response do
692
+ yield result, operation if block_given?
693
+ result
694
+ end
689
695
  end
690
696
 
691
697
  ##
@@ -714,16 +720,18 @@ module Google
714
720
 
715
721
  response = @client_stub.make_http_request(
716
722
  verb,
717
- uri: uri,
718
- body: body || "",
719
- params: query_string_params,
723
+ uri: uri,
724
+ body: body || "",
725
+ params: query_string_params,
726
+ method_name: "get_operation",
720
727
  options: options
721
728
  )
722
729
  operation = ::Gapic::Rest::TransportOperation.new response
723
730
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
724
-
725
- yield result, operation if block_given?
726
- result
731
+ catch :response do
732
+ yield result, operation if block_given?
733
+ result
734
+ end
727
735
  end
728
736
 
729
737
  ##
@@ -752,16 +760,18 @@ module Google
752
760
 
753
761
  response = @client_stub.make_http_request(
754
762
  verb,
755
- uri: uri,
756
- body: body || "",
757
- params: query_string_params,
763
+ uri: uri,
764
+ body: body || "",
765
+ params: query_string_params,
766
+ method_name: "delete_operation",
758
767
  options: options
759
768
  )
760
769
  operation = ::Gapic::Rest::TransportOperation.new response
761
770
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
762
-
763
- yield result, operation if block_given?
764
- result
771
+ catch :response do
772
+ yield result, operation if block_given?
773
+ result
774
+ end
765
775
  end
766
776
 
767
777
  ##
@@ -790,16 +800,18 @@ module Google
790
800
 
791
801
  response = @client_stub.make_http_request(
792
802
  verb,
793
- uri: uri,
794
- body: body || "",
795
- params: query_string_params,
803
+ uri: uri,
804
+ body: body || "",
805
+ params: query_string_params,
806
+ method_name: "cancel_operation",
796
807
  options: options
797
808
  )
798
809
  operation = ::Gapic::Rest::TransportOperation.new response
799
810
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
800
-
801
- yield result, operation if block_given?
802
- result
811
+ catch :response do
812
+ yield result, operation if block_given?
813
+ result
814
+ end
803
815
  end
804
816
 
805
817
  ##