google-cloud-channel-v1 0.20.0 → 0.22.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 (26) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/channel/v1/billing_accounts_pb.rb +47 -0
  3. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/client.rb +10 -1
  4. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/operations.rb +10 -1
  5. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/rest/client.rb +63 -0
  6. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/rest/operations.rb +75 -0
  7. data/lib/google/cloud/channel/v1/cloud_channel_service/client.rb +418 -15
  8. data/lib/google/cloud/channel/v1/cloud_channel_service/operations.rb +10 -1
  9. data/lib/google/cloud/channel/v1/cloud_channel_service/paths.rb +17 -0
  10. data/lib/google/cloud/channel/v1/cloud_channel_service/rest/client.rb +1258 -20
  11. data/lib/google/cloud/channel/v1/cloud_channel_service/rest/operations.rb +75 -0
  12. data/lib/google/cloud/channel/v1/cloud_channel_service/rest/service_stub.rb +177 -0
  13. data/lib/google/cloud/channel/v1/entitlements_pb.rb +1 -1
  14. data/lib/google/cloud/channel/v1/offers_pb.rb +1 -1
  15. data/lib/google/cloud/channel/v1/repricing_pb.rb +1 -1
  16. data/lib/google/cloud/channel/v1/service_pb.rb +13 -1
  17. data/lib/google/cloud/channel/v1/service_services_pb.rb +87 -12
  18. data/lib/google/cloud/channel/v1/version.rb +1 -1
  19. data/proto_docs/google/api/field_behavior.rb +14 -0
  20. data/proto_docs/google/cloud/channel/v1/billing_accounts.rb +48 -0
  21. data/proto_docs/google/cloud/channel/v1/customers.rb +3 -3
  22. data/proto_docs/google/cloud/channel/v1/entitlements.rb +5 -1
  23. data/proto_docs/google/cloud/channel/v1/offers.rb +3 -0
  24. data/proto_docs/google/cloud/channel/v1/repricing.rb +22 -3
  25. data/proto_docs/google/cloud/channel/v1/service.rb +187 -0
  26. metadata +7 -5
@@ -248,6 +248,26 @@ module Google
248
248
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::Customer>]
249
249
  #
250
250
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
251
+ #
252
+ # @example Basic example
253
+ # require "google/cloud/channel/v1"
254
+ #
255
+ # # Create a client object. The client can be reused for multiple calls.
256
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
257
+ #
258
+ # # Create a request. To set request fields, pass in keyword arguments.
259
+ # request = Google::Cloud::Channel::V1::ListCustomersRequest.new
260
+ #
261
+ # # Call the list_customers method.
262
+ # result = client.list_customers request
263
+ #
264
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
265
+ # # over elements, and API calls will be issued to fetch pages as needed.
266
+ # result.each do |item|
267
+ # # Each element is of type ::Google::Cloud::Channel::V1::Customer.
268
+ # p item
269
+ # end
270
+ #
251
271
  def list_customers request, options = nil
252
272
  raise ::ArgumentError, "request must be provided" if request.nil?
253
273
 
@@ -324,6 +344,22 @@ module Google
324
344
  # @return [::Google::Cloud::Channel::V1::Customer]
325
345
  #
326
346
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
347
+ #
348
+ # @example Basic example
349
+ # require "google/cloud/channel/v1"
350
+ #
351
+ # # Create a client object. The client can be reused for multiple calls.
352
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
353
+ #
354
+ # # Create a request. To set request fields, pass in keyword arguments.
355
+ # request = Google::Cloud::Channel::V1::GetCustomerRequest.new
356
+ #
357
+ # # Call the get_customer method.
358
+ # result = client.get_customer request
359
+ #
360
+ # # The returned object is of type Google::Cloud::Channel::V1::Customer.
361
+ # p result
362
+ #
327
363
  def get_customer request, options = nil
328
364
  raise ::ArgumentError, "request must be provided" if request.nil?
329
365
 
@@ -407,6 +443,22 @@ module Google
407
443
  # @return [::Google::Cloud::Channel::V1::CheckCloudIdentityAccountsExistResponse]
408
444
  #
409
445
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
446
+ #
447
+ # @example Basic example
448
+ # require "google/cloud/channel/v1"
449
+ #
450
+ # # Create a client object. The client can be reused for multiple calls.
451
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
452
+ #
453
+ # # Create a request. To set request fields, pass in keyword arguments.
454
+ # request = Google::Cloud::Channel::V1::CheckCloudIdentityAccountsExistRequest.new
455
+ #
456
+ # # Call the check_cloud_identity_accounts_exist method.
457
+ # result = client.check_cloud_identity_accounts_exist request
458
+ #
459
+ # # The returned object is of type Google::Cloud::Channel::V1::CheckCloudIdentityAccountsExistResponse.
460
+ # p result
461
+ #
410
462
  def check_cloud_identity_accounts_exist request, options = nil
411
463
  raise ::ArgumentError, "request must be provided" if request.nil?
412
464
 
@@ -448,8 +500,11 @@ module Google
448
500
  #
449
501
  # Possible error codes:
450
502
  #
451
- # * PERMISSION_DENIED: The reseller account making the request is different
452
- # from the reseller account in the API request.
503
+ # * PERMISSION_DENIED:
504
+ # * The reseller account making the request is different from the
505
+ # reseller account in the API request.
506
+ # * You are not authorized to create a customer. See
507
+ # https://support.google.com/channelservices/answer/9759265
453
508
  # * INVALID_ARGUMENT:
454
509
  # * Required request parameters are missing or invalid.
455
510
  # * Domain field value doesn't match the primary email domain.
@@ -484,6 +539,22 @@ module Google
484
539
  # @return [::Google::Cloud::Channel::V1::Customer]
485
540
  #
486
541
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
542
+ #
543
+ # @example Basic example
544
+ # require "google/cloud/channel/v1"
545
+ #
546
+ # # Create a client object. The client can be reused for multiple calls.
547
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
548
+ #
549
+ # # Create a request. To set request fields, pass in keyword arguments.
550
+ # request = Google::Cloud::Channel::V1::CreateCustomerRequest.new
551
+ #
552
+ # # Call the create_customer method.
553
+ # result = client.create_customer request
554
+ #
555
+ # # The returned object is of type Google::Cloud::Channel::V1::Customer.
556
+ # p result
557
+ #
487
558
  def create_customer request, options = nil
488
559
  raise ::ArgumentError, "request must be provided" if request.nil?
489
560
 
@@ -561,6 +632,22 @@ module Google
561
632
  # @return [::Google::Cloud::Channel::V1::Customer]
562
633
  #
563
634
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
635
+ #
636
+ # @example Basic example
637
+ # require "google/cloud/channel/v1"
638
+ #
639
+ # # Create a client object. The client can be reused for multiple calls.
640
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
641
+ #
642
+ # # Create a request. To set request fields, pass in keyword arguments.
643
+ # request = Google::Cloud::Channel::V1::UpdateCustomerRequest.new
644
+ #
645
+ # # Call the update_customer method.
646
+ # result = client.update_customer request
647
+ #
648
+ # # The returned object is of type Google::Cloud::Channel::V1::Customer.
649
+ # p result
650
+ #
564
651
  def update_customer request, options = nil
565
652
  raise ::ArgumentError, "request must be provided" if request.nil?
566
653
 
@@ -632,6 +719,22 @@ module Google
632
719
  # @return [::Google::Protobuf::Empty]
633
720
  #
634
721
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
722
+ #
723
+ # @example Basic example
724
+ # require "google/cloud/channel/v1"
725
+ #
726
+ # # Create a client object. The client can be reused for multiple calls.
727
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
728
+ #
729
+ # # Create a request. To set request fields, pass in keyword arguments.
730
+ # request = Google::Cloud::Channel::V1::DeleteCustomerRequest.new
731
+ #
732
+ # # Call the delete_customer method.
733
+ # result = client.delete_customer request
734
+ #
735
+ # # The returned object is of type Google::Protobuf::Empty.
736
+ # p result
737
+ #
635
738
  def delete_customer request, options = nil
636
739
  raise ::ArgumentError, "request must be provided" if request.nil?
637
740
 
@@ -675,8 +778,11 @@ module Google
675
778
  #
676
779
  # Possible error codes:
677
780
  #
678
- # * PERMISSION_DENIED: The reseller account making the request is different
679
- # from the reseller account in the API request.
781
+ # * PERMISSION_DENIED:
782
+ # * The reseller account making the request is different from the
783
+ # reseller account in the API request.
784
+ # * You are not authorized to import the customer. See
785
+ # https://support.google.com/channelservices/answer/9759265
680
786
  # * NOT_FOUND: Cloud Identity doesn't exist or was deleted.
681
787
  # * INVALID_ARGUMENT: Required parameters are missing, or the auth_token is
682
788
  # expired or invalid.
@@ -734,6 +840,22 @@ module Google
734
840
  # @return [::Google::Cloud::Channel::V1::Customer]
735
841
  #
736
842
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
843
+ #
844
+ # @example Basic example
845
+ # require "google/cloud/channel/v1"
846
+ #
847
+ # # Create a client object. The client can be reused for multiple calls.
848
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
849
+ #
850
+ # # Create a request. To set request fields, pass in keyword arguments.
851
+ # request = Google::Cloud::Channel::V1::ImportCustomerRequest.new
852
+ #
853
+ # # Call the import_customer method.
854
+ # result = client.import_customer request
855
+ #
856
+ # # The returned object is of type Google::Cloud::Channel::V1::Customer.
857
+ # p result
858
+ #
737
859
  def import_customer request, options = nil
738
860
  raise ::ArgumentError, "request must be provided" if request.nil?
739
861
 
@@ -775,7 +897,10 @@ module Google
775
897
  #
776
898
  # Possible error codes:
777
899
  #
778
- # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
900
+ # * PERMISSION_DENIED:
901
+ # * The customer doesn't belong to the reseller.
902
+ # * You are not authorized to provision cloud identity id. See
903
+ # https://support.google.com/channelservices/answer/9759265
779
904
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
780
905
  # * NOT_FOUND: The customer was not found.
781
906
  # * ALREADY_EXISTS: The customer's primary email already exists. Retry
@@ -823,6 +948,29 @@ module Google
823
948
  # @return [::Gapic::Operation]
824
949
  #
825
950
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
951
+ #
952
+ # @example Basic example
953
+ # require "google/cloud/channel/v1"
954
+ #
955
+ # # Create a client object. The client can be reused for multiple calls.
956
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
957
+ #
958
+ # # Create a request. To set request fields, pass in keyword arguments.
959
+ # request = Google::Cloud::Channel::V1::ProvisionCloudIdentityRequest.new
960
+ #
961
+ # # Call the provision_cloud_identity method.
962
+ # result = client.provision_cloud_identity request
963
+ #
964
+ # # The returned object is of type Gapic::Operation. You can use it to
965
+ # # check the status of an operation, cancel it, or wait for results.
966
+ # # Here is how to wait for a response.
967
+ # result.wait_until_done! timeout: 60
968
+ # if result.response?
969
+ # p result.response
970
+ # else
971
+ # puts "No response received."
972
+ # end
973
+ #
826
974
  def provision_cloud_identity request, options = nil
827
975
  raise ::ArgumentError, "request must be provided" if request.nil?
828
976
 
@@ -909,6 +1057,26 @@ module Google
909
1057
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::Entitlement>]
910
1058
  #
911
1059
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1060
+ #
1061
+ # @example Basic example
1062
+ # require "google/cloud/channel/v1"
1063
+ #
1064
+ # # Create a client object. The client can be reused for multiple calls.
1065
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
1066
+ #
1067
+ # # Create a request. To set request fields, pass in keyword arguments.
1068
+ # request = Google::Cloud::Channel::V1::ListEntitlementsRequest.new
1069
+ #
1070
+ # # Call the list_entitlements method.
1071
+ # result = client.list_entitlements request
1072
+ #
1073
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1074
+ # # over elements, and API calls will be issued to fetch pages as needed.
1075
+ # result.each do |item|
1076
+ # # Each element is of type ::Google::Cloud::Channel::V1::Entitlement.
1077
+ # p item
1078
+ # end
1079
+ #
912
1080
  def list_entitlements request, options = nil
913
1081
  raise ::ArgumentError, "request must be provided" if request.nil?
914
1082
 
@@ -1020,6 +1188,26 @@ module Google
1020
1188
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::TransferableSku>]
1021
1189
  #
1022
1190
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1191
+ #
1192
+ # @example Basic example
1193
+ # require "google/cloud/channel/v1"
1194
+ #
1195
+ # # Create a client object. The client can be reused for multiple calls.
1196
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
1197
+ #
1198
+ # # Create a request. To set request fields, pass in keyword arguments.
1199
+ # request = Google::Cloud::Channel::V1::ListTransferableSkusRequest.new
1200
+ #
1201
+ # # Call the list_transferable_skus method.
1202
+ # result = client.list_transferable_skus request
1203
+ #
1204
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1205
+ # # over elements, and API calls will be issued to fetch pages as needed.
1206
+ # result.each do |item|
1207
+ # # Each element is of type ::Google::Cloud::Channel::V1::TransferableSku.
1208
+ # p item
1209
+ # end
1210
+ #
1023
1211
  def list_transferable_skus request, options = nil
1024
1212
  raise ::ArgumentError, "request must be provided" if request.nil?
1025
1213
 
@@ -1072,6 +1260,8 @@ module Google
1072
1260
  # auth token.
1073
1261
  # * The reseller account making the request is different
1074
1262
  # from the reseller account in the query.
1263
+ # * The reseller is not authorized to transact on this Product. See
1264
+ # https://support.google.com/channelservices/answer/9759265
1075
1265
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
1076
1266
  #
1077
1267
  # Return value:
@@ -1088,7 +1278,7 @@ module Google
1088
1278
  # @param options [::Gapic::CallOptions, ::Hash]
1089
1279
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1090
1280
  #
1091
- # @overload list_transferable_offers(cloud_identity_id: nil, customer_name: nil, parent: nil, page_size: nil, page_token: nil, sku: nil, language_code: nil)
1281
+ # @overload list_transferable_offers(cloud_identity_id: nil, customer_name: nil, parent: nil, page_size: nil, page_token: nil, sku: nil, language_code: nil, billing_account: nil)
1092
1282
  # Pass arguments to `list_transferable_offers` via keyword arguments. Note that at
1093
1283
  # least one keyword argument is required. To specify no parameters, or to keep all
1094
1284
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -1117,6 +1307,12 @@ module Google
1117
1307
  # Optional. The BCP-47 language code. For example, "en-US". The
1118
1308
  # response will localize in the corresponding language code, if specified.
1119
1309
  # The default value is "en-US".
1310
+ # @param billing_account [::String]
1311
+ # Optional. The Billing Account to look up Offers for. Format:
1312
+ # accounts/\\{account_id}/billingAccounts/\\{billing_account_id}.
1313
+ #
1314
+ # This field is only relevant for multi-currency accounts. It should be left
1315
+ # empty for single currency accounts.
1120
1316
  # @yield [result, operation] Access the result along with the TransportOperation object
1121
1317
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::TransferableOffer>]
1122
1318
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1124,6 +1320,26 @@ module Google
1124
1320
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::TransferableOffer>]
1125
1321
  #
1126
1322
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1323
+ #
1324
+ # @example Basic example
1325
+ # require "google/cloud/channel/v1"
1326
+ #
1327
+ # # Create a client object. The client can be reused for multiple calls.
1328
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
1329
+ #
1330
+ # # Create a request. To set request fields, pass in keyword arguments.
1331
+ # request = Google::Cloud::Channel::V1::ListTransferableOffersRequest.new
1332
+ #
1333
+ # # Call the list_transferable_offers method.
1334
+ # result = client.list_transferable_offers request
1335
+ #
1336
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1337
+ # # over elements, and API calls will be issued to fetch pages as needed.
1338
+ # result.each do |item|
1339
+ # # Each element is of type ::Google::Cloud::Channel::V1::TransferableOffer.
1340
+ # p item
1341
+ # end
1342
+ #
1127
1343
  def list_transferable_offers request, options = nil
1128
1344
  raise ::ArgumentError, "request must be provided" if request.nil?
1129
1345
 
@@ -1199,6 +1415,22 @@ module Google
1199
1415
  # @return [::Google::Cloud::Channel::V1::Entitlement]
1200
1416
  #
1201
1417
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1418
+ #
1419
+ # @example Basic example
1420
+ # require "google/cloud/channel/v1"
1421
+ #
1422
+ # # Create a client object. The client can be reused for multiple calls.
1423
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
1424
+ #
1425
+ # # Create a request. To set request fields, pass in keyword arguments.
1426
+ # request = Google::Cloud::Channel::V1::GetEntitlementRequest.new
1427
+ #
1428
+ # # Call the get_entitlement method.
1429
+ # result = client.get_entitlement request
1430
+ #
1431
+ # # The returned object is of type Google::Cloud::Channel::V1::Entitlement.
1432
+ # p result
1433
+ #
1202
1434
  def get_entitlement request, options = nil
1203
1435
  raise ::ArgumentError, "request must be provided" if request.nil?
1204
1436
 
@@ -1239,7 +1471,10 @@ module Google
1239
1471
  #
1240
1472
  # Possible error codes:
1241
1473
  #
1242
- # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
1474
+ # * PERMISSION_DENIED:
1475
+ # * The customer doesn't belong to the reseller.
1476
+ # * The reseller is not authorized to transact on this Product. See
1477
+ # https://support.google.com/channelservices/answer/9759265
1243
1478
  # * INVALID_ARGUMENT:
1244
1479
  # * Required request parameters are missing or invalid.
1245
1480
  # * There is already a customer entitlement for a SKU from the same
@@ -1313,6 +1548,29 @@ module Google
1313
1548
  # @return [::Gapic::Operation]
1314
1549
  #
1315
1550
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1551
+ #
1552
+ # @example Basic example
1553
+ # require "google/cloud/channel/v1"
1554
+ #
1555
+ # # Create a client object. The client can be reused for multiple calls.
1556
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
1557
+ #
1558
+ # # Create a request. To set request fields, pass in keyword arguments.
1559
+ # request = Google::Cloud::Channel::V1::CreateEntitlementRequest.new
1560
+ #
1561
+ # # Call the create_entitlement method.
1562
+ # result = client.create_entitlement request
1563
+ #
1564
+ # # The returned object is of type Gapic::Operation. You can use it to
1565
+ # # check the status of an operation, cancel it, or wait for results.
1566
+ # # Here is how to wait for a response.
1567
+ # result.wait_until_done! timeout: 60
1568
+ # if result.response?
1569
+ # p result.response
1570
+ # else
1571
+ # puts "No response received."
1572
+ # end
1573
+ #
1316
1574
  def create_entitlement request, options = nil
1317
1575
  raise ::ArgumentError, "request must be provided" if request.nil?
1318
1576
 
@@ -1422,6 +1680,29 @@ module Google
1422
1680
  # @return [::Gapic::Operation]
1423
1681
  #
1424
1682
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1683
+ #
1684
+ # @example Basic example
1685
+ # require "google/cloud/channel/v1"
1686
+ #
1687
+ # # Create a client object. The client can be reused for multiple calls.
1688
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
1689
+ #
1690
+ # # Create a request. To set request fields, pass in keyword arguments.
1691
+ # request = Google::Cloud::Channel::V1::ChangeParametersRequest.new
1692
+ #
1693
+ # # Call the change_parameters method.
1694
+ # result = client.change_parameters request
1695
+ #
1696
+ # # The returned object is of type Gapic::Operation. You can use it to
1697
+ # # check the status of an operation, cancel it, or wait for results.
1698
+ # # Here is how to wait for a response.
1699
+ # result.wait_until_done! timeout: 60
1700
+ # if result.response?
1701
+ # p result.response
1702
+ # else
1703
+ # puts "No response received."
1704
+ # end
1705
+ #
1425
1706
  def change_parameters request, options = nil
1426
1707
  raise ::ArgumentError, "request must be provided" if request.nil?
1427
1708
 
@@ -1524,6 +1805,29 @@ module Google
1524
1805
  # @return [::Gapic::Operation]
1525
1806
  #
1526
1807
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1808
+ #
1809
+ # @example Basic example
1810
+ # require "google/cloud/channel/v1"
1811
+ #
1812
+ # # Create a client object. The client can be reused for multiple calls.
1813
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
1814
+ #
1815
+ # # Create a request. To set request fields, pass in keyword arguments.
1816
+ # request = Google::Cloud::Channel::V1::ChangeRenewalSettingsRequest.new
1817
+ #
1818
+ # # Call the change_renewal_settings method.
1819
+ # result = client.change_renewal_settings request
1820
+ #
1821
+ # # The returned object is of type Gapic::Operation. You can use it to
1822
+ # # check the status of an operation, cancel it, or wait for results.
1823
+ # # Here is how to wait for a response.
1824
+ # result.wait_until_done! timeout: 60
1825
+ # if result.response?
1826
+ # p result.response
1827
+ # else
1828
+ # puts "No response received."
1829
+ # end
1830
+ #
1527
1831
  def change_renewal_settings request, options = nil
1528
1832
  raise ::ArgumentError, "request must be provided" if request.nil?
1529
1833
 
@@ -1593,7 +1897,7 @@ module Google
1593
1897
  # @param options [::Gapic::CallOptions, ::Hash]
1594
1898
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1595
1899
  #
1596
- # @overload change_offer(name: nil, offer: nil, parameters: nil, purchase_order_id: nil, request_id: nil)
1900
+ # @overload change_offer(name: nil, offer: nil, parameters: nil, purchase_order_id: nil, request_id: nil, billing_account: nil)
1597
1901
  # Pass arguments to `change_offer` via keyword arguments. Note that at
1598
1902
  # least one keyword argument is required. To specify no parameters, or to keep all
1599
1903
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -1625,6 +1929,12 @@ module Google
1625
1929
  # The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
1626
1930
  # with the exception that zero UUID is not supported
1627
1931
  # (`00000000-0000-0000-0000-000000000000`).
1932
+ # @param billing_account [::String]
1933
+ # Optional. The billing account resource name that is used to pay for this
1934
+ # entitlement when setting up billing on a trial subscription.
1935
+ #
1936
+ # This field is only relevant for multi-currency accounts. It should be
1937
+ # left empty for single currency accounts.
1628
1938
  # @yield [result, operation] Access the result along with the TransportOperation object
1629
1939
  # @yieldparam result [::Gapic::Operation]
1630
1940
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1632,6 +1942,29 @@ module Google
1632
1942
  # @return [::Gapic::Operation]
1633
1943
  #
1634
1944
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1945
+ #
1946
+ # @example Basic example
1947
+ # require "google/cloud/channel/v1"
1948
+ #
1949
+ # # Create a client object. The client can be reused for multiple calls.
1950
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
1951
+ #
1952
+ # # Create a request. To set request fields, pass in keyword arguments.
1953
+ # request = Google::Cloud::Channel::V1::ChangeOfferRequest.new
1954
+ #
1955
+ # # Call the change_offer method.
1956
+ # result = client.change_offer request
1957
+ #
1958
+ # # The returned object is of type Gapic::Operation. You can use it to
1959
+ # # check the status of an operation, cancel it, or wait for results.
1960
+ # # Here is how to wait for a response.
1961
+ # result.wait_until_done! timeout: 60
1962
+ # if result.response?
1963
+ # p result.response
1964
+ # else
1965
+ # puts "No response received."
1966
+ # end
1967
+ #
1635
1968
  def change_offer request, options = nil
1636
1969
  raise ::ArgumentError, "request must be provided" if request.nil?
1637
1970
 
@@ -1733,6 +2066,29 @@ module Google
1733
2066
  # @return [::Gapic::Operation]
1734
2067
  #
1735
2068
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
2069
+ #
2070
+ # @example Basic example
2071
+ # require "google/cloud/channel/v1"
2072
+ #
2073
+ # # Create a client object. The client can be reused for multiple calls.
2074
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
2075
+ #
2076
+ # # Create a request. To set request fields, pass in keyword arguments.
2077
+ # request = Google::Cloud::Channel::V1::StartPaidServiceRequest.new
2078
+ #
2079
+ # # Call the start_paid_service method.
2080
+ # result = client.start_paid_service request
2081
+ #
2082
+ # # The returned object is of type Gapic::Operation. You can use it to
2083
+ # # check the status of an operation, cancel it, or wait for results.
2084
+ # # Here is how to wait for a response.
2085
+ # result.wait_until_done! timeout: 60
2086
+ # if result.response?
2087
+ # p result.response
2088
+ # else
2089
+ # puts "No response received."
2090
+ # end
2091
+ #
1736
2092
  def start_paid_service request, options = nil
1737
2093
  raise ::ArgumentError, "request must be provided" if request.nil?
1738
2094
 
@@ -1831,6 +2187,29 @@ module Google
1831
2187
  # @return [::Gapic::Operation]
1832
2188
  #
1833
2189
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
2190
+ #
2191
+ # @example Basic example
2192
+ # require "google/cloud/channel/v1"
2193
+ #
2194
+ # # Create a client object. The client can be reused for multiple calls.
2195
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
2196
+ #
2197
+ # # Create a request. To set request fields, pass in keyword arguments.
2198
+ # request = Google::Cloud::Channel::V1::SuspendEntitlementRequest.new
2199
+ #
2200
+ # # Call the suspend_entitlement method.
2201
+ # result = client.suspend_entitlement request
2202
+ #
2203
+ # # The returned object is of type Gapic::Operation. You can use it to
2204
+ # # check the status of an operation, cancel it, or wait for results.
2205
+ # # Here is how to wait for a response.
2206
+ # result.wait_until_done! timeout: 60
2207
+ # if result.response?
2208
+ # p result.response
2209
+ # else
2210
+ # puts "No response received."
2211
+ # end
2212
+ #
1834
2213
  def suspend_entitlement request, options = nil
1835
2214
  raise ::ArgumentError, "request must be provided" if request.nil?
1836
2215
 
@@ -1934,6 +2313,29 @@ module Google
1934
2313
  # @return [::Gapic::Operation]
1935
2314
  #
1936
2315
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
2316
+ #
2317
+ # @example Basic example
2318
+ # require "google/cloud/channel/v1"
2319
+ #
2320
+ # # Create a client object. The client can be reused for multiple calls.
2321
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
2322
+ #
2323
+ # # Create a request. To set request fields, pass in keyword arguments.
2324
+ # request = Google::Cloud::Channel::V1::CancelEntitlementRequest.new
2325
+ #
2326
+ # # Call the cancel_entitlement method.
2327
+ # result = client.cancel_entitlement request
2328
+ #
2329
+ # # The returned object is of type Gapic::Operation. You can use it to
2330
+ # # check the status of an operation, cancel it, or wait for results.
2331
+ # # Here is how to wait for a response.
2332
+ # result.wait_until_done! timeout: 60
2333
+ # if result.response?
2334
+ # p result.response
2335
+ # else
2336
+ # puts "No response received."
2337
+ # end
2338
+ #
1937
2339
  def cancel_entitlement request, options = nil
1938
2340
  raise ::ArgumentError, "request must be provided" if request.nil?
1939
2341
 
@@ -2038,6 +2440,29 @@ module Google
2038
2440
  # @return [::Gapic::Operation]
2039
2441
  #
2040
2442
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
2443
+ #
2444
+ # @example Basic example
2445
+ # require "google/cloud/channel/v1"
2446
+ #
2447
+ # # Create a client object. The client can be reused for multiple calls.
2448
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
2449
+ #
2450
+ # # Create a request. To set request fields, pass in keyword arguments.
2451
+ # request = Google::Cloud::Channel::V1::ActivateEntitlementRequest.new
2452
+ #
2453
+ # # Call the activate_entitlement method.
2454
+ # result = client.activate_entitlement request
2455
+ #
2456
+ # # The returned object is of type Gapic::Operation. You can use it to
2457
+ # # check the status of an operation, cancel it, or wait for results.
2458
+ # # Here is how to wait for a response.
2459
+ # result.wait_until_done! timeout: 60
2460
+ # if result.response?
2461
+ # p result.response
2462
+ # else
2463
+ # puts "No response received."
2464
+ # end
2465
+ #
2041
2466
  def activate_entitlement request, options = nil
2042
2467
  raise ::ArgumentError, "request must be provided" if request.nil?
2043
2468
 
@@ -2079,7 +2504,10 @@ module Google
2079
2504
  #
2080
2505
  # Possible error codes:
2081
2506
  #
2082
- # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
2507
+ # * PERMISSION_DENIED:
2508
+ # * The customer doesn't belong to the reseller.
2509
+ # * The reseller is not authorized to transact on this Product. See
2510
+ # https://support.google.com/channelservices/answer/9759265
2083
2511
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
2084
2512
  # * NOT_FOUND: The customer or offer resource was not found.
2085
2513
  # * ALREADY_EXISTS: The SKU was already transferred for the customer.
@@ -2151,6 +2579,29 @@ module Google
2151
2579
  # @return [::Gapic::Operation]
2152
2580
  #
2153
2581
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
2582
+ #
2583
+ # @example Basic example
2584
+ # require "google/cloud/channel/v1"
2585
+ #
2586
+ # # Create a client object. The client can be reused for multiple calls.
2587
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
2588
+ #
2589
+ # # Create a request. To set request fields, pass in keyword arguments.
2590
+ # request = Google::Cloud::Channel::V1::TransferEntitlementsRequest.new
2591
+ #
2592
+ # # Call the transfer_entitlements method.
2593
+ # result = client.transfer_entitlements request
2594
+ #
2595
+ # # The returned object is of type Gapic::Operation. You can use it to
2596
+ # # check the status of an operation, cancel it, or wait for results.
2597
+ # # Here is how to wait for a response.
2598
+ # result.wait_until_done! timeout: 60
2599
+ # if result.response?
2600
+ # p result.response
2601
+ # else
2602
+ # puts "No response received."
2603
+ # end
2604
+ #
2154
2605
  def transfer_entitlements request, options = nil
2155
2606
  raise ::ArgumentError, "request must be provided" if request.nil?
2156
2607
 
@@ -2259,6 +2710,29 @@ module Google
2259
2710
  # @return [::Gapic::Operation]
2260
2711
  #
2261
2712
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
2713
+ #
2714
+ # @example Basic example
2715
+ # require "google/cloud/channel/v1"
2716
+ #
2717
+ # # Create a client object. The client can be reused for multiple calls.
2718
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
2719
+ #
2720
+ # # Create a request. To set request fields, pass in keyword arguments.
2721
+ # request = Google::Cloud::Channel::V1::TransferEntitlementsToGoogleRequest.new
2722
+ #
2723
+ # # Call the transfer_entitlements_to_google method.
2724
+ # result = client.transfer_entitlements_to_google request
2725
+ #
2726
+ # # The returned object is of type Gapic::Operation. You can use it to
2727
+ # # check the status of an operation, cancel it, or wait for results.
2728
+ # # Here is how to wait for a response.
2729
+ # result.wait_until_done! timeout: 60
2730
+ # if result.response?
2731
+ # p result.response
2732
+ # else
2733
+ # puts "No response received."
2734
+ # end
2735
+ #
2262
2736
  def transfer_entitlements_to_google request, options = nil
2263
2737
  raise ::ArgumentError, "request must be provided" if request.nil?
2264
2738
 
@@ -2347,6 +2821,26 @@ module Google
2347
2821
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::ChannelPartnerLink>]
2348
2822
  #
2349
2823
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
2824
+ #
2825
+ # @example Basic example
2826
+ # require "google/cloud/channel/v1"
2827
+ #
2828
+ # # Create a client object. The client can be reused for multiple calls.
2829
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
2830
+ #
2831
+ # # Create a request. To set request fields, pass in keyword arguments.
2832
+ # request = Google::Cloud::Channel::V1::ListChannelPartnerLinksRequest.new
2833
+ #
2834
+ # # Call the list_channel_partner_links method.
2835
+ # result = client.list_channel_partner_links request
2836
+ #
2837
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2838
+ # # over elements, and API calls will be issued to fetch pages as needed.
2839
+ # result.each do |item|
2840
+ # # Each element is of type ::Google::Cloud::Channel::V1::ChannelPartnerLink.
2841
+ # p item
2842
+ # end
2843
+ #
2350
2844
  def list_channel_partner_links request, options = nil
2351
2845
  raise ::ArgumentError, "request must be provided" if request.nil?
2352
2846
 
@@ -2428,6 +2922,22 @@ module Google
2428
2922
  # @return [::Google::Cloud::Channel::V1::ChannelPartnerLink]
2429
2923
  #
2430
2924
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
2925
+ #
2926
+ # @example Basic example
2927
+ # require "google/cloud/channel/v1"
2928
+ #
2929
+ # # Create a client object. The client can be reused for multiple calls.
2930
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
2931
+ #
2932
+ # # Create a request. To set request fields, pass in keyword arguments.
2933
+ # request = Google::Cloud::Channel::V1::GetChannelPartnerLinkRequest.new
2934
+ #
2935
+ # # Call the get_channel_partner_link method.
2936
+ # result = client.get_channel_partner_link request
2937
+ #
2938
+ # # The returned object is of type Google::Cloud::Channel::V1::ChannelPartnerLink.
2939
+ # p result
2940
+ #
2431
2941
  def get_channel_partner_link request, options = nil
2432
2942
  raise ::ArgumentError, "request must be provided" if request.nil?
2433
2943
 
@@ -2518,6 +3028,22 @@ module Google
2518
3028
  # @return [::Google::Cloud::Channel::V1::ChannelPartnerLink]
2519
3029
  #
2520
3030
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
3031
+ #
3032
+ # @example Basic example
3033
+ # require "google/cloud/channel/v1"
3034
+ #
3035
+ # # Create a client object. The client can be reused for multiple calls.
3036
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
3037
+ #
3038
+ # # Create a request. To set request fields, pass in keyword arguments.
3039
+ # request = Google::Cloud::Channel::V1::CreateChannelPartnerLinkRequest.new
3040
+ #
3041
+ # # Call the create_channel_partner_link method.
3042
+ # result = client.create_channel_partner_link request
3043
+ #
3044
+ # # The returned object is of type Google::Cloud::Channel::V1::ChannelPartnerLink.
3045
+ # p result
3046
+ #
2521
3047
  def create_channel_partner_link request, options = nil
2522
3048
  raise ::ArgumentError, "request must be provided" if request.nil?
2523
3049
 
@@ -2610,6 +3136,22 @@ module Google
2610
3136
  # @return [::Google::Cloud::Channel::V1::ChannelPartnerLink]
2611
3137
  #
2612
3138
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
3139
+ #
3140
+ # @example Basic example
3141
+ # require "google/cloud/channel/v1"
3142
+ #
3143
+ # # Create a client object. The client can be reused for multiple calls.
3144
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
3145
+ #
3146
+ # # Create a request. To set request fields, pass in keyword arguments.
3147
+ # request = Google::Cloud::Channel::V1::UpdateChannelPartnerLinkRequest.new
3148
+ #
3149
+ # # Call the update_channel_partner_link method.
3150
+ # result = client.update_channel_partner_link request
3151
+ #
3152
+ # # The returned object is of type Google::Cloud::Channel::V1::ChannelPartnerLink.
3153
+ # p result
3154
+ #
2613
3155
  def update_channel_partner_link request, options = nil
2614
3156
  raise ::ArgumentError, "request must be provided" if request.nil?
2615
3157
 
@@ -2690,6 +3232,22 @@ module Google
2690
3232
  # @return [::Google::Cloud::Channel::V1::CustomerRepricingConfig]
2691
3233
  #
2692
3234
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
3235
+ #
3236
+ # @example Basic example
3237
+ # require "google/cloud/channel/v1"
3238
+ #
3239
+ # # Create a client object. The client can be reused for multiple calls.
3240
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
3241
+ #
3242
+ # # Create a request. To set request fields, pass in keyword arguments.
3243
+ # request = Google::Cloud::Channel::V1::GetCustomerRepricingConfigRequest.new
3244
+ #
3245
+ # # Call the get_customer_repricing_config method.
3246
+ # result = client.get_customer_repricing_config request
3247
+ #
3248
+ # # The returned object is of type Google::Cloud::Channel::V1::CustomerRepricingConfig.
3249
+ # p result
3250
+ #
2693
3251
  def get_customer_repricing_config request, options = nil
2694
3252
  raise ::ArgumentError, "request must be provided" if request.nil?
2695
3253
 
@@ -2798,6 +3356,26 @@ module Google
2798
3356
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::CustomerRepricingConfig>]
2799
3357
  #
2800
3358
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
3359
+ #
3360
+ # @example Basic example
3361
+ # require "google/cloud/channel/v1"
3362
+ #
3363
+ # # Create a client object. The client can be reused for multiple calls.
3364
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
3365
+ #
3366
+ # # Create a request. To set request fields, pass in keyword arguments.
3367
+ # request = Google::Cloud::Channel::V1::ListCustomerRepricingConfigsRequest.new
3368
+ #
3369
+ # # Call the list_customer_repricing_configs method.
3370
+ # result = client.list_customer_repricing_configs request
3371
+ #
3372
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
3373
+ # # over elements, and API calls will be issued to fetch pages as needed.
3374
+ # result.each do |item|
3375
+ # # Each element is of type ::Google::Cloud::Channel::V1::CustomerRepricingConfig.
3376
+ # p item
3377
+ # end
3378
+ #
2801
3379
  def list_customer_repricing_configs request, options = nil
2802
3380
  raise ::ArgumentError, "request must be provided" if request.nil?
2803
3381
 
@@ -2852,12 +3430,12 @@ module Google
2852
3430
  # * The new config will not modify exports used with other configs.
2853
3431
  # Changes to the config may be immediate, but may take up to 24 hours.
2854
3432
  # * There is a limit of ten configs for any
2855
- # {::Google::Cloud::Channel::V1::RepricingConfig::EntitlementGranularity#entitlement RepricingConfig.EntitlementGranularity.entitlement}
2856
- # or
3433
+ # {::Google::Cloud::Channel::V1::RepricingConfig::EntitlementGranularity#entitlement RepricingConfig.EntitlementGranularity.entitlement},
3434
+ # for any
2857
3435
  # {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}.
2858
3436
  # * The contained
2859
3437
  # {::Google::Cloud::Channel::V1::CustomerRepricingConfig#repricing_config CustomerRepricingConfig.repricing_config}
2860
- # vaule must be different from the value used in the current config for a
3438
+ # value must be different from the value used in the current config for a
2861
3439
  # {::Google::Cloud::Channel::V1::RepricingConfig::EntitlementGranularity#entitlement RepricingConfig.EntitlementGranularity.entitlement}.
2862
3440
  #
2863
3441
  # Possible Error Codes:
@@ -2906,6 +3484,22 @@ module Google
2906
3484
  # @return [::Google::Cloud::Channel::V1::CustomerRepricingConfig]
2907
3485
  #
2908
3486
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
3487
+ #
3488
+ # @example Basic example
3489
+ # require "google/cloud/channel/v1"
3490
+ #
3491
+ # # Create a client object. The client can be reused for multiple calls.
3492
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
3493
+ #
3494
+ # # Create a request. To set request fields, pass in keyword arguments.
3495
+ # request = Google::Cloud::Channel::V1::CreateCustomerRepricingConfigRequest.new
3496
+ #
3497
+ # # Call the create_customer_repricing_config method.
3498
+ # result = client.create_customer_repricing_config request
3499
+ #
3500
+ # # The returned object is of type Google::Cloud::Channel::V1::CustomerRepricingConfig.
3501
+ # p result
3502
+ #
2909
3503
  def create_customer_repricing_config request, options = nil
2910
3504
  raise ::ArgumentError, "request must be provided" if request.nil?
2911
3505
 
@@ -2999,6 +3593,22 @@ module Google
2999
3593
  # @return [::Google::Cloud::Channel::V1::CustomerRepricingConfig]
3000
3594
  #
3001
3595
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
3596
+ #
3597
+ # @example Basic example
3598
+ # require "google/cloud/channel/v1"
3599
+ #
3600
+ # # Create a client object. The client can be reused for multiple calls.
3601
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
3602
+ #
3603
+ # # Create a request. To set request fields, pass in keyword arguments.
3604
+ # request = Google::Cloud::Channel::V1::UpdateCustomerRepricingConfigRequest.new
3605
+ #
3606
+ # # Call the update_customer_repricing_config method.
3607
+ # result = client.update_customer_repricing_config request
3608
+ #
3609
+ # # The returned object is of type Google::Cloud::Channel::V1::CustomerRepricingConfig.
3610
+ # p result
3611
+ #
3002
3612
  def update_customer_repricing_config request, options = nil
3003
3613
  raise ::ArgumentError, "request must be provided" if request.nil?
3004
3614
 
@@ -3079,6 +3689,22 @@ module Google
3079
3689
  # @return [::Google::Protobuf::Empty]
3080
3690
  #
3081
3691
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
3692
+ #
3693
+ # @example Basic example
3694
+ # require "google/cloud/channel/v1"
3695
+ #
3696
+ # # Create a client object. The client can be reused for multiple calls.
3697
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
3698
+ #
3699
+ # # Create a request. To set request fields, pass in keyword arguments.
3700
+ # request = Google::Cloud::Channel::V1::DeleteCustomerRepricingConfigRequest.new
3701
+ #
3702
+ # # Call the delete_customer_repricing_config method.
3703
+ # result = client.delete_customer_repricing_config request
3704
+ #
3705
+ # # The returned object is of type Google::Protobuf::Empty.
3706
+ # p result
3707
+ #
3082
3708
  def delete_customer_repricing_config request, options = nil
3083
3709
  raise ::ArgumentError, "request must be provided" if request.nil?
3084
3710
 
@@ -3159,6 +3785,22 @@ module Google
3159
3785
  # @return [::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig]
3160
3786
  #
3161
3787
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
3788
+ #
3789
+ # @example Basic example
3790
+ # require "google/cloud/channel/v1"
3791
+ #
3792
+ # # Create a client object. The client can be reused for multiple calls.
3793
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
3794
+ #
3795
+ # # Create a request. To set request fields, pass in keyword arguments.
3796
+ # request = Google::Cloud::Channel::V1::GetChannelPartnerRepricingConfigRequest.new
3797
+ #
3798
+ # # Call the get_channel_partner_repricing_config method.
3799
+ # result = client.get_channel_partner_repricing_config request
3800
+ #
3801
+ # # The returned object is of type Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig.
3802
+ # p result
3803
+ #
3162
3804
  def get_channel_partner_repricing_config request, options = nil
3163
3805
  raise ::ArgumentError, "request must be provided" if request.nil?
3164
3806
 
@@ -3270,6 +3912,26 @@ module Google
3270
3912
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig>]
3271
3913
  #
3272
3914
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
3915
+ #
3916
+ # @example Basic example
3917
+ # require "google/cloud/channel/v1"
3918
+ #
3919
+ # # Create a client object. The client can be reused for multiple calls.
3920
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
3921
+ #
3922
+ # # Create a request. To set request fields, pass in keyword arguments.
3923
+ # request = Google::Cloud::Channel::V1::ListChannelPartnerRepricingConfigsRequest.new
3924
+ #
3925
+ # # Call the list_channel_partner_repricing_configs method.
3926
+ # result = client.list_channel_partner_repricing_configs request
3927
+ #
3928
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
3929
+ # # over elements, and API calls will be issued to fetch pages as needed.
3930
+ # result.each do |item|
3931
+ # # Each element is of type ::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig.
3932
+ # p item
3933
+ # end
3934
+ #
3273
3935
  def list_channel_partner_repricing_configs request, options = nil
3274
3936
  raise ::ArgumentError, "request must be provided" if request.nil?
3275
3937
 
@@ -3325,10 +3987,12 @@ module Google
3325
3987
  # * The new config will not modify exports used with other configs.
3326
3988
  # Changes to the config may be immediate, but may take up to 24 hours.
3327
3989
  # * There is a limit of ten configs for any ChannelPartner or
3990
+ # {::Google::Cloud::Channel::V1::RepricingConfig::EntitlementGranularity#entitlement RepricingConfig.EntitlementGranularity.entitlement},
3991
+ # for any
3328
3992
  # {::Google::Cloud::Channel::V1::RepricingConfig#effective_invoice_month RepricingConfig.effective_invoice_month}.
3329
3993
  # * The contained
3330
3994
  # {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig#repricing_config ChannelPartnerRepricingConfig.repricing_config}
3331
- # vaule must be different from the value used in the current config for a
3995
+ # value must be different from the value used in the current config for a
3332
3996
  # ChannelPartner.
3333
3997
  #
3334
3998
  # Possible Error Codes:
@@ -3377,6 +4041,22 @@ module Google
3377
4041
  # @return [::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig]
3378
4042
  #
3379
4043
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
4044
+ #
4045
+ # @example Basic example
4046
+ # require "google/cloud/channel/v1"
4047
+ #
4048
+ # # Create a client object. The client can be reused for multiple calls.
4049
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
4050
+ #
4051
+ # # Create a request. To set request fields, pass in keyword arguments.
4052
+ # request = Google::Cloud::Channel::V1::CreateChannelPartnerRepricingConfigRequest.new
4053
+ #
4054
+ # # Call the create_channel_partner_repricing_config method.
4055
+ # result = client.create_channel_partner_repricing_config request
4056
+ #
4057
+ # # The returned object is of type Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig.
4058
+ # p result
4059
+ #
3380
4060
  def create_channel_partner_repricing_config request, options = nil
3381
4061
  raise ::ArgumentError, "request must be provided" if request.nil?
3382
4062
 
@@ -3470,6 +4150,22 @@ module Google
3470
4150
  # @return [::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig]
3471
4151
  #
3472
4152
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
4153
+ #
4154
+ # @example Basic example
4155
+ # require "google/cloud/channel/v1"
4156
+ #
4157
+ # # Create a client object. The client can be reused for multiple calls.
4158
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
4159
+ #
4160
+ # # Create a request. To set request fields, pass in keyword arguments.
4161
+ # request = Google::Cloud::Channel::V1::UpdateChannelPartnerRepricingConfigRequest.new
4162
+ #
4163
+ # # Call the update_channel_partner_repricing_config method.
4164
+ # result = client.update_channel_partner_repricing_config request
4165
+ #
4166
+ # # The returned object is of type Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig.
4167
+ # p result
4168
+ #
3473
4169
  def update_channel_partner_repricing_config request, options = nil
3474
4170
  raise ::ArgumentError, "request must be provided" if request.nil?
3475
4171
 
@@ -3549,6 +4245,22 @@ module Google
3549
4245
  # @return [::Google::Protobuf::Empty]
3550
4246
  #
3551
4247
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
4248
+ #
4249
+ # @example Basic example
4250
+ # require "google/cloud/channel/v1"
4251
+ #
4252
+ # # Create a client object. The client can be reused for multiple calls.
4253
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
4254
+ #
4255
+ # # Create a request. To set request fields, pass in keyword arguments.
4256
+ # request = Google::Cloud::Channel::V1::DeleteChannelPartnerRepricingConfigRequest.new
4257
+ #
4258
+ # # Call the delete_channel_partner_repricing_config method.
4259
+ # result = client.delete_channel_partner_repricing_config request
4260
+ #
4261
+ # # The returned object is of type Google::Protobuf::Empty.
4262
+ # p result
4263
+ #
3552
4264
  def delete_channel_partner_repricing_config request, options = nil
3553
4265
  raise ::ArgumentError, "request must be provided" if request.nil?
3554
4266
 
@@ -3585,15 +4297,240 @@ module Google
3585
4297
  end
3586
4298
 
3587
4299
  ##
3588
- # Returns the requested {::Google::Cloud::Channel::V1::Offer Offer} resource.
4300
+ # Lists the Rebilling supported SKU groups the account is authorized to
4301
+ # sell.
4302
+ # Reference: https://cloud.google.com/skus/sku-groups
3589
4303
  #
3590
- # Possible error codes:
4304
+ # Possible Error Codes:
3591
4305
  #
3592
- # * PERMISSION_DENIED: The entitlement doesn't belong to the reseller.
3593
- # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
3594
- # * NOT_FOUND: Entitlement or offer was not found.
4306
+ # * PERMISSION_DENIED: If the account making the request and the account
4307
+ # being queried are different, or the account doesn't exist.
4308
+ # * INTERNAL: Any non-user error related to technical issues in the
4309
+ # backend. In this case, contact Cloud Channel support.
3595
4310
  #
3596
- # Return value:
4311
+ # Return Value:
4312
+ # If successful, the {::Google::Cloud::Channel::V1::SkuGroup SkuGroup} resources.
4313
+ # The data for each resource is displayed in the alphabetical order of SKU
4314
+ # group display name.
4315
+ # The data for each resource is displayed in the ascending order of
4316
+ # {::Google::Cloud::Channel::V1::SkuGroup#display_name SkuGroup.display_name}
4317
+ #
4318
+ # If unsuccessful, returns an error.
4319
+ #
4320
+ # @overload list_sku_groups(request, options = nil)
4321
+ # Pass arguments to `list_sku_groups` via a request object, either of type
4322
+ # {::Google::Cloud::Channel::V1::ListSkuGroupsRequest} or an equivalent Hash.
4323
+ #
4324
+ # @param request [::Google::Cloud::Channel::V1::ListSkuGroupsRequest, ::Hash]
4325
+ # A request object representing the call parameters. Required. To specify no
4326
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
4327
+ # @param options [::Gapic::CallOptions, ::Hash]
4328
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
4329
+ #
4330
+ # @overload list_sku_groups(parent: nil, page_size: nil, page_token: nil)
4331
+ # Pass arguments to `list_sku_groups` via keyword arguments. Note that at
4332
+ # least one keyword argument is required. To specify no parameters, or to keep all
4333
+ # the default parameter values, pass an empty Hash as a request object (see above).
4334
+ #
4335
+ # @param parent [::String]
4336
+ # Required. The resource name of the account from which to list SKU groups.
4337
+ # Parent uses the format: accounts/\\{account}.
4338
+ # @param page_size [::Integer]
4339
+ # Optional. The maximum number of SKU groups to return. The service may
4340
+ # return fewer than this value. If unspecified, returns a maximum of 1000 SKU
4341
+ # groups. The maximum value is 1000; values above 1000 will be coerced to
4342
+ # 1000.
4343
+ # @param page_token [::String]
4344
+ # Optional. A token identifying a page of results beyond the first page.
4345
+ # Obtained through
4346
+ # [ListSkuGroups.next_page_token][] of the previous
4347
+ # {::Google::Cloud::Channel::V1::CloudChannelService::Rest::Client#list_sku_groups CloudChannelService.ListSkuGroups}
4348
+ # call.
4349
+ # @yield [result, operation] Access the result along with the TransportOperation object
4350
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::SkuGroup>]
4351
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
4352
+ #
4353
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::SkuGroup>]
4354
+ #
4355
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
4356
+ #
4357
+ # @example Basic example
4358
+ # require "google/cloud/channel/v1"
4359
+ #
4360
+ # # Create a client object. The client can be reused for multiple calls.
4361
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
4362
+ #
4363
+ # # Create a request. To set request fields, pass in keyword arguments.
4364
+ # request = Google::Cloud::Channel::V1::ListSkuGroupsRequest.new
4365
+ #
4366
+ # # Call the list_sku_groups method.
4367
+ # result = client.list_sku_groups request
4368
+ #
4369
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
4370
+ # # over elements, and API calls will be issued to fetch pages as needed.
4371
+ # result.each do |item|
4372
+ # # Each element is of type ::Google::Cloud::Channel::V1::SkuGroup.
4373
+ # p item
4374
+ # end
4375
+ #
4376
+ def list_sku_groups request, options = nil
4377
+ raise ::ArgumentError, "request must be provided" if request.nil?
4378
+
4379
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Channel::V1::ListSkuGroupsRequest
4380
+
4381
+ # Converts hash and nil to an options object
4382
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
4383
+
4384
+ # Customize the options with defaults
4385
+ call_metadata = @config.rpcs.list_sku_groups.metadata.to_h
4386
+
4387
+ # Set x-goog-api-client and x-goog-user-project headers
4388
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
4389
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
4390
+ gapic_version: ::Google::Cloud::Channel::V1::VERSION,
4391
+ transports_version_send: [:rest]
4392
+
4393
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
4394
+
4395
+ options.apply_defaults timeout: @config.rpcs.list_sku_groups.timeout,
4396
+ metadata: call_metadata,
4397
+ retry_policy: @config.rpcs.list_sku_groups.retry_policy
4398
+
4399
+ options.apply_defaults timeout: @config.timeout,
4400
+ metadata: @config.metadata,
4401
+ retry_policy: @config.retry_policy
4402
+
4403
+ @cloud_channel_service_stub.list_sku_groups request, options do |result, operation|
4404
+ result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_sku_groups, "sku_groups", request, result, options
4405
+ yield result, operation if block_given?
4406
+ return result
4407
+ end
4408
+ rescue ::Gapic::Rest::Error => e
4409
+ raise ::Google::Cloud::Error.from_error(e)
4410
+ end
4411
+
4412
+ ##
4413
+ # Lists the Billable SKUs in a given SKU group.
4414
+ #
4415
+ # Possible error codes:
4416
+ # PERMISSION_DENIED: If the account making the request and the account
4417
+ # being queried for are different, or the account doesn't exist.
4418
+ # INVALID_ARGUMENT: Missing or invalid required parameters in the
4419
+ # request.
4420
+ # INTERNAL: Any non-user error related to technical issue in the
4421
+ # backend. In this case, contact cloud channel support.
4422
+ #
4423
+ # Return Value:
4424
+ # If successful, the {::Google::Cloud::Channel::V1::BillableSku BillableSku}
4425
+ # resources. The data for each resource is displayed in the ascending order
4426
+ # of:
4427
+ #
4428
+ # * {::Google::Cloud::Channel::V1::BillableSku#service_display_name BillableSku.service_display_name}
4429
+ # * {::Google::Cloud::Channel::V1::BillableSku#sku_display_name BillableSku.sku_display_name}
4430
+ #
4431
+ # If unsuccessful, returns an error.
4432
+ #
4433
+ # @overload list_sku_group_billable_skus(request, options = nil)
4434
+ # Pass arguments to `list_sku_group_billable_skus` via a request object, either of type
4435
+ # {::Google::Cloud::Channel::V1::ListSkuGroupBillableSkusRequest} or an equivalent Hash.
4436
+ #
4437
+ # @param request [::Google::Cloud::Channel::V1::ListSkuGroupBillableSkusRequest, ::Hash]
4438
+ # A request object representing the call parameters. Required. To specify no
4439
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
4440
+ # @param options [::Gapic::CallOptions, ::Hash]
4441
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
4442
+ #
4443
+ # @overload list_sku_group_billable_skus(parent: nil, page_size: nil, page_token: nil)
4444
+ # Pass arguments to `list_sku_group_billable_skus` via keyword arguments. Note that at
4445
+ # least one keyword argument is required. To specify no parameters, or to keep all
4446
+ # the default parameter values, pass an empty Hash as a request object (see above).
4447
+ #
4448
+ # @param parent [::String]
4449
+ # Required. Resource name of the SKU group.
4450
+ # Format: accounts/\\{account}/skuGroups/\\{sku_group}.
4451
+ # @param page_size [::Integer]
4452
+ # Optional. The maximum number of SKUs to return. The service may return
4453
+ # fewer than this value. If unspecified, returns a maximum of 100000 SKUs.
4454
+ # The maximum value is 100000; values above 100000 will be coerced to 100000.
4455
+ # @param page_token [::String]
4456
+ # Optional. A token identifying a page of results beyond the first page.
4457
+ # Obtained through
4458
+ # [ListSkuGroupBillableSkus.next_page_token][] of the previous
4459
+ # {::Google::Cloud::Channel::V1::CloudChannelService::Rest::Client#list_sku_group_billable_skus CloudChannelService.ListSkuGroupBillableSkus}
4460
+ # call.
4461
+ # @yield [result, operation] Access the result along with the TransportOperation object
4462
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::BillableSku>]
4463
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
4464
+ #
4465
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::BillableSku>]
4466
+ #
4467
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
4468
+ #
4469
+ # @example Basic example
4470
+ # require "google/cloud/channel/v1"
4471
+ #
4472
+ # # Create a client object. The client can be reused for multiple calls.
4473
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
4474
+ #
4475
+ # # Create a request. To set request fields, pass in keyword arguments.
4476
+ # request = Google::Cloud::Channel::V1::ListSkuGroupBillableSkusRequest.new
4477
+ #
4478
+ # # Call the list_sku_group_billable_skus method.
4479
+ # result = client.list_sku_group_billable_skus request
4480
+ #
4481
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
4482
+ # # over elements, and API calls will be issued to fetch pages as needed.
4483
+ # result.each do |item|
4484
+ # # Each element is of type ::Google::Cloud::Channel::V1::BillableSku.
4485
+ # p item
4486
+ # end
4487
+ #
4488
+ def list_sku_group_billable_skus request, options = nil
4489
+ raise ::ArgumentError, "request must be provided" if request.nil?
4490
+
4491
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Channel::V1::ListSkuGroupBillableSkusRequest
4492
+
4493
+ # Converts hash and nil to an options object
4494
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
4495
+
4496
+ # Customize the options with defaults
4497
+ call_metadata = @config.rpcs.list_sku_group_billable_skus.metadata.to_h
4498
+
4499
+ # Set x-goog-api-client and x-goog-user-project headers
4500
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
4501
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
4502
+ gapic_version: ::Google::Cloud::Channel::V1::VERSION,
4503
+ transports_version_send: [:rest]
4504
+
4505
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
4506
+
4507
+ options.apply_defaults timeout: @config.rpcs.list_sku_group_billable_skus.timeout,
4508
+ metadata: call_metadata,
4509
+ retry_policy: @config.rpcs.list_sku_group_billable_skus.retry_policy
4510
+
4511
+ options.apply_defaults timeout: @config.timeout,
4512
+ metadata: @config.metadata,
4513
+ retry_policy: @config.retry_policy
4514
+
4515
+ @cloud_channel_service_stub.list_sku_group_billable_skus request, options do |result, operation|
4516
+ result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_sku_group_billable_skus, "billable_skus", request, result, options
4517
+ yield result, operation if block_given?
4518
+ return result
4519
+ end
4520
+ rescue ::Gapic::Rest::Error => e
4521
+ raise ::Google::Cloud::Error.from_error(e)
4522
+ end
4523
+
4524
+ ##
4525
+ # Returns the requested {::Google::Cloud::Channel::V1::Offer Offer} resource.
4526
+ #
4527
+ # Possible error codes:
4528
+ #
4529
+ # * PERMISSION_DENIED: The entitlement doesn't belong to the reseller.
4530
+ # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
4531
+ # * NOT_FOUND: Entitlement or offer was not found.
4532
+ #
4533
+ # Return value:
3597
4534
  # The {::Google::Cloud::Channel::V1::Offer Offer} resource.
3598
4535
  #
3599
4536
  # @overload lookup_offer(request, options = nil)
@@ -3622,6 +4559,22 @@ module Google
3622
4559
  # @return [::Google::Cloud::Channel::V1::Offer]
3623
4560
  #
3624
4561
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
4562
+ #
4563
+ # @example Basic example
4564
+ # require "google/cloud/channel/v1"
4565
+ #
4566
+ # # Create a client object. The client can be reused for multiple calls.
4567
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
4568
+ #
4569
+ # # Create a request. To set request fields, pass in keyword arguments.
4570
+ # request = Google::Cloud::Channel::V1::LookupOfferRequest.new
4571
+ #
4572
+ # # Call the lookup_offer method.
4573
+ # result = client.lookup_offer request
4574
+ #
4575
+ # # The returned object is of type Google::Cloud::Channel::V1::Offer.
4576
+ # p result
4577
+ #
3625
4578
  def lookup_offer request, options = nil
3626
4579
  raise ::ArgumentError, "request must be provided" if request.nil?
3627
4580
 
@@ -3699,6 +4652,26 @@ module Google
3699
4652
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::Product>]
3700
4653
  #
3701
4654
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
4655
+ #
4656
+ # @example Basic example
4657
+ # require "google/cloud/channel/v1"
4658
+ #
4659
+ # # Create a client object. The client can be reused for multiple calls.
4660
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
4661
+ #
4662
+ # # Create a request. To set request fields, pass in keyword arguments.
4663
+ # request = Google::Cloud::Channel::V1::ListProductsRequest.new
4664
+ #
4665
+ # # Call the list_products method.
4666
+ # result = client.list_products request
4667
+ #
4668
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
4669
+ # # over elements, and API calls will be issued to fetch pages as needed.
4670
+ # result.each do |item|
4671
+ # # Each element is of type ::Google::Cloud::Channel::V1::Product.
4672
+ # p item
4673
+ # end
4674
+ #
3702
4675
  def list_products request, options = nil
3703
4676
  raise ::ArgumentError, "request must be provided" if request.nil?
3704
4677
 
@@ -3782,6 +4755,26 @@ module Google
3782
4755
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::Sku>]
3783
4756
  #
3784
4757
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
4758
+ #
4759
+ # @example Basic example
4760
+ # require "google/cloud/channel/v1"
4761
+ #
4762
+ # # Create a client object. The client can be reused for multiple calls.
4763
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
4764
+ #
4765
+ # # Create a request. To set request fields, pass in keyword arguments.
4766
+ # request = Google::Cloud::Channel::V1::ListSkusRequest.new
4767
+ #
4768
+ # # Call the list_skus method.
4769
+ # result = client.list_skus request
4770
+ #
4771
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
4772
+ # # over elements, and API calls will be issued to fetch pages as needed.
4773
+ # result.each do |item|
4774
+ # # Each element is of type ::Google::Cloud::Channel::V1::Sku.
4775
+ # p item
4776
+ # end
4777
+ #
3785
4778
  def list_skus request, options = nil
3786
4779
  raise ::ArgumentError, "request must be provided" if request.nil?
3787
4780
 
@@ -3871,6 +4864,26 @@ module Google
3871
4864
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::Offer>]
3872
4865
  #
3873
4866
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
4867
+ #
4868
+ # @example Basic example
4869
+ # require "google/cloud/channel/v1"
4870
+ #
4871
+ # # Create a client object. The client can be reused for multiple calls.
4872
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
4873
+ #
4874
+ # # Create a request. To set request fields, pass in keyword arguments.
4875
+ # request = Google::Cloud::Channel::V1::ListOffersRequest.new
4876
+ #
4877
+ # # Call the list_offers method.
4878
+ # result = client.list_offers request
4879
+ #
4880
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
4881
+ # # over elements, and API calls will be issued to fetch pages as needed.
4882
+ # result.each do |item|
4883
+ # # Each element is of type ::Google::Cloud::Channel::V1::Offer.
4884
+ # p item
4885
+ # end
4886
+ #
3874
4887
  def list_offers request, options = nil
3875
4888
  raise ::ArgumentError, "request must be provided" if request.nil?
3876
4889
 
@@ -3957,6 +4970,26 @@ module Google
3957
4970
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::PurchasableSku>]
3958
4971
  #
3959
4972
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
4973
+ #
4974
+ # @example Basic example
4975
+ # require "google/cloud/channel/v1"
4976
+ #
4977
+ # # Create a client object. The client can be reused for multiple calls.
4978
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
4979
+ #
4980
+ # # Create a request. To set request fields, pass in keyword arguments.
4981
+ # request = Google::Cloud::Channel::V1::ListPurchasableSkusRequest.new
4982
+ #
4983
+ # # Call the list_purchasable_skus method.
4984
+ # result = client.list_purchasable_skus request
4985
+ #
4986
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
4987
+ # # over elements, and API calls will be issued to fetch pages as needed.
4988
+ # result.each do |item|
4989
+ # # Each element is of type ::Google::Cloud::Channel::V1::PurchasableSku.
4990
+ # p item
4991
+ # end
4992
+ #
3960
4993
  def list_purchasable_skus request, options = nil
3961
4994
  raise ::ArgumentError, "request must be provided" if request.nil?
3962
4995
 
@@ -4001,7 +5034,10 @@ module Google
4001
5034
  #
4002
5035
  # Possible error codes:
4003
5036
  #
4004
- # * PERMISSION_DENIED: The customer doesn't belong to the reseller
5037
+ # * PERMISSION_DENIED:
5038
+ # * The customer doesn't belong to the reseller
5039
+ # * The reseller is not authorized to transact on this Product. See
5040
+ # https://support.google.com/channelservices/answer/9759265
4005
5041
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
4006
5042
  #
4007
5043
  # @overload list_purchasable_offers(request, options = nil)
@@ -4043,6 +5079,26 @@ module Google
4043
5079
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::PurchasableOffer>]
4044
5080
  #
4045
5081
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
5082
+ #
5083
+ # @example Basic example
5084
+ # require "google/cloud/channel/v1"
5085
+ #
5086
+ # # Create a client object. The client can be reused for multiple calls.
5087
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
5088
+ #
5089
+ # # Create a request. To set request fields, pass in keyword arguments.
5090
+ # request = Google::Cloud::Channel::V1::ListPurchasableOffersRequest.new
5091
+ #
5092
+ # # Call the list_purchasable_offers method.
5093
+ # result = client.list_purchasable_offers request
5094
+ #
5095
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
5096
+ # # over elements, and API calls will be issued to fetch pages as needed.
5097
+ # result.each do |item|
5098
+ # # Each element is of type ::Google::Cloud::Channel::V1::PurchasableOffer.
5099
+ # p item
5100
+ # end
5101
+ #
4046
5102
  def list_purchasable_offers request, options = nil
4047
5103
  raise ::ArgumentError, "request must be provided" if request.nil?
4048
5104
 
@@ -4079,6 +5135,99 @@ module Google
4079
5135
  raise ::Google::Cloud::Error.from_error(e)
4080
5136
  end
4081
5137
 
5138
+ ##
5139
+ # Lists the billing accounts that are eligible to purchase particular SKUs
5140
+ # for a given customer.
5141
+ #
5142
+ # Possible error codes:
5143
+ #
5144
+ # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
5145
+ # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
5146
+ #
5147
+ # Return value:
5148
+ # Based on the provided list of SKUs, returns a list of SKU groups that must
5149
+ # be purchased using the same billing account and the billing accounts
5150
+ # eligible to purchase each SKU group.
5151
+ #
5152
+ # @overload query_eligible_billing_accounts(request, options = nil)
5153
+ # Pass arguments to `query_eligible_billing_accounts` via a request object, either of type
5154
+ # {::Google::Cloud::Channel::V1::QueryEligibleBillingAccountsRequest} or an equivalent Hash.
5155
+ #
5156
+ # @param request [::Google::Cloud::Channel::V1::QueryEligibleBillingAccountsRequest, ::Hash]
5157
+ # A request object representing the call parameters. Required. To specify no
5158
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
5159
+ # @param options [::Gapic::CallOptions, ::Hash]
5160
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
5161
+ #
5162
+ # @overload query_eligible_billing_accounts(customer: nil, skus: nil)
5163
+ # Pass arguments to `query_eligible_billing_accounts` via keyword arguments. Note that at
5164
+ # least one keyword argument is required. To specify no parameters, or to keep all
5165
+ # the default parameter values, pass an empty Hash as a request object (see above).
5166
+ #
5167
+ # @param customer [::String]
5168
+ # Required. The resource name of the customer to list eligible billing
5169
+ # accounts for. Format: accounts/\\{account_id}/customers/\\{customer_id}.
5170
+ # @param skus [::Array<::String>]
5171
+ # Required. List of SKUs to list eligible billing accounts for. At least one
5172
+ # SKU is required. Format: products/\\{product_id}/skus/\\{sku_id}.
5173
+ # @yield [result, operation] Access the result along with the TransportOperation object
5174
+ # @yieldparam result [::Google::Cloud::Channel::V1::QueryEligibleBillingAccountsResponse]
5175
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
5176
+ #
5177
+ # @return [::Google::Cloud::Channel::V1::QueryEligibleBillingAccountsResponse]
5178
+ #
5179
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
5180
+ #
5181
+ # @example Basic example
5182
+ # require "google/cloud/channel/v1"
5183
+ #
5184
+ # # Create a client object. The client can be reused for multiple calls.
5185
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
5186
+ #
5187
+ # # Create a request. To set request fields, pass in keyword arguments.
5188
+ # request = Google::Cloud::Channel::V1::QueryEligibleBillingAccountsRequest.new
5189
+ #
5190
+ # # Call the query_eligible_billing_accounts method.
5191
+ # result = client.query_eligible_billing_accounts request
5192
+ #
5193
+ # # The returned object is of type Google::Cloud::Channel::V1::QueryEligibleBillingAccountsResponse.
5194
+ # p result
5195
+ #
5196
+ def query_eligible_billing_accounts request, options = nil
5197
+ raise ::ArgumentError, "request must be provided" if request.nil?
5198
+
5199
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Channel::V1::QueryEligibleBillingAccountsRequest
5200
+
5201
+ # Converts hash and nil to an options object
5202
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
5203
+
5204
+ # Customize the options with defaults
5205
+ call_metadata = @config.rpcs.query_eligible_billing_accounts.metadata.to_h
5206
+
5207
+ # Set x-goog-api-client and x-goog-user-project headers
5208
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
5209
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
5210
+ gapic_version: ::Google::Cloud::Channel::V1::VERSION,
5211
+ transports_version_send: [:rest]
5212
+
5213
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
5214
+
5215
+ options.apply_defaults timeout: @config.rpcs.query_eligible_billing_accounts.timeout,
5216
+ metadata: call_metadata,
5217
+ retry_policy: @config.rpcs.query_eligible_billing_accounts.retry_policy
5218
+
5219
+ options.apply_defaults timeout: @config.timeout,
5220
+ metadata: @config.metadata,
5221
+ retry_policy: @config.retry_policy
5222
+
5223
+ @cloud_channel_service_stub.query_eligible_billing_accounts request, options do |result, operation|
5224
+ yield result, operation if block_given?
5225
+ return result
5226
+ end
5227
+ rescue ::Gapic::Rest::Error => e
5228
+ raise ::Google::Cloud::Error.from_error(e)
5229
+ end
5230
+
4082
5231
  ##
4083
5232
  # Registers a service account with subscriber privileges on the Cloud Pub/Sub
4084
5233
  # topic for this Channel Services account. After you create a
@@ -4126,6 +5275,22 @@ module Google
4126
5275
  # @return [::Google::Cloud::Channel::V1::RegisterSubscriberResponse]
4127
5276
  #
4128
5277
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
5278
+ #
5279
+ # @example Basic example
5280
+ # require "google/cloud/channel/v1"
5281
+ #
5282
+ # # Create a client object. The client can be reused for multiple calls.
5283
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
5284
+ #
5285
+ # # Create a request. To set request fields, pass in keyword arguments.
5286
+ # request = Google::Cloud::Channel::V1::RegisterSubscriberRequest.new
5287
+ #
5288
+ # # Call the register_subscriber method.
5289
+ # result = client.register_subscriber request
5290
+ #
5291
+ # # The returned object is of type Google::Cloud::Channel::V1::RegisterSubscriberResponse.
5292
+ # p result
5293
+ #
4129
5294
  def register_subscriber request, options = nil
4130
5295
  raise ::ArgumentError, "request must be provided" if request.nil?
4131
5296
 
@@ -4211,6 +5376,22 @@ module Google
4211
5376
  # @return [::Google::Cloud::Channel::V1::UnregisterSubscriberResponse]
4212
5377
  #
4213
5378
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
5379
+ #
5380
+ # @example Basic example
5381
+ # require "google/cloud/channel/v1"
5382
+ #
5383
+ # # Create a client object. The client can be reused for multiple calls.
5384
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
5385
+ #
5386
+ # # Create a request. To set request fields, pass in keyword arguments.
5387
+ # request = Google::Cloud::Channel::V1::UnregisterSubscriberRequest.new
5388
+ #
5389
+ # # Call the unregister_subscriber method.
5390
+ # result = client.unregister_subscriber request
5391
+ #
5392
+ # # The returned object is of type Google::Cloud::Channel::V1::UnregisterSubscriberResponse.
5393
+ # p result
5394
+ #
4214
5395
  def unregister_subscriber request, options = nil
4215
5396
  raise ::ArgumentError, "request must be provided" if request.nil?
4216
5397
 
@@ -4300,6 +5481,22 @@ module Google
4300
5481
  # @return [::Gapic::Rest::PagedEnumerable<::String>]
4301
5482
  #
4302
5483
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
5484
+ #
5485
+ # @example Basic example
5486
+ # require "google/cloud/channel/v1"
5487
+ #
5488
+ # # Create a client object. The client can be reused for multiple calls.
5489
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
5490
+ #
5491
+ # # Create a request. To set request fields, pass in keyword arguments.
5492
+ # request = Google::Cloud::Channel::V1::ListSubscribersRequest.new
5493
+ #
5494
+ # # Call the list_subscribers method.
5495
+ # result = client.list_subscribers request
5496
+ #
5497
+ # # The returned object is of type Google::Cloud::Channel::V1::ListSubscribersResponse.
5498
+ # p result
5499
+ #
4303
5500
  def list_subscribers request, options = nil
4304
5501
  raise ::ArgumentError, "request must be provided" if request.nil?
4305
5502
 
@@ -4398,6 +5595,26 @@ module Google
4398
5595
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::EntitlementChange>]
4399
5596
  #
4400
5597
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
5598
+ #
5599
+ # @example Basic example
5600
+ # require "google/cloud/channel/v1"
5601
+ #
5602
+ # # Create a client object. The client can be reused for multiple calls.
5603
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
5604
+ #
5605
+ # # Create a request. To set request fields, pass in keyword arguments.
5606
+ # request = Google::Cloud::Channel::V1::ListEntitlementChangesRequest.new
5607
+ #
5608
+ # # Call the list_entitlement_changes method.
5609
+ # result = client.list_entitlement_changes request
5610
+ #
5611
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
5612
+ # # over elements, and API calls will be issued to fetch pages as needed.
5613
+ # result.each do |item|
5614
+ # # Each element is of type ::Google::Cloud::Channel::V1::EntitlementChange.
5615
+ # p item
5616
+ # end
5617
+ #
4401
5618
  def list_entitlement_changes request, options = nil
4402
5619
  raise ::ArgumentError, "request must be provided" if request.nil?
4403
5620
 
@@ -4740,6 +5957,16 @@ module Google
4740
5957
  #
4741
5958
  attr_reader :delete_channel_partner_repricing_config
4742
5959
  ##
5960
+ # RPC-specific configuration for `list_sku_groups`
5961
+ # @return [::Gapic::Config::Method]
5962
+ #
5963
+ attr_reader :list_sku_groups
5964
+ ##
5965
+ # RPC-specific configuration for `list_sku_group_billable_skus`
5966
+ # @return [::Gapic::Config::Method]
5967
+ #
5968
+ attr_reader :list_sku_group_billable_skus
5969
+ ##
4743
5970
  # RPC-specific configuration for `lookup_offer`
4744
5971
  # @return [::Gapic::Config::Method]
4745
5972
  #
@@ -4770,6 +5997,11 @@ module Google
4770
5997
  #
4771
5998
  attr_reader :list_purchasable_offers
4772
5999
  ##
6000
+ # RPC-specific configuration for `query_eligible_billing_accounts`
6001
+ # @return [::Gapic::Config::Method]
6002
+ #
6003
+ attr_reader :query_eligible_billing_accounts
6004
+ ##
4773
6005
  # RPC-specific configuration for `register_subscriber`
4774
6006
  # @return [::Gapic::Config::Method]
4775
6007
  #
@@ -4864,6 +6096,10 @@ module Google
4864
6096
  @update_channel_partner_repricing_config = ::Gapic::Config::Method.new update_channel_partner_repricing_config_config
4865
6097
  delete_channel_partner_repricing_config_config = parent_rpcs.delete_channel_partner_repricing_config if parent_rpcs.respond_to? :delete_channel_partner_repricing_config
4866
6098
  @delete_channel_partner_repricing_config = ::Gapic::Config::Method.new delete_channel_partner_repricing_config_config
6099
+ list_sku_groups_config = parent_rpcs.list_sku_groups if parent_rpcs.respond_to? :list_sku_groups
6100
+ @list_sku_groups = ::Gapic::Config::Method.new list_sku_groups_config
6101
+ list_sku_group_billable_skus_config = parent_rpcs.list_sku_group_billable_skus if parent_rpcs.respond_to? :list_sku_group_billable_skus
6102
+ @list_sku_group_billable_skus = ::Gapic::Config::Method.new list_sku_group_billable_skus_config
4867
6103
  lookup_offer_config = parent_rpcs.lookup_offer if parent_rpcs.respond_to? :lookup_offer
4868
6104
  @lookup_offer = ::Gapic::Config::Method.new lookup_offer_config
4869
6105
  list_products_config = parent_rpcs.list_products if parent_rpcs.respond_to? :list_products
@@ -4876,6 +6112,8 @@ module Google
4876
6112
  @list_purchasable_skus = ::Gapic::Config::Method.new list_purchasable_skus_config
4877
6113
  list_purchasable_offers_config = parent_rpcs.list_purchasable_offers if parent_rpcs.respond_to? :list_purchasable_offers
4878
6114
  @list_purchasable_offers = ::Gapic::Config::Method.new list_purchasable_offers_config
6115
+ query_eligible_billing_accounts_config = parent_rpcs.query_eligible_billing_accounts if parent_rpcs.respond_to? :query_eligible_billing_accounts
6116
+ @query_eligible_billing_accounts = ::Gapic::Config::Method.new query_eligible_billing_accounts_config
4879
6117
  register_subscriber_config = parent_rpcs.register_subscriber if parent_rpcs.respond_to? :register_subscriber
4880
6118
  @register_subscriber = ::Gapic::Config::Method.new register_subscriber_config
4881
6119
  unregister_subscriber_config = parent_rpcs.unregister_subscriber if parent_rpcs.respond_to? :unregister_subscriber