google-cloud-channel-v1 0.14.0 → 0.16.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.
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.