google-cloud-channel-v1 0.20.0 → 0.22.0

Sign up to get free protection for your applications and to get access to all the features.
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