google-cloud-channel-v1 0.6.0 → 0.8.0

data/lib/google/cloud/channel/v1/cloud_channel_service/operations.rb

@@ -82,7 +82,7 @@ module Google
               # Create credentials
               credentials = @config.credentials
               credentials ||= Credentials.default scope: @config.scope
-              if credentials.is_a?(String) || credentials.is_a?(Hash)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -169,7 +169,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.list_operations.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_operations.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :list_operations, request, options: options do |response, operation|
@@ -239,7 +241,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.get_operation.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_operation.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
@@ -309,7 +313,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.delete_operation.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_operation.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
@@ -384,7 +390,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.cancel_operation.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.cancel_operation.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
@@ -396,9 +404,9 @@ module Google
             end
 
             ##
-            # Waits for the specified long-running operation until it is done or reaches
-            # at most a specified timeout, returning the latest state.  If the operation
-            # is already done, the latest state is immediately returned.  If the timeout
+            # Waits until the specified long-running operation is done or reaches at most
+            # a specified timeout, returning the latest state.  If the operation is
+            # already done, the latest state is immediately returned.  If the timeout
             # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
             # timeout is used.  If the server does not support this method, it returns
             # `google.rpc.Code.UNIMPLEMENTED`.
@@ -456,7 +464,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.wait_operation.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.wait_operation.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
@@ -481,22 +491,21 @@ module Google
             # Configuration can be applied globally to all clients, or to a single client
             # on construction.
             #
-            # # Examples
-            #
-            # To modify the global config, setting the timeout for list_operations
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
-            #
-            #     ::Google::Longrunning::Operations::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_operations.timeout = 20.0
-            #     end
-            #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Longrunning::Operations::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_operations.timeout = 20.0
-            #     end
+            # @example
+            #
+            #   # Modify the global config, setting the timeout for
+            #   # list_operations to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Longrunning::Operations::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_operations.timeout = 20.0
+            #   end
+            #
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Longrunning::Operations::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_operations.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.

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

@@ -54,6 +54,17 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.channel.v1.DeleteCustomerRequest" do
       optional :name, :string, 1
     end
+    add_message "google.cloud.channel.v1.ImportCustomerRequest" do
+      optional :parent, :string, 1
+      optional :auth_token, :string, 4
+      optional :overwrite_if_exists, :bool, 5
+      optional :channel_partner_id, :string, 6
+      optional :customer, :string, 7
+      oneof :customer_identity do
+        optional :domain, :string, 2
+        optional :cloud_identity_id, :string, 3
+      end
+    end
     add_message "google.cloud.channel.v1.ProvisionCloudIdentityRequest" do
       optional :customer, :string, 1
       optional :cloud_identity_info, :message, 2, "google.cloud.channel.v1.CloudIdentityInfo"
@@ -181,6 +192,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :name, :string, 1
       optional :request_id, :string, 3
     end
+    add_message "google.cloud.channel.v1.LookupOfferRequest" do
+      optional :entitlement, :string, 1
+    end
     add_message "google.cloud.channel.v1.ListProductsRequest" do
       optional :account, :string, 1
       optional :page_size, :int32, 2
@@ -306,6 +320,7 @@ module Google
         CreateCustomerRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.CreateCustomerRequest").msgclass
         UpdateCustomerRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.UpdateCustomerRequest").msgclass
         DeleteCustomerRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.DeleteCustomerRequest").msgclass
+        ImportCustomerRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ImportCustomerRequest").msgclass
         ProvisionCloudIdentityRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ProvisionCloudIdentityRequest").msgclass
         ListEntitlementsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ListEntitlementsRequest").msgclass
         ListEntitlementsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ListEntitlementsResponse").msgclass
@@ -331,6 +346,7 @@ module Google
         CancelEntitlementRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.CancelEntitlementRequest").msgclass
         SuspendEntitlementRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.SuspendEntitlementRequest").msgclass
         ActivateEntitlementRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ActivateEntitlementRequest").msgclass
+        LookupOfferRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.LookupOfferRequest").msgclass
         ListProductsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ListProductsRequest").msgclass
         ListProductsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ListProductsResponse").msgclass
         ListSkusRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ListSkusRequest").msgclass

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

@@ -62,7 +62,7 @@ module Google
             # Return value:
             # List of [Customer][google.cloud.channel.v1.Customer]s, or an empty list if there are no customers.
             rpc :ListCustomers, ::Google::Cloud::Channel::V1::ListCustomersRequest, ::Google::Cloud::Channel::V1::ListCustomersResponse
-            # Returns a requested [Customer][google.cloud.channel.v1.Customer] resource.
+            # Returns the requested [Customer][google.cloud.channel.v1.Customer] resource.
             #
             # Possible error codes:
             #
@@ -119,7 +119,7 @@ module Google
             # Return value:
             # The updated [Customer][google.cloud.channel.v1.Customer] resource.
             rpc :UpdateCustomer, ::Google::Cloud::Channel::V1::UpdateCustomerRequest, ::Google::Cloud::Channel::V1::Customer
-            # Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently and irreversibly.
+            # Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently.
             #
             # Possible error codes:
             #
@@ -129,6 +129,24 @@ module Google
             # * FAILED_PRECONDITION: The customer has existing entitlements.
             # * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name in the request.
             rpc :DeleteCustomer, ::Google::Cloud::Channel::V1::DeleteCustomerRequest, ::Google::Protobuf::Empty
+            # Imports a [Customer][google.cloud.channel.v1.Customer] from the Cloud Identity associated with the provided
+            # Cloud Identity ID or domain before a TransferEntitlements call. If a
+            # linked Customer already exists and overwrite_if_exists is true, it will
+            # update that Customer's data.
+            #
+            # Possible error codes:
+            #
+            # * PERMISSION_DENIED: The reseller account making the request is different
+            # from the reseller account in the API request.
+            # * NOT_FOUND: Cloud Identity doesn't exist or was deleted.
+            # * INVALID_ARGUMENT: Required parameters are missing, or the auth_token is
+            # expired or invalid.
+            # * ALREADY_EXISTS: A customer already exists and has conflicting critical
+            # fields. Requires an overwrite.
+            #
+            # Return value:
+            # The [Customer][google.cloud.channel.v1.Customer].
+            rpc :ImportCustomer, ::Google::Cloud::Channel::V1::ImportCustomerRequest, ::Google::Cloud::Channel::V1::Customer
             # Creates a Cloud Identity for the given customer using the customer's
             # information, or the information provided here.
             #
@@ -199,7 +217,7 @@ module Google
             # Return value:
             # List of [TransferableOffer][google.cloud.channel.v1.TransferableOffer] for the given customer and SKU.
             rpc :ListTransferableOffers, ::Google::Cloud::Channel::V1::ListTransferableOffersRequest, ::Google::Cloud::Channel::V1::ListTransferableOffersResponse
-            # Returns a requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
+            # Returns the requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
             #
             # Possible error codes:
             #
@@ -491,7 +509,7 @@ module Google
             # Return value:
             # The list of the distributor account's [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources.
             rpc :ListChannelPartnerLinks, ::Google::Cloud::Channel::V1::ListChannelPartnerLinksRequest, ::Google::Cloud::Channel::V1::ListChannelPartnerLinksResponse
-            # Returns a requested [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
+            # Returns the requested [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
             # You must be a distributor to call this method.
             #
             # Possible error codes:
@@ -550,6 +568,17 @@ module Google
             # Return value:
             # The updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
             rpc :UpdateChannelPartnerLink, ::Google::Cloud::Channel::V1::UpdateChannelPartnerLinkRequest, ::Google::Cloud::Channel::V1::ChannelPartnerLink
+            # Returns the requested [Offer][google.cloud.channel.v1.Offer] resource.
+            #
+            # Possible error codes:
+            #
+            # * PERMISSION_DENIED: The entitlement doesn't belong to the reseller.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+            # * NOT_FOUND: Entitlement or offer was not found.
+            #
+            # Return value:
+            # The [Offer][google.cloud.channel.v1.Offer] resource.
+            rpc :LookupOffer, ::Google::Cloud::Channel::V1::LookupOfferRequest, ::Google::Cloud::Channel::V1::Offer
             # Lists the Products the reseller is authorized to sell.
             #
             # Possible error codes:

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

@@ -33,6 +33,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :RENEWAL_SETTING_CHANGED, 10
       value :PAID_SERVICE_STARTED, 11
       value :LICENSE_ASSIGNMENT_CHANGED, 12
+      value :LICENSE_CAP_CHANGED, 13
     end
     add_message "google.cloud.channel.v1.SubscriberEvent" do
       oneof :event do

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Channel
       module V1
-        VERSION = "0.6.0"
+        VERSION = "0.8.0"
       end
     end
   end

data/proto_docs/google/api/field_behavior.rb

@@ -57,9 +57,15 @@ module Google
 
       # Denotes that a (repeated) field is an unordered list.
       # This indicates that the service may provide the elements of the list
-      # in any arbitrary order, rather than the order the user originally
+      # in any arbitrary  order, rather than the order the user originally
       # provided. Additionally, the list's order may or may not be stable.
       UNORDERED_LIST = 6
+
+      # Denotes that this field returns a non-empty default value if not set.
+      # This indicates that if the user provides the empty value in a request,
+      # a non-empty value will be returned. The user will not be aware of what
+      # non-empty value to expect.
+      NON_EMPTY_DEFAULT = 7
     end
   end
 end

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

@@ -31,36 +31,34 @@ module Google
         #     Required. Name of the organization that the customer entity represents.
         # @!attribute [rw] org_postal_address
         #   @return [::Google::Type::PostalAddress]
-        #     Required. Address of the organization of the customer entity.
-        #     Region and zip codes are required to enforce US laws and embargoes.
-        #     Valid address lines are required for all customers.
-        #     Language code is discarded. Use the Customer-level language code to set the
-        #     customer's language.
+        #     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.
         # @!attribute [rw] primary_contact_info
         #   @return [::Google::Cloud::Channel::V1::ContactInfo]
         #     Primary contact info.
         # @!attribute [rw] alternate_email
         #   @return [::String]
-        #     Secondary contact email.
-        #     Alternate email and primary contact email are required to have different
-        #     domains if primary contact email is present.
-        #     When creating admin.google.com accounts, users get notified credentials at
-        #     this email. This email address is also used as a recovery email.
+        #     Secondary contact email. You need to provide an alternate email to create
+        #     different domains if a primary contact email already exists. Users will
+        #     receive a notification with credentials when you create an admin.google.com
+        #     account. Secondary emails are also recovery email addresses. Alternate
+        #     emails are optional when you create Team customers.
         # @!attribute [rw] domain
         #   @return [::String]
-        #     Required. Primary domain used by the customer.
-        #     Domain of primary contact email is required to be same as the provided
-        #     domain.
+        #     Required. The customer's primary domain. Must match the primary contact
+        #     email's domain.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     Output only. The time at which the customer is created.
+        #     Output only. Time when the customer was created.
         # @!attribute [r] update_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     Output only. The time at which the customer is updated.
+        #     Output only. Time when the customer was updated.
         # @!attribute [r] cloud_identity_id
         #   @return [::String]
-        #     Output only. Customer's cloud_identity_id.
-        #     Populated only if a Cloud Identity resource exists for this customer.
+        #     Output only. The customer's Cloud Identity ID if the customer has a Cloud
+        #     Identity resource.
         # @!attribute [rw] language_code
         #   @return [::String]
         #     Optional. The BCP-47 language code, such as "en-US" or "sr-Latn". For more
@@ -82,26 +80,25 @@ module Google
         # Contact information for a customer account.
         # @!attribute [rw] first_name
         #   @return [::String]
-        #     First name of the contact in the customer account.
+        #     The customer account contact's first name. Optional for Team customers.
         # @!attribute [rw] last_name
         #   @return [::String]
-        #     Last name of the contact in the customer account.
+        #     The customer account contact's last name. Optional for Team customers.
         # @!attribute [r] display_name
         #   @return [::String]
-        #     Output only. Display name of the contact in the customer account.
-        #     Populated by combining customer first name and last name.
+        #     Output only. The customer account contact's display name, formatted as a
+        #     combination of the customer's first and last name.
         # @!attribute [rw] email
         #   @return [::String]
-        #     Email of the contact in the customer account.
-        #     Email is required for entitlements that need creation of admin.google.com
-        #     accounts. The email will be the username used in credentials to access the
-        #     admin.google.com account.
+        #     The customer account's contact email. Required for entitlements that create
+        #     admin.google.com accounts, and serves as the customer's username for those
+        #     accounts. Use this email to invite Team customers.
         # @!attribute [rw] title
         #   @return [::String]
-        #     Optional. Job title of the contact in the customer account.
+        #     Optional. The customer account contact's job title.
         # @!attribute [rw] phone
         #   @return [::String]
-        #     Phone number of the contact in the customer account.
+        #     The customer account's contact phone number.
         class ContactInfo
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -146,6 +146,44 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for {::Google::Cloud::Channel::V1::CloudChannelService::Client#import_customer CloudChannelService.ImportCustomer}
+        # @!attribute [rw] domain
+        #   @return [::String]
+        #     Required. Customer domain.
+        # @!attribute [rw] cloud_identity_id
+        #   @return [::String]
+        #     Required. Customer's Cloud Identity ID
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The resource name of the reseller's account.
+        #     Parent takes the format: accounts/\\{account_id} or
+        #     accounts/\\{account_id}/channelPartnerLinks/\\{channel_partner_id}
+        # @!attribute [rw] auth_token
+        #   @return [::String]
+        #     Optional. The super admin of the resold customer generates this token to
+        #     authorize a reseller to access their Cloud Identity and purchase
+        #     entitlements on their behalf. You can omit this token after authorization.
+        #     See https://support.google.com/a/answer/7643790 for more details.
+        # @!attribute [rw] overwrite_if_exists
+        #   @return [::Boolean]
+        #     Required. Choose to overwrite an existing customer if found.
+        #     This must be set to true if there is an existing customer with a
+        #     conflicting region code or domain.
+        # @!attribute [rw] channel_partner_id
+        #   @return [::String]
+        #     Optional. Cloud Identity ID of a channel partner who will be the direct reseller for
+        #     the customer's order. This field is required for 2-tier transfer scenarios
+        #     and can be provided via the request Parent binding as well.
+        # @!attribute [rw] customer
+        #   @return [::String]
+        #     Optional. Specifies the customer that will receive imported Cloud Identity
+        #     information.
+        #     Format: accounts/\\{account_id}/customers/\\{customer_id}
+        class ImportCustomerRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for {::Google::Cloud::Channel::V1::CloudChannelService::Client#provision_cloud_identity CloudChannelService.ProvisionCloudIdentity}
         # @!attribute [rw] customer
         #   @return [::String]
@@ -701,6 +739,17 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for LookupOffer.
+        # @!attribute [rw] entitlement
+        #   @return [::String]
+        #     Required. The resource name of the entitlement to retrieve the Offer.
+        #     Entitlement uses the format:
+        #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
+        class LookupOfferRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for ListProducts.
         # @!attribute [rw] account
         #   @return [::String]

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

@@ -98,6 +98,9 @@ module Google
 
             # License was assigned to or revoked from a user.
             LICENSE_ASSIGNMENT_CHANGED = 12
+
+            # License cap was changed for the entitlement.
+            LICENSE_CAP_CHANGED = 13
           end
         end
 

data/proto_docs/google/type/money.rb

@@ -22,7 +22,7 @@ module Google
     # Represents an amount of money with its currency type.
     # @!attribute [rw] currency_code
     #   @return [::String]
-    #     The 3-letter currency code defined in ISO 4217.
+    #     The three-letter currency code defined in ISO 4217.
     # @!attribute [rw] units
     #   @return [::Integer]
     #     The whole units of the amount.

metadata

@@ -1,29 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-channel-v1
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-04-26 00:00:00.000000000 Z
+date: 2021-09-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.7'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: 2.a
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.7'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: 2.a
 - !ruby/object:Gem::Dependency
   name: google-cloud-errors
   requirement: !ruby/object:Gem::Requirement
@@ -224,7 +230,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.13
+rubygems_version: 3.2.17
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Channel V1 API