google-cloud-channel-v1 0.15.0 → 0.17.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (29) 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 +14 -18
  4. data/lib/google/cloud/channel/v1/cloud_channel_reports_service/operations.rb +14 -16
  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 +232 -119
  11. data/lib/google/cloud/channel/v1/cloud_channel_service/operations.rb +14 -16
  12. data/lib/google/cloud/channel/v1/cloud_channel_service/rest/client.rb +4894 -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 +2830 -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 +7 -1
  17. data/lib/google/cloud/channel/v1/customers_pb.rb +1 -0
  18. data/lib/google/cloud/channel/v1/entitlement_changes_pb.rb +81 -0
  19. data/lib/google/cloud/channel/v1/reports_service_pb.rb +1 -0
  20. data/lib/google/cloud/channel/v1/rest.rb +38 -0
  21. data/lib/google/cloud/channel/v1/service_pb.rb +15 -0
  22. data/lib/google/cloud/channel/v1/service_services_pb.rb +17 -0
  23. data/lib/google/cloud/channel/v1/version.rb +1 -1
  24. data/lib/google/cloud/channel/v1.rb +7 -2
  25. data/proto_docs/google/cloud/channel/v1/customers.rb +4 -0
  26. data/proto_docs/google/cloud/channel/v1/entitlement_changes.rb +182 -0
  27. data/proto_docs/google/cloud/channel/v1/entitlements.rb +12 -3
  28. data/proto_docs/google/cloud/channel/v1/service.rb +52 -0
  29. metadata +21 -8
@@ -271,13 +271,11 @@ module Google
271
271
  # # Call the list_customers method.
272
272
  # result = client.list_customers request
273
273
  #
274
- # # The returned object is of type Gapic::PagedEnumerable. You can
275
- # # iterate over all elements by calling #each, and the enumerable
276
- # # will lazily make API calls to fetch subsequent pages. Other
277
- # # methods are also available for managing paging directly.
278
- # 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|
279
277
  # # Each element is of type ::Google::Cloud::Channel::V1::Customer.
280
- # p response
278
+ # p item
281
279
  # end
282
280
  #
283
281
  def list_customers request, options = nil
@@ -1013,14 +1011,14 @@ module Google
1013
1011
  # # Call the provision_cloud_identity method.
1014
1012
  # result = client.provision_cloud_identity request
1015
1013
  #
1016
- # # The returned object is of type Gapic::Operation. You can use this
1017
- # # object to check the status of an operation, cancel it, or wait
1018
- # # 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.
1019
1017
  # result.wait_until_done! timeout: 60
1020
1018
  # if result.response?
1021
1019
  # p result.response
1022
1020
  # else
1023
- # puts "Error!"
1021
+ # puts "No response received."
1024
1022
  # end
1025
1023
  #
1026
1024
  def provision_cloud_identity request, options = nil
@@ -1129,13 +1127,11 @@ module Google
1129
1127
  # # Call the list_entitlements method.
1130
1128
  # result = client.list_entitlements request
1131
1129
  #
1132
- # # The returned object is of type Gapic::PagedEnumerable. You can
1133
- # # iterate over all elements by calling #each, and the enumerable
1134
- # # will lazily make API calls to fetch subsequent pages. Other
1135
- # # methods are also available for managing paging directly.
1136
- # 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|
1137
1133
  # # Each element is of type ::Google::Cloud::Channel::V1::Entitlement.
1138
- # p response
1134
+ # p item
1139
1135
  # end
1140
1136
  #
1141
1137
  def list_entitlements request, options = nil
@@ -1269,13 +1265,11 @@ module Google
1269
1265
  # # Call the list_transferable_skus method.
1270
1266
  # result = client.list_transferable_skus request
1271
1267
  #
1272
- # # The returned object is of type Gapic::PagedEnumerable. You can
1273
- # # iterate over all elements by calling #each, and the enumerable
1274
- # # will lazily make API calls to fetch subsequent pages. Other
1275
- # # methods are also available for managing paging directly.
1276
- # 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|
1277
1271
  # # Each element is of type ::Google::Cloud::Channel::V1::TransferableSku.
1278
- # p response
1272
+ # p item
1279
1273
  # end
1280
1274
  #
1281
1275
  def list_transferable_skus request, options = nil
@@ -1402,13 +1396,11 @@ module Google
1402
1396
  # # Call the list_transferable_offers method.
1403
1397
  # result = client.list_transferable_offers request
1404
1398
  #
1405
- # # The returned object is of type Gapic::PagedEnumerable. You can
1406
- # # iterate over all elements by calling #each, and the enumerable
1407
- # # will lazily make API calls to fetch subsequent pages. Other
1408
- # # methods are also available for managing paging directly.
1409
- # 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|
1410
1402
  # # Each element is of type ::Google::Cloud::Channel::V1::TransferableOffer.
1411
- # p response
1403
+ # p item
1412
1404
  # end
1413
1405
  #
1414
1406
  def list_transferable_offers request, options = nil
@@ -1643,14 +1635,14 @@ module Google
1643
1635
  # # Call the create_entitlement method.
1644
1636
  # result = client.create_entitlement request
1645
1637
  #
1646
- # # The returned object is of type Gapic::Operation. You can use this
1647
- # # object to check the status of an operation, cancel it, or wait
1648
- # # 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.
1649
1641
  # result.wait_until_done! timeout: 60
1650
1642
  # if result.response?
1651
1643
  # p result.response
1652
1644
  # else
1653
- # puts "Error!"
1645
+ # puts "No response received."
1654
1646
  # end
1655
1647
  #
1656
1648
  def create_entitlement request, options = nil
@@ -1782,14 +1774,14 @@ module Google
1782
1774
  # # Call the change_parameters method.
1783
1775
  # result = client.change_parameters request
1784
1776
  #
1785
- # # The returned object is of type Gapic::Operation. You can use this
1786
- # # object to check the status of an operation, cancel it, or wait
1787
- # # 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.
1788
1780
  # result.wait_until_done! timeout: 60
1789
1781
  # if result.response?
1790
1782
  # p result.response
1791
1783
  # else
1792
- # puts "Error!"
1784
+ # puts "No response received."
1793
1785
  # end
1794
1786
  #
1795
1787
  def change_parameters request, options = nil
@@ -1914,14 +1906,14 @@ module Google
1914
1906
  # # Call the change_renewal_settings method.
1915
1907
  # result = client.change_renewal_settings request
1916
1908
  #
1917
- # # The returned object is of type Gapic::Operation. You can use this
1918
- # # object to check the status of an operation, cancel it, or wait
1919
- # # 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.
1920
1912
  # result.wait_until_done! timeout: 60
1921
1913
  # if result.response?
1922
1914
  # p result.response
1923
1915
  # else
1924
- # puts "Error!"
1916
+ # puts "No response received."
1925
1917
  # end
1926
1918
  #
1927
1919
  def change_renewal_settings request, options = nil
@@ -2052,14 +2044,14 @@ module Google
2052
2044
  # # Call the change_offer method.
2053
2045
  # result = client.change_offer request
2054
2046
  #
2055
- # # The returned object is of type Gapic::Operation. You can use this
2056
- # # object to check the status of an operation, cancel it, or wait
2057
- # # 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.
2058
2050
  # result.wait_until_done! timeout: 60
2059
2051
  # if result.response?
2060
2052
  # p result.response
2061
2053
  # else
2062
- # puts "Error!"
2054
+ # puts "No response received."
2063
2055
  # end
2064
2056
  #
2065
2057
  def change_offer request, options = nil
@@ -2183,14 +2175,14 @@ module Google
2183
2175
  # # Call the start_paid_service method.
2184
2176
  # result = client.start_paid_service request
2185
2177
  #
2186
- # # The returned object is of type Gapic::Operation. You can use this
2187
- # # object to check the status of an operation, cancel it, or wait
2188
- # # 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.
2189
2181
  # result.wait_until_done! timeout: 60
2190
2182
  # if result.response?
2191
2183
  # p result.response
2192
2184
  # else
2193
- # puts "Error!"
2185
+ # puts "No response received."
2194
2186
  # end
2195
2187
  #
2196
2188
  def start_paid_service request, options = nil
@@ -2311,14 +2303,14 @@ module Google
2311
2303
  # # Call the suspend_entitlement method.
2312
2304
  # result = client.suspend_entitlement request
2313
2305
  #
2314
- # # The returned object is of type Gapic::Operation. You can use this
2315
- # # object to check the status of an operation, cancel it, or wait
2316
- # # 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.
2317
2309
  # result.wait_until_done! timeout: 60
2318
2310
  # if result.response?
2319
2311
  # p result.response
2320
2312
  # else
2321
- # puts "Error!"
2313
+ # puts "No response received."
2322
2314
  # end
2323
2315
  #
2324
2316
  def suspend_entitlement request, options = nil
@@ -2444,14 +2436,14 @@ module Google
2444
2436
  # # Call the cancel_entitlement method.
2445
2437
  # result = client.cancel_entitlement request
2446
2438
  #
2447
- # # The returned object is of type Gapic::Operation. You can use this
2448
- # # object to check the status of an operation, cancel it, or wait
2449
- # # 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.
2450
2442
  # result.wait_until_done! timeout: 60
2451
2443
  # if result.response?
2452
2444
  # p result.response
2453
2445
  # else
2454
- # puts "Error!"
2446
+ # puts "No response received."
2455
2447
  # end
2456
2448
  #
2457
2449
  def cancel_entitlement request, options = nil
@@ -2578,14 +2570,14 @@ module Google
2578
2570
  # # Call the activate_entitlement method.
2579
2571
  # result = client.activate_entitlement request
2580
2572
  #
2581
- # # The returned object is of type Gapic::Operation. You can use this
2582
- # # object to check the status of an operation, cancel it, or wait
2583
- # # 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.
2584
2576
  # result.wait_until_done! timeout: 60
2585
2577
  # if result.response?
2586
2578
  # p result.response
2587
2579
  # else
2588
- # puts "Error!"
2580
+ # puts "No response received."
2589
2581
  # end
2590
2582
  #
2591
2583
  def activate_entitlement request, options = nil
@@ -2721,14 +2713,14 @@ module Google
2721
2713
  # # Call the transfer_entitlements method.
2722
2714
  # result = client.transfer_entitlements request
2723
2715
  #
2724
- # # The returned object is of type Gapic::Operation. You can use this
2725
- # # object to check the status of an operation, cancel it, or wait
2726
- # # 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.
2727
2719
  # result.wait_until_done! timeout: 60
2728
2720
  # if result.response?
2729
2721
  # p result.response
2730
2722
  # else
2731
- # puts "Error!"
2723
+ # puts "No response received."
2732
2724
  # end
2733
2725
  #
2734
2726
  def transfer_entitlements request, options = nil
@@ -2859,14 +2851,14 @@ module Google
2859
2851
  # # Call the transfer_entitlements_to_google method.
2860
2852
  # result = client.transfer_entitlements_to_google request
2861
2853
  #
2862
- # # The returned object is of type Gapic::Operation. You can use this
2863
- # # object to check the status of an operation, cancel it, or wait
2864
- # # 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.
2865
2857
  # result.wait_until_done! timeout: 60
2866
2858
  # if result.response?
2867
2859
  # p result.response
2868
2860
  # else
2869
- # puts "Error!"
2861
+ # puts "No response received."
2870
2862
  # end
2871
2863
  #
2872
2864
  def transfer_entitlements_to_google request, options = nil
@@ -2977,13 +2969,11 @@ module Google
2977
2969
  # # Call the list_channel_partner_links method.
2978
2970
  # result = client.list_channel_partner_links request
2979
2971
  #
2980
- # # The returned object is of type Gapic::PagedEnumerable. You can
2981
- # # iterate over all elements by calling #each, and the enumerable
2982
- # # will lazily make API calls to fetch subsequent pages. Other
2983
- # # methods are also available for managing paging directly.
2984
- # 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|
2985
2975
  # # Each element is of type ::Google::Cloud::Channel::V1::ChannelPartnerLink.
2986
- # p response
2976
+ # p item
2987
2977
  # end
2988
2978
  #
2989
2979
  def list_channel_partner_links request, options = nil
@@ -3548,13 +3538,11 @@ module Google
3548
3538
  # # Call the list_customer_repricing_configs method.
3549
3539
  # result = client.list_customer_repricing_configs request
3550
3540
  #
3551
- # # The returned object is of type Gapic::PagedEnumerable. You can
3552
- # # iterate over all elements by calling #each, and the enumerable
3553
- # # will lazily make API calls to fetch subsequent pages. Other
3554
- # # methods are also available for managing paging directly.
3555
- # 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|
3556
3544
  # # Each element is of type ::Google::Cloud::Channel::V1::CustomerRepricingConfig.
3557
- # p response
3545
+ # p item
3558
3546
  # end
3559
3547
  #
3560
3548
  def list_customer_repricing_configs request, options = nil
@@ -4140,13 +4128,11 @@ module Google
4140
4128
  # # Call the list_channel_partner_repricing_configs method.
4141
4129
  # result = client.list_channel_partner_repricing_configs request
4142
4130
  #
4143
- # # The returned object is of type Gapic::PagedEnumerable. You can
4144
- # # iterate over all elements by calling #each, and the enumerable
4145
- # # will lazily make API calls to fetch subsequent pages. Other
4146
- # # methods are also available for managing paging directly.
4147
- # 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|
4148
4134
  # # Each element is of type ::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig.
4149
- # p response
4135
+ # p item
4150
4136
  # end
4151
4137
  #
4152
4138
  def list_channel_partner_repricing_configs request, options = nil
@@ -4690,13 +4676,11 @@ module Google
4690
4676
  # # Call the list_products method.
4691
4677
  # result = client.list_products request
4692
4678
  #
4693
- # # The returned object is of type Gapic::PagedEnumerable. You can
4694
- # # iterate over all elements by calling #each, and the enumerable
4695
- # # will lazily make API calls to fetch subsequent pages. Other
4696
- # # methods are also available for managing paging directly.
4697
- # 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|
4698
4682
  # # Each element is of type ::Google::Cloud::Channel::V1::Product.
4699
- # p response
4683
+ # p item
4700
4684
  # end
4701
4685
  #
4702
4686
  def list_products request, options = nil
@@ -4794,13 +4778,11 @@ module Google
4794
4778
  # # Call the list_skus method.
4795
4779
  # result = client.list_skus request
4796
4780
  #
4797
- # # The returned object is of type Gapic::PagedEnumerable. You can
4798
- # # iterate over all elements by calling #each, and the enumerable
4799
- # # will lazily make API calls to fetch subsequent pages. Other
4800
- # # methods are also available for managing paging directly.
4801
- # 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|
4802
4784
  # # Each element is of type ::Google::Cloud::Channel::V1::Sku.
4803
- # p response
4785
+ # p item
4804
4786
  # end
4805
4787
  #
4806
4788
  def list_skus request, options = nil
@@ -4862,7 +4844,7 @@ module Google
4862
4844
  # @param options [::Gapic::CallOptions, ::Hash]
4863
4845
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
4864
4846
  #
4865
- # @overload list_offers(parent: nil, page_size: nil, page_token: nil, filter: nil, language_code: nil)
4847
+ # @overload list_offers(parent: nil, page_size: nil, page_token: nil, filter: nil, language_code: nil, show_future_offers: nil)
4866
4848
  # Pass arguments to `list_offers` via keyword arguments. Note that at
4867
4849
  # least one keyword argument is required. To specify no parameters, or to keep all
4868
4850
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -4886,6 +4868,11 @@ module Google
4886
4868
  # Optional. The BCP-47 language code. For example, "en-US". The
4887
4869
  # response will localize in the corresponding language code, if specified.
4888
4870
  # The default value is "en-US".
4871
+ # @param show_future_offers [::Boolean]
4872
+ # Optional. A boolean flag that determines if a response returns future
4873
+ # offers 30 days from now. If the show_future_offers is true, the response
4874
+ # will only contain offers that are scheduled to be available 30 days from
4875
+ # now.
4889
4876
  #
4890
4877
  # @yield [response, operation] Access the result along with the RPC operation
4891
4878
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Channel::V1::Offer>]
@@ -4907,13 +4894,11 @@ module Google
4907
4894
  # # Call the list_offers method.
4908
4895
  # result = client.list_offers request
4909
4896
  #
4910
- # # The returned object is of type Gapic::PagedEnumerable. You can
4911
- # # iterate over all elements by calling #each, and the enumerable
4912
- # # will lazily make API calls to fetch subsequent pages. Other
4913
- # # methods are also available for managing paging directly.
4914
- # result.each do |response|
4897
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
4898
+ # # over elements, and API calls will be issued to fetch pages as needed.
4899
+ # result.each do |item|
4915
4900
  # # Each element is of type ::Google::Cloud::Channel::V1::Offer.
4916
- # p response
4901
+ # p item
4917
4902
  # end
4918
4903
  #
4919
4904
  def list_offers request, options = nil
@@ -5022,13 +5007,11 @@ module Google
5022
5007
  # # Call the list_purchasable_skus method.
5023
5008
  # result = client.list_purchasable_skus request
5024
5009
  #
5025
- # # The returned object is of type Gapic::PagedEnumerable. You can
5026
- # # iterate over all elements by calling #each, and the enumerable
5027
- # # will lazily make API calls to fetch subsequent pages. Other
5028
- # # methods are also available for managing paging directly.
5029
- # result.each do |response|
5010
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
5011
+ # # over elements, and API calls will be issued to fetch pages as needed.
5012
+ # result.each do |item|
5030
5013
  # # Each element is of type ::Google::Cloud::Channel::V1::PurchasableSku.
5031
- # p response
5014
+ # p item
5032
5015
  # end
5033
5016
  #
5034
5017
  def list_purchasable_skus request, options = nil
@@ -5137,13 +5120,11 @@ module Google
5137
5120
  # # Call the list_purchasable_offers method.
5138
5121
  # result = client.list_purchasable_offers request
5139
5122
  #
5140
- # # The returned object is of type Gapic::PagedEnumerable. You can
5141
- # # iterate over all elements by calling #each, and the enumerable
5142
- # # will lazily make API calls to fetch subsequent pages. Other
5143
- # # methods are also available for managing paging directly.
5144
- # result.each do |response|
5123
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
5124
+ # # over elements, and API calls will be issued to fetch pages as needed.
5125
+ # result.each do |item|
5145
5126
  # # Each element is of type ::Google::Cloud::Channel::V1::PurchasableOffer.
5146
- # p response
5127
+ # p item
5147
5128
  # end
5148
5129
  #
5149
5130
  def list_purchasable_offers request, options = nil
@@ -5513,6 +5494,131 @@ module Google
5513
5494
  raise ::Google::Cloud::Error.from_error(e)
5514
5495
  end
5515
5496
 
5497
+ ##
5498
+ # List entitlement history.
5499
+ #
5500
+ # Possible error codes:
5501
+ #
5502
+ # * PERMISSION_DENIED: The reseller account making the request and the
5503
+ # provided reseller account are different.
5504
+ # * INVALID_ARGUMENT: Missing or invalid required fields in the request.
5505
+ # * NOT_FOUND: The parent resource doesn't exist. Usually the result of an
5506
+ # invalid name parameter.
5507
+ # * INTERNAL: Any non-user error related to a technical issue in the backend.
5508
+ # In this case, contact CloudChannel support.
5509
+ # * UNKNOWN: Any non-user error related to a technical issue in the backend.
5510
+ # In this case, contact Cloud Channel support.
5511
+ #
5512
+ # Return value:
5513
+ # List of {::Google::Cloud::Channel::V1::EntitlementChange EntitlementChange}s.
5514
+ #
5515
+ # @overload list_entitlement_changes(request, options = nil)
5516
+ # Pass arguments to `list_entitlement_changes` via a request object, either of type
5517
+ # {::Google::Cloud::Channel::V1::ListEntitlementChangesRequest} or an equivalent Hash.
5518
+ #
5519
+ # @param request [::Google::Cloud::Channel::V1::ListEntitlementChangesRequest, ::Hash]
5520
+ # A request object representing the call parameters. Required. To specify no
5521
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
5522
+ # @param options [::Gapic::CallOptions, ::Hash]
5523
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
5524
+ #
5525
+ # @overload list_entitlement_changes(parent: nil, page_size: nil, page_token: nil, filter: nil)
5526
+ # Pass arguments to `list_entitlement_changes` via keyword arguments. Note that at
5527
+ # least one keyword argument is required. To specify no parameters, or to keep all
5528
+ # the default parameter values, pass an empty Hash as a request object (see above).
5529
+ #
5530
+ # @param parent [::String]
5531
+ # Required. The resource name of the entitlement for which to list
5532
+ # entitlement changes. The `-` wildcard may be used to match entitlements
5533
+ # across a customer. Formats:
5534
+ #
5535
+ # * accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
5536
+ # * accounts/\\{account_id}/customers/\\{customer_id}/entitlements/-
5537
+ # @param page_size [::Integer]
5538
+ # Optional. The maximum number of entitlement changes to return. The service
5539
+ # may return fewer than this value. If unspecified, returns at most 10
5540
+ # entitlement changes. The maximum value is 50; the server will coerce values
5541
+ # above 50.
5542
+ # @param page_token [::String]
5543
+ # Optional. A page token, received from a previous
5544
+ # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_entitlement_changes CloudChannelService.ListEntitlementChanges}
5545
+ # call. Provide this to retrieve the subsequent page.
5546
+ #
5547
+ # When paginating, all other parameters provided to
5548
+ # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_entitlement_changes CloudChannelService.ListEntitlementChanges}
5549
+ # must match the call that provided the page token.
5550
+ # @param filter [::String]
5551
+ # Optional. Filters applied to the list results.
5552
+ #
5553
+ # @yield [response, operation] Access the result along with the RPC operation
5554
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Channel::V1::EntitlementChange>]
5555
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
5556
+ #
5557
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::Channel::V1::EntitlementChange>]
5558
+ #
5559
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
5560
+ #
5561
+ # @example Basic example
5562
+ # require "google/cloud/channel/v1"
5563
+ #
5564
+ # # Create a client object. The client can be reused for multiple calls.
5565
+ # client = Google::Cloud::Channel::V1::CloudChannelService::Client.new
5566
+ #
5567
+ # # Create a request. To set request fields, pass in keyword arguments.
5568
+ # request = Google::Cloud::Channel::V1::ListEntitlementChangesRequest.new
5569
+ #
5570
+ # # Call the list_entitlement_changes method.
5571
+ # result = client.list_entitlement_changes request
5572
+ #
5573
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
5574
+ # # over elements, and API calls will be issued to fetch pages as needed.
5575
+ # result.each do |item|
5576
+ # # Each element is of type ::Google::Cloud::Channel::V1::EntitlementChange.
5577
+ # p item
5578
+ # end
5579
+ #
5580
+ def list_entitlement_changes request, options = nil
5581
+ raise ::ArgumentError, "request must be provided" if request.nil?
5582
+
5583
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Channel::V1::ListEntitlementChangesRequest
5584
+
5585
+ # Converts hash and nil to an options object
5586
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
5587
+
5588
+ # Customize the options with defaults
5589
+ metadata = @config.rpcs.list_entitlement_changes.metadata.to_h
5590
+
5591
+ # Set x-goog-api-client and x-goog-user-project headers
5592
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
5593
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
5594
+ gapic_version: ::Google::Cloud::Channel::V1::VERSION
5595
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
5596
+
5597
+ header_params = {}
5598
+ if request.parent
5599
+ header_params["parent"] = request.parent
5600
+ end
5601
+
5602
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
5603
+ metadata[:"x-goog-request-params"] ||= request_params_header
5604
+
5605
+ options.apply_defaults timeout: @config.rpcs.list_entitlement_changes.timeout,
5606
+ metadata: metadata,
5607
+ retry_policy: @config.rpcs.list_entitlement_changes.retry_policy
5608
+
5609
+ options.apply_defaults timeout: @config.timeout,
5610
+ metadata: @config.metadata,
5611
+ retry_policy: @config.retry_policy
5612
+
5613
+ @cloud_channel_service_stub.call_rpc :list_entitlement_changes, request, options: options do |response, operation|
5614
+ response = ::Gapic::PagedEnumerable.new @cloud_channel_service_stub, :list_entitlement_changes, request, response, operation, options
5615
+ yield response, operation if block_given?
5616
+ return response
5617
+ end
5618
+ rescue ::GRPC::BadStatus => e
5619
+ raise ::Google::Cloud::Error.from_error(e)
5620
+ end
5621
+
5516
5622
  ##
5517
5623
  # Configuration class for the CloudChannelService API.
5518
5624
  #
@@ -5551,9 +5657,9 @@ module Google
5551
5657
  # * (`String`) The path to a service account key file in JSON format
5552
5658
  # * (`Hash`) A service account key as a Hash
5553
5659
  # * (`Google::Auth::Credentials`) A googleauth credentials object
5554
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
5660
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
5555
5661
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
5556
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
5662
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
5557
5663
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
5558
5664
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
5559
5665
  # * (`nil`) indicating no credentials
@@ -5873,6 +5979,11 @@ module Google
5873
5979
  # @return [::Gapic::Config::Method]
5874
5980
  #
5875
5981
  attr_reader :list_subscribers
5982
+ ##
5983
+ # RPC-specific configuration for `list_entitlement_changes`
5984
+ # @return [::Gapic::Config::Method]
5985
+ #
5986
+ attr_reader :list_entitlement_changes
5876
5987
 
5877
5988
  # @private
5878
5989
  def initialize parent_rpcs = nil
@@ -5966,6 +6077,8 @@ module Google
5966
6077
  @unregister_subscriber = ::Gapic::Config::Method.new unregister_subscriber_config
5967
6078
  list_subscribers_config = parent_rpcs.list_subscribers if parent_rpcs.respond_to? :list_subscribers
5968
6079
  @list_subscribers = ::Gapic::Config::Method.new list_subscribers_config
6080
+ list_entitlement_changes_config = parent_rpcs.list_entitlement_changes if parent_rpcs.respond_to? :list_entitlement_changes
6081
+ @list_entitlement_changes = ::Gapic::Config::Method.new list_entitlement_changes_config
5969
6082
 
5970
6083
  yield self if block_given?
5971
6084
  end