google-cloud-channel-v1 1.1.0 → 1.3.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (23) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +31 -21
  3. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/client.rb +37 -4
  4. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/operations.rb +19 -15
  5. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/rest/client.rb +37 -4
  6. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/rest/operations.rb +50 -38
  7. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/rest/service_stub.rb +38 -20
  8. data/lib/google/cloud/channel/v1/cloud_channel_service/client.rb +82 -50
  9. data/lib/google/cloud/channel/v1/cloud_channel_service/operations.rb +19 -15
  10. data/lib/google/cloud/channel/v1/cloud_channel_service/rest/client.rb +83 -50
  11. data/lib/google/cloud/channel/v1/cloud_channel_service/rest/operations.rb +50 -38
  12. data/lib/google/cloud/channel/v1/cloud_channel_service/rest/service_stub.rb +406 -296
  13. data/lib/google/cloud/channel/v1/version.rb +1 -1
  14. data/proto_docs/google/api/client.rb +39 -0
  15. data/proto_docs/google/cloud/channel/v1/common.rb +10 -0
  16. data/proto_docs/google/cloud/channel/v1/entitlement_changes.rb +8 -0
  17. data/proto_docs/google/cloud/channel/v1/reports_service.rb +12 -0
  18. data/proto_docs/google/cloud/channel/v1/repricing.rb +4 -0
  19. data/proto_docs/google/cloud/channel/v1/service.rb +22 -0
  20. data/proto_docs/google/cloud/channel/v1/subscriber_event.rb +4 -0
  21. data/proto_docs/google/longrunning/operations.rb +23 -14
  22. data/proto_docs/google/type/datetime.rb +4 -0
  23. metadata +6 -9
data/lib/google/cloud/channel/v1/cloud_channel_service/operations.rb CHANGED
@@ -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
data/lib/google/cloud/channel/v1/cloud_channel_service/rest/client.rb CHANGED
@@ -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