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
@@ -103,8 +103,11 @@ module Google
103
103
  #
104
104
  # Possible error codes:
105
105
  #
106
- # * PERMISSION_DENIED: The reseller account making the request is different
107
- # from the reseller account in the API request.
106
+ # * PERMISSION_DENIED:
107
+ # * The reseller account making the request is different from the
108
+ # reseller account in the API request.
109
+ # * You are not authorized to create a customer. See
110
+ # https://support.google.com/channelservices/answer/9759265
108
111
  # * INVALID_ARGUMENT:
109
112
  # * Required request parameters are missing or invalid.
110
113
  # * Domain field value doesn't match the primary email domain.
@@ -144,8 +147,11 @@ module Google
144
147
  #
145
148
  # Possible error codes:
146
149
  #
147
- # * PERMISSION_DENIED: The reseller account making the request is different
148
- # from the reseller account in the API request.
150
+ # * PERMISSION_DENIED:
151
+ # * The reseller account making the request is different from the
152
+ # reseller account in the API request.
153
+ # * You are not authorized to import the customer. See
154
+ # https://support.google.com/channelservices/answer/9759265
149
155
  # * NOT_FOUND: Cloud Identity doesn't exist or was deleted.
150
156
  # * INVALID_ARGUMENT: Required parameters are missing, or the auth_token is
151
157
  # expired or invalid.
@@ -160,7 +166,10 @@ module Google
160
166
  #
161
167
  # Possible error codes:
162
168
  #
163
- # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
169
+ # * PERMISSION_DENIED:
170
+ # * The customer doesn't belong to the reseller.
171
+ # * You are not authorized to provision cloud identity id. See
172
+ # https://support.google.com/channelservices/answer/9759265
164
173
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
165
174
  # * NOT_FOUND: The customer was not found.
166
175
  # * ALREADY_EXISTS: The customer's primary email already exists. Retry
@@ -224,6 +233,8 @@ module Google
224
233
  # auth token.
225
234
  # * The reseller account making the request is different
226
235
  # from the reseller account in the query.
236
+ # * The reseller is not authorized to transact on this Product. See
237
+ # https://support.google.com/channelservices/answer/9759265
227
238
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
228
239
  #
229
240
  # Return value:
@@ -246,7 +257,10 @@ module Google
246
257
  #
247
258
  # Possible error codes:
248
259
  #
249
- # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
260
+ # * PERMISSION_DENIED:
261
+ # * The customer doesn't belong to the reseller.
262
+ # * The reseller is not authorized to transact on this Product. See
263
+ # https://support.google.com/channelservices/answer/9759265
250
264
  # * INVALID_ARGUMENT:
251
265
  # * Required request parameters are missing or invalid.
252
266
  # * There is already a customer entitlement for a SKU from the same
@@ -455,7 +469,10 @@ module Google
455
469
  #
456
470
  # Possible error codes:
457
471
  #
458
- # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
472
+ # * PERMISSION_DENIED:
473
+ # * The customer doesn't belong to the reseller.
474
+ # * The reseller is not authorized to transact on this Product. See
475
+ # https://support.google.com/channelservices/answer/9759265
459
476
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
460
477
  # * NOT_FOUND: The customer or offer resource was not found.
461
478
  # * ALREADY_EXISTS: The SKU was already transferred for the customer.
@@ -648,12 +665,12 @@ module Google
648
665
  # * The new config will not modify exports used with other configs.
649
666
  # Changes to the config may be immediate, but may take up to 24 hours.
650
667
  # * There is a limit of ten configs for any
651
- # [RepricingConfig.EntitlementGranularity.entitlement][google.cloud.channel.v1.RepricingConfig.EntitlementGranularity.entitlement]
652
- # or
668
+ # [RepricingConfig.EntitlementGranularity.entitlement][google.cloud.channel.v1.RepricingConfig.EntitlementGranularity.entitlement],
669
+ # for any
653
670
  # [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month].
654
671
  # * The contained
655
672
  # [CustomerRepricingConfig.repricing_config][google.cloud.channel.v1.CustomerRepricingConfig.repricing_config]
656
- # vaule must be different from the value used in the current config for a
673
+ # value must be different from the value used in the current config for a
657
674
  # [RepricingConfig.EntitlementGranularity.entitlement][google.cloud.channel.v1.RepricingConfig.EntitlementGranularity.entitlement].
658
675
  #
659
676
  # Possible Error Codes:
@@ -786,10 +803,12 @@ module Google
786
803
  # * The new config will not modify exports used with other configs.
787
804
  # Changes to the config may be immediate, but may take up to 24 hours.
788
805
  # * There is a limit of ten configs for any ChannelPartner or
806
+ # [RepricingConfig.EntitlementGranularity.entitlement][google.cloud.channel.v1.RepricingConfig.EntitlementGranularity.entitlement],
807
+ # for any
789
808
  # [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month].
790
809
  # * The contained
791
810
  # [ChannelPartnerRepricingConfig.repricing_config][google.cloud.channel.v1.ChannelPartnerRepricingConfig.repricing_config]
792
- # vaule must be different from the value used in the current config for a
811
+ # value must be different from the value used in the current config for a
793
812
  # ChannelPartner.
794
813
  #
795
814
  # Possible Error Codes:
@@ -861,6 +880,46 @@ module Google
861
880
  # [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig]
862
881
  # found for the name in the request.
863
882
  rpc :DeleteChannelPartnerRepricingConfig, ::Google::Cloud::Channel::V1::DeleteChannelPartnerRepricingConfigRequest, ::Google::Protobuf::Empty
883
+ # Lists the Rebilling supported SKU groups the account is authorized to
884
+ # sell.
885
+ # Reference: https://cloud.google.com/skus/sku-groups
886
+ #
887
+ # Possible Error Codes:
888
+ #
889
+ # * PERMISSION_DENIED: If the account making the request and the account
890
+ # being queried are different, or the account doesn't exist.
891
+ # * INTERNAL: Any non-user error related to technical issues in the
892
+ # backend. In this case, contact Cloud Channel support.
893
+ #
894
+ # Return Value:
895
+ # If successful, the [SkuGroup][google.cloud.channel.v1.SkuGroup] resources.
896
+ # The data for each resource is displayed in the alphabetical order of SKU
897
+ # group display name.
898
+ # The data for each resource is displayed in the ascending order of
899
+ # [SkuGroup.display_name][google.cloud.channel.v1.SkuGroup.display_name]
900
+ #
901
+ # If unsuccessful, returns an error.
902
+ rpc :ListSkuGroups, ::Google::Cloud::Channel::V1::ListSkuGroupsRequest, ::Google::Cloud::Channel::V1::ListSkuGroupsResponse
903
+ # Lists the Billable SKUs in a given SKU group.
904
+ #
905
+ # Possible error codes:
906
+ # PERMISSION_DENIED: If the account making the request and the account
907
+ # being queried for are different, or the account doesn't exist.
908
+ # INVALID_ARGUMENT: Missing or invalid required parameters in the
909
+ # request.
910
+ # INTERNAL: Any non-user error related to technical issue in the
911
+ # backend. In this case, contact cloud channel support.
912
+ #
913
+ # Return Value:
914
+ # If successful, the [BillableSku][google.cloud.channel.v1.BillableSku]
915
+ # resources. The data for each resource is displayed in the ascending order
916
+ # of:
917
+ #
918
+ # * [BillableSku.service_display_name][google.cloud.channel.v1.BillableSku.service_display_name]
919
+ # * [BillableSku.sku_display_name][google.cloud.channel.v1.BillableSku.sku_display_name]
920
+ #
921
+ # If unsuccessful, returns an error.
922
+ rpc :ListSkuGroupBillableSkus, ::Google::Cloud::Channel::V1::ListSkuGroupBillableSkusRequest, ::Google::Cloud::Channel::V1::ListSkuGroupBillableSkusResponse
864
923
  # Returns the requested [Offer][google.cloud.channel.v1.Offer] resource.
865
924
  #
866
925
  # Possible error codes:
@@ -907,9 +966,25 @@ module Google
907
966
  #
908
967
  # Possible error codes:
909
968
  #
910
- # * PERMISSION_DENIED: The customer doesn't belong to the reseller
969
+ # * PERMISSION_DENIED:
970
+ # * The customer doesn't belong to the reseller
971
+ # * The reseller is not authorized to transact on this Product. See
972
+ # https://support.google.com/channelservices/answer/9759265
911
973
  # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
912
974
  rpc :ListPurchasableOffers, ::Google::Cloud::Channel::V1::ListPurchasableOffersRequest, ::Google::Cloud::Channel::V1::ListPurchasableOffersResponse
975
+ # Lists the billing accounts that are eligible to purchase particular SKUs
976
+ # for a given customer.
977
+ #
978
+ # Possible error codes:
979
+ #
980
+ # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
981
+ # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
982
+ #
983
+ # Return value:
984
+ # Based on the provided list of SKUs, returns a list of SKU groups that must
985
+ # be purchased using the same billing account and the billing accounts
986
+ # eligible to purchase each SKU group.
987
+ rpc :QueryEligibleBillingAccounts, ::Google::Cloud::Channel::V1::QueryEligibleBillingAccountsRequest, ::Google::Cloud::Channel::V1::QueryEligibleBillingAccountsResponse
913
988
  # Registers a service account with subscriber privileges on the Cloud Pub/Sub
914
989
  # topic for this Channel Services account. After you create a
915
990
  # subscriber, you get the events through
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Channel
23
23
  module V1
24
- VERSION = "0.20.0"
24
+ VERSION = "0.22.0"
25
25
  end
26
26
  end
27
27
  end
@@ -66,6 +66,20 @@ module Google
66
66
  # a non-empty value will be returned. The user will not be aware of what
67
67
  # non-empty value to expect.
68
68
  NON_EMPTY_DEFAULT = 7
69
+
70
+ # Denotes that the field in a resource (a message annotated with
71
+ # google.api.resource) is used in the resource name to uniquely identify the
72
+ # resource. For AIP-compliant APIs, this should only be applied to the
73
+ # `name` field on the resource.
74
+ #
75
+ # This behavior should not be applied to references to other resources within
76
+ # the message.
77
+ #
78
+ # The identifier field of resources often have different field behavior
79
+ # depending on the request it is embedded in (e.g. for Create methods name
80
+ # is optional and unused, while for Update methods it is required). Instead
81
+ # of method-specific annotations, only `IDENTIFIER` is required.
82
+ IDENTIFIER = 8
69
83
  end
70
84
  end
71
85
  end
@@ -0,0 +1,48 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Cloud
22
+ module Channel
23
+ module V1
24
+ # Represents a billing account.
25
+ # @!attribute [r] name
26
+ # @return [::String]
27
+ # Output only. Resource name of the billing account.
28
+ # Format: accounts/\\{account_id}/billingAccounts/\\{billing_account_id}.
29
+ # @!attribute [rw] display_name
30
+ # @return [::String]
31
+ # Display name of the billing account.
32
+ # @!attribute [r] create_time
33
+ # @return [::Google::Protobuf::Timestamp]
34
+ # Output only. The time when this billing account was created.
35
+ # @!attribute [r] currency_code
36
+ # @return [::String]
37
+ # Output only. The 3-letter currency code defined in ISO 4217.
38
+ # @!attribute [r] region_code
39
+ # @return [::String]
40
+ # Output only. The CLDR region code.
41
+ class BillingAccount
42
+ include ::Google::Protobuf::MessageExts
43
+ extend ::Google::Protobuf::MessageExts::ClassMethods
44
+ end
45
+ end
46
+ end
47
+ end
48
+ end
@@ -32,9 +32,9 @@ module Google
32
32
  # @!attribute [rw] org_postal_address
33
33
  # @return [::Google::Type::PostalAddress]
34
34
  # Required. The organization address for the customer. To enforce US laws and
35
- # embargoes, we require a region and zip code. You must provide valid
36
- # addresses for every customer. To set the customer's language, use the
37
- # Customer-level language code.
35
+ # embargoes, we require a region, postal code, and address lines. You must
36
+ # provide valid addresses for every customer. To set the customer's
37
+ # language, use the Customer-level language code.
38
38
  # @!attribute [rw] primary_contact_info
39
39
  # @return [::Google::Cloud::Channel::V1::ContactInfo]
40
40
  # Primary contact info.
@@ -161,7 +161,7 @@ module Google
161
161
  # @return [::String]
162
162
  # Output only. Provisioning ID of the entitlement. For Google Workspace, this
163
163
  # is the underlying Subscription ID. For Google Cloud, this is the Billing
164
- # Account ID of the billing subaccount."
164
+ # Account ID of the billing subaccount.
165
165
  # @!attribute [r] product_id
166
166
  # @return [::String]
167
167
  # Output only. The product pertaining to the provisioning resource as
@@ -272,6 +272,10 @@ module Google
272
272
 
273
273
  # SKU subscription is suspended
274
274
  SKU_SUSPENDED = 3
275
+
276
+ # The reseller is not authorized to transact on this Product. See
277
+ # https://support.google.com/channelservices/answer/9759265
278
+ CHANNEL_PARTNER_NOT_AUTHORIZED_FOR_SKU = 4
275
279
  end
276
280
  end
277
281
  end
@@ -104,6 +104,9 @@ module Google
104
104
 
105
105
  # Double type.
106
106
  DOUBLE = 3
107
+
108
+ # Boolean type.
109
+ BOOLEAN = 4
107
110
  end
108
111
  end
109
112
 
@@ -67,12 +67,28 @@ module Google
67
67
  # Configuration for repricing a Google bill over a period of time.
68
68
  # @!attribute [rw] entitlement_granularity
69
69
  # @return [::Google::Cloud::Channel::V1::RepricingConfig::EntitlementGranularity]
70
- # Applies the repricing configuration at the entitlement level. This is
71
- # the only supported value for CustomerRepricingConfig.
70
+ # Applies the repricing configuration at the entitlement level.
71
+ #
72
+ # Note: If a
73
+ # {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}
74
+ # using
75
+ # {::Google::Cloud::Channel::V1::RepricingConfig::EntitlementGranularity RepricingConfig.EntitlementGranularity}
76
+ # becomes effective, then no existing or future
77
+ # {::Google::Cloud::Channel::V1::RepricingConfig::ChannelPartnerGranularity RepricingConfig.ChannelPartnerGranularity}
78
+ # will apply to the
79
+ # {::Google::Cloud::Channel::V1::RepricingConfig::EntitlementGranularity#entitlement RepricingConfig.EntitlementGranularity.entitlement}.
80
+ # This is the recommended value for both
81
+ # {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig}
82
+ # and
83
+ # {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}.
72
84
  # @!attribute [rw] channel_partner_granularity
73
85
  # @return [::Google::Cloud::Channel::V1::RepricingConfig::ChannelPartnerGranularity]
74
86
  # Applies the repricing configuration at the channel partner level.
75
- # This is the only supported value for ChannelPartnerRepricingConfig.
87
+ # Only
88
+ # {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}
89
+ # supports this value. Deprecated: This is no longer supported. Use
90
+ # {::Google::Cloud::Channel::V1::RepricingConfig#entitlement_granularity RepricingConfig.entitlement_granularity}
91
+ # instead.
76
92
  # @!attribute [rw] effective_invoice_month
77
93
  # @return [::Google::Type::Date]
78
94
  # Required. The YearMonth when these adjustments activate. The Day field
@@ -108,6 +124,9 @@ module Google
108
124
  # Applies the repricing configuration at the channel partner level.
109
125
  # The channel partner value is derived from the resource name. Takes an
110
126
  # empty json object.
127
+ # Deprecated: This is no longer supported. Use
128
+ # {::Google::Cloud::Channel::V1::RepricingConfig::EntitlementGranularity RepricingConfig.EntitlementGranularity}
129
+ # instead.
111
130
  class ChannelPartnerGranularity
112
131
  include ::Google::Protobuf::MessageExts
113
132
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -359,6 +359,13 @@ module Google
359
359
  # Optional. The BCP-47 language code. For example, "en-US". The
360
360
  # response will localize in the corresponding language code, if specified.
361
361
  # The default value is "en-US".
362
+ # @!attribute [rw] billing_account
363
+ # @return [::String]
364
+ # Optional. The Billing Account to look up Offers for. Format:
365
+ # accounts/\\{account_id}/billingAccounts/\\{billing_account_id}.
366
+ #
367
+ # This field is only relevant for multi-currency accounts. It should be left
368
+ # empty for single currency accounts.
362
369
  class ListTransferableOffersRequest
363
370
  include ::Google::Protobuf::MessageExts
364
371
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -701,6 +708,118 @@ module Google
701
708
  extend ::Google::Protobuf::MessageExts::ClassMethods
702
709
  end
703
710
 
711
+ # Request message for ListSkuGroups.
712
+ # @!attribute [rw] parent
713
+ # @return [::String]
714
+ # Required. The resource name of the account from which to list SKU groups.
715
+ # Parent uses the format: accounts/\\{account}.
716
+ # @!attribute [rw] page_size
717
+ # @return [::Integer]
718
+ # Optional. The maximum number of SKU groups to return. The service may
719
+ # return fewer than this value. If unspecified, returns a maximum of 1000 SKU
720
+ # groups. The maximum value is 1000; values above 1000 will be coerced to
721
+ # 1000.
722
+ # @!attribute [rw] page_token
723
+ # @return [::String]
724
+ # Optional. A token identifying a page of results beyond the first page.
725
+ # Obtained through
726
+ # [ListSkuGroups.next_page_token][] of the previous
727
+ # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_sku_groups CloudChannelService.ListSkuGroups}
728
+ # call.
729
+ class ListSkuGroupsRequest
730
+ include ::Google::Protobuf::MessageExts
731
+ extend ::Google::Protobuf::MessageExts::ClassMethods
732
+ end
733
+
734
+ # Request message for ListSkuGroupBillableSkus.
735
+ # @!attribute [rw] parent
736
+ # @return [::String]
737
+ # Required. Resource name of the SKU group.
738
+ # Format: accounts/\\{account}/skuGroups/\\{sku_group}.
739
+ # @!attribute [rw] page_size
740
+ # @return [::Integer]
741
+ # Optional. The maximum number of SKUs to return. The service may return
742
+ # fewer than this value. If unspecified, returns a maximum of 100000 SKUs.
743
+ # The maximum value is 100000; values above 100000 will be coerced to 100000.
744
+ # @!attribute [rw] page_token
745
+ # @return [::String]
746
+ # Optional. A token identifying a page of results beyond the first page.
747
+ # Obtained through
748
+ # [ListSkuGroupBillableSkus.next_page_token][] of the previous
749
+ # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_sku_group_billable_skus CloudChannelService.ListSkuGroupBillableSkus}
750
+ # call.
751
+ class ListSkuGroupBillableSkusRequest
752
+ include ::Google::Protobuf::MessageExts
753
+ extend ::Google::Protobuf::MessageExts::ClassMethods
754
+ end
755
+
756
+ # Response message for ListSkuGroups.
757
+ # @!attribute [rw] sku_groups
758
+ # @return [::Array<::Google::Cloud::Channel::V1::SkuGroup>]
759
+ # The list of SKU groups requested.
760
+ # @!attribute [rw] next_page_token
761
+ # @return [::String]
762
+ # A token to retrieve the next page of results.
763
+ # Pass to [ListSkuGroups.page_token][] to obtain that
764
+ # page.
765
+ class ListSkuGroupsResponse
766
+ include ::Google::Protobuf::MessageExts
767
+ extend ::Google::Protobuf::MessageExts::ClassMethods
768
+ end
769
+
770
+ # Response message for ListSkuGroupBillableSkus.
771
+ # @!attribute [rw] billable_skus
772
+ # @return [::Array<::Google::Cloud::Channel::V1::BillableSku>]
773
+ # The list of billable SKUs in the requested SKU group.
774
+ # @!attribute [rw] next_page_token
775
+ # @return [::String]
776
+ # A token to retrieve the next page of results.
777
+ # Pass to [ListSkuGroupBillableSkus.page_token][] to obtain that
778
+ # page.
779
+ class ListSkuGroupBillableSkusResponse
780
+ include ::Google::Protobuf::MessageExts
781
+ extend ::Google::Protobuf::MessageExts::ClassMethods
782
+ end
783
+
784
+ # Represents the SKU group information.
785
+ # @!attribute [rw] name
786
+ # @return [::String]
787
+ # Resource name of SKU group. Format:
788
+ # accounts/\\{account}/skuGroups/\\{sku_group}.
789
+ # Example:
790
+ # "accounts/C01234/skuGroups/3d50fd57-3157-4577-a5a9-a219b8490041".
791
+ # @!attribute [rw] display_name
792
+ # @return [::String]
793
+ # Unique human readable identifier for the SKU group.
794
+ class SkuGroup
795
+ include ::Google::Protobuf::MessageExts
796
+ extend ::Google::Protobuf::MessageExts::ClassMethods
797
+ end
798
+
799
+ # Represents the Billable SKU information.
800
+ # @!attribute [rw] sku
801
+ # @return [::String]
802
+ # Resource name of Billable SKU. Format:
803
+ # billableSkus/\\{sku}.
804
+ # Example:
805
+ # billableSkus/6E1B-6634-470F".
806
+ # @!attribute [rw] sku_display_name
807
+ # @return [::String]
808
+ # Unique human readable name for the SKU.
809
+ # @!attribute [rw] service
810
+ # @return [::String]
811
+ # Resource name of Service which contains Repricing SKU. Format:
812
+ # services/\\{service}.
813
+ # Example:
814
+ # "services/B7D9-FDCB-15D8".
815
+ # @!attribute [rw] service_display_name
816
+ # @return [::String]
817
+ # Unique human readable name for the Service.
818
+ class BillableSku
819
+ include ::Google::Protobuf::MessageExts
820
+ extend ::Google::Protobuf::MessageExts::ClassMethods
821
+ end
822
+
704
823
  # Request message for
705
824
  # {::Google::Cloud::Channel::V1::CloudChannelService::Client#create_entitlement CloudChannelService.CreateEntitlement}
706
825
  # @!attribute [rw] parent
@@ -904,6 +1023,13 @@ module Google
904
1023
  # The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
905
1024
  # with the exception that zero UUID is not supported
906
1025
  # (`00000000-0000-0000-0000-000000000000`).
1026
+ # @!attribute [rw] billing_account
1027
+ # @return [::String]
1028
+ # Optional. The billing account resource name that is used to pay for this
1029
+ # entitlement when setting up billing on a trial subscription.
1030
+ #
1031
+ # This field is only relevant for multi-currency accounts. It should be
1032
+ # left empty for single currency accounts.
907
1033
  class ChangeOfferRequest
908
1034
  include ::Google::Protobuf::MessageExts
909
1035
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1272,6 +1398,10 @@ module Google
1272
1398
  # @return [::String]
1273
1399
  # Required. SKU that the result should be restricted to.
1274
1400
  # Format: products/\\{product_id}/skus/\\{sku_id}.
1401
+ # @!attribute [rw] billing_account
1402
+ # @return [::String]
1403
+ # Optional. Billing account that the result should be restricted to.
1404
+ # Format: accounts/\\{account_id}/billingAccounts/\\{billing_account_id}.
1275
1405
  class CreateEntitlementPurchase
1276
1406
  include ::Google::Protobuf::MessageExts
1277
1407
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1288,6 +1418,14 @@ module Google
1288
1418
  # Optional. Resource name of the new target SKU. Provide this SKU when
1289
1419
  # upgrading or downgrading an entitlement. Format:
1290
1420
  # products/\\{product_id}/skus/\\{sku_id}
1421
+ # @!attribute [rw] billing_account
1422
+ # @return [::String]
1423
+ # Optional. Resource name of the new target Billing Account. Provide this
1424
+ # Billing Account when setting up billing for a trial subscription. Format:
1425
+ # accounts/\\{account_id}/billingAccounts/\\{billing_account_id}.
1426
+ #
1427
+ # This field is only relevant for multi-currency accounts. It should be
1428
+ # left empty for single currency accounts.
1291
1429
  class ChangeOfferPurchase
1292
1430
  include ::Google::Protobuf::MessageExts
1293
1431
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1316,6 +1454,55 @@ module Google
1316
1454
  extend ::Google::Protobuf::MessageExts::ClassMethods
1317
1455
  end
1318
1456
 
1457
+ # Request message for QueryEligibleBillingAccounts.
1458
+ # @!attribute [rw] customer
1459
+ # @return [::String]
1460
+ # Required. The resource name of the customer to list eligible billing
1461
+ # accounts for. Format: accounts/\\{account_id}/customers/\\{customer_id}.
1462
+ # @!attribute [rw] skus
1463
+ # @return [::Array<::String>]
1464
+ # Required. List of SKUs to list eligible billing accounts for. At least one
1465
+ # SKU is required. Format: products/\\{product_id}/skus/\\{sku_id}.
1466
+ class QueryEligibleBillingAccountsRequest
1467
+ include ::Google::Protobuf::MessageExts
1468
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1469
+ end
1470
+
1471
+ # Response message for QueryEligibleBillingAccounts.
1472
+ # @!attribute [rw] sku_purchase_groups
1473
+ # @return [::Array<::Google::Cloud::Channel::V1::SkuPurchaseGroup>]
1474
+ # List of SKU purchase groups where each group represents a set of SKUs that
1475
+ # must be purchased using the same billing account. Each SKU from
1476
+ # [QueryEligibleBillingAccountsRequest.skus] will appear in exactly one SKU
1477
+ # group.
1478
+ class QueryEligibleBillingAccountsResponse
1479
+ include ::Google::Protobuf::MessageExts
1480
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1481
+ end
1482
+
1483
+ # Represents a set of SKUs that must be purchased using the same billing
1484
+ # account.
1485
+ # @!attribute [rw] skus
1486
+ # @return [::Array<::String>]
1487
+ # Resource names of the SKUs included in this group.
1488
+ # Format: products/\\{product_id}/skus/\\{sku_id}.
1489
+ # @!attribute [rw] billing_account_purchase_infos
1490
+ # @return [::Array<::Google::Cloud::Channel::V1::BillingAccountPurchaseInfo>]
1491
+ # List of billing accounts that are eligible to purhcase these SKUs.
1492
+ class SkuPurchaseGroup
1493
+ include ::Google::Protobuf::MessageExts
1494
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1495
+ end
1496
+
1497
+ # Represents a billing account that can be used to make a purchase.
1498
+ # @!attribute [rw] billing_account
1499
+ # @return [::Google::Cloud::Channel::V1::BillingAccount]
1500
+ # The billing account resource.
1501
+ class BillingAccountPurchaseInfo
1502
+ include ::Google::Protobuf::MessageExts
1503
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1504
+ end
1505
+
1319
1506
  # Request Message for RegisterSubscriber.
1320
1507
  # @!attribute [rw] account
1321
1508
  # @return [::String]
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-channel-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.20.0
4
+ version: 0.22.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-06-06 00:00:00.000000000 Z
11
+ date: 2023-09-12 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: 0.19.1
19
+ version: 0.20.0
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: 0.19.1
29
+ version: 0.20.0
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -173,6 +173,7 @@ files:
173
173
  - README.md
174
174
  - lib/google-cloud-channel-v1.rb
175
175
  - lib/google/cloud/channel/v1.rb
176
+ - lib/google/cloud/channel/v1/billing_accounts_pb.rb
176
177
  - lib/google/cloud/channel/v1/channel_partner_links_pb.rb
177
178
  - lib/google/cloud/channel/v1/cloud_channel_reports_service.rb
178
179
  - lib/google/cloud/channel/v1/cloud_channel_reports_service/client.rb
@@ -212,6 +213,7 @@ files:
212
213
  - proto_docs/google/api/field_behavior.rb
213
214
  - proto_docs/google/api/launch_stage.rb
214
215
  - proto_docs/google/api/resource.rb
216
+ - proto_docs/google/cloud/channel/v1/billing_accounts.rb
215
217
  - proto_docs/google/cloud/channel/v1/channel_partner_links.rb
216
218
  - proto_docs/google/cloud/channel/v1/common.rb
217
219
  - proto_docs/google/cloud/channel/v1/customers.rb
@@ -255,7 +257,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
255
257
  - !ruby/object:Gem::Version
256
258
  version: '0'
257
259
  requirements: []
258
- rubygems_version: 3.4.2
260
+ rubygems_version: 3.4.19
259
261
  signing_key:
260
262
  specification_version: 4
261
263
  summary: The Cloud Channel API enables Google Cloud partners to have a single unified