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.
@@ -31,7 +31,8 @@ module Google
31
31
  #
32
32
  # @deprecated This service is deprecated and may be removed in the next major version update.
33
33
  class ServiceStub
34
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
34
+ # @private
35
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
35
36
  # These require statements are intentionally placed here to initialize
36
37
  # the REST modules only when it's required.
37
38
  require "gapic/rest"
@@ -41,7 +42,9 @@ module Google
41
42
  universe_domain: universe_domain,
42
43
  credentials: credentials,
43
44
  numeric_enums: true,
44
- raise_faraday_errors: false
45
+ service_name: self.class,
46
+ raise_faraday_errors: false,
47
+ logger: logger
45
48
  end
46
49
 
47
50
  ##
@@ -62,6 +65,15 @@ module Google
62
65
  @client_stub.endpoint
63
66
  end
64
67
 
68
+ ##
69
+ # The logger used for request/response debug logging.
70
+ #
71
+ # @return [Logger]
72
+ #
73
+ def logger stub: false
74
+ stub ? @client_stub.stub_logger : @client_stub.logger
75
+ end
76
+
65
77
  ##
66
78
  # Baseline implementation for the run_report_job REST call
67
79
  #
@@ -88,16 +100,18 @@ module Google
88
100
 
89
101
  response = @client_stub.make_http_request(
90
102
  verb,
91
- uri: uri,
92
- body: body || "",
93
- params: query_string_params,
103
+ uri: uri,
104
+ body: body || "",
105
+ params: query_string_params,
106
+ method_name: "run_report_job",
94
107
  options: options
95
108
  )
96
109
  operation = ::Gapic::Rest::TransportOperation.new response
97
110
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
98
-
99
- yield result, operation if block_given?
100
- result
111
+ catch :response do
112
+ yield result, operation if block_given?
113
+ result
114
+ end
101
115
  end
102
116
 
103
117
  ##
@@ -126,16 +140,18 @@ module Google
126
140
 
127
141
  response = @client_stub.make_http_request(
128
142
  verb,
129
- uri: uri,
130
- body: body || "",
131
- params: query_string_params,
143
+ uri: uri,
144
+ body: body || "",
145
+ params: query_string_params,
146
+ method_name: "fetch_report_results",
132
147
  options: options
133
148
  )
134
149
  operation = ::Gapic::Rest::TransportOperation.new response
135
150
  result = ::Google::Cloud::Channel::V1::FetchReportResultsResponse.decode_json response.body, ignore_unknown_fields: true
136
-
137
- yield result, operation if block_given?
138
- result
151
+ catch :response do
152
+ yield result, operation if block_given?
153
+ result
154
+ end
139
155
  end
140
156
 
141
157
  ##
@@ -164,16 +180,18 @@ module Google
164
180
 
165
181
  response = @client_stub.make_http_request(
166
182
  verb,
167
- uri: uri,
168
- body: body || "",
169
- params: query_string_params,
183
+ uri: uri,
184
+ body: body || "",
185
+ params: query_string_params,
186
+ method_name: "list_reports",
170
187
  options: options
171
188
  )
172
189
  operation = ::Gapic::Rest::TransportOperation.new response
173
190
  result = ::Google::Cloud::Channel::V1::ListReportsResponse.decode_json response.body, ignore_unknown_fields: true
174
-
175
- yield result, operation if block_given?
176
- result
191
+ catch :response do
192
+ yield result, operation if block_given?
193
+ result
194
+ end
177
195
  end
178
196
 
179
197
  ##
@@ -210,8 +210,19 @@ module Google
210
210
  universe_domain: @config.universe_domain,
211
211
  channel_args: @config.channel_args,
212
212
  interceptors: @config.interceptors,
213
- channel_pool_config: @config.channel_pool
213
+ channel_pool_config: @config.channel_pool,
214
+ logger: @config.logger
214
215
  )
216
+
217
+ @cloud_channel_service_stub.stub_logger&.info do |entry|
218
+ entry.set_system_name
219
+ entry.set_service
220
+ entry.message = "Created client for #{entry.service}"
221
+ entry.set_credentials_fields credentials
222
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
223
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
224
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
225
+ end
215
226
  end
216
227
 
217
228
  ##
@@ -221,6 +232,15 @@ module Google
221
232
  #
222
233
  attr_reader :operations_client
223
234
 
235
+ ##
236
+ # The logger used for request/response debug logging.
237
+ #
238
+ # @return [Logger]
239
+ #
240
+ def logger
241
+ @cloud_channel_service_stub.logger
242
+ end
243
+
224
244
  # Service calls
225
245
 
226
246
  ##
@@ -335,7 +355,7 @@ module Google
335
355
  @cloud_channel_service_stub.call_rpc :list_customers, request, options: options do |response, operation|
336
356
  response = ::Gapic::PagedEnumerable.new @cloud_channel_service_stub, :list_customers, request, response, operation, options
337
357
  yield response, operation if block_given?
338
- return response
358
+ throw :response, response
339
359
  end
340
360
  rescue ::GRPC::BadStatus => e
341
361
  raise ::Google::Cloud::Error.from_error(e)
@@ -434,7 +454,6 @@ module Google
434
454
 
435
455
  @cloud_channel_service_stub.call_rpc :get_customer, request, options: options do |response, operation|
436
456
  yield response, operation if block_given?
437
- return response
438
457
  end
439
458
  rescue ::GRPC::BadStatus => e
440
459
  raise ::Google::Cloud::Error.from_error(e)
@@ -546,7 +565,6 @@ module Google
546
565
 
547
566
  @cloud_channel_service_stub.call_rpc :check_cloud_identity_accounts_exist, request, options: options do |response, operation|
548
567
  yield response, operation if block_given?
549
- return response
550
568
  end
551
569
  rescue ::GRPC::BadStatus => e
552
570
  raise ::Google::Cloud::Error.from_error(e)
@@ -650,7 +668,6 @@ module Google
650
668
 
651
669
  @cloud_channel_service_stub.call_rpc :create_customer, request, options: options do |response, operation|
652
670
  yield response, operation if block_given?
653
- return response
654
671
  end
655
672
  rescue ::GRPC::BadStatus => e
656
673
  raise ::Google::Cloud::Error.from_error(e)
@@ -751,7 +768,6 @@ module Google
751
768
 
752
769
  @cloud_channel_service_stub.call_rpc :update_customer, request, options: options do |response, operation|
753
770
  yield response, operation if block_given?
754
- return response
755
771
  end
756
772
  rescue ::GRPC::BadStatus => e
757
773
  raise ::Google::Cloud::Error.from_error(e)
@@ -846,7 +862,6 @@ module Google
846
862
 
847
863
  @cloud_channel_service_stub.call_rpc :delete_customer, request, options: options do |response, operation|
848
864
  yield response, operation if block_given?
849
- return response
850
865
  end
851
866
  rescue ::GRPC::BadStatus => e
852
867
  raise ::Google::Cloud::Error.from_error(e)
@@ -891,10 +906,16 @@ module Google
891
906
  #
892
907
  # @param domain [::String]
893
908
  # Required. Customer domain.
909
+ #
910
+ # 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.
894
911
  # @param cloud_identity_id [::String]
895
912
  # Required. Customer's Cloud Identity ID
913
+ #
914
+ # 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.
896
915
  # @param primary_admin_email [::String]
897
916
  # Required. Customer's primary admin email.
917
+ #
918
+ # 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.
898
919
  # @param parent [::String]
899
920
  # Required. The resource name of the reseller's account.
900
921
  # Parent takes the format: accounts/\\{account_id} or
@@ -977,7 +998,6 @@ module Google
977
998
 
978
999
  @cloud_channel_service_stub.call_rpc :import_customer, request, options: options do |response, operation|
979
1000
  yield response, operation if block_given?
980
- return response
981
1001
  end
982
1002
  rescue ::GRPC::BadStatus => e
983
1003
  raise ::Google::Cloud::Error.from_error(e)
@@ -1101,7 +1121,7 @@ module Google
1101
1121
  @cloud_channel_service_stub.call_rpc :provision_cloud_identity, request, options: options do |response, operation|
1102
1122
  response = ::Gapic::Operation.new response, @operations_client, options: options
1103
1123
  yield response, operation if block_given?
1104
- return response
1124
+ throw :response, response
1105
1125
  end
1106
1126
  rescue ::GRPC::BadStatus => e
1107
1127
  raise ::Google::Cloud::Error.from_error(e)
@@ -1215,7 +1235,7 @@ module Google
1215
1235
  @cloud_channel_service_stub.call_rpc :list_entitlements, request, options: options do |response, operation|
1216
1236
  response = ::Gapic::PagedEnumerable.new @cloud_channel_service_stub, :list_entitlements, request, response, operation, options
1217
1237
  yield response, operation if block_given?
1218
- return response
1238
+ throw :response, response
1219
1239
  end
1220
1240
  rescue ::GRPC::BadStatus => e
1221
1241
  raise ::Google::Cloud::Error.from_error(e)
@@ -1259,11 +1279,15 @@ module Google
1259
1279
  #
1260
1280
  # @param cloud_identity_id [::String]
1261
1281
  # Customer's Cloud Identity ID
1282
+ #
1283
+ # 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.
1262
1284
  # @param customer_name [::String]
1263
1285
  # A reseller is required to create a customer and use the resource name of
1264
1286
  # the created customer here.
1265
1287
  # Customer_name uses the format:
1266
1288
  # accounts/\\{account_id}/customers/\\{customer_id}
1289
+ #
1290
+ # 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.
1267
1291
  # @param parent [::String]
1268
1292
  # Required. The reseller account's resource name.
1269
1293
  # Parent uses the format: accounts/\\{account_id}
@@ -1354,7 +1378,7 @@ module Google
1354
1378
  @cloud_channel_service_stub.call_rpc :list_transferable_skus, request, options: options do |response, operation|
1355
1379
  response = ::Gapic::PagedEnumerable.new @cloud_channel_service_stub, :list_transferable_skus, request, response, operation, options
1356
1380
  yield response, operation if block_given?
1357
- return response
1381
+ throw :response, response
1358
1382
  end
1359
1383
  rescue ::GRPC::BadStatus => e
1360
1384
  raise ::Google::Cloud::Error.from_error(e)
@@ -1401,9 +1425,13 @@ module Google
1401
1425
  #
1402
1426
  # @param cloud_identity_id [::String]
1403
1427
  # Customer's Cloud Identity ID
1428
+ #
1429
+ # 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.
1404
1430
  # @param customer_name [::String]
1405
1431
  # A reseller should create a customer and use the resource name of
1406
1432
  # that customer here.
1433
+ #
1434
+ # 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.
1407
1435
  # @param parent [::String]
1408
1436
  # Required. The resource name of the reseller's account.
1409
1437
  # @param page_size [::Integer]
@@ -1494,7 +1522,7 @@ module Google
1494
1522
  @cloud_channel_service_stub.call_rpc :list_transferable_offers, request, options: options do |response, operation|
1495
1523
  response = ::Gapic::PagedEnumerable.new @cloud_channel_service_stub, :list_transferable_offers, request, response, operation, options
1496
1524
  yield response, operation if block_given?
1497
- return response
1525
+ throw :response, response
1498
1526
  end
1499
1527
  rescue ::GRPC::BadStatus => e
1500
1528
  raise ::Google::Cloud::Error.from_error(e)
@@ -1592,7 +1620,6 @@ module Google
1592
1620
 
1593
1621
  @cloud_channel_service_stub.call_rpc :get_entitlement, request, options: options do |response, operation|
1594
1622
  yield response, operation if block_given?
1595
- return response
1596
1623
  end
1597
1624
  rescue ::GRPC::BadStatus => e
1598
1625
  raise ::Google::Cloud::Error.from_error(e)
@@ -1741,7 +1768,7 @@ module Google
1741
1768
  @cloud_channel_service_stub.call_rpc :create_entitlement, request, options: options do |response, operation|
1742
1769
  response = ::Gapic::Operation.new response, @operations_client, options: options
1743
1770
  yield response, operation if block_given?
1744
- return response
1771
+ throw :response, response
1745
1772
  end
1746
1773
  rescue ::GRPC::BadStatus => e
1747
1774
  raise ::Google::Cloud::Error.from_error(e)
@@ -1881,7 +1908,7 @@ module Google
1881
1908
  @cloud_channel_service_stub.call_rpc :change_parameters, request, options: options do |response, operation|
1882
1909
  response = ::Gapic::Operation.new response, @operations_client, options: options
1883
1910
  yield response, operation if block_given?
1884
- return response
1911
+ throw :response, response
1885
1912
  end
1886
1913
  rescue ::GRPC::BadStatus => e
1887
1914
  raise ::Google::Cloud::Error.from_error(e)
@@ -2014,7 +2041,7 @@ module Google
2014
2041
  @cloud_channel_service_stub.call_rpc :change_renewal_settings, request, options: options do |response, operation|
2015
2042
  response = ::Gapic::Operation.new response, @operations_client, options: options
2016
2043
  yield response, operation if block_given?
2017
- return response
2044
+ throw :response, response
2018
2045
  end
2019
2046
  rescue ::GRPC::BadStatus => e
2020
2047
  raise ::Google::Cloud::Error.from_error(e)
@@ -2159,7 +2186,7 @@ module Google
2159
2186
  @cloud_channel_service_stub.call_rpc :change_offer, request, options: options do |response, operation|
2160
2187
  response = ::Gapic::Operation.new response, @operations_client, options: options
2161
2188
  yield response, operation if block_given?
2162
- return response
2189
+ throw :response, response
2163
2190
  end
2164
2191
  rescue ::GRPC::BadStatus => e
2165
2192
  raise ::Google::Cloud::Error.from_error(e)
@@ -2291,7 +2318,7 @@ module Google
2291
2318
  @cloud_channel_service_stub.call_rpc :start_paid_service, request, options: options do |response, operation|
2292
2319
  response = ::Gapic::Operation.new response, @operations_client, options: options
2293
2320
  yield response, operation if block_given?
2294
- return response
2321
+ throw :response, response
2295
2322
  end
2296
2323
  rescue ::GRPC::BadStatus => e
2297
2324
  raise ::Google::Cloud::Error.from_error(e)
@@ -2420,7 +2447,7 @@ module Google
2420
2447
  @cloud_channel_service_stub.call_rpc :suspend_entitlement, request, options: options do |response, operation|
2421
2448
  response = ::Gapic::Operation.new response, @operations_client, options: options
2422
2449
  yield response, operation if block_given?
2423
- return response
2450
+ throw :response, response
2424
2451
  end
2425
2452
  rescue ::GRPC::BadStatus => e
2426
2453
  raise ::Google::Cloud::Error.from_error(e)
@@ -2554,7 +2581,7 @@ module Google
2554
2581
  @cloud_channel_service_stub.call_rpc :cancel_entitlement, request, options: options do |response, operation|
2555
2582
  response = ::Gapic::Operation.new response, @operations_client, options: options
2556
2583
  yield response, operation if block_given?
2557
- return response
2584
+ throw :response, response
2558
2585
  end
2559
2586
  rescue ::GRPC::BadStatus => e
2560
2587
  raise ::Google::Cloud::Error.from_error(e)
@@ -2689,7 +2716,7 @@ module Google
2689
2716
  @cloud_channel_service_stub.call_rpc :activate_entitlement, request, options: options do |response, operation|
2690
2717
  response = ::Gapic::Operation.new response, @operations_client, options: options
2691
2718
  yield response, operation if block_given?
2692
- return response
2719
+ throw :response, response
2693
2720
  end
2694
2721
  rescue ::GRPC::BadStatus => e
2695
2722
  raise ::Google::Cloud::Error.from_error(e)
@@ -2836,7 +2863,7 @@ module Google
2836
2863
  @cloud_channel_service_stub.call_rpc :transfer_entitlements, request, options: options do |response, operation|
2837
2864
  response = ::Gapic::Operation.new response, @operations_client, options: options
2838
2865
  yield response, operation if block_given?
2839
- return response
2866
+ throw :response, response
2840
2867
  end
2841
2868
  rescue ::GRPC::BadStatus => e
2842
2869
  raise ::Google::Cloud::Error.from_error(e)
@@ -2975,7 +3002,7 @@ module Google
2975
3002
  @cloud_channel_service_stub.call_rpc :transfer_entitlements_to_google, request, options: options do |response, operation|
2976
3003
  response = ::Gapic::Operation.new response, @operations_client, options: options
2977
3004
  yield response, operation if block_given?
2978
- return response
3005
+ throw :response, response
2979
3006
  end
2980
3007
  rescue ::GRPC::BadStatus => e
2981
3008
  raise ::Google::Cloud::Error.from_error(e)
@@ -3091,7 +3118,7 @@ module Google
3091
3118
  @cloud_channel_service_stub.call_rpc :list_channel_partner_links, request, options: options do |response, operation|
3092
3119
  response = ::Gapic::PagedEnumerable.new @cloud_channel_service_stub, :list_channel_partner_links, request, response, operation, options
3093
3120
  yield response, operation if block_given?
3094
- return response
3121
+ throw :response, response
3095
3122
  end
3096
3123
  rescue ::GRPC::BadStatus => e
3097
3124
  raise ::Google::Cloud::Error.from_error(e)
@@ -3195,7 +3222,6 @@ module Google
3195
3222
 
3196
3223
  @cloud_channel_service_stub.call_rpc :get_channel_partner_link, request, options: options do |response, operation|
3197
3224
  yield response, operation if block_given?
3198
- return response
3199
3225
  end
3200
3226
  rescue ::GRPC::BadStatus => e
3201
3227
  raise ::Google::Cloud::Error.from_error(e)
@@ -3309,7 +3335,6 @@ module Google
3309
3335
 
3310
3336
  @cloud_channel_service_stub.call_rpc :create_channel_partner_link, request, options: options do |response, operation|
3311
3337
  yield response, operation if block_given?
3312
- return response
3313
3338
  end
3314
3339
  rescue ::GRPC::BadStatus => e
3315
3340
  raise ::Google::Cloud::Error.from_error(e)
@@ -3425,7 +3450,6 @@ module Google
3425
3450
 
3426
3451
  @cloud_channel_service_stub.call_rpc :update_channel_partner_link, request, options: options do |response, operation|
3427
3452
  yield response, operation if block_given?
3428
- return response
3429
3453
  end
3430
3454
  rescue ::GRPC::BadStatus => e
3431
3455
  raise ::Google::Cloud::Error.from_error(e)
@@ -3529,7 +3553,6 @@ module Google
3529
3553
 
3530
3554
  @cloud_channel_service_stub.call_rpc :get_customer_repricing_config, request, options: options do |response, operation|
3531
3555
  yield response, operation if block_given?
3532
- return response
3533
3556
  end
3534
3557
  rescue ::GRPC::BadStatus => e
3535
3558
  raise ::Google::Cloud::Error.from_error(e)
@@ -3666,7 +3689,7 @@ module Google
3666
3689
  @cloud_channel_service_stub.call_rpc :list_customer_repricing_configs, request, options: options do |response, operation|
3667
3690
  response = ::Gapic::PagedEnumerable.new @cloud_channel_service_stub, :list_customer_repricing_configs, request, response, operation, options
3668
3691
  yield response, operation if block_given?
3669
- return response
3692
+ throw :response, response
3670
3693
  end
3671
3694
  rescue ::GRPC::BadStatus => e
3672
3695
  raise ::Google::Cloud::Error.from_error(e)
@@ -3797,7 +3820,6 @@ module Google
3797
3820
 
3798
3821
  @cloud_channel_service_stub.call_rpc :create_customer_repricing_config, request, options: options do |response, operation|
3799
3822
  yield response, operation if block_given?
3800
- return response
3801
3823
  end
3802
3824
  rescue ::GRPC::BadStatus => e
3803
3825
  raise ::Google::Cloud::Error.from_error(e)
@@ -3914,7 +3936,6 @@ module Google
3914
3936
 
3915
3937
  @cloud_channel_service_stub.call_rpc :update_customer_repricing_config, request, options: options do |response, operation|
3916
3938
  yield response, operation if block_given?
3917
- return response
3918
3939
  end
3919
3940
  rescue ::GRPC::BadStatus => e
3920
3941
  raise ::Google::Cloud::Error.from_error(e)
@@ -4018,7 +4039,6 @@ module Google
4018
4039
 
4019
4040
  @cloud_channel_service_stub.call_rpc :delete_customer_repricing_config, request, options: options do |response, operation|
4020
4041
  yield response, operation if block_given?
4021
- return response
4022
4042
  end
4023
4043
  rescue ::GRPC::BadStatus => e
4024
4044
  raise ::Google::Cloud::Error.from_error(e)
@@ -4122,7 +4142,6 @@ module Google
4122
4142
 
4123
4143
  @cloud_channel_service_stub.call_rpc :get_channel_partner_repricing_config, request, options: options do |response, operation|
4124
4144
  yield response, operation if block_given?
4125
- return response
4126
4145
  end
4127
4146
  rescue ::GRPC::BadStatus => e
4128
4147
  raise ::Google::Cloud::Error.from_error(e)
@@ -4262,7 +4281,7 @@ module Google
4262
4281
  @cloud_channel_service_stub.call_rpc :list_channel_partner_repricing_configs, request, options: options do |response, operation|
4263
4282
  response = ::Gapic::PagedEnumerable.new @cloud_channel_service_stub, :list_channel_partner_repricing_configs, request, response, operation, options
4264
4283
  yield response, operation if block_given?
4265
- return response
4284
+ throw :response, response
4266
4285
  end
4267
4286
  rescue ::GRPC::BadStatus => e
4268
4287
  raise ::Google::Cloud::Error.from_error(e)
@@ -4394,7 +4413,6 @@ module Google
4394
4413
 
4395
4414
  @cloud_channel_service_stub.call_rpc :create_channel_partner_repricing_config, request, options: options do |response, operation|
4396
4415
  yield response, operation if block_given?
4397
- return response
4398
4416
  end
4399
4417
  rescue ::GRPC::BadStatus => e
4400
4418
  raise ::Google::Cloud::Error.from_error(e)
@@ -4511,7 +4529,6 @@ module Google
4511
4529
 
4512
4530
  @cloud_channel_service_stub.call_rpc :update_channel_partner_repricing_config, request, options: options do |response, operation|
4513
4531
  yield response, operation if block_given?
4514
- return response
4515
4532
  end
4516
4533
  rescue ::GRPC::BadStatus => e
4517
4534
  raise ::Google::Cloud::Error.from_error(e)
@@ -4614,7 +4631,6 @@ module Google
4614
4631
 
4615
4632
  @cloud_channel_service_stub.call_rpc :delete_channel_partner_repricing_config, request, options: options do |response, operation|
4616
4633
  yield response, operation if block_given?
4617
- return response
4618
4634
  end
4619
4635
  rescue ::GRPC::BadStatus => e
4620
4636
  raise ::Google::Cloud::Error.from_error(e)
@@ -4735,7 +4751,7 @@ module Google
4735
4751
  @cloud_channel_service_stub.call_rpc :list_sku_groups, request, options: options do |response, operation|
4736
4752
  response = ::Gapic::PagedEnumerable.new @cloud_channel_service_stub, :list_sku_groups, request, response, operation, options
4737
4753
  yield response, operation if block_given?
4738
- return response
4754
+ throw :response, response
4739
4755
  end
4740
4756
  rescue ::GRPC::BadStatus => e
4741
4757
  raise ::Google::Cloud::Error.from_error(e)
@@ -4855,7 +4871,7 @@ module Google
4855
4871
  @cloud_channel_service_stub.call_rpc :list_sku_group_billable_skus, request, options: options do |response, operation|
4856
4872
  response = ::Gapic::PagedEnumerable.new @cloud_channel_service_stub, :list_sku_group_billable_skus, request, response, operation, options
4857
4873
  yield response, operation if block_given?
4858
- return response
4874
+ throw :response, response
4859
4875
  end
4860
4876
  rescue ::GRPC::BadStatus => e
4861
4877
  raise ::Google::Cloud::Error.from_error(e)
@@ -4952,7 +4968,6 @@ module Google
4952
4968
 
4953
4969
  @cloud_channel_service_stub.call_rpc :lookup_offer, request, options: options do |response, operation|
4954
4970
  yield response, operation if block_given?
4955
- return response
4956
4971
  end
4957
4972
  rescue ::GRPC::BadStatus => e
4958
4973
  raise ::Google::Cloud::Error.from_error(e)
@@ -5050,7 +5065,7 @@ module Google
5050
5065
  @cloud_channel_service_stub.call_rpc :list_products, request, options: options do |response, operation|
5051
5066
  response = ::Gapic::PagedEnumerable.new @cloud_channel_service_stub, :list_products, request, response, operation, options
5052
5067
  yield response, operation if block_given?
5053
- return response
5068
+ throw :response, response
5054
5069
  end
5055
5070
  rescue ::GRPC::BadStatus => e
5056
5071
  raise ::Google::Cloud::Error.from_error(e)
@@ -5161,7 +5176,7 @@ module Google
5161
5176
  @cloud_channel_service_stub.call_rpc :list_skus, request, options: options do |response, operation|
5162
5177
  response = ::Gapic::PagedEnumerable.new @cloud_channel_service_stub, :list_skus, request, response, operation, options
5163
5178
  yield response, operation if block_given?
5164
- return response
5179
+ throw :response, response
5165
5180
  end
5166
5181
  rescue ::GRPC::BadStatus => e
5167
5182
  raise ::Google::Cloud::Error.from_error(e)
@@ -5278,7 +5293,7 @@ module Google
5278
5293
  @cloud_channel_service_stub.call_rpc :list_offers, request, options: options do |response, operation|
5279
5294
  response = ::Gapic::PagedEnumerable.new @cloud_channel_service_stub, :list_offers, request, response, operation, options
5280
5295
  yield response, operation if block_given?
5281
- return response
5296
+ throw :response, response
5282
5297
  end
5283
5298
  rescue ::GRPC::BadStatus => e
5284
5299
  raise ::Google::Cloud::Error.from_error(e)
@@ -5312,8 +5327,12 @@ module Google
5312
5327
  #
5313
5328
  # @param create_entitlement_purchase [::Google::Cloud::Channel::V1::ListPurchasableSkusRequest::CreateEntitlementPurchase, ::Hash]
5314
5329
  # List SKUs for CreateEntitlement purchase.
5330
+ #
5331
+ # 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.
5315
5332
  # @param change_offer_purchase [::Google::Cloud::Channel::V1::ListPurchasableSkusRequest::ChangeOfferPurchase, ::Hash]
5316
5333
  # List SKUs for ChangeOffer purchase with a new SKU.
5334
+ #
5335
+ # 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.
5317
5336
  # @param customer [::String]
5318
5337
  # Required. The resource name of the customer to list SKUs for.
5319
5338
  # Format: accounts/\\{account_id}/customers/\\{customer_id}.
@@ -5392,7 +5411,7 @@ module Google
5392
5411
  @cloud_channel_service_stub.call_rpc :list_purchasable_skus, request, options: options do |response, operation|
5393
5412
  response = ::Gapic::PagedEnumerable.new @cloud_channel_service_stub, :list_purchasable_skus, request, response, operation, options
5394
5413
  yield response, operation if block_given?
5395
- return response
5414
+ throw :response, response
5396
5415
  end
5397
5416
  rescue ::GRPC::BadStatus => e
5398
5417
  raise ::Google::Cloud::Error.from_error(e)
@@ -5429,8 +5448,12 @@ module Google
5429
5448
  #
5430
5449
  # @param create_entitlement_purchase [::Google::Cloud::Channel::V1::ListPurchasableOffersRequest::CreateEntitlementPurchase, ::Hash]
5431
5450
  # List Offers for CreateEntitlement purchase.
5451
+ #
5452
+ # 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.
5432
5453
  # @param change_offer_purchase [::Google::Cloud::Channel::V1::ListPurchasableOffersRequest::ChangeOfferPurchase, ::Hash]
5433
5454
  # List Offers for ChangeOffer purchase.
5455
+ #
5456
+ # 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.
5434
5457
  # @param customer [::String]
5435
5458
  # Required. The resource name of the customer to list Offers for.
5436
5459
  # Format: accounts/\\{account_id}/customers/\\{customer_id}.
@@ -5509,7 +5532,7 @@ module Google
5509
5532
  @cloud_channel_service_stub.call_rpc :list_purchasable_offers, request, options: options do |response, operation|
5510
5533
  response = ::Gapic::PagedEnumerable.new @cloud_channel_service_stub, :list_purchasable_offers, request, response, operation, options
5511
5534
  yield response, operation if block_given?
5512
- return response
5535
+ throw :response, response
5513
5536
  end
5514
5537
  rescue ::GRPC::BadStatus => e
5515
5538
  raise ::Google::Cloud::Error.from_error(e)
@@ -5610,7 +5633,6 @@ module Google
5610
5633
 
5611
5634
  @cloud_channel_service_stub.call_rpc :query_eligible_billing_accounts, request, options: options do |response, operation|
5612
5635
  yield response, operation if block_given?
5613
- return response
5614
5636
  end
5615
5637
  rescue ::GRPC::BadStatus => e
5616
5638
  raise ::Google::Cloud::Error.from_error(e)
@@ -5716,7 +5738,6 @@ module Google
5716
5738
 
5717
5739
  @cloud_channel_service_stub.call_rpc :register_subscriber, request, options: options do |response, operation|
5718
5740
  yield response, operation if block_given?
5719
- return response
5720
5741
  end
5721
5742
  rescue ::GRPC::BadStatus => e
5722
5743
  raise ::Google::Cloud::Error.from_error(e)
@@ -5825,7 +5846,6 @@ module Google
5825
5846
 
5826
5847
  @cloud_channel_service_stub.call_rpc :unregister_subscriber, request, options: options do |response, operation|
5827
5848
  yield response, operation if block_given?
5828
- return response
5829
5849
  end
5830
5850
  rescue ::GRPC::BadStatus => e
5831
5851
  raise ::Google::Cloud::Error.from_error(e)
@@ -5938,7 +5958,6 @@ module Google
5938
5958
 
5939
5959
  @cloud_channel_service_stub.call_rpc :list_subscribers, request, options: options do |response, operation|
5940
5960
  yield response, operation if block_given?
5941
- return response
5942
5961
  end
5943
5962
  rescue ::GRPC::BadStatus => e
5944
5963
  raise ::Google::Cloud::Error.from_error(e)
@@ -6064,7 +6083,7 @@ module Google
6064
6083
  @cloud_channel_service_stub.call_rpc :list_entitlement_changes, request, options: options do |response, operation|
6065
6084
  response = ::Gapic::PagedEnumerable.new @cloud_channel_service_stub, :list_entitlement_changes, request, response, operation, options
6066
6085
  yield response, operation if block_given?
6067
- return response
6086
+ throw :response, response
6068
6087
  end
6069
6088
  rescue ::GRPC::BadStatus => e
6070
6089
  raise ::Google::Cloud::Error.from_error(e)
@@ -6114,6 +6133,13 @@ module Google
6114
6133
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
6115
6134
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
6116
6135
  # * (`nil`) indicating no credentials
6136
+ #
6137
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
6138
+ # external source for authentication to Google Cloud, you must validate it before
6139
+ # providing it to a Google API client library. Providing an unvalidated credential
6140
+ # configuration to Google APIs can compromise the security of your systems and data.
6141
+ # For more information, refer to [Validate credential configurations from external
6142
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
6117
6143
  # @return [::Object]
6118
6144
  # @!attribute [rw] scope
6119
6145
  # The OAuth scopes
@@ -6153,6 +6179,11 @@ module Google
6153
6179
  # default endpoint URL. The default value of nil uses the environment
6154
6180
  # universe (usually the default "googleapis.com" universe).
6155
6181
  # @return [::String,nil]
6182
+ # @!attribute [rw] logger
6183
+ # A custom logger to use for request/response debug logging, or the value
6184
+ # `:default` (the default) to construct a default logger, or `nil` to
6185
+ # explicitly disable logging.
6186
+ # @return [::Logger,:default,nil]
6156
6187
  #
6157
6188
  class Configuration
6158
6189
  extend ::Gapic::Config
@@ -6177,6 +6208,7 @@ module Google
6177
6208
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
6178
6209
  config_attr :quota_project, nil, ::String, nil
6179
6210
  config_attr :universe_domain, nil, ::String, nil
6211
+ config_attr :logger, :default, ::Logger, nil, :default
6180
6212
 
6181
6213
  # @private
6182
6214
  def initialize parent_config = nil