google-cloud-channel-v1 1.1.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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)
@@ -649,6 +640,13 @@ module Google
649
640
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
650
641
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
651
642
  # * (`nil`) indicating no credentials
643
+ #
644
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
645
+ # external source for authentication to Google Cloud, you must validate it before
646
+ # providing it to a Google API client library. Providing an unvalidated credential
647
+ # configuration to Google APIs can compromise the security of your systems and data.
648
+ # For more information, refer to [Validate credential configurations from external
649
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
652
650
  # @return [::Object]
653
651
  # @!attribute [rw] scope
654
652
  # The OAuth scopes
@@ -688,6 +686,11 @@ module Google
688
686
  # default endpoint URL. The default value of nil uses the environment
689
687
  # universe (usually the default "googleapis.com" universe).
690
688
  # @return [::String,nil]
689
+ # @!attribute [rw] logger
690
+ # A custom logger to use for request/response debug logging, or the value
691
+ # `:default` (the default) to construct a default logger, or `nil` to
692
+ # explicitly disable logging.
693
+ # @return [::Logger,:default,nil]
691
694
  #
692
695
  class Configuration
693
696
  extend ::Gapic::Config
@@ -712,6 +715,7 @@ module Google
712
715
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
713
716
  config_attr :quota_project, nil, ::String, nil
714
717
  config_attr :universe_domain, nil, ::String, nil
718
+ config_attr :logger, :default, ::Logger, nil, :default
715
719
 
716
720
  # @private
717
721
  def initialize parent_config = nil
@@ -203,8 +203,19 @@ module Google
203
203
  endpoint: @config.endpoint,
204
204
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
205
205
  universe_domain: @config.universe_domain,
206
- credentials: credentials
206
+ credentials: credentials,
207
+ logger: @config.logger
207
208
  )
209
+
210
+ @cloud_channel_service_stub.logger(stub: true)&.info do |entry|
211
+ entry.set_system_name
212
+ entry.set_service
213
+ entry.message = "Created client for #{entry.service}"
214
+ entry.set_credentials_fields credentials
215
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
216
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
217
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
218
+ end
208
219
  end
209
220
 
210
221
  ##
@@ -214,6 +225,15 @@ module Google
214
225
  #
215
226
  attr_reader :operations_client
216
227
 
228
+ ##
229
+ # The logger used for request/response debug logging.
230
+ #
231
+ # @return [Logger]
232
+ #
233
+ def logger
234
+ @cloud_channel_service_stub.logger
235
+ end
236
+
217
237
  # Service calls
218
238
 
219
239
  ##
@@ -321,7 +341,7 @@ module Google
321
341
  @cloud_channel_service_stub.list_customers request, options do |result, operation|
322
342
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_customers, "customers", request, result, options
323
343
  yield result, operation if block_given?
324
- return result
344
+ throw :response, result
325
345
  end
326
346
  rescue ::Gapic::Rest::Error => e
327
347
  raise ::Google::Cloud::Error.from_error(e)
@@ -413,7 +433,6 @@ module Google
413
433
 
414
434
  @cloud_channel_service_stub.get_customer request, options do |result, operation|
415
435
  yield result, operation if block_given?
416
- return result
417
436
  end
418
437
  rescue ::Gapic::Rest::Error => e
419
438
  raise ::Google::Cloud::Error.from_error(e)
@@ -518,7 +537,6 @@ module Google
518
537
 
519
538
  @cloud_channel_service_stub.check_cloud_identity_accounts_exist request, options do |result, operation|
520
539
  yield result, operation if block_given?
521
- return result
522
540
  end
523
541
  rescue ::Gapic::Rest::Error => e
524
542
  raise ::Google::Cloud::Error.from_error(e)
@@ -615,7 +633,6 @@ module Google
615
633
 
616
634
  @cloud_channel_service_stub.create_customer request, options do |result, operation|
617
635
  yield result, operation if block_given?
618
- return result
619
636
  end
620
637
  rescue ::Gapic::Rest::Error => e
621
638
  raise ::Google::Cloud::Error.from_error(e)
@@ -709,7 +726,6 @@ module Google
709
726
 
710
727
  @cloud_channel_service_stub.update_customer request, options do |result, operation|
711
728
  yield result, operation if block_given?
712
- return result
713
729
  end
714
730
  rescue ::Gapic::Rest::Error => e
715
731
  raise ::Google::Cloud::Error.from_error(e)
@@ -797,7 +813,6 @@ module Google
797
813
 
798
814
  @cloud_channel_service_stub.delete_customer request, options do |result, operation|
799
815
  yield result, operation if block_given?
800
- return result
801
816
  end
802
817
  rescue ::Gapic::Rest::Error => e
803
818
  raise ::Google::Cloud::Error.from_error(e)
@@ -842,10 +857,16 @@ module Google
842
857
  #
843
858
  # @param domain [::String]
844
859
  # Required. Customer domain.
860
+ #
861
+ # Note: The following fields are mutually exclusive: `domain`, `cloud_identity_id`, `primary_admin_email`. If a field in that set is populated, all other fields in the set will automatically be cleared.
845
862
  # @param cloud_identity_id [::String]
846
863
  # Required. Customer's Cloud Identity ID
864
+ #
865
+ # Note: The following fields are mutually exclusive: `cloud_identity_id`, `domain`, `primary_admin_email`. If a field in that set is populated, all other fields in the set will automatically be cleared.
847
866
  # @param primary_admin_email [::String]
848
867
  # Required. Customer's primary admin email.
868
+ #
869
+ # Note: The following fields are mutually exclusive: `primary_admin_email`, `domain`, `cloud_identity_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
849
870
  # @param parent [::String]
850
871
  # Required. The resource name of the reseller's account.
851
872
  # Parent takes the format: accounts/\\{account_id} or
@@ -921,7 +942,6 @@ module Google
921
942
 
922
943
  @cloud_channel_service_stub.import_customer request, options do |result, operation|
923
944
  yield result, operation if block_given?
924
- return result
925
945
  end
926
946
  rescue ::Gapic::Rest::Error => e
927
947
  raise ::Google::Cloud::Error.from_error(e)
@@ -1038,7 +1058,7 @@ module Google
1038
1058
  @cloud_channel_service_stub.provision_cloud_identity request, options do |result, operation|
1039
1059
  result = ::Gapic::Operation.new result, @operations_client, options: options
1040
1060
  yield result, operation if block_given?
1041
- return result
1061
+ throw :response, result
1042
1062
  end
1043
1063
  rescue ::Gapic::Rest::Error => e
1044
1064
  raise ::Google::Cloud::Error.from_error(e)
@@ -1145,7 +1165,7 @@ module Google
1145
1165
  @cloud_channel_service_stub.list_entitlements request, options do |result, operation|
1146
1166
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_entitlements, "entitlements", request, result, options
1147
1167
  yield result, operation if block_given?
1148
- return result
1168
+ throw :response, result
1149
1169
  end
1150
1170
  rescue ::Gapic::Rest::Error => e
1151
1171
  raise ::Google::Cloud::Error.from_error(e)
@@ -1189,11 +1209,15 @@ module Google
1189
1209
  #
1190
1210
  # @param cloud_identity_id [::String]
1191
1211
  # Customer's Cloud Identity ID
1212
+ #
1213
+ # Note: The following fields are mutually exclusive: `cloud_identity_id`, `customer_name`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1192
1214
  # @param customer_name [::String]
1193
1215
  # A reseller is required to create a customer and use the resource name of
1194
1216
  # the created customer here.
1195
1217
  # Customer_name uses the format:
1196
1218
  # accounts/\\{account_id}/customers/\\{customer_id}
1219
+ #
1220
+ # Note: The following fields are mutually exclusive: `customer_name`, `cloud_identity_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1197
1221
  # @param parent [::String]
1198
1222
  # Required. The reseller account's resource name.
1199
1223
  # Parent uses the format: accounts/\\{account_id}
@@ -1277,7 +1301,7 @@ module Google
1277
1301
  @cloud_channel_service_stub.list_transferable_skus request, options do |result, operation|
1278
1302
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_transferable_skus, "transferable_skus", request, result, options
1279
1303
  yield result, operation if block_given?
1280
- return result
1304
+ throw :response, result
1281
1305
  end
1282
1306
  rescue ::Gapic::Rest::Error => e
1283
1307
  raise ::Google::Cloud::Error.from_error(e)
@@ -1324,9 +1348,13 @@ module Google
1324
1348
  #
1325
1349
  # @param cloud_identity_id [::String]
1326
1350
  # Customer's Cloud Identity ID
1351
+ #
1352
+ # Note: The following fields are mutually exclusive: `cloud_identity_id`, `customer_name`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1327
1353
  # @param customer_name [::String]
1328
1354
  # A reseller should create a customer and use the resource name of
1329
1355
  # that customer here.
1356
+ #
1357
+ # Note: The following fields are mutually exclusive: `customer_name`, `cloud_identity_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1330
1358
  # @param parent [::String]
1331
1359
  # Required. The resource name of the reseller's account.
1332
1360
  # @param page_size [::Integer]
@@ -1410,7 +1438,7 @@ module Google
1410
1438
  @cloud_channel_service_stub.list_transferable_offers request, options do |result, operation|
1411
1439
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_transferable_offers, "transferable_offers", request, result, options
1412
1440
  yield result, operation if block_given?
1413
- return result
1441
+ throw :response, result
1414
1442
  end
1415
1443
  rescue ::Gapic::Rest::Error => e
1416
1444
  raise ::Google::Cloud::Error.from_error(e)
@@ -1501,7 +1529,6 @@ module Google
1501
1529
 
1502
1530
  @cloud_channel_service_stub.get_entitlement request, options do |result, operation|
1503
1531
  yield result, operation if block_given?
1504
- return result
1505
1532
  end
1506
1533
  rescue ::Gapic::Rest::Error => e
1507
1534
  raise ::Google::Cloud::Error.from_error(e)
@@ -1643,7 +1670,7 @@ module Google
1643
1670
  @cloud_channel_service_stub.create_entitlement request, options do |result, operation|
1644
1671
  result = ::Gapic::Operation.new result, @operations_client, options: options
1645
1672
  yield result, operation if block_given?
1646
- return result
1673
+ throw :response, result
1647
1674
  end
1648
1675
  rescue ::Gapic::Rest::Error => e
1649
1676
  raise ::Google::Cloud::Error.from_error(e)
@@ -1776,7 +1803,7 @@ module Google
1776
1803
  @cloud_channel_service_stub.change_parameters request, options do |result, operation|
1777
1804
  result = ::Gapic::Operation.new result, @operations_client, options: options
1778
1805
  yield result, operation if block_given?
1779
- return result
1806
+ throw :response, result
1780
1807
  end
1781
1808
  rescue ::Gapic::Rest::Error => e
1782
1809
  raise ::Google::Cloud::Error.from_error(e)
@@ -1902,7 +1929,7 @@ module Google
1902
1929
  @cloud_channel_service_stub.change_renewal_settings request, options do |result, operation|
1903
1930
  result = ::Gapic::Operation.new result, @operations_client, options: options
1904
1931
  yield result, operation if block_given?
1905
- return result
1932
+ throw :response, result
1906
1933
  end
1907
1934
  rescue ::Gapic::Rest::Error => e
1908
1935
  raise ::Google::Cloud::Error.from_error(e)
@@ -2040,7 +2067,7 @@ module Google
2040
2067
  @cloud_channel_service_stub.change_offer request, options do |result, operation|
2041
2068
  result = ::Gapic::Operation.new result, @operations_client, options: options
2042
2069
  yield result, operation if block_given?
2043
- return result
2070
+ throw :response, result
2044
2071
  end
2045
2072
  rescue ::Gapic::Rest::Error => e
2046
2073
  raise ::Google::Cloud::Error.from_error(e)
@@ -2165,7 +2192,7 @@ module Google
2165
2192
  @cloud_channel_service_stub.start_paid_service request, options do |result, operation|
2166
2193
  result = ::Gapic::Operation.new result, @operations_client, options: options
2167
2194
  yield result, operation if block_given?
2168
- return result
2195
+ throw :response, result
2169
2196
  end
2170
2197
  rescue ::Gapic::Rest::Error => e
2171
2198
  raise ::Google::Cloud::Error.from_error(e)
@@ -2287,7 +2314,7 @@ module Google
2287
2314
  @cloud_channel_service_stub.suspend_entitlement request, options do |result, operation|
2288
2315
  result = ::Gapic::Operation.new result, @operations_client, options: options
2289
2316
  yield result, operation if block_given?
2290
- return result
2317
+ throw :response, result
2291
2318
  end
2292
2319
  rescue ::Gapic::Rest::Error => e
2293
2320
  raise ::Google::Cloud::Error.from_error(e)
@@ -2414,7 +2441,7 @@ module Google
2414
2441
  @cloud_channel_service_stub.cancel_entitlement request, options do |result, operation|
2415
2442
  result = ::Gapic::Operation.new result, @operations_client, options: options
2416
2443
  yield result, operation if block_given?
2417
- return result
2444
+ throw :response, result
2418
2445
  end
2419
2446
  rescue ::Gapic::Rest::Error => e
2420
2447
  raise ::Google::Cloud::Error.from_error(e)
@@ -2542,7 +2569,7 @@ module Google
2542
2569
  @cloud_channel_service_stub.activate_entitlement request, options do |result, operation|
2543
2570
  result = ::Gapic::Operation.new result, @operations_client, options: options
2544
2571
  yield result, operation if block_given?
2545
- return result
2572
+ throw :response, result
2546
2573
  end
2547
2574
  rescue ::Gapic::Rest::Error => e
2548
2575
  raise ::Google::Cloud::Error.from_error(e)
@@ -2682,7 +2709,7 @@ module Google
2682
2709
  @cloud_channel_service_stub.transfer_entitlements request, options do |result, operation|
2683
2710
  result = ::Gapic::Operation.new result, @operations_client, options: options
2684
2711
  yield result, operation if block_given?
2685
- return result
2712
+ throw :response, result
2686
2713
  end
2687
2714
  rescue ::Gapic::Rest::Error => e
2688
2715
  raise ::Google::Cloud::Error.from_error(e)
@@ -2814,7 +2841,7 @@ module Google
2814
2841
  @cloud_channel_service_stub.transfer_entitlements_to_google request, options do |result, operation|
2815
2842
  result = ::Gapic::Operation.new result, @operations_client, options: options
2816
2843
  yield result, operation if block_given?
2817
- return result
2844
+ throw :response, result
2818
2845
  end
2819
2846
  rescue ::Gapic::Rest::Error => e
2820
2847
  raise ::Google::Cloud::Error.from_error(e)
@@ -2923,7 +2950,7 @@ module Google
2923
2950
  @cloud_channel_service_stub.list_channel_partner_links request, options do |result, operation|
2924
2951
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_channel_partner_links, "channel_partner_links", request, result, options
2925
2952
  yield result, operation if block_given?
2926
- return result
2953
+ throw :response, result
2927
2954
  end
2928
2955
  rescue ::Gapic::Rest::Error => e
2929
2956
  raise ::Google::Cloud::Error.from_error(e)
@@ -3020,7 +3047,6 @@ module Google
3020
3047
 
3021
3048
  @cloud_channel_service_stub.get_channel_partner_link request, options do |result, operation|
3022
3049
  yield result, operation if block_given?
3023
- return result
3024
3050
  end
3025
3051
  rescue ::Gapic::Rest::Error => e
3026
3052
  raise ::Google::Cloud::Error.from_error(e)
@@ -3127,7 +3153,6 @@ module Google
3127
3153
 
3128
3154
  @cloud_channel_service_stub.create_channel_partner_link request, options do |result, operation|
3129
3155
  yield result, operation if block_given?
3130
- return result
3131
3156
  end
3132
3157
  rescue ::Gapic::Rest::Error => e
3133
3158
  raise ::Google::Cloud::Error.from_error(e)
@@ -3236,7 +3261,6 @@ module Google
3236
3261
 
3237
3262
  @cloud_channel_service_stub.update_channel_partner_link request, options do |result, operation|
3238
3263
  yield result, operation if block_given?
3239
- return result
3240
3264
  end
3241
3265
  rescue ::Gapic::Rest::Error => e
3242
3266
  raise ::Google::Cloud::Error.from_error(e)
@@ -3333,7 +3357,6 @@ module Google
3333
3357
 
3334
3358
  @cloud_channel_service_stub.get_customer_repricing_config request, options do |result, operation|
3335
3359
  yield result, operation if block_given?
3336
- return result
3337
3360
  end
3338
3361
  rescue ::Gapic::Rest::Error => e
3339
3362
  raise ::Google::Cloud::Error.from_error(e)
@@ -3463,7 +3486,7 @@ module Google
3463
3486
  @cloud_channel_service_stub.list_customer_repricing_configs request, options do |result, operation|
3464
3487
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_customer_repricing_configs, "customer_repricing_configs", request, result, options
3465
3488
  yield result, operation if block_given?
3466
- return result
3489
+ throw :response, result
3467
3490
  end
3468
3491
  rescue ::Gapic::Rest::Error => e
3469
3492
  raise ::Google::Cloud::Error.from_error(e)
@@ -3587,7 +3610,6 @@ module Google
3587
3610
 
3588
3611
  @cloud_channel_service_stub.create_customer_repricing_config request, options do |result, operation|
3589
3612
  yield result, operation if block_given?
3590
- return result
3591
3613
  end
3592
3614
  rescue ::Gapic::Rest::Error => e
3593
3615
  raise ::Google::Cloud::Error.from_error(e)
@@ -3697,7 +3719,6 @@ module Google
3697
3719
 
3698
3720
  @cloud_channel_service_stub.update_customer_repricing_config request, options do |result, operation|
3699
3721
  yield result, operation if block_given?
3700
- return result
3701
3722
  end
3702
3723
  rescue ::Gapic::Rest::Error => e
3703
3724
  raise ::Google::Cloud::Error.from_error(e)
@@ -3794,7 +3815,6 @@ module Google
3794
3815
 
3795
3816
  @cloud_channel_service_stub.delete_customer_repricing_config request, options do |result, operation|
3796
3817
  yield result, operation if block_given?
3797
- return result
3798
3818
  end
3799
3819
  rescue ::Gapic::Rest::Error => e
3800
3820
  raise ::Google::Cloud::Error.from_error(e)
@@ -3891,7 +3911,6 @@ module Google
3891
3911
 
3892
3912
  @cloud_channel_service_stub.get_channel_partner_repricing_config request, options do |result, operation|
3893
3913
  yield result, operation if block_given?
3894
- return result
3895
3914
  end
3896
3915
  rescue ::Gapic::Rest::Error => e
3897
3916
  raise ::Google::Cloud::Error.from_error(e)
@@ -4024,7 +4043,7 @@ module Google
4024
4043
  @cloud_channel_service_stub.list_channel_partner_repricing_configs request, options do |result, operation|
4025
4044
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_channel_partner_repricing_configs, "channel_partner_repricing_configs", request, result, options
4026
4045
  yield result, operation if block_given?
4027
- return result
4046
+ throw :response, result
4028
4047
  end
4029
4048
  rescue ::Gapic::Rest::Error => e
4030
4049
  raise ::Google::Cloud::Error.from_error(e)
@@ -4149,7 +4168,6 @@ module Google
4149
4168
 
4150
4169
  @cloud_channel_service_stub.create_channel_partner_repricing_config request, options do |result, operation|
4151
4170
  yield result, operation if block_given?
4152
- return result
4153
4171
  end
4154
4172
  rescue ::Gapic::Rest::Error => e
4155
4173
  raise ::Google::Cloud::Error.from_error(e)
@@ -4259,7 +4277,6 @@ module Google
4259
4277
 
4260
4278
  @cloud_channel_service_stub.update_channel_partner_repricing_config request, options do |result, operation|
4261
4279
  yield result, operation if block_given?
4262
- return result
4263
4280
  end
4264
4281
  rescue ::Gapic::Rest::Error => e
4265
4282
  raise ::Google::Cloud::Error.from_error(e)
@@ -4355,7 +4372,6 @@ module Google
4355
4372
 
4356
4373
  @cloud_channel_service_stub.delete_channel_partner_repricing_config request, options do |result, operation|
4357
4374
  yield result, operation if block_given?
4358
- return result
4359
4375
  end
4360
4376
  rescue ::Gapic::Rest::Error => e
4361
4377
  raise ::Google::Cloud::Error.from_error(e)
@@ -4469,7 +4485,7 @@ module Google
4469
4485
  @cloud_channel_service_stub.list_sku_groups request, options do |result, operation|
4470
4486
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_sku_groups, "sku_groups", request, result, options
4471
4487
  yield result, operation if block_given?
4472
- return result
4488
+ throw :response, result
4473
4489
  end
4474
4490
  rescue ::Gapic::Rest::Error => e
4475
4491
  raise ::Google::Cloud::Error.from_error(e)
@@ -4582,7 +4598,7 @@ module Google
4582
4598
  @cloud_channel_service_stub.list_sku_group_billable_skus request, options do |result, operation|
4583
4599
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_sku_group_billable_skus, "billable_skus", request, result, options
4584
4600
  yield result, operation if block_given?
4585
- return result
4601
+ throw :response, result
4586
4602
  end
4587
4603
  rescue ::Gapic::Rest::Error => e
4588
4604
  raise ::Google::Cloud::Error.from_error(e)
@@ -4672,7 +4688,6 @@ module Google
4672
4688
 
4673
4689
  @cloud_channel_service_stub.lookup_offer request, options do |result, operation|
4674
4690
  yield result, operation if block_given?
4675
- return result
4676
4691
  end
4677
4692
  rescue ::Gapic::Rest::Error => e
4678
4693
  raise ::Google::Cloud::Error.from_error(e)
@@ -4771,7 +4786,7 @@ module Google
4771
4786
  @cloud_channel_service_stub.list_products request, options do |result, operation|
4772
4787
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_products, "products", request, result, options
4773
4788
  yield result, operation if block_given?
4774
- return result
4789
+ throw :response, result
4775
4790
  end
4776
4791
  rescue ::Gapic::Rest::Error => e
4777
4792
  raise ::Google::Cloud::Error.from_error(e)
@@ -4875,7 +4890,7 @@ module Google
4875
4890
  @cloud_channel_service_stub.list_skus request, options do |result, operation|
4876
4891
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_skus, "skus", request, result, options
4877
4892
  yield result, operation if block_given?
4878
- return result
4893
+ throw :response, result
4879
4894
  end
4880
4895
  rescue ::Gapic::Rest::Error => e
4881
4896
  raise ::Google::Cloud::Error.from_error(e)
@@ -4985,7 +5000,7 @@ module Google
4985
5000
  @cloud_channel_service_stub.list_offers request, options do |result, operation|
4986
5001
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_offers, "offers", request, result, options
4987
5002
  yield result, operation if block_given?
4988
- return result
5003
+ throw :response, result
4989
5004
  end
4990
5005
  rescue ::Gapic::Rest::Error => e
4991
5006
  raise ::Google::Cloud::Error.from_error(e)
@@ -5019,8 +5034,12 @@ module Google
5019
5034
  #
5020
5035
  # @param create_entitlement_purchase [::Google::Cloud::Channel::V1::ListPurchasableSkusRequest::CreateEntitlementPurchase, ::Hash]
5021
5036
  # List SKUs for CreateEntitlement purchase.
5037
+ #
5038
+ # Note: The following fields are mutually exclusive: `create_entitlement_purchase`, `change_offer_purchase`. If a field in that set is populated, all other fields in the set will automatically be cleared.
5022
5039
  # @param change_offer_purchase [::Google::Cloud::Channel::V1::ListPurchasableSkusRequest::ChangeOfferPurchase, ::Hash]
5023
5040
  # List SKUs for ChangeOffer purchase with a new SKU.
5041
+ #
5042
+ # Note: The following fields are mutually exclusive: `change_offer_purchase`, `create_entitlement_purchase`. If a field in that set is populated, all other fields in the set will automatically be cleared.
5024
5043
  # @param customer [::String]
5025
5044
  # Required. The resource name of the customer to list SKUs for.
5026
5045
  # Format: accounts/\\{account_id}/customers/\\{customer_id}.
@@ -5092,7 +5111,7 @@ module Google
5092
5111
  @cloud_channel_service_stub.list_purchasable_skus request, options do |result, operation|
5093
5112
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_purchasable_skus, "purchasable_skus", request, result, options
5094
5113
  yield result, operation if block_given?
5095
- return result
5114
+ throw :response, result
5096
5115
  end
5097
5116
  rescue ::Gapic::Rest::Error => e
5098
5117
  raise ::Google::Cloud::Error.from_error(e)
@@ -5129,8 +5148,12 @@ module Google
5129
5148
  #
5130
5149
  # @param create_entitlement_purchase [::Google::Cloud::Channel::V1::ListPurchasableOffersRequest::CreateEntitlementPurchase, ::Hash]
5131
5150
  # List Offers for CreateEntitlement purchase.
5151
+ #
5152
+ # Note: The following fields are mutually exclusive: `create_entitlement_purchase`, `change_offer_purchase`. If a field in that set is populated, all other fields in the set will automatically be cleared.
5132
5153
  # @param change_offer_purchase [::Google::Cloud::Channel::V1::ListPurchasableOffersRequest::ChangeOfferPurchase, ::Hash]
5133
5154
  # List Offers for ChangeOffer purchase.
5155
+ #
5156
+ # Note: The following fields are mutually exclusive: `change_offer_purchase`, `create_entitlement_purchase`. If a field in that set is populated, all other fields in the set will automatically be cleared.
5134
5157
  # @param customer [::String]
5135
5158
  # Required. The resource name of the customer to list Offers for.
5136
5159
  # Format: accounts/\\{account_id}/customers/\\{customer_id}.
@@ -5202,7 +5225,7 @@ module Google
5202
5225
  @cloud_channel_service_stub.list_purchasable_offers request, options do |result, operation|
5203
5226
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_purchasable_offers, "purchasable_offers", request, result, options
5204
5227
  yield result, operation if block_given?
5205
- return result
5228
+ throw :response, result
5206
5229
  end
5207
5230
  rescue ::Gapic::Rest::Error => e
5208
5231
  raise ::Google::Cloud::Error.from_error(e)
@@ -5296,7 +5319,6 @@ module Google
5296
5319
 
5297
5320
  @cloud_channel_service_stub.query_eligible_billing_accounts request, options do |result, operation|
5298
5321
  yield result, operation if block_given?
5299
- return result
5300
5322
  end
5301
5323
  rescue ::Gapic::Rest::Error => e
5302
5324
  raise ::Google::Cloud::Error.from_error(e)
@@ -5395,7 +5417,6 @@ module Google
5395
5417
 
5396
5418
  @cloud_channel_service_stub.register_subscriber request, options do |result, operation|
5397
5419
  yield result, operation if block_given?
5398
- return result
5399
5420
  end
5400
5421
  rescue ::Gapic::Rest::Error => e
5401
5422
  raise ::Google::Cloud::Error.from_error(e)
@@ -5497,7 +5518,6 @@ module Google
5497
5518
 
5498
5519
  @cloud_channel_service_stub.unregister_subscriber request, options do |result, operation|
5499
5520
  yield result, operation if block_given?
5500
- return result
5501
5521
  end
5502
5522
  rescue ::Gapic::Rest::Error => e
5503
5523
  raise ::Google::Cloud::Error.from_error(e)
@@ -5604,7 +5624,7 @@ module Google
5604
5624
  @cloud_channel_service_stub.list_subscribers request, options do |result, operation|
5605
5625
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_subscribers, "service_accounts", request, result, options
5606
5626
  yield result, operation if block_given?
5607
- return result
5627
+ throw :response, result
5608
5628
  end
5609
5629
  rescue ::Gapic::Rest::Error => e
5610
5630
  raise ::Google::Cloud::Error.from_error(e)
@@ -5723,7 +5743,7 @@ module Google
5723
5743
  @cloud_channel_service_stub.list_entitlement_changes request, options do |result, operation|
5724
5744
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_entitlement_changes, "entitlement_changes", request, result, options
5725
5745
  yield result, operation if block_given?
5726
- return result
5746
+ throw :response, result
5727
5747
  end
5728
5748
  rescue ::Gapic::Rest::Error => e
5729
5749
  raise ::Google::Cloud::Error.from_error(e)
@@ -5771,6 +5791,13 @@ module Google
5771
5791
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
5772
5792
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
5773
5793
  # * (`nil`) indicating no credentials
5794
+ #
5795
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
5796
+ # external source for authentication to Google Cloud, you must validate it before
5797
+ # providing it to a Google API client library. Providing an unvalidated credential
5798
+ # configuration to Google APIs can compromise the security of your systems and data.
5799
+ # For more information, refer to [Validate credential configurations from external
5800
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
5774
5801
  # @return [::Object]
5775
5802
  # @!attribute [rw] scope
5776
5803
  # The OAuth scopes
@@ -5803,6 +5830,11 @@ module Google
5803
5830
  # default endpoint URL. The default value of nil uses the environment
5804
5831
  # universe (usually the default "googleapis.com" universe).
5805
5832
  # @return [::String,nil]
5833
+ # @!attribute [rw] logger
5834
+ # A custom logger to use for request/response debug logging, or the value
5835
+ # `:default` (the default) to construct a default logger, or `nil` to
5836
+ # explicitly disable logging.
5837
+ # @return [::Logger,:default,nil]
5806
5838
  #
5807
5839
  class Configuration
5808
5840
  extend ::Gapic::Config
@@ -5824,6 +5856,7 @@ module Google
5824
5856
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
5825
5857
  config_attr :quota_project, nil, ::String, nil
5826
5858
  config_attr :universe_domain, nil, ::String, nil
5859
+ config_attr :logger, :default, ::Logger, nil, :default
5827
5860
 
5828
5861
  # @private
5829
5862
  def initialize parent_config = nil