google-cloud-channel-v1 0.15.0 → 0.17.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 (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