google-cloud-channel-v1 0.21.0 → 0.22.1

data/lib/google/cloud/channel/v1/service_services_pb.rb

@@ -103,8 +103,11 @@ module Google
             #
             # Possible error codes:
             #
-            # * PERMISSION_DENIED: The reseller account making the request is different
-            # from the reseller account in the API request.
+            # * PERMISSION_DENIED:
+            #     * The reseller account making the request is different from the
+            #     reseller account in the API request.
+            #     * You are not authorized to create a customer. See
+            #     https://support.google.com/channelservices/answer/9759265
             # * INVALID_ARGUMENT:
             #     * Required request parameters are missing or invalid.
             #     * Domain field value doesn't match the primary email domain.
@@ -144,8 +147,11 @@ module Google
             #
             # Possible error codes:
             #
-            # * PERMISSION_DENIED: The reseller account making the request is different
-            # from the reseller account in the API request.
+            # * PERMISSION_DENIED:
+            #     * The reseller account making the request is different from the
+            #     reseller account in the API request.
+            #     * You are not authorized to import the customer. See
+            #     https://support.google.com/channelservices/answer/9759265
             # * NOT_FOUND: Cloud Identity doesn't exist or was deleted.
             # * INVALID_ARGUMENT: Required parameters are missing, or the auth_token is
             # expired or invalid.
@@ -160,7 +166,10 @@ module Google
             #
             # Possible error codes:
             #
-            # *  PERMISSION_DENIED: The customer doesn't belong to the reseller.
+            # *  PERMISSION_DENIED:
+            #      * The customer doesn't belong to the reseller.
+            #      * You are not authorized to provision cloud identity id. See
+            #      https://support.google.com/channelservices/answer/9759265
             # *  INVALID_ARGUMENT: Required request parameters are missing or invalid.
             # *  NOT_FOUND: The customer was not found.
             # *  ALREADY_EXISTS: The customer's primary email already exists. Retry
@@ -224,6 +233,8 @@ module Google
             #     auth token.
             #     * The reseller account making the request is different
             #     from the reseller account in the query.
+            #     * The reseller is not authorized to transact on this Product. See
+            #     https://support.google.com/channelservices/answer/9759265
             # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             #
             # Return value:
@@ -246,7 +257,10 @@ module Google
             #
             # Possible error codes:
             #
-            # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+            # * PERMISSION_DENIED:
+            #     * The customer doesn't belong to the reseller.
+            #     * The reseller is not authorized to transact on this Product. See
+            #     https://support.google.com/channelservices/answer/9759265
             # * INVALID_ARGUMENT:
             #     * Required request parameters are missing or invalid.
             #     * There is already a customer entitlement for a SKU from the same
@@ -455,7 +469,10 @@ module Google
             #
             # Possible error codes:
             #
-            # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+            # * PERMISSION_DENIED:
+            #     * The customer doesn't belong to the reseller.
+            #     * The reseller is not authorized to transact on this Product. See
+            #     https://support.google.com/channelservices/answer/9759265
             # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             # * NOT_FOUND: The customer or offer resource was not found.
             # * ALREADY_EXISTS: The SKU was already transferred for the customer.
@@ -648,12 +665,12 @@ module Google
             # * The new config will not modify exports used with other configs.
             # Changes to the config may be immediate, but may take up to 24 hours.
             # * There is a limit of ten configs for any
-            # [RepricingConfig.EntitlementGranularity.entitlement][google.cloud.channel.v1.RepricingConfig.EntitlementGranularity.entitlement]
-            # or
+            # [RepricingConfig.EntitlementGranularity.entitlement][google.cloud.channel.v1.RepricingConfig.EntitlementGranularity.entitlement],
+            # for any
             # [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month].
             # * The contained
             # [CustomerRepricingConfig.repricing_config][google.cloud.channel.v1.CustomerRepricingConfig.repricing_config]
-            # vaule must be different from the value used in the current config for a
+            # value must be different from the value used in the current config for a
             # [RepricingConfig.EntitlementGranularity.entitlement][google.cloud.channel.v1.RepricingConfig.EntitlementGranularity.entitlement].
             #
             # Possible Error Codes:
@@ -786,10 +803,12 @@ module Google
             # * The new config will not modify exports used with other configs.
             # Changes to the config may be immediate, but may take up to 24 hours.
             # * There is a limit of ten configs for any ChannelPartner or
+            # [RepricingConfig.EntitlementGranularity.entitlement][google.cloud.channel.v1.RepricingConfig.EntitlementGranularity.entitlement],
+            # for any
             # [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month].
             # * The contained
             # [ChannelPartnerRepricingConfig.repricing_config][google.cloud.channel.v1.ChannelPartnerRepricingConfig.repricing_config]
-            # vaule must be different from the value used in the current config for a
+            # value must be different from the value used in the current config for a
             # ChannelPartner.
             #
             # Possible Error Codes:
@@ -947,9 +966,25 @@ module Google
             #
             # Possible error codes:
             #
-            # * PERMISSION_DENIED: The customer doesn't belong to the reseller
+            # * PERMISSION_DENIED:
+            #     * The customer doesn't belong to the reseller
+            #     * The reseller is not authorized to transact on this Product. See
+            #     https://support.google.com/channelservices/answer/9759265
             # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             rpc :ListPurchasableOffers, ::Google::Cloud::Channel::V1::ListPurchasableOffersRequest, ::Google::Cloud::Channel::V1::ListPurchasableOffersResponse
+            # Lists the billing accounts that are eligible to purchase particular SKUs
+            # for a given customer.
+            #
+            # Possible error codes:
+            #
+            # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+            #
+            # Return value:
+            # Based on the provided list of SKUs, returns a list of SKU groups that must
+            # be purchased using the same billing account and the billing accounts
+            # eligible to purchase each SKU group.
+            rpc :QueryEligibleBillingAccounts, ::Google::Cloud::Channel::V1::QueryEligibleBillingAccountsRequest, ::Google::Cloud::Channel::V1::QueryEligibleBillingAccountsResponse
             # Registers a service account with subscriber privileges on the Cloud Pub/Sub
             # topic for this Channel Services account. After you create a
             # subscriber, you get the events through

data/lib/google/cloud/channel/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Channel
       module V1
-        VERSION = "0.21.0"
+        VERSION = "0.22.1"
       end
     end
   end

data/proto_docs/google/api/client.rb

@@ -304,6 +304,19 @@ module Google
     #                seconds: 360 # 6 minutes
     #              total_poll_timeout:
     #                 seconds: 54000 # 90 minutes
+    # @!attribute [rw] auto_populated_fields
+    #   @return [::Array<::String>]
+    #     List of top-level fields of the request message, that should be
+    #     automatically populated by the client libraries based on their
+    #     (google.api.field_info).format. Currently supported format: UUID4.
+    #
+    #     Example of a YAML configuration:
+    #
+    #      publishing:
+    #        method_settings:
+    #          - selector: google.example.v1.ExampleService.CreateExample
+    #            auto_populated_fields:
+    #            - request_id
     class MethodSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/api/field_behavior.rb

@@ -66,6 +66,20 @@ module Google
       # a non-empty value will be returned. The user will not be aware of what
       # non-empty value to expect.
       NON_EMPTY_DEFAULT = 7
+
+      # Denotes that the field in a resource (a message annotated with
+      # google.api.resource) is used in the resource name to uniquely identify the
+      # resource. For AIP-compliant APIs, this should only be applied to the
+      # `name` field on the resource.
+      #
+      # This behavior should not be applied to references to other resources within
+      # the message.
+      #
+      # The identifier field of resources often have different field behavior
+      # depending on the request it is embedded in (e.g. for Create methods name
+      # is optional and unused, while for Update methods it is required). Instead
+      # of method-specific annotations, only `IDENTIFIER` is required.
+      IDENTIFIER = 8
     end
   end
 end

data/proto_docs/google/cloud/channel/v1/billing_accounts.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Channel
+      module V1
+        # Represents a billing account.
+        # @!attribute [r] name
+        #   @return [::String]
+        #     Output only. Resource name of the billing account.
+        #     Format: accounts/\\{account_id}/billingAccounts/\\{billing_account_id}.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Display name of the billing account.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time when this billing account was created.
+        # @!attribute [r] currency_code
+        #   @return [::String]
+        #     Output only. The 3-letter currency code defined in ISO 4217.
+        # @!attribute [r] region_code
+        #   @return [::String]
+        #     Output only. The CLDR region code.
+        class BillingAccount
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/channel/v1/customers.rb

@@ -32,9 +32,9 @@ module Google
         # @!attribute [rw] org_postal_address
         #   @return [::Google::Type::PostalAddress]
         #     Required. The organization address for the customer. To enforce US laws and
-        #     embargoes, we require a region and zip code. You must provide valid
-        #     addresses for every customer. To set the customer's language, use the
-        #     Customer-level language code.
+        #     embargoes, we require a region, postal code, and address lines. You must
+        #     provide valid addresses for every customer. To set the customer's
+        #     language, use the Customer-level language code.
         # @!attribute [rw] primary_contact_info
         #   @return [::Google::Cloud::Channel::V1::ContactInfo]
         #     Primary contact info.

data/proto_docs/google/cloud/channel/v1/entitlements.rb

@@ -161,7 +161,7 @@ module Google
         #   @return [::String]
         #     Output only. Provisioning ID of the entitlement. For Google Workspace, this
         #     is the underlying Subscription ID. For Google Cloud, this is the Billing
-        #     Account ID of the billing subaccount."
+        #     Account ID of the billing subaccount.
         # @!attribute [r] product_id
         #   @return [::String]
         #     Output only. The product pertaining to the provisioning resource as
@@ -272,6 +272,10 @@ module Google
 
             # SKU subscription is suspended
             SKU_SUSPENDED = 3
+
+            # The reseller is not authorized to transact on this Product. See
+            # https://support.google.com/channelservices/answer/9759265
+            CHANNEL_PARTNER_NOT_AUTHORIZED_FOR_SKU = 4
           end
         end
       end

data/proto_docs/google/cloud/channel/v1/offers.rb

@@ -104,6 +104,9 @@ module Google
 
             # Double type.
             DOUBLE = 3
+
+            # Boolean type.
+            BOOLEAN = 4
           end
         end
 

data/proto_docs/google/cloud/channel/v1/repricing.rb

@@ -67,12 +67,28 @@ module Google
         # Configuration for repricing a Google bill over a period of time.
         # @!attribute [rw] entitlement_granularity
         #   @return [::Google::Cloud::Channel::V1::RepricingConfig::EntitlementGranularity]
-        #     Applies the repricing configuration at the entitlement level. This is
-        #     the only supported value for CustomerRepricingConfig.
+        #     Applies the repricing configuration at the entitlement level.
+        #
+        #     Note: If a
+        #     {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}
+        #     using
+        #     {::Google::Cloud::Channel::V1::RepricingConfig::EntitlementGranularity RepricingConfig.EntitlementGranularity}
+        #     becomes effective, then no existing or future
+        #     {::Google::Cloud::Channel::V1::RepricingConfig::ChannelPartnerGranularity RepricingConfig.ChannelPartnerGranularity}
+        #     will apply to the
+        #     {::Google::Cloud::Channel::V1::RepricingConfig::EntitlementGranularity#entitlement RepricingConfig.EntitlementGranularity.entitlement}.
+        #     This is the recommended value for both
+        #     {::Google::Cloud::Channel::V1::CustomerRepricingConfig CustomerRepricingConfig}
+        #     and
+        #     {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}.
         # @!attribute [rw] channel_partner_granularity
         #   @return [::Google::Cloud::Channel::V1::RepricingConfig::ChannelPartnerGranularity]
         #     Applies the repricing configuration at the channel partner level.
-        #     This is the only supported value for ChannelPartnerRepricingConfig.
+        #     Only
+        #     {::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig ChannelPartnerRepricingConfig}
+        #     supports this value. Deprecated: This is no longer supported. Use
+        #     {::Google::Cloud::Channel::V1::RepricingConfig#entitlement_granularity RepricingConfig.entitlement_granularity}
+        #     instead.
         # @!attribute [rw] effective_invoice_month
         #   @return [::Google::Type::Date]
         #     Required. The YearMonth when these adjustments activate. The Day field
@@ -108,6 +124,9 @@ module Google
           # Applies the repricing configuration at the channel partner level.
           # The channel partner value is derived from the resource name. Takes an
           # empty json object.
+          # Deprecated: This is no longer supported. Use
+          # {::Google::Cloud::Channel::V1::RepricingConfig::EntitlementGranularity RepricingConfig.EntitlementGranularity}
+          # instead.
           class ChannelPartnerGranularity
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/channel/v1/service.rb

@@ -359,6 +359,13 @@ module Google
         #     Optional. The BCP-47 language code. For example, "en-US". The
         #     response will localize in the corresponding language code, if specified.
         #     The default value is "en-US".
+        # @!attribute [rw] billing_account
+        #   @return [::String]
+        #     Optional. The Billing Account to look up Offers for. Format:
+        #     accounts/\\{account_id}/billingAccounts/\\{billing_account_id}.
+        #
+        #     This field is only relevant for multi-currency accounts. It should be left
+        #     empty for single currency accounts.
         class ListTransferableOffersRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1016,6 +1023,13 @@ module Google
         #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
         #     with the exception that zero UUID is not supported
         #     (`00000000-0000-0000-0000-000000000000`).
+        # @!attribute [rw] billing_account
+        #   @return [::String]
+        #     Optional. The billing account resource name that is used to pay for this
+        #     entitlement when setting up billing on a trial subscription.
+        #
+        #     This field is only relevant for multi-currency accounts. It should be
+        #     left empty for single currency accounts.
         class ChangeOfferRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1384,6 +1398,10 @@ module Google
           #   @return [::String]
           #     Required. SKU that the result should be restricted to.
           #     Format: products/\\{product_id}/skus/\\{sku_id}.
+          # @!attribute [rw] billing_account
+          #   @return [::String]
+          #     Optional. Billing account that the result should be restricted to.
+          #     Format: accounts/\\{account_id}/billingAccounts/\\{billing_account_id}.
           class CreateEntitlementPurchase
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1400,6 +1418,14 @@ module Google
           #     Optional. Resource name of the new target SKU. Provide this SKU when
           #     upgrading or downgrading an entitlement. Format:
           #     products/\\{product_id}/skus/\\{sku_id}
+          # @!attribute [rw] billing_account
+          #   @return [::String]
+          #     Optional. Resource name of the new target Billing Account. Provide this
+          #     Billing Account when setting up billing for a trial subscription. Format:
+          #     accounts/\\{account_id}/billingAccounts/\\{billing_account_id}.
+          #
+          #     This field is only relevant for multi-currency accounts. It should be
+          #     left empty for single currency accounts.
           class ChangeOfferPurchase
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1428,6 +1454,55 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for QueryEligibleBillingAccounts.
+        # @!attribute [rw] customer
+        #   @return [::String]
+        #     Required. The resource name of the customer to list eligible billing
+        #     accounts for. Format: accounts/\\{account_id}/customers/\\{customer_id}.
+        # @!attribute [rw] skus
+        #   @return [::Array<::String>]
+        #     Required. List of SKUs to list eligible billing accounts for. At least one
+        #     SKU is required. Format: products/\\{product_id}/skus/\\{sku_id}.
+        class QueryEligibleBillingAccountsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for QueryEligibleBillingAccounts.
+        # @!attribute [rw] sku_purchase_groups
+        #   @return [::Array<::Google::Cloud::Channel::V1::SkuPurchaseGroup>]
+        #     List of SKU purchase groups where each group represents a set of SKUs that
+        #     must be purchased using the same billing account. Each SKU from
+        #     [QueryEligibleBillingAccountsRequest.skus] will appear in exactly one SKU
+        #     group.
+        class QueryEligibleBillingAccountsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Represents a set of SKUs that must be purchased using the same billing
+        # account.
+        # @!attribute [rw] skus
+        #   @return [::Array<::String>]
+        #     Resource names of the SKUs included in this group.
+        #     Format: products/\\{product_id}/skus/\\{sku_id}.
+        # @!attribute [rw] billing_account_purchase_infos
+        #   @return [::Array<::Google::Cloud::Channel::V1::BillingAccountPurchaseInfo>]
+        #     List of billing accounts that are eligible to purhcase these SKUs.
+        class SkuPurchaseGroup
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Represents a billing account that can be used to make a purchase.
+        # @!attribute [rw] billing_account
+        #   @return [::Google::Cloud::Channel::V1::BillingAccount]
+        #     The billing account resource.
+        class BillingAccountPurchaseInfo
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request Message for RegisterSubscriber.
         # @!attribute [rw] account
         #   @return [::String]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-channel-v1
 version: !ruby/object:Gem::Version
-  version: 0.21.0
+  version: 0.22.1
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-16 00:00:00.000000000 Z
+date: 2024-01-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -173,6 +173,7 @@ files:
 - README.md
 - lib/google-cloud-channel-v1.rb
 - lib/google/cloud/channel/v1.rb
+- lib/google/cloud/channel/v1/billing_accounts_pb.rb
 - lib/google/cloud/channel/v1/channel_partner_links_pb.rb
 - lib/google/cloud/channel/v1/cloud_channel_reports_service.rb
 - lib/google/cloud/channel/v1/cloud_channel_reports_service/client.rb
@@ -212,6 +213,7 @@ files:
 - proto_docs/google/api/field_behavior.rb
 - proto_docs/google/api/launch_stage.rb
 - proto_docs/google/api/resource.rb
+- proto_docs/google/cloud/channel/v1/billing_accounts.rb
 - proto_docs/google/cloud/channel/v1/channel_partner_links.rb
 - proto_docs/google/cloud/channel/v1/common.rb
 - proto_docs/google/cloud/channel/v1/customers.rb
@@ -255,7 +257,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.2
+rubygems_version: 3.5.3
 signing_key: 
 specification_version: 4
 summary: The Cloud Channel API enables Google Cloud partners to have a single unified