google-cloud-channel-v1 0.14.0 → 0.16.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (33) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +2 -2
  3. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/client.rb +38 -36
  4. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/operations.rb +12 -14
  5. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/rest/client.rb +583 -0
  6. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/rest/operations.rb +793 -0
  7. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/rest/service_stub.rb +227 -0
  8. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/rest.rb +56 -0
  9. data/lib/google/cloud/channel/v1/cloud_channel_reports_service.rb +7 -1
  10. data/lib/google/cloud/channel/v1/cloud_channel_service/client.rb +389 -327
  11. data/lib/google/cloud/channel/v1/cloud_channel_service/operations.rb +12 -14
  12. data/lib/google/cloud/channel/v1/cloud_channel_service/rest/client.rb +4784 -0
  13. data/lib/google/cloud/channel/v1/cloud_channel_service/rest/operations.rb +793 -0
  14. data/lib/google/cloud/channel/v1/cloud_channel_service/rest/service_stub.rb +2771 -0
  15. data/lib/google/cloud/channel/v1/cloud_channel_service/rest.rb +72 -0
  16. data/lib/google/cloud/channel/v1/cloud_channel_service.rb +15 -8
  17. data/lib/google/cloud/channel/v1/reports_service_services_pb.rb +4 -2
  18. data/lib/google/cloud/channel/v1/repricing_pb.rb +17 -0
  19. data/lib/google/cloud/channel/v1/rest.rb +38 -0
  20. data/lib/google/cloud/channel/v1/service_services_pb.rb +155 -102
  21. data/lib/google/cloud/channel/v1/version.rb +1 -1
  22. data/lib/google/cloud/channel/v1.rb +7 -2
  23. data/proto_docs/google/api/client.rb +318 -0
  24. data/proto_docs/google/api/launch_stage.rb +71 -0
  25. data/proto_docs/google/cloud/channel/v1/channel_partner_links.rb +5 -3
  26. data/proto_docs/google/cloud/channel/v1/entitlements.rb +21 -16
  27. data/proto_docs/google/cloud/channel/v1/offers.rb +2 -2
  28. data/proto_docs/google/cloud/channel/v1/operations.rb +2 -1
  29. data/proto_docs/google/cloud/channel/v1/reports_service.rb +49 -34
  30. data/proto_docs/google/cloud/channel/v1/repricing.rb +63 -14
  31. data/proto_docs/google/cloud/channel/v1/service.rb +241 -159
  32. data/proto_docs/google/rpc/status.rb +4 -2
  33. metadata +21 -8
@@ -37,15 +37,16 @@ module Google
37
37
  # 3. Resellers and distributors can manage customer entitlements.
38
38
  #
39
39
  # CloudChannelService exposes the following resources:
40
- # - {::Google::Cloud::Channel::V1::Customer Customer}s: An entityusually an enterprise—managed by a reseller or
41
- # distributor.
40
+ # - {::Google::Cloud::Channel::V1::Customer Customer}s: An entity-usually an
41
+ # enterprise-managed by a reseller or distributor.
42
42
  #
43
- # - {::Google::Cloud::Channel::V1::Entitlement Entitlement}s: An entity that provides a customer with the means to use
44
- # a service. Entitlements are created or updated as a result of a successful
45
- # fulfillment.
43
+ # - {::Google::Cloud::Channel::V1::Entitlement Entitlement}s: An entity that
44
+ # provides a customer with the means to use a service. Entitlements are created
45
+ # or updated as a result of a successful fulfillment.
46
46
  #
47
- # - {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink}s: An entity that identifies links between
48
- # distributors and their indirect resellers in a channel.
47
+ # - {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink}s: An
48
+ # entity that identifies links between distributors and their indirect
49
+ # resellers in a channel.
49
50
  #
50
51
  class Client
51
52
  include Paths
@@ -212,7 +213,8 @@ module Google
212
213
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
213
214
  #
214
215
  # Return value:
215
- # List of {::Google::Cloud::Channel::V1::Customer Customer}s, or an empty list if there are no customers.
216
+ # List of {::Google::Cloud::Channel::V1::Customer Customer}s, or an empty list if
217
+ # there are no customers.
216
218
  #
217
219
  # @overload list_customers(request, options = nil)
218
220
  # Pass arguments to `list_customers` via a request object, either of type
@@ -233,16 +235,19 @@ module Google
233
235
  # Required. The resource name of the reseller account to list customers from.
234
236
  # Parent uses the format: accounts/\\{account_id}.
235
237
  # @param page_size [::Integer]
236
- # Optional. The maximum number of customers to return. The service may return fewer
237
- # than this value. If unspecified, returns at most 10 customers. The
238
+ # Optional. The maximum number of customers to return. The service may return
239
+ # fewer than this value. If unspecified, returns at most 10 customers. The
238
240
  # maximum value is 50.
239
241
  # @param page_token [::String]
240
242
  # Optional. A token identifying a page of results other than the first page.
241
243
  # Obtained through
242
- # {::Google::Cloud::Channel::V1::ListCustomersResponse#next_page_token ListCustomersResponse.next_page_token} of the previous
243
- # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_customers CloudChannelService.ListCustomers} call.
244
+ # {::Google::Cloud::Channel::V1::ListCustomersResponse#next_page_token ListCustomersResponse.next_page_token}
245
+ # of the previous
246
+ # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_customers CloudChannelService.ListCustomers}
247
+ # call.
244
248
  # @param filter [::String]
245
- # Optional. Filters applied to the [CloudChannelService.ListCustomers] results. See
249
+ # Optional. Filters applied to the [CloudChannelService.ListCustomers]
250
+ # results. See
246
251
  # https://cloud.google.com/channel/docs/concepts/google-cloud/filter-customers
247
252
  # for more information.
248
253
  #
@@ -266,13 +271,11 @@ module Google
266
271
  # # Call the list_customers method.
267
272
  # result = client.list_customers request
268
273
  #
269
- # # The returned object is of type Gapic::PagedEnumerable. You can
270
- # # iterate over all elements by calling #each, and the enumerable
271
- # # will lazily make API calls to fetch subsequent pages. Other
272
- # # methods are also available for managing paging directly.
273
- # result.each do |response|
274
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
275
+ # # over elements, and API calls will be issued to fetch pages as needed.
276
+ # result.each do |item|
274
277
  # # Each element is of type ::Google::Cloud::Channel::V1::Customer.
275
- # p response
278
+ # p item
276
279
  # end
277
280
  #
278
281
  def list_customers request, options = nil
@@ -318,7 +321,8 @@ module Google
318
321
  end
319
322
 
320
323
  ##
321
- # Returns the requested {::Google::Cloud::Channel::V1::Customer Customer} resource.
324
+ # Returns the requested {::Google::Cloud::Channel::V1::Customer Customer}
325
+ # resource.
322
326
  #
323
327
  # Possible error codes:
324
328
  #
@@ -426,11 +430,14 @@ module Google
426
430
  # * INVALID_VALUE: Invalid domain value in the request.
427
431
  #
428
432
  # Return value:
429
- # A list of {::Google::Cloud::Channel::V1::CloudIdentityCustomerAccount CloudIdentityCustomerAccount} resources for the domain (may be
430
- # empty)
433
+ # A list of
434
+ # {::Google::Cloud::Channel::V1::CloudIdentityCustomerAccount CloudIdentityCustomerAccount}
435
+ # resources for the domain (may be empty)
431
436
  #
432
437
  # Note: in the v1alpha1 version of the API, a NOT_FOUND error returns if
433
- # no {::Google::Cloud::Channel::V1::CloudIdentityCustomerAccount CloudIdentityCustomerAccount} resources match the domain.
438
+ # no
439
+ # {::Google::Cloud::Channel::V1::CloudIdentityCustomerAccount CloudIdentityCustomerAccount}
440
+ # resources match the domain.
434
441
  #
435
442
  # @overload check_cloud_identity_accounts_exist(request, options = nil)
436
443
  # Pass arguments to `check_cloud_identity_accounts_exist` via a request object, either of type
@@ -518,8 +525,8 @@ module Google
518
525
  end
519
526
 
520
527
  ##
521
- # Creates a new {::Google::Cloud::Channel::V1::Customer Customer} resource under the reseller or distributor
522
- # account.
528
+ # Creates a new {::Google::Cloud::Channel::V1::Customer Customer} resource under
529
+ # the reseller or distributor account.
523
530
  #
524
531
  # Possible error codes:
525
532
  #
@@ -548,8 +555,8 @@ module Google
548
555
  # the default parameter values, pass an empty Hash as a request object (see above).
549
556
  #
550
557
  # @param parent [::String]
551
- # Required. The resource name of reseller account in which to create the customer.
552
- # Parent uses the format: accounts/\\{account_id}
558
+ # Required. The resource name of reseller account in which to create the
559
+ # customer. Parent uses the format: accounts/\\{account_id}
553
560
  # @param customer [::Google::Cloud::Channel::V1::Customer, ::Hash]
554
561
  # Required. The customer to create.
555
562
  #
@@ -618,15 +625,16 @@ module Google
618
625
  end
619
626
 
620
627
  ##
621
- # Updates an existing {::Google::Cloud::Channel::V1::Customer Customer} resource for the reseller or
622
- # distributor.
628
+ # Updates an existing {::Google::Cloud::Channel::V1::Customer Customer} resource
629
+ # for the reseller or distributor.
623
630
  #
624
631
  # Possible error codes:
625
632
  #
626
633
  # * PERMISSION_DENIED: The reseller account making the request is different
627
634
  # from the reseller account in the API request.
628
635
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
629
- # * NOT_FOUND: No {::Google::Cloud::Channel::V1::Customer Customer} resource found for the name in the request.
636
+ # * NOT_FOUND: No {::Google::Cloud::Channel::V1::Customer Customer} resource found
637
+ # for the name in the request.
630
638
  #
631
639
  # Return value:
632
640
  # The updated {::Google::Cloud::Channel::V1::Customer Customer} resource.
@@ -725,7 +733,8 @@ module Google
725
733
  # this customer.
726
734
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
727
735
  # * FAILED_PRECONDITION: The customer has existing entitlements.
728
- # * NOT_FOUND: No {::Google::Cloud::Channel::V1::Customer Customer} resource found for the name in the request.
736
+ # * NOT_FOUND: No {::Google::Cloud::Channel::V1::Customer Customer} resource found
737
+ # for the name in the request.
729
738
  #
730
739
  # @overload delete_customer(request, options = nil)
731
740
  # Pass arguments to `delete_customer` via a request object, either of type
@@ -810,10 +819,10 @@ module Google
810
819
  end
811
820
 
812
821
  ##
813
- # Imports a {::Google::Cloud::Channel::V1::Customer Customer} from the Cloud Identity associated with the provided
814
- # Cloud Identity ID or domain before a TransferEntitlements call. If a
815
- # linked Customer already exists and overwrite_if_exists is true, it will
816
- # update that Customer's data.
822
+ # Imports a {::Google::Cloud::Channel::V1::Customer Customer} from the Cloud
823
+ # Identity associated with the provided Cloud Identity ID or domain before a
824
+ # TransferEntitlements call. If a linked Customer already exists and
825
+ # overwrite_if_exists is true, it will update that Customer's data.
817
826
  #
818
827
  # Possible error codes:
819
828
  #
@@ -861,9 +870,10 @@ module Google
861
870
  # This must be set to true if there is an existing customer with a
862
871
  # conflicting region code or domain.
863
872
  # @param channel_partner_id [::String]
864
- # Optional. Cloud Identity ID of a channel partner who will be the direct reseller for
865
- # the customer's order. This field is required for 2-tier transfer scenarios
866
- # and can be provided via the request Parent binding as well.
873
+ # Optional. Cloud Identity ID of a channel partner who will be the direct
874
+ # reseller for the customer's order. This field is required for 2-tier
875
+ # transfer scenarios and can be provided via the request Parent binding as
876
+ # well.
867
877
  # @param customer [::String]
868
878
  # Optional. Specifies the customer that will receive imported Cloud Identity
869
879
  # information.
@@ -1001,14 +1011,14 @@ module Google
1001
1011
  # # Call the provision_cloud_identity method.
1002
1012
  # result = client.provision_cloud_identity request
1003
1013
  #
1004
- # # The returned object is of type Gapic::Operation. You can use this
1005
- # # object to check the status of an operation, cancel it, or wait
1006
- # # for results. Here is how to block until completion:
1014
+ # # The returned object is of type Gapic::Operation. You can use it to
1015
+ # # check the status of an operation, cancel it, or wait for results.
1016
+ # # Here is how to wait for a response.
1007
1017
  # result.wait_until_done! timeout: 60
1008
1018
  # if result.response?
1009
1019
  # p result.response
1010
1020
  # else
1011
- # puts "Error!"
1021
+ # puts "No response received."
1012
1022
  # end
1013
1023
  #
1014
1024
  def provision_cloud_identity request, options = nil
@@ -1054,7 +1064,8 @@ module Google
1054
1064
  end
1055
1065
 
1056
1066
  ##
1057
- # Lists {::Google::Cloud::Channel::V1::Entitlement Entitlement}s belonging to a customer.
1067
+ # Lists {::Google::Cloud::Channel::V1::Entitlement Entitlement}s belonging to a
1068
+ # customer.
1058
1069
  #
1059
1070
  # Possible error codes:
1060
1071
  #
@@ -1062,7 +1073,8 @@ module Google
1062
1073
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
1063
1074
  #
1064
1075
  # Return value:
1065
- # A list of the customer's {::Google::Cloud::Channel::V1::Entitlement Entitlement}s.
1076
+ # A list of the customer's
1077
+ # {::Google::Cloud::Channel::V1::Entitlement Entitlement}s.
1066
1078
  #
1067
1079
  # @overload list_entitlements(request, options = nil)
1068
1080
  # Pass arguments to `list_entitlements` via a request object, either of type
@@ -1084,14 +1096,16 @@ module Google
1084
1096
  # entitlements for.
1085
1097
  # Parent uses the format: accounts/\\{account_id}/customers/\\{customer_id}
1086
1098
  # @param page_size [::Integer]
1087
- # Optional. Requested page size. Server might return fewer results than requested.
1088
- # If unspecified, return at most 50 entitlements.
1089
- # The maximum value is 100; the server will coerce values above 100.
1099
+ # Optional. Requested page size. Server might return fewer results than
1100
+ # requested. If unspecified, return at most 50 entitlements. The maximum
1101
+ # value is 100; the server will coerce values above 100.
1090
1102
  # @param page_token [::String]
1091
1103
  # Optional. A token for a page of results other than the first page.
1092
1104
  # Obtained using
1093
- # {::Google::Cloud::Channel::V1::ListEntitlementsResponse#next_page_token ListEntitlementsResponse.next_page_token} of the previous
1094
- # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_entitlements CloudChannelService.ListEntitlements} call.
1105
+ # {::Google::Cloud::Channel::V1::ListEntitlementsResponse#next_page_token ListEntitlementsResponse.next_page_token}
1106
+ # of the previous
1107
+ # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_entitlements CloudChannelService.ListEntitlements}
1108
+ # call.
1095
1109
  #
1096
1110
  # @yield [response, operation] Access the result along with the RPC operation
1097
1111
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Channel::V1::Entitlement>]
@@ -1113,13 +1127,11 @@ module Google
1113
1127
  # # Call the list_entitlements method.
1114
1128
  # result = client.list_entitlements request
1115
1129
  #
1116
- # # The returned object is of type Gapic::PagedEnumerable. You can
1117
- # # iterate over all elements by calling #each, and the enumerable
1118
- # # will lazily make API calls to fetch subsequent pages. Other
1119
- # # methods are also available for managing paging directly.
1120
- # result.each do |response|
1130
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1131
+ # # over elements, and API calls will be issued to fetch pages as needed.
1132
+ # result.each do |item|
1121
1133
  # # Each element is of type ::Google::Cloud::Channel::V1::Entitlement.
1122
- # p response
1134
+ # p item
1123
1135
  # end
1124
1136
  #
1125
1137
  def list_entitlements request, options = nil
@@ -1165,8 +1177,8 @@ module Google
1165
1177
  end
1166
1178
 
1167
1179
  ##
1168
- # List {::Google::Cloud::Channel::V1::TransferableSku TransferableSku}s of a customer based on the Cloud Identity ID or
1169
- # Customer Name in the request.
1180
+ # List {::Google::Cloud::Channel::V1::TransferableSku TransferableSku}s of a
1181
+ # customer based on the Cloud Identity ID or Customer Name in the request.
1170
1182
  #
1171
1183
  # Use this method to list the entitlements information of an
1172
1184
  # unowned customer. You should provide the customer's
@@ -1182,7 +1194,8 @@ module Google
1182
1194
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
1183
1195
  #
1184
1196
  # Return value:
1185
- # A list of the customer's {::Google::Cloud::Channel::V1::TransferableSku TransferableSku}.
1197
+ # A list of the customer's
1198
+ # {::Google::Cloud::Channel::V1::TransferableSku TransferableSku}.
1186
1199
  #
1187
1200
  # @overload list_transferable_skus(request, options = nil)
1188
1201
  # Pass arguments to `list_transferable_skus` via a request object, either of type
@@ -1217,9 +1230,10 @@ module Google
1217
1230
  # @param page_token [::String]
1218
1231
  # A token for a page of results other than the first page.
1219
1232
  # Obtained using
1220
- # {::Google::Cloud::Channel::V1::ListTransferableSkusResponse#next_page_token ListTransferableSkusResponse.next_page_token} of the previous
1221
- # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_transferable_skus CloudChannelService.ListTransferableSkus} call.
1222
- # Optional.
1233
+ # {::Google::Cloud::Channel::V1::ListTransferableSkusResponse#next_page_token ListTransferableSkusResponse.next_page_token}
1234
+ # of the previous
1235
+ # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_transferable_skus CloudChannelService.ListTransferableSkus}
1236
+ # call. Optional.
1223
1237
  # @param auth_token [::String]
1224
1238
  # Optional. The super admin of the resold customer generates this token to
1225
1239
  # authorize a reseller to access their Cloud Identity and purchase
@@ -1251,13 +1265,11 @@ module Google
1251
1265
  # # Call the list_transferable_skus method.
1252
1266
  # result = client.list_transferable_skus request
1253
1267
  #
1254
- # # The returned object is of type Gapic::PagedEnumerable. You can
1255
- # # iterate over all elements by calling #each, and the enumerable
1256
- # # will lazily make API calls to fetch subsequent pages. Other
1257
- # # methods are also available for managing paging directly.
1258
- # result.each do |response|
1268
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1269
+ # # over elements, and API calls will be issued to fetch pages as needed.
1270
+ # result.each do |item|
1259
1271
  # # Each element is of type ::Google::Cloud::Channel::V1::TransferableSku.
1260
- # p response
1272
+ # p item
1261
1273
  # end
1262
1274
  #
1263
1275
  def list_transferable_skus request, options = nil
@@ -1303,8 +1315,8 @@ module Google
1303
1315
  end
1304
1316
 
1305
1317
  ##
1306
- # List {::Google::Cloud::Channel::V1::TransferableOffer TransferableOffer}s of a customer based on Cloud Identity ID or
1307
- # Customer Name in the request.
1318
+ # List {::Google::Cloud::Channel::V1::TransferableOffer TransferableOffer}s of a
1319
+ # customer based on Cloud Identity ID or Customer Name in the request.
1308
1320
  #
1309
1321
  # Use this method when a reseller gets the entitlement information of an
1310
1322
  # unowned customer. The reseller should provide the customer's
@@ -1321,7 +1333,8 @@ module Google
1321
1333
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
1322
1334
  #
1323
1335
  # Return value:
1324
- # List of {::Google::Cloud::Channel::V1::TransferableOffer TransferableOffer} for the given customer and SKU.
1336
+ # List of {::Google::Cloud::Channel::V1::TransferableOffer TransferableOffer} for
1337
+ # the given customer and SKU.
1325
1338
  #
1326
1339
  # @overload list_transferable_offers(request, options = nil)
1327
1340
  # Pass arguments to `list_transferable_offers` via a request object, either of type
@@ -1352,8 +1365,10 @@ module Google
1352
1365
  # @param page_token [::String]
1353
1366
  # A token for a page of results other than the first page.
1354
1367
  # Obtained using
1355
- # {::Google::Cloud::Channel::V1::ListTransferableOffersResponse#next_page_token ListTransferableOffersResponse.next_page_token} of the previous
1356
- # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_transferable_offers CloudChannelService.ListTransferableOffers} call.
1368
+ # {::Google::Cloud::Channel::V1::ListTransferableOffersResponse#next_page_token ListTransferableOffersResponse.next_page_token}
1369
+ # of the previous
1370
+ # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_transferable_offers CloudChannelService.ListTransferableOffers}
1371
+ # call.
1357
1372
  # @param sku [::String]
1358
1373
  # Required. The SKU to look up Offers for.
1359
1374
  # @param language_code [::String]
@@ -1381,13 +1396,11 @@ module Google
1381
1396
  # # Call the list_transferable_offers method.
1382
1397
  # result = client.list_transferable_offers request
1383
1398
  #
1384
- # # The returned object is of type Gapic::PagedEnumerable. You can
1385
- # # iterate over all elements by calling #each, and the enumerable
1386
- # # will lazily make API calls to fetch subsequent pages. Other
1387
- # # methods are also available for managing paging directly.
1388
- # result.each do |response|
1399
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1400
+ # # over elements, and API calls will be issued to fetch pages as needed.
1401
+ # result.each do |item|
1389
1402
  # # Each element is of type ::Google::Cloud::Channel::V1::TransferableOffer.
1390
- # p response
1403
+ # p item
1391
1404
  # end
1392
1405
  #
1393
1406
  def list_transferable_offers request, options = nil
@@ -1433,7 +1446,8 @@ module Google
1433
1446
  end
1434
1447
 
1435
1448
  ##
1436
- # Returns the requested {::Google::Cloud::Channel::V1::Entitlement Entitlement} resource.
1449
+ # Returns the requested {::Google::Cloud::Channel::V1::Entitlement Entitlement}
1450
+ # resource.
1437
1451
  #
1438
1452
  # Possible error codes:
1439
1453
  #
@@ -1582,14 +1596,15 @@ module Google
1582
1596
  # the default parameter values, pass an empty Hash as a request object (see above).
1583
1597
  #
1584
1598
  # @param parent [::String]
1585
- # Required. The resource name of the reseller's customer account in which to create the
1586
- # entitlement.
1587
- # Parent uses the format: accounts/\\{account_id}/customers/\\{customer_id}
1599
+ # Required. The resource name of the reseller's customer account in which to
1600
+ # create the entitlement. Parent uses the format:
1601
+ # accounts/\\{account_id}/customers/\\{customer_id}
1588
1602
  # @param entitlement [::Google::Cloud::Channel::V1::Entitlement, ::Hash]
1589
1603
  # Required. The entitlement to create.
1590
1604
  # @param request_id [::String]
1591
- # Optional. You can specify an optional unique request ID, and if you need to retry
1592
- # your request, the server will know to ignore the request if it's complete.
1605
+ # Optional. You can specify an optional unique request ID, and if you need to
1606
+ # retry your request, the server will know to ignore the request if it's
1607
+ # complete.
1593
1608
  #
1594
1609
  # For example, you make an initial request and the request times out. If you
1595
1610
  # make the request again with the same request ID, the server can check if
@@ -1620,14 +1635,14 @@ module Google
1620
1635
  # # Call the create_entitlement method.
1621
1636
  # result = client.create_entitlement request
1622
1637
  #
1623
- # # The returned object is of type Gapic::Operation. You can use this
1624
- # # object to check the status of an operation, cancel it, or wait
1625
- # # for results. Here is how to block until completion:
1638
+ # # The returned object is of type Gapic::Operation. You can use it to
1639
+ # # check the status of an operation, cancel it, or wait for results.
1640
+ # # Here is how to wait for a response.
1626
1641
  # result.wait_until_done! timeout: 60
1627
1642
  # if result.response?
1628
1643
  # p result.response
1629
1644
  # else
1630
- # puts "Error!"
1645
+ # puts "No response received."
1631
1646
  # end
1632
1647
  #
1633
1648
  def create_entitlement request, options = nil
@@ -1717,13 +1732,16 @@ module Google
1717
1732
  # Name uses the format:
1718
1733
  # accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
1719
1734
  # @param parameters [::Array<::Google::Cloud::Channel::V1::Parameter, ::Hash>]
1720
- # Required. Entitlement parameters to update. You can only change editable parameters.
1735
+ # Required. Entitlement parameters to update. You can only change editable
1736
+ # parameters.
1721
1737
  #
1722
1738
  # To view the available Parameters for a request, refer to the
1723
- # {::Google::Cloud::Channel::V1::Offer#parameter_definitions Offer.parameter_definitions} from the desired offer.
1739
+ # {::Google::Cloud::Channel::V1::Offer#parameter_definitions Offer.parameter_definitions}
1740
+ # from the desired offer.
1724
1741
  # @param request_id [::String]
1725
- # Optional. You can specify an optional unique request ID, and if you need to retry
1726
- # your request, the server will know to ignore the request if it's complete.
1742
+ # Optional. You can specify an optional unique request ID, and if you need to
1743
+ # retry your request, the server will know to ignore the request if it's
1744
+ # complete.
1727
1745
  #
1728
1746
  # For example, you make an initial request and the request times out. If you
1729
1747
  # make the request again with the same request ID, the server can check if
@@ -1756,14 +1774,14 @@ module Google
1756
1774
  # # Call the change_parameters method.
1757
1775
  # result = client.change_parameters request
1758
1776
  #
1759
- # # The returned object is of type Gapic::Operation. You can use this
1760
- # # object to check the status of an operation, cancel it, or wait
1761
- # # for results. Here is how to block until completion:
1777
+ # # The returned object is of type Gapic::Operation. You can use it to
1778
+ # # check the status of an operation, cancel it, or wait for results.
1779
+ # # Here is how to wait for a response.
1762
1780
  # result.wait_until_done! timeout: 60
1763
1781
  # if result.response?
1764
1782
  # p result.response
1765
1783
  # else
1766
- # puts "Error!"
1784
+ # puts "No response received."
1767
1785
  # end
1768
1786
  #
1769
1787
  def change_parameters request, options = nil
@@ -1855,8 +1873,9 @@ module Google
1855
1873
  # @param renewal_settings [::Google::Cloud::Channel::V1::RenewalSettings, ::Hash]
1856
1874
  # Required. New renewal settings.
1857
1875
  # @param request_id [::String]
1858
- # Optional. You can specify an optional unique request ID, and if you need to retry
1859
- # your request, the server will know to ignore the request if it's complete.
1876
+ # Optional. You can specify an optional unique request ID, and if you need to
1877
+ # retry your request, the server will know to ignore the request if it's
1878
+ # complete.
1860
1879
  #
1861
1880
  # For example, you make an initial request and the request times out. If you
1862
1881
  # make the request again with the same request ID, the server can check if
@@ -1887,14 +1906,14 @@ module Google
1887
1906
  # # Call the change_renewal_settings method.
1888
1907
  # result = client.change_renewal_settings request
1889
1908
  #
1890
- # # The returned object is of type Gapic::Operation. You can use this
1891
- # # object to check the status of an operation, cancel it, or wait
1892
- # # for results. Here is how to block until completion:
1909
+ # # The returned object is of type Gapic::Operation. You can use it to
1910
+ # # check the status of an operation, cancel it, or wait for results.
1911
+ # # Here is how to wait for a response.
1893
1912
  # result.wait_until_done! timeout: 60
1894
1913
  # if result.response?
1895
1914
  # p result.response
1896
1915
  # else
1897
- # puts "Error!"
1916
+ # puts "No response received."
1898
1917
  # end
1899
1918
  #
1900
1919
  def change_renewal_settings request, options = nil
@@ -1985,13 +2004,16 @@ module Google
1985
2004
  # Required. New Offer.
1986
2005
  # Format: accounts/\\{account_id}/offers/\\{offer_id}.
1987
2006
  # @param parameters [::Array<::Google::Cloud::Channel::V1::Parameter, ::Hash>]
1988
- # Optional. Parameters needed to purchase the Offer. To view the available Parameters
1989
- # refer to the {::Google::Cloud::Channel::V1::Offer#parameter_definitions Offer.parameter_definitions} from the desired offer.
2007
+ # Optional. Parameters needed to purchase the Offer. To view the available
2008
+ # Parameters refer to the
2009
+ # {::Google::Cloud::Channel::V1::Offer#parameter_definitions Offer.parameter_definitions}
2010
+ # from the desired offer.
1990
2011
  # @param purchase_order_id [::String]
1991
2012
  # Optional. Purchase order id provided by the reseller.
1992
2013
  # @param request_id [::String]
1993
- # Optional. You can specify an optional unique request ID, and if you need to retry
1994
- # your request, the server will know to ignore the request if it's complete.
2014
+ # Optional. You can specify an optional unique request ID, and if you need to
2015
+ # retry your request, the server will know to ignore the request if it's
2016
+ # complete.
1995
2017
  #
1996
2018
  # For example, you make an initial request and the request times out. If you
1997
2019
  # make the request again with the same request ID, the server can check if
@@ -2022,14 +2044,14 @@ module Google
2022
2044
  # # Call the change_offer method.
2023
2045
  # result = client.change_offer request
2024
2046
  #
2025
- # # The returned object is of type Gapic::Operation. You can use this
2026
- # # object to check the status of an operation, cancel it, or wait
2027
- # # for results. Here is how to block until completion:
2047
+ # # The returned object is of type Gapic::Operation. You can use it to
2048
+ # # check the status of an operation, cancel it, or wait for results.
2049
+ # # Here is how to wait for a response.
2028
2050
  # result.wait_until_done! timeout: 60
2029
2051
  # if result.response?
2030
2052
  # p result.response
2031
2053
  # else
2032
- # puts "Error!"
2054
+ # puts "No response received."
2033
2055
  # end
2034
2056
  #
2035
2057
  def change_offer request, options = nil
@@ -2120,8 +2142,9 @@ module Google
2120
2142
  # Name uses the format:
2121
2143
  # accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
2122
2144
  # @param request_id [::String]
2123
- # Optional. You can specify an optional unique request ID, and if you need to retry
2124
- # your request, the server will know to ignore the request if it's complete.
2145
+ # Optional. You can specify an optional unique request ID, and if you need to
2146
+ # retry your request, the server will know to ignore the request if it's
2147
+ # complete.
2125
2148
  #
2126
2149
  # For example, you make an initial request and the request times out. If you
2127
2150
  # make the request again with the same request ID, the server can check if
@@ -2152,14 +2175,14 @@ module Google
2152
2175
  # # Call the start_paid_service method.
2153
2176
  # result = client.start_paid_service request
2154
2177
  #
2155
- # # The returned object is of type Gapic::Operation. You can use this
2156
- # # object to check the status of an operation, cancel it, or wait
2157
- # # for results. Here is how to block until completion:
2178
+ # # The returned object is of type Gapic::Operation. You can use it to
2179
+ # # check the status of an operation, cancel it, or wait for results.
2180
+ # # Here is how to wait for a response.
2158
2181
  # result.wait_until_done! timeout: 60
2159
2182
  # if result.response?
2160
2183
  # p result.response
2161
2184
  # else
2162
- # puts "Error!"
2185
+ # puts "No response received."
2163
2186
  # end
2164
2187
  #
2165
2188
  def start_paid_service request, options = nil
@@ -2247,8 +2270,9 @@ module Google
2247
2270
  # Name uses the format:
2248
2271
  # accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
2249
2272
  # @param request_id [::String]
2250
- # Optional. You can specify an optional unique request ID, and if you need to retry
2251
- # your request, the server will know to ignore the request if it's complete.
2273
+ # Optional. You can specify an optional unique request ID, and if you need to
2274
+ # retry your request, the server will know to ignore the request if it's
2275
+ # complete.
2252
2276
  #
2253
2277
  # For example, you make an initial request and the request times out. If you
2254
2278
  # make the request again with the same request ID, the server can check if
@@ -2279,14 +2303,14 @@ module Google
2279
2303
  # # Call the suspend_entitlement method.
2280
2304
  # result = client.suspend_entitlement request
2281
2305
  #
2282
- # # The returned object is of type Gapic::Operation. You can use this
2283
- # # object to check the status of an operation, cancel it, or wait
2284
- # # for results. Here is how to block until completion:
2306
+ # # The returned object is of type Gapic::Operation. You can use it to
2307
+ # # check the status of an operation, cancel it, or wait for results.
2308
+ # # Here is how to wait for a response.
2285
2309
  # result.wait_until_done! timeout: 60
2286
2310
  # if result.response?
2287
2311
  # p result.response
2288
2312
  # else
2289
- # puts "Error!"
2313
+ # puts "No response received."
2290
2314
  # end
2291
2315
  #
2292
2316
  def suspend_entitlement request, options = nil
@@ -2379,8 +2403,9 @@ module Google
2379
2403
  # Name uses the format:
2380
2404
  # accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
2381
2405
  # @param request_id [::String]
2382
- # Optional. You can specify an optional unique request ID, and if you need to retry
2383
- # your request, the server will know to ignore the request if it's complete.
2406
+ # Optional. You can specify an optional unique request ID, and if you need to
2407
+ # retry your request, the server will know to ignore the request if it's
2408
+ # complete.
2384
2409
  #
2385
2410
  # For example, you make an initial request and the request times out. If you
2386
2411
  # make the request again with the same request ID, the server can check if
@@ -2411,14 +2436,14 @@ module Google
2411
2436
  # # Call the cancel_entitlement method.
2412
2437
  # result = client.cancel_entitlement request
2413
2438
  #
2414
- # # The returned object is of type Gapic::Operation. You can use this
2415
- # # object to check the status of an operation, cancel it, or wait
2416
- # # for results. Here is how to block until completion:
2439
+ # # The returned object is of type Gapic::Operation. You can use it to
2440
+ # # check the status of an operation, cancel it, or wait for results.
2441
+ # # Here is how to wait for a response.
2417
2442
  # result.wait_until_done! timeout: 60
2418
2443
  # if result.response?
2419
2444
  # p result.response
2420
2445
  # else
2421
- # puts "Error!"
2446
+ # puts "No response received."
2422
2447
  # end
2423
2448
  #
2424
2449
  def cancel_entitlement request, options = nil
@@ -2512,8 +2537,9 @@ module Google
2512
2537
  # Name uses the format:
2513
2538
  # accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
2514
2539
  # @param request_id [::String]
2515
- # Optional. You can specify an optional unique request ID, and if you need to retry
2516
- # your request, the server will know to ignore the request if it's complete.
2540
+ # Optional. You can specify an optional unique request ID, and if you need to
2541
+ # retry your request, the server will know to ignore the request if it's
2542
+ # complete.
2517
2543
  #
2518
2544
  # For example, you make an initial request and the request times out. If you
2519
2545
  # make the request again with the same request ID, the server can check if
@@ -2544,14 +2570,14 @@ module Google
2544
2570
  # # Call the activate_entitlement method.
2545
2571
  # result = client.activate_entitlement request
2546
2572
  #
2547
- # # The returned object is of type Gapic::Operation. You can use this
2548
- # # object to check the status of an operation, cancel it, or wait
2549
- # # for results. Here is how to block until completion:
2573
+ # # The returned object is of type Gapic::Operation. You can use it to
2574
+ # # check the status of an operation, cancel it, or wait for results.
2575
+ # # Here is how to wait for a response.
2550
2576
  # result.wait_until_done! timeout: 60
2551
2577
  # if result.response?
2552
2578
  # p result.response
2553
2579
  # else
2554
- # puts "Error!"
2580
+ # puts "No response received."
2555
2581
  # end
2556
2582
  #
2557
2583
  def activate_entitlement request, options = nil
@@ -2643,9 +2669,9 @@ module Google
2643
2669
  # the default parameter values, pass an empty Hash as a request object (see above).
2644
2670
  #
2645
2671
  # @param parent [::String]
2646
- # Required. The resource name of the reseller's customer account that will receive
2647
- # transferred entitlements.
2648
- # Parent uses the format: accounts/\\{account_id}/customers/\\{customer_id}
2672
+ # Required. The resource name of the reseller's customer account that will
2673
+ # receive transferred entitlements. Parent uses the format:
2674
+ # accounts/\\{account_id}/customers/\\{customer_id}
2649
2675
  # @param entitlements [::Array<::Google::Cloud::Channel::V1::Entitlement, ::Hash>]
2650
2676
  # Required. The new entitlements to create or transfer.
2651
2677
  # @param auth_token [::String]
@@ -2654,8 +2680,9 @@ module Google
2654
2680
  # entitlements on their behalf. You can omit this token after authorization.
2655
2681
  # See https://support.google.com/a/answer/7643790 for more details.
2656
2682
  # @param request_id [::String]
2657
- # Optional. You can specify an optional unique request ID, and if you need to retry
2658
- # your request, the server will know to ignore the request if it's complete.
2683
+ # Optional. You can specify an optional unique request ID, and if you need to
2684
+ # retry your request, the server will know to ignore the request if it's
2685
+ # complete.
2659
2686
  #
2660
2687
  # For example, you make an initial request and the request times out. If you
2661
2688
  # make the request again with the same request ID, the server can check if
@@ -2686,14 +2713,14 @@ module Google
2686
2713
  # # Call the transfer_entitlements method.
2687
2714
  # result = client.transfer_entitlements request
2688
2715
  #
2689
- # # The returned object is of type Gapic::Operation. You can use this
2690
- # # object to check the status of an operation, cancel it, or wait
2691
- # # for results. Here is how to block until completion:
2716
+ # # The returned object is of type Gapic::Operation. You can use it to
2717
+ # # check the status of an operation, cancel it, or wait for results.
2718
+ # # Here is how to wait for a response.
2692
2719
  # result.wait_until_done! timeout: 60
2693
2720
  # if result.response?
2694
2721
  # p result.response
2695
2722
  # else
2696
- # puts "Error!"
2723
+ # puts "No response received."
2697
2724
  # end
2698
2725
  #
2699
2726
  def transfer_entitlements request, options = nil
@@ -2785,14 +2812,15 @@ module Google
2785
2812
  # the default parameter values, pass an empty Hash as a request object (see above).
2786
2813
  #
2787
2814
  # @param parent [::String]
2788
- # Required. The resource name of the reseller's customer account where the entitlements
2789
- # transfer from.
2790
- # Parent uses the format: accounts/\\{account_id}/customers/\\{customer_id}
2815
+ # Required. The resource name of the reseller's customer account where the
2816
+ # entitlements transfer from. Parent uses the format:
2817
+ # accounts/\\{account_id}/customers/\\{customer_id}
2791
2818
  # @param entitlements [::Array<::Google::Cloud::Channel::V1::Entitlement, ::Hash>]
2792
2819
  # Required. The entitlements to transfer to Google.
2793
2820
  # @param request_id [::String]
2794
- # Optional. You can specify an optional unique request ID, and if you need to retry
2795
- # your request, the server will know to ignore the request if it's complete.
2821
+ # Optional. You can specify an optional unique request ID, and if you need to
2822
+ # retry your request, the server will know to ignore the request if it's
2823
+ # complete.
2796
2824
  #
2797
2825
  # For example, you make an initial request and the request times out. If you
2798
2826
  # make the request again with the same request ID, the server can check if
@@ -2823,14 +2851,14 @@ module Google
2823
2851
  # # Call the transfer_entitlements_to_google method.
2824
2852
  # result = client.transfer_entitlements_to_google request
2825
2853
  #
2826
- # # The returned object is of type Gapic::Operation. You can use this
2827
- # # object to check the status of an operation, cancel it, or wait
2828
- # # for results. Here is how to block until completion:
2854
+ # # The returned object is of type Gapic::Operation. You can use it to
2855
+ # # check the status of an operation, cancel it, or wait for results.
2856
+ # # Here is how to wait for a response.
2829
2857
  # result.wait_until_done! timeout: 60
2830
2858
  # if result.response?
2831
2859
  # p result.response
2832
2860
  # else
2833
- # puts "Error!"
2861
+ # puts "No response received."
2834
2862
  # end
2835
2863
  #
2836
2864
  def transfer_entitlements_to_google request, options = nil
@@ -2876,8 +2904,8 @@ module Google
2876
2904
  end
2877
2905
 
2878
2906
  ##
2879
- # List {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink}s belonging to a distributor.
2880
- # You must be a distributor to call this method.
2907
+ # List {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink}s
2908
+ # belonging to a distributor. You must be a distributor to call this method.
2881
2909
  #
2882
2910
  # Possible error codes:
2883
2911
  #
@@ -2886,7 +2914,8 @@ module Google
2886
2914
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
2887
2915
  #
2888
2916
  # Return value:
2889
- # The list of the distributor account's {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resources.
2917
+ # The list of the distributor account's
2918
+ # {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resources.
2890
2919
  #
2891
2920
  # @overload list_channel_partner_links(request, options = nil)
2892
2921
  # Pass arguments to `list_channel_partner_links` via a request object, either of type
@@ -2904,18 +2933,19 @@ module Google
2904
2933
  # the default parameter values, pass an empty Hash as a request object (see above).
2905
2934
  #
2906
2935
  # @param parent [::String]
2907
- # Required. The resource name of the reseller account for listing channel partner
2908
- # links.
2909
- # Parent uses the format: accounts/\\{account_id}
2936
+ # Required. The resource name of the reseller account for listing channel
2937
+ # partner links. Parent uses the format: accounts/\\{account_id}
2910
2938
  # @param page_size [::Integer]
2911
- # Optional. Requested page size. Server might return fewer results than requested.
2912
- # If unspecified, server will pick a default size (25).
2913
- # The maximum value is 200; the server will coerce values above 200.
2939
+ # Optional. Requested page size. Server might return fewer results than
2940
+ # requested. If unspecified, server will pick a default size (25). The
2941
+ # maximum value is 200; the server will coerce values above 200.
2914
2942
  # @param page_token [::String]
2915
2943
  # Optional. A token for a page of results other than the first page.
2916
2944
  # Obtained using
2917
- # {::Google::Cloud::Channel::V1::ListChannelPartnerLinksResponse#next_page_token ListChannelPartnerLinksResponse.next_page_token} of the previous
2918
- # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_channel_partner_links CloudChannelService.ListChannelPartnerLinks} call.
2945
+ # {::Google::Cloud::Channel::V1::ListChannelPartnerLinksResponse#next_page_token ListChannelPartnerLinksResponse.next_page_token}
2946
+ # of the previous
2947
+ # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_channel_partner_links CloudChannelService.ListChannelPartnerLinks}
2948
+ # call.
2919
2949
  # @param view [::Google::Cloud::Channel::V1::ChannelPartnerLinkView]
2920
2950
  # Optional. The level of granularity the ChannelPartnerLink will display.
2921
2951
  #
@@ -2939,13 +2969,11 @@ module Google
2939
2969
  # # Call the list_channel_partner_links method.
2940
2970
  # result = client.list_channel_partner_links request
2941
2971
  #
2942
- # # The returned object is of type Gapic::PagedEnumerable. You can
2943
- # # iterate over all elements by calling #each, and the enumerable
2944
- # # will lazily make API calls to fetch subsequent pages. Other
2945
- # # methods are also available for managing paging directly.
2946
- # result.each do |response|
2972
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2973
+ # # over elements, and API calls will be issued to fetch pages as needed.
2974
+ # result.each do |item|
2947
2975
  # # Each element is of type ::Google::Cloud::Channel::V1::ChannelPartnerLink.
2948
- # p response
2976
+ # p item
2949
2977
  # end
2950
2978
  #
2951
2979
  def list_channel_partner_links request, options = nil
@@ -2991,7 +3019,8 @@ module Google
2991
3019
  end
2992
3020
 
2993
3021
  ##
2994
- # Returns the requested {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resource.
3022
+ # Returns the requested
3023
+ # {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resource.
2995
3024
  # You must be a distributor to call this method.
2996
3025
  #
2997
3026
  # Possible error codes:
@@ -3003,7 +3032,8 @@ module Google
3003
3032
  # invalid channel partner link name.
3004
3033
  #
3005
3034
  # Return value:
3006
- # The {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resource.
3035
+ # The {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink}
3036
+ # resource.
3007
3037
  #
3008
3038
  # @overload get_channel_partner_link(request, options = nil)
3009
3039
  # Pass arguments to `get_channel_partner_link` via a request object, either of type
@@ -3113,7 +3143,8 @@ module Google
3113
3143
  # Contact Cloud Channel support.
3114
3144
  #
3115
3145
  # Return value:
3116
- # The new {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resource.
3146
+ # The new {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink}
3147
+ # resource.
3117
3148
  #
3118
3149
  # @overload create_channel_partner_link(request, options = nil)
3119
3150
  # Pass arguments to `create_channel_partner_link` via a request object, either of type
@@ -3224,7 +3255,8 @@ module Google
3224
3255
  # Contact Cloud Channel support.
3225
3256
  #
3226
3257
  # Return value:
3227
- # The updated {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resource.
3258
+ # The updated
3259
+ # {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resource.
3228
3260
  #
3229
3261
  # @overload update_channel_partner_link(request, options = nil)
3230
3262
  # Pass arguments to `update_channel_partner_link` via a request object, either of type
@@ -3246,8 +3278,8 @@ module Google
3246
3278
  # Name uses the format: accounts/\\{account_id}/channelPartnerLinks/\\{id}
3247
3279
  # where \\{id} is the Cloud Identity ID of the partner.
3248
3280
  # @param channel_partner_link [::Google::Cloud::Channel::V1::ChannelPartnerLink, ::Hash]
3249
- # Required. The channel partner link to update. Only channel_partner_link.link_state
3250
- # is allowed for updates.
3281
+ # Required. The channel partner link to update. Only
3282
+ # channel_partner_link.link_state is allowed for updates.
3251
3283
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
3252
3284
  # Required. The update mask that applies to the resource.
3253
3285
  # The only allowable value for an update mask is
@@ -3325,13 +3357,16 @@ module Google
3325
3357
  #
3326
3358
  # * PERMISSION_DENIED: If the account making the request and the account
3327
3359
  # being queried are different.
3328
- # * NOT_FOUND: The {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig} was not found.
3360
+ # * NOT_FOUND: The
3361
+ # {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig}
3362
+ # was not found.
3329
3363
  # * INTERNAL: Any non-user error related to technical issues in the
3330
3364
  # backend. In this case, contact Cloud Channel support.
3331
3365
  #
3332
3366
  # Return Value:
3333
- # If successful, the {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig} resource, otherwise returns
3334
- # an error.
3367
+ # If successful, the
3368
+ # {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig}
3369
+ # resource, otherwise returns an error.
3335
3370
  #
3336
3371
  # @overload get_customer_repricing_config(request, options = nil)
3337
3372
  # Pass arguments to `get_customer_repricing_config` via a request object, either of type
@@ -3425,14 +3460,17 @@ module Google
3425
3460
  #
3426
3461
  # * PERMISSION_DENIED: If the account making the request and the account
3427
3462
  # being queried are different.
3428
- # * NOT_FOUND: The {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig} specified does not exist or is
3429
- # not associated with the given account.
3463
+ # * NOT_FOUND: The
3464
+ # {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig}
3465
+ # specified does not exist or is not associated with the given account.
3430
3466
  # * INTERNAL: Any non-user error related to technical issues in the
3431
3467
  # backend. In this case, contact Cloud Channel support.
3432
3468
  #
3433
3469
  # Return Value:
3434
- # If successful, the {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig} resources. The
3435
- # data for each resource is displayed in the ascending order of:
3470
+ # If successful, the
3471
+ # {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig}
3472
+ # resources. The data for each resource is displayed in the ascending order
3473
+ # of:
3436
3474
  # * customer ID
3437
3475
  # * {::Google::Cloud::Channel::V1::RepricingConfig::EntitlementGranularity#entitlement RepricingConfig.EntitlementGranularity.entitlement}
3438
3476
  # * {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}
@@ -3461,14 +3499,16 @@ module Google
3461
3499
  # Supports accounts/\\{account_id}/customers/- to retrieve configs for all
3462
3500
  # customers.
3463
3501
  # @param page_size [::Integer]
3464
- # Optional. The maximum number of repricing configs to return. The service may return
3465
- # fewer than this value. If unspecified, returns a maximum of 50 rules. The
3466
- # maximum value is 100; values above 100 will be coerced to 100.
3502
+ # Optional. The maximum number of repricing configs to return. The service
3503
+ # may return fewer than this value. If unspecified, returns a maximum of 50
3504
+ # rules. The maximum value is 100; values above 100 will be coerced to 100.
3467
3505
  # @param page_token [::String]
3468
3506
  # Optional. A token identifying a page of results beyond the first page.
3469
3507
  # Obtained through
3470
- # {::Google::Cloud::Channel::V1::ListCustomerRepricingConfigsResponse#next_page_token ListCustomerRepricingConfigsResponse.next_page_token} of the previous
3471
- # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_customer_repricing_configs CloudChannelService.ListCustomerRepricingConfigs} call.
3508
+ # {::Google::Cloud::Channel::V1::ListCustomerRepricingConfigsResponse#next_page_token ListCustomerRepricingConfigsResponse.next_page_token}
3509
+ # of the previous
3510
+ # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_customer_repricing_configs CloudChannelService.ListCustomerRepricingConfigs}
3511
+ # call.
3472
3512
  # @param filter [::String]
3473
3513
  # Optional. A filter for [CloudChannelService.ListCustomerRepricingConfigs]
3474
3514
  # results (customer only). You can use this filter when you support
@@ -3498,13 +3538,11 @@ module Google
3498
3538
  # # Call the list_customer_repricing_configs method.
3499
3539
  # result = client.list_customer_repricing_configs request
3500
3540
  #
3501
- # # The returned object is of type Gapic::PagedEnumerable. You can
3502
- # # iterate over all elements by calling #each, and the enumerable
3503
- # # will lazily make API calls to fetch subsequent pages. Other
3504
- # # methods are also available for managing paging directly.
3505
- # result.each do |response|
3541
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
3542
+ # # over elements, and API calls will be issued to fetch pages as needed.
3543
+ # result.each do |item|
3506
3544
  # # Each element is of type ::Google::Cloud::Channel::V1::CustomerRepricingConfig.
3507
- # p response
3545
+ # p item
3508
3546
  # end
3509
3547
  #
3510
3548
  def list_customer_repricing_configs request, options = nil
@@ -3552,9 +3590,9 @@ module Google
3552
3590
  ##
3553
3591
  # Creates a CustomerRepricingConfig. Call this method to set modifications
3554
3592
  # for a specific customer's bill. You can only create configs if the
3555
- # {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month} is a
3556
- # future month. If needed, you can create a config for the current month,
3557
- # with some restrictions.
3593
+ # {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}
3594
+ # is a future month. If needed, you can create a config for the current
3595
+ # month, with some restrictions.
3558
3596
  #
3559
3597
  # When creating a config for a future month, make sure there are no existing
3560
3598
  # configs for that
@@ -3568,9 +3606,11 @@ module Google
3568
3606
  # Changes to the config may be immediate, but may take up to 24 hours.
3569
3607
  # * There is a limit of ten configs for any
3570
3608
  # {::Google::Cloud::Channel::V1::RepricingConfig::EntitlementGranularity#entitlement RepricingConfig.EntitlementGranularity.entitlement}
3571
- # or {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}.
3572
- # * The contained {::Google::Cloud::Channel::V1::CustomerRepricingConfig#repricing_config CustomerRepricingConfig.repricing_config} vaule must be
3573
- # different from the value used in the current config for a
3609
+ # or
3610
+ # {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}.
3611
+ # * The contained
3612
+ # {::Google::Cloud::Channel::V1::CustomerRepricingConfig#repricing_config CustomerRepricingConfig.repricing_config}
3613
+ # vaule must be different from the value used in the current config for a
3574
3614
  # {::Google::Cloud::Channel::V1::RepricingConfig::EntitlementGranularity#entitlement RepricingConfig.EntitlementGranularity.entitlement}.
3575
3615
  #
3576
3616
  # Possible Error Codes:
@@ -3580,14 +3620,16 @@ module Google
3580
3620
  # * INVALID_ARGUMENT: Missing or invalid required parameters in the
3581
3621
  # request. Also displays if the updated config is for the current month or
3582
3622
  # past months.
3583
- # * NOT_FOUND: The {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig} specified does not exist or is
3584
- # not associated with the given account.
3623
+ # * NOT_FOUND: The
3624
+ # {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig}
3625
+ # specified does not exist or is not associated with the given account.
3585
3626
  # * INTERNAL: Any non-user error related to technical issues in the
3586
3627
  # backend. In this case, contact Cloud Channel support.
3587
3628
  #
3588
3629
  # Return Value:
3589
- # If successful, the updated {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig} resource, otherwise
3590
- # returns an error.
3630
+ # If successful, the updated
3631
+ # {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig}
3632
+ # resource, otherwise returns an error.
3591
3633
  #
3592
3634
  # @overload create_customer_repricing_config(request, options = nil)
3593
3635
  # Pass arguments to `create_customer_repricing_config` via a request object, either of type
@@ -3605,8 +3647,9 @@ module Google
3605
3647
  # the default parameter values, pass an empty Hash as a request object (see above).
3606
3648
  #
3607
3649
  # @param parent [::String]
3608
- # Required. The resource name of the customer that will receive this repricing config.
3609
- # Parent uses the format: accounts/\\{account_id}/customers/\\{customer_id}
3650
+ # Required. The resource name of the customer that will receive this
3651
+ # repricing config. Parent uses the format:
3652
+ # accounts/\\{account_id}/customers/\\{customer_id}
3610
3653
  # @param customer_repricing_config [::Google::Cloud::Channel::V1::CustomerRepricingConfig, ::Hash]
3611
3654
  # Required. The CustomerRepricingConfig object to update.
3612
3655
  #
@@ -3680,10 +3723,11 @@ module Google
3680
3723
  # CustomerRepricingConfig.
3681
3724
  #
3682
3725
  # You can only update configs if the
3683
- # {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month} is a
3684
- # future month. To make changes to configs for the current month, use
3685
- # {::Google::Cloud::Channel::V1::CloudChannelService::Client#create_customer_repricing_config CreateCustomerRepricingConfig}, taking note of its restrictions. You
3686
- # cannot update the {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}.
3726
+ # {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}
3727
+ # is a future month. To make changes to configs for the current month, use
3728
+ # {::Google::Cloud::Channel::V1::CloudChannelService::Client#create_customer_repricing_config CreateCustomerRepricingConfig},
3729
+ # taking note of its restrictions. You cannot update the
3730
+ # {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}.
3687
3731
  #
3688
3732
  # When updating a config in the future:
3689
3733
  #
@@ -3696,14 +3740,16 @@ module Google
3696
3740
  # * INVALID_ARGUMENT: Missing or invalid required parameters in the
3697
3741
  # request. Also displays if the updated config is for the current month or
3698
3742
  # past months.
3699
- # * NOT_FOUND: The {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig} specified does not exist or is
3700
- # not associated with the given account.
3743
+ # * NOT_FOUND: The
3744
+ # {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig}
3745
+ # specified does not exist or is not associated with the given account.
3701
3746
  # * INTERNAL: Any non-user error related to technical issues in the
3702
3747
  # backend. In this case, contact Cloud Channel support.
3703
3748
  #
3704
3749
  # Return Value:
3705
- # If successful, the updated {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig} resource, otherwise
3706
- # returns an error.
3750
+ # If successful, the updated
3751
+ # {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig}
3752
+ # resource, otherwise returns an error.
3707
3753
  #
3708
3754
  # @overload update_customer_repricing_config(request, options = nil)
3709
3755
  # Pass arguments to `update_customer_repricing_config` via a request object, either of type
@@ -3788,19 +3834,23 @@ module Google
3788
3834
  end
3789
3835
 
3790
3836
  ##
3791
- # Deletes the given {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig} permanently. You can only
3792
- # delete configs if their {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month} is set
3793
- # to a date after the current month.
3837
+ # Deletes the given
3838
+ # {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig}
3839
+ # permanently. You can only delete configs if their
3840
+ # {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}
3841
+ # is set to a date after the current month.
3794
3842
  #
3795
3843
  # Possible error codes:
3796
3844
  #
3797
3845
  # * PERMISSION_DENIED: The account making the request does not own
3798
3846
  # this customer.
3799
3847
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
3800
- # * FAILED_PRECONDITION: The {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig} is active or in the
3801
- # past.
3802
- # * NOT_FOUND: No {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig} found for the name in the
3803
- # request.
3848
+ # * FAILED_PRECONDITION: The
3849
+ # {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig}
3850
+ # is active or in the past.
3851
+ # * NOT_FOUND: No
3852
+ # {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig}
3853
+ # found for the name in the request.
3804
3854
  #
3805
3855
  # @overload delete_customer_repricing_config(request, options = nil)
3806
3856
  # Pass arguments to `delete_customer_repricing_config` via a request object, either of type
@@ -3818,8 +3868,8 @@ module Google
3818
3868
  # the default parameter values, pass an empty Hash as a request object (see above).
3819
3869
  #
3820
3870
  # @param name [::String]
3821
- # Required. The resource name of the customer repricing config rule to delete.
3822
- # Format:
3871
+ # Required. The resource name of the customer repricing config rule to
3872
+ # delete. Format:
3823
3873
  # accounts/\\{account_id}/customers/\\{customer_id}/customerRepricingConfigs/\\{id}.
3824
3874
  #
3825
3875
  # @yield [response, operation] Access the result along with the RPC operation
@@ -3894,13 +3944,16 @@ module Google
3894
3944
  #
3895
3945
  # * PERMISSION_DENIED: If the account making the request and the account
3896
3946
  # being queried are different.
3897
- # * NOT_FOUND: The {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig} was not found.
3947
+ # * NOT_FOUND: The
3948
+ # {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}
3949
+ # was not found.
3898
3950
  # * INTERNAL: Any non-user error related to technical issues in the
3899
3951
  # backend. In this case, contact Cloud Channel support.
3900
3952
  #
3901
3953
  # Return Value:
3902
- # If successful, the {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig} resource, otherwise
3903
- # returns an error.
3954
+ # If successful, the
3955
+ # {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}
3956
+ # resource, otherwise returns an error.
3904
3957
  #
3905
3958
  # @overload get_channel_partner_repricing_config(request, options = nil)
3906
3959
  # Pass arguments to `get_channel_partner_repricing_config` via a request object, either of type
@@ -3994,14 +4047,17 @@ module Google
3994
4047
  #
3995
4048
  # * PERMISSION_DENIED: If the account making the request and the account
3996
4049
  # being queried are different.
3997
- # * NOT_FOUND: The {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig} specified does not exist
3998
- # or is not associated with the given account.
4050
+ # * NOT_FOUND: The
4051
+ # {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}
4052
+ # specified does not exist or is not associated with the given account.
3999
4053
  # * INTERNAL: Any non-user error related to technical issues in the
4000
4054
  # backend. In this case, contact Cloud Channel support.
4001
4055
  #
4002
4056
  # Return Value:
4003
- # If successful, the {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig} resources.
4004
- # The data for each resource is displayed in the ascending order of:
4057
+ # If successful, the
4058
+ # {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}
4059
+ # resources. The data for each resource is displayed in the ascending order
4060
+ # of:
4005
4061
  # * channel partner ID
4006
4062
  # * {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}
4007
4063
  # * {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig#update_time ChannelPartnerRepricingConfig.update_time}
@@ -4024,25 +4080,28 @@ module Google
4024
4080
  # the default parameter values, pass an empty Hash as a request object (see above).
4025
4081
  #
4026
4082
  # @param parent [::String]
4027
- # Required. The resource name of the account's {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink}.
4028
- # Parent uses the format:
4083
+ # Required. The resource name of the account's
4084
+ # {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink}. Parent
4085
+ # uses the format:
4029
4086
  # accounts/\\{account_id}/channelPartnerLinks/\\{channel_partner_id}.
4030
4087
  # Supports accounts/\\{account_id}/channelPartnerLinks/- to retrieve configs
4031
4088
  # for all channel partners.
4032
4089
  # @param page_size [::Integer]
4033
- # Optional. The maximum number of repricing configs to return. The service may return
4034
- # fewer than this value. If unspecified, returns a maximum of 50 rules. The
4035
- # maximum value is 100; values above 100 will be coerced to 100.
4090
+ # Optional. The maximum number of repricing configs to return. The service
4091
+ # may return fewer than this value. If unspecified, returns a maximum of 50
4092
+ # rules. The maximum value is 100; values above 100 will be coerced to 100.
4036
4093
  # @param page_token [::String]
4037
4094
  # Optional. A token identifying a page of results beyond the first page.
4038
4095
  # Obtained through
4039
- # {::Google::Cloud::Channel::V1::ListChannelPartnerRepricingConfigsResponse#next_page_token ListChannelPartnerRepricingConfigsResponse.next_page_token} of the
4040
- # previous {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_channel_partner_repricing_configs CloudChannelService.ListChannelPartnerRepricingConfigs} call.
4096
+ # {::Google::Cloud::Channel::V1::ListChannelPartnerRepricingConfigsResponse#next_page_token ListChannelPartnerRepricingConfigsResponse.next_page_token}
4097
+ # of the previous
4098
+ # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_channel_partner_repricing_configs CloudChannelService.ListChannelPartnerRepricingConfigs}
4099
+ # call.
4041
4100
  # @param filter [::String]
4042
- # Optional. A filter for [CloudChannelService.ListChannelPartnerRepricingConfigs]
4043
- # results (channel_partner_link only). You can use this filter when you
4044
- # support a BatchGet-like query.
4045
- # To use the filter, you must set
4101
+ # Optional. A filter for
4102
+ # [CloudChannelService.ListChannelPartnerRepricingConfigs] results
4103
+ # (channel_partner_link only). You can use this filter when you support a
4104
+ # BatchGet-like query. To use the filter, you must set
4046
4105
  # `parent=accounts/{account_id}/channelPartnerLinks/-`.
4047
4106
  #
4048
4107
  # Example: `channel_partner_link =
@@ -4069,13 +4128,11 @@ module Google
4069
4128
  # # Call the list_channel_partner_repricing_configs method.
4070
4129
  # result = client.list_channel_partner_repricing_configs request
4071
4130
  #
4072
- # # The returned object is of type Gapic::PagedEnumerable. You can
4073
- # # iterate over all elements by calling #each, and the enumerable
4074
- # # will lazily make API calls to fetch subsequent pages. Other
4075
- # # methods are also available for managing paging directly.
4076
- # result.each do |response|
4131
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
4132
+ # # over elements, and API calls will be issued to fetch pages as needed.
4133
+ # result.each do |item|
4077
4134
  # # Each element is of type ::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig.
4078
- # p response
4135
+ # p item
4079
4136
  # end
4080
4137
  #
4081
4138
  def list_channel_partner_repricing_configs request, options = nil
@@ -4123,9 +4180,10 @@ module Google
4123
4180
  ##
4124
4181
  # Creates a ChannelPartnerRepricingConfig. Call this method to set
4125
4182
  # modifications for a specific ChannelPartner's bill. You can only create
4126
- # configs if the {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month} is a future
4127
- # month. If needed, you can create a config for the current month, with some
4128
- # restrictions.
4183
+ # configs if the
4184
+ # {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}
4185
+ # is a future month. If needed, you can create a config for the current
4186
+ # month, with some restrictions.
4129
4187
  #
4130
4188
  # When creating a config for a future month, make sure there are no existing
4131
4189
  # configs for that
@@ -4139,8 +4197,9 @@ module Google
4139
4197
  # Changes to the config may be immediate, but may take up to 24 hours.
4140
4198
  # * There is a limit of ten configs for any ChannelPartner or
4141
4199
  # {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}.
4142
- # * The contained {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig#repricing_config ChannelPartnerRepricingConfig.repricing_config} vaule
4143
- # must be different from the value used in the current config for a
4200
+ # * The contained
4201
+ # {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig#repricing_config ChannelPartnerRepricingConfig.repricing_config}
4202
+ # vaule must be different from the value used in the current config for a
4144
4203
  # ChannelPartner.
4145
4204
  #
4146
4205
  # Possible Error Codes:
@@ -4150,14 +4209,16 @@ module Google
4150
4209
  # * INVALID_ARGUMENT: Missing or invalid required parameters in the
4151
4210
  # request. Also displays if the updated config is for the current month or
4152
4211
  # past months.
4153
- # * NOT_FOUND: The {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig} specified does not exist
4154
- # or is not associated with the given account.
4212
+ # * NOT_FOUND: The
4213
+ # {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}
4214
+ # specified does not exist or is not associated with the given account.
4155
4215
  # * INTERNAL: Any non-user error related to technical issues in the
4156
4216
  # backend. In this case, contact Cloud Channel support.
4157
4217
  #
4158
4218
  # Return Value:
4159
- # If successful, the updated {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig} resource,
4160
- # otherwise returns an error.
4219
+ # If successful, the updated
4220
+ # {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}
4221
+ # resource, otherwise returns an error.
4161
4222
  #
4162
4223
  # @overload create_channel_partner_repricing_config(request, options = nil)
4163
4224
  # Pass arguments to `create_channel_partner_repricing_config` via a request object, either of type
@@ -4175,8 +4236,8 @@ module Google
4175
4236
  # the default parameter values, pass an empty Hash as a request object (see above).
4176
4237
  #
4177
4238
  # @param parent [::String]
4178
- # Required. The resource name of the ChannelPartner that will receive the repricing
4179
- # config. Parent uses the format:
4239
+ # Required. The resource name of the ChannelPartner that will receive the
4240
+ # repricing config. Parent uses the format:
4180
4241
  # accounts/\\{account_id}/channelPartnerLinks/\\{channel_partner_id}
4181
4242
  # @param channel_partner_repricing_config [::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig, ::Hash]
4182
4243
  # Required. The ChannelPartnerRepricingConfig object to update.
@@ -4251,10 +4312,11 @@ module Google
4251
4312
  # the existing CustomerRepricingConfig.
4252
4313
  #
4253
4314
  # You can only update configs if the
4254
- # {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month} is a
4255
- # future month. To make changes to configs for the current month, use
4256
- # {::Google::Cloud::Channel::V1::CloudChannelService::Client#create_channel_partner_repricing_config CreateChannelPartnerRepricingConfig}, taking note of its restrictions.
4257
- # You cannot update the {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}.
4315
+ # {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}
4316
+ # is a future month. To make changes to configs for the current month, use
4317
+ # {::Google::Cloud::Channel::V1::CloudChannelService::Client#create_channel_partner_repricing_config CreateChannelPartnerRepricingConfig},
4318
+ # taking note of its restrictions. You cannot update the
4319
+ # {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}.
4258
4320
  #
4259
4321
  # When updating a config in the future:
4260
4322
  #
@@ -4267,14 +4329,16 @@ module Google
4267
4329
  # * INVALID_ARGUMENT: Missing or invalid required parameters in the
4268
4330
  # request. Also displays if the updated config is for the current month or
4269
4331
  # past months.
4270
- # * NOT_FOUND: The {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig} specified does not exist
4271
- # or is not associated with the given account.
4332
+ # * NOT_FOUND: The
4333
+ # {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}
4334
+ # specified does not exist or is not associated with the given account.
4272
4335
  # * INTERNAL: Any non-user error related to technical issues in the
4273
4336
  # backend. In this case, contact Cloud Channel support.
4274
4337
  #
4275
4338
  # Return Value:
4276
- # If successful, the updated {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig} resource,
4277
- # otherwise returns an error.
4339
+ # If successful, the updated
4340
+ # {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}
4341
+ # resource, otherwise returns an error.
4278
4342
  #
4279
4343
  # @overload update_channel_partner_repricing_config(request, options = nil)
4280
4344
  # Pass arguments to `update_channel_partner_repricing_config` via a request object, either of type
@@ -4359,19 +4423,23 @@ module Google
4359
4423
  end
4360
4424
 
4361
4425
  ##
4362
- # Deletes the given {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig} permanently. You can
4363
- # only delete configs if their {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month} is
4364
- # set to a date after the current month.
4426
+ # Deletes the given
4427
+ # {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}
4428
+ # permanently. You can only delete configs if their
4429
+ # {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}
4430
+ # is set to a date after the current month.
4365
4431
  #
4366
4432
  # Possible error codes:
4367
4433
  #
4368
4434
  # * PERMISSION_DENIED: The account making the request does not own
4369
4435
  # this customer.
4370
4436
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
4371
- # * FAILED_PRECONDITION: The {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig} is active or
4372
- # in the past.
4373
- # * NOT_FOUND: No {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig} found for the name in the
4374
- # request.
4437
+ # * FAILED_PRECONDITION: The
4438
+ # {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}
4439
+ # is active or in the past.
4440
+ # * NOT_FOUND: No
4441
+ # {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}
4442
+ # found for the name in the request.
4375
4443
  #
4376
4444
  # @overload delete_channel_partner_repricing_config(request, options = nil)
4377
4445
  # Pass arguments to `delete_channel_partner_repricing_config` via a request object, either of type
@@ -4389,7 +4457,8 @@ module Google
4389
4457
  # the default parameter values, pass an empty Hash as a request object (see above).
4390
4458
  #
4391
4459
  # @param name [::String]
4392
- # Required. The resource name of the channel partner repricing config rule to delete.
4460
+ # Required. The resource name of the channel partner repricing config rule to
4461
+ # delete.
4393
4462
  #
4394
4463
  # @yield [response, operation] Access the result along with the RPC operation
4395
4464
  # @yieldparam response [::Google::Protobuf::Empty]
@@ -4577,9 +4646,9 @@ module Google
4577
4646
  # Required. The resource name of the reseller account.
4578
4647
  # Format: accounts/\\{account_id}.
4579
4648
  # @param page_size [::Integer]
4580
- # Optional. Requested page size. Server might return fewer results than requested.
4581
- # If unspecified, returns at most 100 Products.
4582
- # The maximum value is 1000; the server will coerce values above 1000.
4649
+ # Optional. Requested page size. Server might return fewer results than
4650
+ # requested. If unspecified, returns at most 100 Products. The maximum value
4651
+ # is 1000; the server will coerce values above 1000.
4583
4652
  # @param page_token [::String]
4584
4653
  # Optional. A token for a page of results other than the first page.
4585
4654
  # @param language_code [::String]
@@ -4607,13 +4676,11 @@ module Google
4607
4676
  # # Call the list_products method.
4608
4677
  # result = client.list_products request
4609
4678
  #
4610
- # # The returned object is of type Gapic::PagedEnumerable. You can
4611
- # # iterate over all elements by calling #each, and the enumerable
4612
- # # will lazily make API calls to fetch subsequent pages. Other
4613
- # # methods are also available for managing paging directly.
4614
- # result.each do |response|
4679
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
4680
+ # # over elements, and API calls will be issued to fetch pages as needed.
4681
+ # result.each do |item|
4615
4682
  # # Each element is of type ::Google::Cloud::Channel::V1::Product.
4616
- # p response
4683
+ # p item
4617
4684
  # end
4618
4685
  #
4619
4686
  def list_products request, options = nil
@@ -4680,9 +4747,9 @@ module Google
4680
4747
  # Required. Resource name of the reseller.
4681
4748
  # Format: accounts/\\{account_id}.
4682
4749
  # @param page_size [::Integer]
4683
- # Optional. Requested page size. Server might return fewer results than requested.
4684
- # If unspecified, returns at most 100 SKUs.
4685
- # The maximum value is 1000; the server will coerce values above 1000.
4750
+ # Optional. Requested page size. Server might return fewer results than
4751
+ # requested. If unspecified, returns at most 100 SKUs. The maximum value is
4752
+ # 1000; the server will coerce values above 1000.
4686
4753
  # @param page_token [::String]
4687
4754
  # Optional. A token for a page of results other than the first page.
4688
4755
  # Optional.
@@ -4711,13 +4778,11 @@ module Google
4711
4778
  # # Call the list_skus method.
4712
4779
  # result = client.list_skus request
4713
4780
  #
4714
- # # The returned object is of type Gapic::PagedEnumerable. You can
4715
- # # iterate over all elements by calling #each, and the enumerable
4716
- # # will lazily make API calls to fetch subsequent pages. Other
4717
- # # methods are also available for managing paging directly.
4718
- # result.each do |response|
4781
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
4782
+ # # over elements, and API calls will be issued to fetch pages as needed.
4783
+ # result.each do |item|
4719
4784
  # # Each element is of type ::Google::Cloud::Channel::V1::Sku.
4720
- # p response
4785
+ # p item
4721
4786
  # end
4722
4787
  #
4723
4788
  def list_skus request, options = nil
@@ -4785,12 +4850,12 @@ module Google
4785
4850
  # the default parameter values, pass an empty Hash as a request object (see above).
4786
4851
  #
4787
4852
  # @param parent [::String]
4788
- # Required. The resource name of the reseller account from which to list Offers.
4789
- # Parent uses the format: accounts/\\{account_id}.
4853
+ # Required. The resource name of the reseller account from which to list
4854
+ # Offers. Parent uses the format: accounts/\\{account_id}.
4790
4855
  # @param page_size [::Integer]
4791
- # Optional. Requested page size. Server might return fewer results than requested.
4792
- # If unspecified, returns at most 500 Offers.
4793
- # The maximum value is 1000; the server will coerce values above 1000.
4856
+ # Optional. Requested page size. Server might return fewer results than
4857
+ # requested. If unspecified, returns at most 500 Offers. The maximum value is
4858
+ # 1000; the server will coerce values above 1000.
4794
4859
  # @param page_token [::String]
4795
4860
  # Optional. A token for a page of results other than the first page.
4796
4861
  # @param filter [::String]
@@ -4824,13 +4889,11 @@ module Google
4824
4889
  # # Call the list_offers method.
4825
4890
  # result = client.list_offers request
4826
4891
  #
4827
- # # The returned object is of type Gapic::PagedEnumerable. You can
4828
- # # iterate over all elements by calling #each, and the enumerable
4829
- # # will lazily make API calls to fetch subsequent pages. Other
4830
- # # methods are also available for managing paging directly.
4831
- # result.each do |response|
4892
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
4893
+ # # over elements, and API calls will be issued to fetch pages as needed.
4894
+ # result.each do |item|
4832
4895
  # # Each element is of type ::Google::Cloud::Channel::V1::Offer.
4833
- # p response
4896
+ # p item
4834
4897
  # end
4835
4898
  #
4836
4899
  def list_offers request, options = nil
@@ -4909,9 +4972,9 @@ module Google
4909
4972
  # Required. The resource name of the customer to list SKUs for.
4910
4973
  # Format: accounts/\\{account_id}/customers/\\{customer_id}.
4911
4974
  # @param page_size [::Integer]
4912
- # Optional. Requested page size. Server might return fewer results than requested.
4913
- # If unspecified, returns at most 100 SKUs.
4914
- # The maximum value is 1000; the server will coerce values above 1000.
4975
+ # Optional. Requested page size. Server might return fewer results than
4976
+ # requested. If unspecified, returns at most 100 SKUs. The maximum value is
4977
+ # 1000; the server will coerce values above 1000.
4915
4978
  # @param page_token [::String]
4916
4979
  # Optional. A token for a page of results other than the first page.
4917
4980
  # @param language_code [::String]
@@ -4939,13 +5002,11 @@ module Google
4939
5002
  # # Call the list_purchasable_skus method.
4940
5003
  # result = client.list_purchasable_skus request
4941
5004
  #
4942
- # # The returned object is of type Gapic::PagedEnumerable. You can
4943
- # # iterate over all elements by calling #each, and the enumerable
4944
- # # will lazily make API calls to fetch subsequent pages. Other
4945
- # # methods are also available for managing paging directly.
4946
- # result.each do |response|
5005
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
5006
+ # # over elements, and API calls will be issued to fetch pages as needed.
5007
+ # result.each do |item|
4947
5008
  # # Each element is of type ::Google::Cloud::Channel::V1::PurchasableSku.
4948
- # p response
5009
+ # p item
4949
5010
  # end
4950
5011
  #
4951
5012
  def list_purchasable_skus request, options = nil
@@ -5024,9 +5085,9 @@ module Google
5024
5085
  # Required. The resource name of the customer to list Offers for.
5025
5086
  # Format: accounts/\\{account_id}/customers/\\{customer_id}.
5026
5087
  # @param page_size [::Integer]
5027
- # Optional. Requested page size. Server might return fewer results than requested.
5028
- # If unspecified, returns at most 100 Offers.
5029
- # The maximum value is 1000; the server will coerce values above 1000.
5088
+ # Optional. Requested page size. Server might return fewer results than
5089
+ # requested. If unspecified, returns at most 100 Offers. The maximum value is
5090
+ # 1000; the server will coerce values above 1000.
5030
5091
  # @param page_token [::String]
5031
5092
  # Optional. A token for a page of results other than the first page.
5032
5093
  # @param language_code [::String]
@@ -5054,13 +5115,11 @@ module Google
5054
5115
  # # Call the list_purchasable_offers method.
5055
5116
  # result = client.list_purchasable_offers request
5056
5117
  #
5057
- # # The returned object is of type Gapic::PagedEnumerable. You can
5058
- # # iterate over all elements by calling #each, and the enumerable
5059
- # # will lazily make API calls to fetch subsequent pages. Other
5060
- # # methods are also available for managing paging directly.
5061
- # result.each do |response|
5118
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
5119
+ # # over elements, and API calls will be issued to fetch pages as needed.
5120
+ # result.each do |item|
5062
5121
  # # Each element is of type ::Google::Cloud::Channel::V1::PurchasableOffer.
5063
- # p response
5122
+ # p item
5064
5123
  # end
5065
5124
  #
5066
5125
  def list_purchasable_offers request, options = nil
@@ -5108,7 +5167,8 @@ module Google
5108
5167
  ##
5109
5168
  # Registers a service account with subscriber privileges on the Cloud Pub/Sub
5110
5169
  # topic for this Channel Services account. After you create a
5111
- # subscriber, you get the events through {::Google::Cloud::Channel::V1::SubscriberEvent SubscriberEvent}
5170
+ # subscriber, you get the events through
5171
+ # {::Google::Cloud::Channel::V1::SubscriberEvent SubscriberEvent}
5112
5172
  #
5113
5173
  # Possible error codes:
5114
5174
  #
@@ -5142,7 +5202,8 @@ module Google
5142
5202
  # @param account [::String]
5143
5203
  # Required. Resource name of the account.
5144
5204
  # @param service_account [::String]
5145
- # Required. Service account that provides subscriber access to the registered topic.
5205
+ # Required. Service account that provides subscriber access to the registered
5206
+ # topic.
5146
5207
  #
5147
5208
  # @yield [response, operation] Access the result along with the RPC operation
5148
5209
  # @yieldparam response [::Google::Cloud::Channel::V1::RegisterSubscriberResponse]
@@ -5249,7 +5310,8 @@ module Google
5249
5310
  # @param account [::String]
5250
5311
  # Required. Resource name of the account.
5251
5312
  # @param service_account [::String]
5252
- # Required. Service account to unregister from subscriber access to the topic.
5313
+ # Required. Service account to unregister from subscriber access to the
5314
+ # topic.
5253
5315
  #
5254
5316
  # @yield [response, operation] Access the result along with the RPC operation
5255
5317
  # @yieldparam response [::Google::Cloud::Channel::V1::UnregisterSubscriberResponse]
@@ -5352,10 +5414,10 @@ module Google
5352
5414
  # @param account [::String]
5353
5415
  # Required. Resource name of the account.
5354
5416
  # @param page_size [::Integer]
5355
- # Optional. The maximum number of service accounts to return. The service may return
5356
- # fewer than this value.
5357
- # If unspecified, returns at most 100 service accounts.
5358
- # The maximum value is 1000; the server will coerce values above 1000.
5417
+ # Optional. The maximum number of service accounts to return. The service may
5418
+ # return fewer than this value. If unspecified, returns at most 100 service
5419
+ # accounts. The maximum value is 1000; the server will coerce values above
5420
+ # 1000.
5359
5421
  # @param page_token [::String]
5360
5422
  # Optional. A page token, received from a previous `ListSubscribers` call.
5361
5423
  # Provide this to retrieve the subsequent page.