google-cloud-channel-v1 0.1.1 → 0.6.0

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

@@ -103,8 +103,13 @@ module Google
             # Lists operations that match the specified filter in the request. If the
             # server doesn't support this method, it returns `UNIMPLEMENTED`.
             #
-            # NOTE: the `name` binding below allows API services to override the binding
-            # to use different resource name schemes, such as `users/*/operations`.
+            # NOTE: the `name` binding allows API services to override the binding
+            # to use different resource name schemes, such as `users/*/operations`. To
+            # override the binding, API services can add a binding such as
+            # `"/v1/{name=users/*}/operations"` to their service configuration.
+            # For backwards compatibility, the default name includes the operations
+            # collection id, however overriding users must ensure the name binding
+            # is the parent resource, without the operations collection id.
             #
             # @overload list_operations(request, options = nil)
             #   Pass arguments to `list_operations` via a request object, either of type
@@ -122,7 +127,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     The name of the operation collection.
+            #     The name of the operation's parent resource.
             #   @param filter [::String]
             #     The standard list filter.
             #   @param page_size [::Integer]
@@ -390,6 +395,79 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             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
+            # 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`.
+            # Note that this method is on a best-effort basis.  It may return the latest
+            # state before the specified timeout (including immediately), meaning even an
+            # immediate response is no guarantee that the operation is done.
+            #
+            # @overload wait_operation(request, options = nil)
+            #   Pass arguments to `wait_operation` via a request object, either of type
+            #   {::Google::Longrunning::WaitOperationRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Longrunning::WaitOperationRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload wait_operation(name: nil, timeout: nil)
+            #   Pass arguments to `wait_operation` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param name [::String]
+            #     The name of the operation resource to wait on.
+            #   @param timeout [::Google::Protobuf::Duration, ::Hash]
+            #     The maximum duration to wait before timing out. If left blank, the wait
+            #     will be at most the time permitted by the underlying HTTP/RPC protocol.
+            #     If RPC context deadline is also specified, the shorter one will be used.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::Operation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::Operation]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def wait_operation request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Longrunning::WaitOperationRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.wait_operation.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Channel::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              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,
+                                     retry_policy: @config.retry_policy
+
+              @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
+                response = ::Gapic::Operation.new response, @operations_client, options: options
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Configuration class for the Operations API.
             #
@@ -482,7 +560,7 @@ module Google
               config_attr :scope,         nil, ::String, ::Array, nil
               config_attr :lib_name,      nil, ::String, nil
               config_attr :lib_version,   nil, ::String, nil
-              config_attr(:channel_args,  { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
+              config_attr(:channel_args,  { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
               config_attr :interceptors,  nil, ::Array, nil
               config_attr :timeout,       nil, ::Numeric, nil
               config_attr :metadata,      nil, ::Hash, nil
@@ -503,7 +581,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end
@@ -546,17 +624,24 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :cancel_operation
+                ##
+                # RPC-specific configuration for `wait_operation`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :wait_operation
 
                 # @private
                 def initialize parent_rpcs = nil
-                  list_operations_config = parent_rpcs&.list_operations if parent_rpcs&.respond_to? :list_operations
+                  list_operations_config = parent_rpcs.list_operations if parent_rpcs.respond_to? :list_operations
                   @list_operations = ::Gapic::Config::Method.new list_operations_config
-                  get_operation_config = parent_rpcs&.get_operation if parent_rpcs&.respond_to? :get_operation
+                  get_operation_config = parent_rpcs.get_operation if parent_rpcs.respond_to? :get_operation
                   @get_operation = ::Gapic::Config::Method.new get_operation_config
-                  delete_operation_config = parent_rpcs&.delete_operation if parent_rpcs&.respond_to? :delete_operation
+                  delete_operation_config = parent_rpcs.delete_operation if parent_rpcs.respond_to? :delete_operation
                   @delete_operation = ::Gapic::Config::Method.new delete_operation_config
-                  cancel_operation_config = parent_rpcs&.cancel_operation if parent_rpcs&.respond_to? :cancel_operation
+                  cancel_operation_config = parent_rpcs.cancel_operation if parent_rpcs.respond_to? :cancel_operation
                   @cancel_operation = ::Gapic::Config::Method.new cancel_operation_config
+                  wait_operation_config = parent_rpcs.wait_operation if parent_rpcs.respond_to? :wait_operation
+                  @wait_operation = ::Gapic::Config::Method.new wait_operation_config
 
                   yield self if block_given?
                 end

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

@@ -49,6 +49,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
         optional :string_value, :string, 2
         optional :double_value, :double, 3
         optional :proto_value, :message, 4, "google.protobuf.Any"
+        optional :bool_value, :bool, 5
       end
     end
     add_message "google.cloud.channel.v1.AdminUser" do

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

@@ -69,10 +69,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :end_time, :message, 2, "google.protobuf.Timestamp"
     end
     add_message "google.cloud.channel.v1.TransferableSku" do
-      optional :is_commitment, :message, 6, "google.protobuf.BoolValue"
-      optional :commitment_end_timestamp, :message, 7, "google.protobuf.Timestamp"
       optional :transfer_eligibility, :message, 9, "google.cloud.channel.v1.TransferEligibility"
       optional :sku, :message, 11, "google.cloud.channel.v1.Sku"
+      optional :legacy_sku, :message, 12, "google.cloud.channel.v1.Sku"
     end
     add_message "google.cloud.channel.v1.TransferEligibility" do
       optional :is_eligible, :bool, 1

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

@@ -50,6 +50,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :payment_type, :enum, 2, "google.cloud.channel.v1.PaymentType"
       optional :payment_cycle, :message, 3, "google.cloud.channel.v1.Period"
       optional :trial_period, :message, 4, "google.cloud.channel.v1.Period"
+      optional :billing_account, :string, 5
     end
     add_message "google.cloud.channel.v1.PriceByResource" do
       optional :resource_type, :enum, 1, "google.cloud.channel.v1.ResourceType"

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

@@ -122,7 +122,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.channel.v1.CreateChannelPartnerLinkRequest" do
       optional :parent, :string, 1
       optional :channel_partner_link, :message, 2, "google.cloud.channel.v1.ChannelPartnerLink"
-      optional :domain, :string, 3
     end
     add_message "google.cloud.channel.v1.UpdateChannelPartnerLinkRequest" do
       optional :name, :string, 1
@@ -267,6 +266,30 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.channel.v1.PurchasableOffer" do
       optional :offer, :message, 1, "google.cloud.channel.v1.Offer"
     end
+    add_message "google.cloud.channel.v1.RegisterSubscriberRequest" do
+      optional :account, :string, 1
+      optional :service_account, :string, 2
+    end
+    add_message "google.cloud.channel.v1.RegisterSubscriberResponse" do
+      optional :topic, :string, 1
+    end
+    add_message "google.cloud.channel.v1.UnregisterSubscriberRequest" do
+      optional :account, :string, 1
+      optional :service_account, :string, 2
+    end
+    add_message "google.cloud.channel.v1.UnregisterSubscriberResponse" do
+      optional :topic, :string, 1
+    end
+    add_message "google.cloud.channel.v1.ListSubscribersRequest" do
+      optional :account, :string, 1
+      optional :page_size, :int32, 2
+      optional :page_token, :string, 3
+    end
+    add_message "google.cloud.channel.v1.ListSubscribersResponse" do
+      optional :topic, :string, 1
+      repeated :service_accounts, :string, 2
+      optional :next_page_token, :string, 3
+    end
   end
 end
 
@@ -325,6 +348,12 @@ module Google
         ListPurchasableOffersRequest::ChangeOfferPurchase = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ListPurchasableOffersRequest.ChangeOfferPurchase").msgclass
         ListPurchasableOffersResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ListPurchasableOffersResponse").msgclass
         PurchasableOffer = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.PurchasableOffer").msgclass
+        RegisterSubscriberRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.RegisterSubscriberRequest").msgclass
+        RegisterSubscriberResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.RegisterSubscriberResponse").msgclass
+        UnregisterSubscriberRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.UnregisterSubscriberRequest").msgclass
+        UnregisterSubscriberResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.UnregisterSubscriberResponse").msgclass
+        ListSubscribersRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ListSubscribersRequest").msgclass
+        ListSubscribersResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ListSubscribersResponse").msgclass
       end
     end
   end

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

@@ -24,27 +24,25 @@ module Google
     module Channel
       module V1
         module CloudChannelService
-          # CloudChannelService enables Google cloud resellers and distributors to manage
-          # their customers, channel partners, entitlements and reports.
+          # CloudChannelService lets Google cloud resellers and distributors manage
+          # their customers, channel partners, entitlements, and reports.
           #
           # Using this service:
-          # 1. Resellers or distributors can manage a customer entity.
-          # 2. Distributors can register an authorized reseller in their channel and then
-          #    enable delegated admin access for the reseller.
-          # 3. Resellers or distributors can manage entitlements for their customers.
+          # 1. Resellers and distributors can manage a customer entity.
+          # 2. Distributors can register an authorized reseller in their channel and
+          #    provide them with delegated admin access.
+          # 3. Resellers and distributors can manage customer entitlements.
           #
-          # The service primarily exposes the following resources:
-          # - [Customer][google.cloud.channel.v1.Customer]s: A Customer represents an entity managed by a reseller or
-          # distributor. A customer typically represents an enterprise. In an n-tier
-          # resale channel hierarchy, customers are generally represented as leaf nodes.
-          # Customers primarily have an Entitlement sub-resource discussed below.
+          # CloudChannelService exposes the following resources:
+          # - [Customer][google.cloud.channel.v1.Customer]s: An entity—usually an enterprise—managed by a reseller or
+          # distributor.
           #
-          # - [Entitlement][google.cloud.channel.v1.Entitlement]s: An Entitlement represents an entity which provides a
-          # customer means to start using a service. Entitlements are created or updated
-          # as a result of a successful fulfillment.
+          # - [Entitlement][google.cloud.channel.v1.Entitlement]s: An entity that provides a customer with the means to use
+          # a service. Entitlements are created or updated as a result of a successful
+          # fulfillment.
           #
-          # - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: A ChannelPartnerLink is an entity that identifies
-          # links between distributors and their indirect resellers in a channel.
+          # - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: An entity that identifies links between
+          # distributors and their indirect resellers in a channel.
           class Service
 
             include GRPC::GenericService
@@ -53,260 +51,221 @@ module Google
             self.unmarshal_class_method = :decode
             self.service_name = 'google.cloud.channel.v1.CloudChannelService'
 
-            # List downstream [Customer][google.cloud.channel.v1.Customer]s.
+            # List [Customer][google.cloud.channel.v1.Customer]s.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the reseller account making the request and the
-            # reseller account being queried for are different.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
+            # * PERMISSION_DENIED: The reseller account making the request is different
+            # from the reseller account in the API request.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             #
-            # Return Value:
-            # <br/> List of [Customer][google.cloud.channel.v1.Customer]s pertaining to the reseller or empty list if
-            # there are none.
+            # 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.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the reseller account making the request and the
-            # reseller account being queried for are different.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
-            # * NOT_FOUND: If the customer resource doesn't exist. Usually
-            # the result of an invalid name parameter.
+            # * PERMISSION_DENIED: The reseller account making the request is different
+            # from the reseller account in the API request.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+            # * NOT_FOUND: The customer resource doesn't exist. Usually the result of an
+            # invalid name parameter.
             #
-            # Return Value:
-            # <br/> [Customer][google.cloud.channel.v1.Customer] resource if found, error otherwise.
+            # Return value:
+            # The [Customer][google.cloud.channel.v1.Customer] resource.
             rpc :GetCustomer, ::Google::Cloud::Channel::V1::GetCustomerRequest, ::Google::Cloud::Channel::V1::Customer
-            # Confirms the existence of Cloud Identity accounts, based on the domain and
-            # whether the Cloud Identity accounts are owned by the reseller.
+            # Confirms the existence of Cloud Identity accounts based on the domain and
+            # if the Cloud Identity accounts are owned by the reseller.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the reseller account making the request and the
-            # reseller account being queried for are different.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
+            # * PERMISSION_DENIED: The reseller account making the request is different
+            # from the reseller account in the API request.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             # * INVALID_VALUE: Invalid domain value in the request.
-            # * NOT_FOUND: If there is no [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] customer
-            # for the domain specified in the request.
             #
-            # Return Value:
-            # <br/> List of [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources if any exist for
-            # the domain, otherwise an error is returned.
+            # Return value:
+            # A list of [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources for the domain (may be
+            # empty)
+            #
+            # Note: in the v1alpha1 version of the API, a NOT_FOUND error returns if
+            # no [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources match the domain.
             rpc :CheckCloudIdentityAccountsExist, ::Google::Cloud::Channel::V1::CheckCloudIdentityAccountsExistRequest, ::Google::Cloud::Channel::V1::CheckCloudIdentityAccountsExistResponse
             # Creates a new [Customer][google.cloud.channel.v1.Customer] resource under the reseller or distributor
             # account.
             #
-            # Possible Error Codes:
-            # <ul>
-            # <li>PERMISSION_DENIED: If the reseller account making the request and the
-            # reseller account being queried for are different.</li>
-            # <li> INVALID_ARGUMENT:
-            # <ul>
-            #  <li> Missing or invalid required parameters in the request. </li>
-            #  <li> Domain field value doesn't match the domain specified in primary
-            #  email.</li>
-            # </ul>
-            # </li>
-            # </ul>
-            #
-            # Return Value:
-            # <br/> If successful, the newly created [Customer][google.cloud.channel.v1.Customer] resource, otherwise
-            # returns an error.
+            # Possible error codes:
+            #
+            # * PERMISSION_DENIED: The reseller account making the request is different
+            # from the reseller account in the API request.
+            # * INVALID_ARGUMENT:
+            #     * Required request parameters are missing or invalid.
+            #     * Domain field value doesn't match the primary email domain.
+            #
+            # Return value:
+            # The newly created [Customer][google.cloud.channel.v1.Customer] resource.
             rpc :CreateCustomer, ::Google::Cloud::Channel::V1::CreateCustomerRequest, ::Google::Cloud::Channel::V1::Customer
-            # Updates an existing [Customer][google.cloud.channel.v1.Customer] resource belonging to the reseller or
+            # Updates an existing [Customer][google.cloud.channel.v1.Customer] resource for the reseller or
             # distributor.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the reseller account making the request and the
-            # reseller account being queried for are different.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
-            # * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name
-            # specified in the request.
+            # * PERMISSION_DENIED: The reseller account making the request is different
+            # from the reseller account in the API request.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+            # * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name in the request.
             #
-            # Return Value:
-            # <br/> If successful, the updated [Customer][google.cloud.channel.v1.Customer] resource, otherwise returns
-            # an error.
+            # 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.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the account making the request does not own
+            # * PERMISSION_DENIED: The account making the request does not own
             # this customer.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
-            # * FAILED_PRECONDITION: If the customer has existing entitlements.
-            # * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name
-            # specified in the request.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+            # * 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
             # Creates a Cloud Identity for the given customer using the customer's
-            # information or the information provided here, if present.
+            # information, or the information provided here.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # *  PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-            # *  INVALID_ARGUMENT: Missing or invalid required parameters in the request.
-            # *  NOT_FOUND: If the customer is not found for the reseller.
-            # *  ALREADY_EXISTS: If the customer's primary email already exists. In this
-            #    case, retry after changing the customer's primary contact email.
-            # *  INTERNAL: Any non-user error related to a technical issue in the
-            #    backend. Contact Cloud Channel support in this case.
-            # *  UNKNOWN: Any non-user error related to a technical issue in the backend.
-            #    Contact Cloud Channel support in this case.
+            # *  PERMISSION_DENIED: The customer doesn't belong to the reseller.
+            # *  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
+            #    after changing the customer's primary contact email.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. Contact Cloud Channel support.
+            # * UNKNOWN: Any non-user error related to a technical issue in the backend.
+            # Contact Cloud Channel support.
             #
-            # Return Value:
-            # <br/>  Long Running Operation ID.
+            # Return value:
+            # The ID of a long-running operation.
             #
             # To get the results of the operation, call the GetOperation method of
-            # CloudChannelOperationsService. The Operation metadata will contain an
+            # CloudChannelOperationsService. The Operation metadata contains an
             # instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
             rpc :ProvisionCloudIdentity, ::Google::Cloud::Channel::V1::ProvisionCloudIdentityRequest, ::Google::Longrunning::Operation
-            # List [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer.
+            # Lists [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the request.
+            # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             #
-            # Return Value:
-            # <br/> List of [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to the customer, or empty list if
-            # there are none.
+            # Return value:
+            # A list of the customer's [Entitlement][google.cloud.channel.v1.Entitlement]s.
             rpc :ListEntitlements, ::Google::Cloud::Channel::V1::ListEntitlementsRequest, ::Google::Cloud::Channel::V1::ListEntitlementsResponse
-            # List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on Cloud Identity ID or
+            # List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on the Cloud Identity ID or
             # Customer Name in the request.
             #
-            # This method is used when a reseller lists the entitlements
-            # information of a customer that is not owned. The reseller should provide
-            # the customer's Cloud Identity ID or Customer Name.
-            #
-            # Possible Error Codes:
-            # <ul>
-            # <li>PERMISSION_DENIED, due to one of the following reasons:
-            # <ul>
-            #    <li> If the customer doesn't belong to the reseller and no auth token,
-            #    or an invalid auth token is supplied. </li> <li> If the reseller account
-            #    making the request and the reseller account being queried for are
-            #    different. </li>
-            # </ul>
-            # </li>
-            # <li> INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.</li>
-            # </ul>
-            #
-            # Return Value:
-            # <br/> List of [TransferableSku][google.cloud.channel.v1.TransferableSku] for the given customer.
+            # Use this method to list the entitlements information of an
+            # unowned customer. You should provide the customer's
+            # Cloud Identity ID or Customer Name.
+            #
+            # Possible error codes:
+            #
+            # * PERMISSION_DENIED:
+            #     * The customer doesn't belong to the reseller and has no auth token.
+            #     * The supplied auth token is invalid.
+            #     * The reseller account making the request is different
+            #     from the reseller account in the query.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+            #
+            # Return value:
+            # A list of the customer's [TransferableSku][google.cloud.channel.v1.TransferableSku].
             rpc :ListTransferableSkus, ::Google::Cloud::Channel::V1::ListTransferableSkusRequest, ::Google::Cloud::Channel::V1::ListTransferableSkusResponse
             # List [TransferableOffer][google.cloud.channel.v1.TransferableOffer]s of a customer based on Cloud Identity ID or
             # Customer Name in the request.
             #
-            # This method is used when a reseller gets the entitlement
-            # information of a customer that is not owned. The reseller should provide
-            # the customer's Cloud Identity ID or Customer Name.
+            # Use this method when a reseller gets the entitlement information of an
+            # unowned customer. The reseller should provide the customer's
+            # Cloud Identity ID or Customer Name.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED, due to one of the following reasons: (a) If the
-            # customer doesn't belong to the reseller and no auth token or invalid auth
-            # token is supplied. (b) If the reseller account making the request and the
-            # reseller account being queried for are different.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
+            # * PERMISSION_DENIED:
+            #     * The customer doesn't belong to the reseller and has no auth token.
+            #     * The supplied auth token is invalid.
+            #     * The reseller account making the request is different
+            #     from the reseller account in the query.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             #
-            # Return Value:
+            # 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.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
-            # * NOT_FOUND: If the entitlement is not found for the customer.
+            # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+            # * NOT_FOUND: The customer entitlement was not found.
             #
-            # Return Value:
-            # <br/> If found, the requested [Entitlement][google.cloud.channel.v1.Entitlement] resource, otherwise returns
-            # an error.
+            # Return value:
+            # The requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
             rpc :GetEntitlement, ::Google::Cloud::Channel::V1::GetEntitlementRequest, ::Google::Cloud::Channel::V1::Entitlement
             # Creates an entitlement for a customer.
             #
-            # Possible Error Codes:
-            # <ul>
-            # <li> PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-            # </li> <li> INVALID_ARGUMENT: <ul>
-            #   <li> Missing or invalid required parameters in the request. </li>
-            #   <li> Cannot purchase an entitlement if there is already an
-            #    entitlement for customer, for a SKU from the same product family. </li>
-            #   <li> INVALID_VALUE: Offer passed in isn't valid. Make sure OfferId is
-            # valid. If it is valid, then contact Google Channel support for further
-            # troubleshooting. </li>
-            # </ul>
-            # </li>
-            # <li> NOT_FOUND: If the customer or offer resource is not found for the
-            # reseller. </li>
-            # <li> ALREADY_EXISTS: This failure can happen in the following cases:
-            #   <ul>
-            #     <li>If the SKU has been already purchased for the customer.</li>
-            #     <li>If the customer's primary email already exists. In this case retry
-            #         after changing the customer's primary contact email.
-            #     </li>
-            #   </ul>
-            # </li>
-            # <li> CONDITION_NOT_MET or FAILED_PRECONDITION: This
-            # failure can happen in the following cases:
-            # <ul>
-            #    <li> Purchasing a SKU that requires domain verification and the
-            #    domain has not been verified. </li>
-            #    <li> Purchasing an Add-On SKU like Vault or Drive without purchasing
-            #    the pre-requisite SKU, such as Google Workspace Business Starter. </li>
-            #    <li> Applicable only for developer accounts: reseller and resold
-            #    domain. Must meet the following domain naming requirements:
-            #     <ul>
-            #       <li> Domain names must start with goog-test. </li>
-            #       <li> Resold domain names must include the reseller domain. </li>
-            #     </ul>
-            #    </li>
-            # </ul>
-            # </li>
-            # <li> INTERNAL: Any non-user error related to a technical issue in the
-            # backend. Contact Cloud Channel Support in this case. </li>
-            # <li> UNKNOWN: Any non-user error related to a technical issue in the
-            # backend. Contact Cloud Channel Support in this case. </li>
-            # </ul>
-            #
-            # Return Value:
-            # <br/> Long Running Operation ID.
+            # Possible error codes:
+            #
+            # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+            # * INVALID_ARGUMENT:
+            #     * Required request parameters are missing or invalid.
+            #     * There is already a customer entitlement for a SKU from the same
+            #     product family.
+            # * INVALID_VALUE: Make sure the OfferId is valid. If it is, contact
+            # Google Channel support for further troubleshooting.
+            # * NOT_FOUND: The customer or offer resource was not found.
+            # * ALREADY_EXISTS:
+            #     * The SKU was already purchased for the customer.
+            #     * The customer's primary email already exists. Retry
+            #     after changing the customer's primary contact email.
+            # * CONDITION_NOT_MET or FAILED_PRECONDITION:
+            #     * The domain required for purchasing a SKU has not been verified.
+            #     * A pre-requisite SKU required to purchase an Add-On SKU is missing.
+            #     For example, Google Workspace Business Starter is required to purchase
+            #     Vault or Drive.
+            #     * (Developer accounts only) Reseller and resold domain must meet the
+            #     following naming requirements:
+            #         * Domain names must start with goog-test.
+            #         * Domain names must include the reseller domain.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. Contact Cloud Channel support.
+            # * UNKNOWN: Any non-user error related to a technical issue in the backend.
+            # Contact Cloud Channel support.
+            #
+            # Return value:
+            # The ID of a long-running operation.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
             # instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
             rpc :CreateEntitlement, ::Google::Cloud::Channel::V1::CreateEntitlementRequest, ::Google::Longrunning::Operation
-            # Change parameters of the entitlement
+            # Change parameters of the entitlement.
             #
-            # An entitlement parameters update is a long-running operation and results in
-            # updates to the entitlement as a result of fulfillment.
+            # An entitlement update is a long-running operation and it updates the
+            # entitlement as a result of fulfillment.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request. For example, if the number of seats being changed to is greater
-            # than the allowed number of max seats for the resource. Or decreasing seats
-            # for a commitment based plan.
+            # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+            # For example, the number of seats being changed is greater than the allowed
+            # number of max seats, or decreasing seats for a commitment based plan.
             # * NOT_FOUND: Entitlement resource not found.
-            # * INTERNAL: Any non-user error related to a technical issue
-            # in the backend. In this case, contact Cloud Channel support.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. Contact Cloud Channel support.
             # * UNKNOWN: Any non-user error related to a technical issue in the backend.
-            # In this case, contact Cloud Channel support.
+            # Contact Cloud Channel support.
             #
-            # Return Value:
-            # <br/> Long Running Operation ID.
+            # Return value:
+            # The ID of a long-running operation.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
@@ -314,24 +273,23 @@ module Google
             rpc :ChangeParameters, ::Google::Cloud::Channel::V1::ChangeParametersRequest, ::Google::Longrunning::Operation
             # Updates the renewal settings for an existing customer entitlement.
             #
-            # An entitlement update is a long-running operation and results in updates to
-            # the entitlement as a result of fulfillment.
+            # An entitlement update is a long-running operation and it updates the
+            # entitlement as a result of fulfillment.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
+            # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             # * NOT_FOUND: Entitlement resource not found.
             # * NOT_COMMITMENT_PLAN: Renewal Settings are only applicable for a
-            # commitment plan. Can't enable or disable renewal for non-commitment plans.
-            # * INTERNAL: Any non user error related to a technical issue in the
-            # backend. In this case, contact Cloud Channel support.
-            # * UNKNOWN: Any non user error related to a technical issue in the backend.
-            # In this case, contact Cloud Channel support.
+            # commitment plan. Can't enable or disable renewals for non-commitment plans.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. Contact Cloud Channel support.
+            # * UNKNOWN: Any non-user error related to a technical issue in the backend.
+            #   Contact Cloud Channel support.
             #
-            # Return Value:
-            # <br/> Long Running Operation ID.
+            # Return value:
+            # The ID of a long-running operation.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
@@ -339,22 +297,21 @@ module Google
             rpc :ChangeRenewalSettings, ::Google::Cloud::Channel::V1::ChangeRenewalSettingsRequest, ::Google::Longrunning::Operation
             # Updates the Offer for an existing customer entitlement.
             #
-            # An entitlement update is a long-running operation and results in updates to
-            # the entitlement as a result of fulfillment.
+            # An entitlement update is a long-running operation and it updates the
+            # entitlement as a result of fulfillment.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
+            # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             # * NOT_FOUND: Offer or Entitlement resource not found.
-            # * INTERNAL: Any non-user error related to a technical issue in the backend.
-            # In this case, contact Cloud Channel support.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. Contact Cloud Channel support.
             # * UNKNOWN: Any non-user error related to a technical issue in the backend.
-            # In this case, contact Cloud Channel support.
+            # Contact Cloud Channel support.
             #
-            # Return Value:
-            # <br/> Long Running Operation ID.
+            # Return value:
+            # The ID of a long-running operation.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
@@ -363,105 +320,100 @@ module Google
             # Starts paid service for a trial entitlement.
             #
             # Starts paid service for a trial entitlement immediately. This method is
-            # only applicable if a plan has already been set up for a trial entitlement
-            # but has some trial days remaining.
+            # only applicable if a plan is set up for a trial entitlement but has some
+            # trial days remaining.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
+            # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             # * NOT_FOUND: Entitlement resource not found.
             # * FAILED_PRECONDITION/NOT_IN_TRIAL: This method only works for
             # entitlement on trial plans.
-            # * INTERNAL: Any non-user error related to a technical issue in the backend.
-            # In this case, contact Cloud Channel support.
-            # * UNKNOWN: Any non-user error related to a technical issue
-            # in the backend. In this case, contact Cloud Channel support.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. Contact Cloud Channel support.
+            # * UNKNOWN: Any non-user error related to a technical issue in the backend.
+            # Contact Cloud Channel support.
             #
-            # Return Value:
-            # <br/> Long Running Operation ID.
+            # Return value:
+            # The ID of a long-running operation.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
             # instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
             rpc :StartPaidService, ::Google::Cloud::Channel::V1::StartPaidServiceRequest, ::Google::Longrunning::Operation
             # Suspends a previously fulfilled entitlement.
+            #
             # An entitlement suspension is a long-running operation.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
+            # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             # * NOT_FOUND: Entitlement resource not found.
             # * NOT_ACTIVE: Entitlement is not active.
-            # * INTERNAL: Any non-user error related to a technical issue in the backend.
-            # In this case, contact Cloud Channel support.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. Contact Cloud Channel support.
             # * UNKNOWN: Any non-user error related to a technical issue in the backend.
-            # In this case, contact Cloud Channel support.
+            # Contact Cloud Channel support.
             #
-            # Return Value:
-            # <br/> Long Running Operation ID.
+            # Return value:
+            # The ID of a long-running operation.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
             # instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
             rpc :SuspendEntitlement, ::Google::Cloud::Channel::V1::SuspendEntitlementRequest, ::Google::Longrunning::Operation
             # Cancels a previously fulfilled entitlement.
+            #
             # An entitlement cancellation is a long-running operation.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the customer doesn't belong to the reseller or
-            # if the reseller account making the request and reseller account being
-            # queried for are different.
-            # * FAILED_PRECONDITION: If there are any Google Cloud projects linked to the
+            # * PERMISSION_DENIED: The reseller account making the request is different
+            # from the reseller account in the API request.
+            # * FAILED_PRECONDITION: There are Google Cloud projects linked to the
             # Google Cloud entitlement's Cloud Billing subaccount.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             # * NOT_FOUND: Entitlement resource not found.
             # * DELETION_TYPE_NOT_ALLOWED: Cancel is only allowed for Google Workspace
-            # add-ons or entitlements for Google Cloud's development platform.
+            # add-ons, or entitlements for Google Cloud's development platform.
             # * INTERNAL: Any non-user error related to a technical issue in the
-            # backend. In this case, contact Cloud Channel support.
+            # backend. Contact Cloud Channel support.
             # * UNKNOWN: Any non-user error related to a technical issue in the backend.
-            # In this case, contact Cloud Channel support.
+            # Contact Cloud Channel support.
             #
-            # Return Value:
-            # <br/> Long Running Operation ID.
+            # Return value:
+            # The ID of a long-running operation.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The response will contain
             # google.protobuf.Empty on success. The Operation metadata will contain an
             # instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
             rpc :CancelEntitlement, ::Google::Cloud::Channel::V1::CancelEntitlementRequest, ::Google::Longrunning::Operation
-            # Activates a previously suspended entitlement. The entitlement must be in a
-            # suspended state for it to be activated. Entitlements suspended for pending
-            # ToS acceptance can't be activated using this method. An entitlement
-            # activation is a long-running operation and can result in updates to
+            # Activates a previously suspended entitlement. Entitlements suspended for
+            # pending ToS acceptance can't be activated using this method.
+            #
+            # An entitlement activation is a long-running operation and it updates
             # the state of the customer entitlement.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the customer doesn't belong to the reseller or
-            # if the reseller account making the request and reseller account being
-            # queried for are different.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
+            # * PERMISSION_DENIED: The reseller account making the request is different
+            # from the reseller account in the API request.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             # * NOT_FOUND: Entitlement resource not found.
-            # * SUSPENSION_NOT_RESELLER_INITIATED: Can't activate an
-            # entitlement that is pending TOS acceptance. Only reseller initiated
-            # suspensions can be activated.
-            # * NOT_SUSPENDED: Can't activate entitlements that are already in ACTIVE
-            # state. Can only activate suspended entitlements.
-            # * INTERNAL: Any non-user error related to a technical issue
-            # in the backend. In this case, contact Cloud Channel support.
+            # * SUSPENSION_NOT_RESELLER_INITIATED: Can only activate reseller-initiated
+            # suspensions and entitlements that have accepted the TOS.
+            # * NOT_SUSPENDED: Can only activate suspended entitlements not in an ACTIVE
+            # state.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. Contact Cloud Channel support.
             # * UNKNOWN: Any non-user error related to a technical issue in the backend.
-            # In this case, contact Cloud Channel support.
+            # Contact Cloud Channel support.
             #
-            # Return Value:
-            # <br/> Long Running Operation ID.
+            # Return value:
+            # The ID of a long-running operation.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
@@ -469,77 +421,58 @@ module Google
             rpc :ActivateEntitlement, ::Google::Cloud::Channel::V1::ActivateEntitlementRequest, ::Google::Longrunning::Operation
             # Transfers customer entitlements to new reseller.
             #
-            # Possible Error Codes:
-            # <ul>
-            # <li> PERMISSION_DENIED: If the customer doesn't belong to the
-            # reseller.</li> <li> INVALID_ARGUMENT: Missing or invalid required
-            # parameters in the request. </li> <li> NOT_FOUND: If the customer or offer
-            # resource is not found for the reseller. </li> <li> ALREADY_EXISTS: If the
-            # SKU has been already transferred for the customer. </li> <li>
-            # CONDITION_NOT_MET or FAILED_PRECONDITION: This failure can happen in the
-            # following cases: <ul>
-            #    <li> Transferring a SKU that requires domain verification and the
-            # domain has not been verified. </li>
-            #    <li> Transferring an Add-On SKU like Vault or Drive without transferring
-            # the pre-requisite SKU, such as G Suite Basic </li> <li> Applicable only for
-            # developer accounts: reseller and resold domain must follow the domain
-            # naming convention as follows:
-            #      <ul>
-            #         <li> Domain names must start with goog-test. </li>
-            #         <li> Resold domain names must include the reseller domain. </li>
-            #      </ul>
-            #   </li>
-            #   <li> All transferring entitlements must be specified. </li>
-            # </ul>
-            # </li>
-            # <li> INTERNAL: Any non-user error related to a technical issue in the
-            # backend. Please contact Cloud Channel Support in this case. </li>
-            # <li> UNKNOWN: Any non-user error related to a technical issue in the
-            # backend. Please contact Cloud Channel Support in this case. </li>
-            # </ul>
-            #
-            # Return Value:
-            # <br/> Long Running Operation ID.
+            # Possible error codes:
+            #
+            # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+            # * 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.
+            # * CONDITION_NOT_MET or FAILED_PRECONDITION:
+            #     * The SKU requires domain verification to transfer, but the domain is
+            #     not verified.
+            #     * An Add-On SKU (example, Vault or Drive) is missing the
+            #     pre-requisite SKU (example, G Suite Basic).
+            #     * (Developer accounts only) Reseller and resold domain must meet the
+            #     following naming requirements:
+            #         * Domain names must start with goog-test.
+            #         * Domain names must include the reseller domain.
+            #     * Specify all transferring entitlements.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. Contact Cloud Channel support.
+            # * UNKNOWN: Any non-user error related to a technical issue in the backend.
+            # Contact Cloud Channel support.
+            #
+            # Return value:
+            # The ID of a long-running operation.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
             # instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
             rpc :TransferEntitlements, ::Google::Cloud::Channel::V1::TransferEntitlementsRequest, ::Google::Longrunning::Operation
-            # Transfers customer entitlements from current reseller to Google.
-            #
-            # Possible Error Codes:
-            # <ul>
-            # <li> PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-            # </li> <li> INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request. </li>
-            # <li> NOT_FOUND: If the customer or offer resource is not found
-            # for the reseller. </li>
-            # <li> ALREADY_EXISTS: If the SKU has been already
-            # transferred for the customer. </li>
-            # <li> CONDITION_NOT_MET or FAILED_PRECONDITION: This failure can happen in
-            # the following cases:
-            # <ul>
-            #    <li> Transferring a SKU that requires domain verification and the
-            # domain has not been verified. </li>
-            #    <li> Transferring an Add-On SKU like Vault or Drive without purchasing
-            # the pre-requisite SKU, such as G Suite Basic </li> <li> Applicable only for
-            # developer accounts: reseller and resold domain must follow the domain
-            # naming convention as follows:
-            #      <ul>
-            #         <li> Domain names must start with goog-test. </li>
-            #         <li> Resold domain names must include the reseller domain. </li>
-            #      </ul>
-            #    </li>
-            # </ul>
-            # </li>
-            # <li> INTERNAL: Any non-user error related to a technical issue in the
-            # backend. Please contact Cloud Channel Support in this case. </li>
-            # <li> UNKNOWN: Any non-user error related to a technical issue in the
-            # backend. Please contact Cloud Channel Support in this case.</li>
-            # </ul>
-            #
-            # Return Value:
-            # <br/> Long Running Operation ID.
+            # Transfers customer entitlements from their current reseller to Google.
+            #
+            # Possible error codes:
+            #
+            # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+            # * 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.
+            # * CONDITION_NOT_MET or FAILED_PRECONDITION:
+            #     * The SKU requires domain verification to transfer, but the domain is
+            #     not verified.
+            #     * An Add-On SKU (example, Vault or Drive) is missing the
+            #     pre-requisite SKU (example, G Suite Basic).
+            #     * (Developer accounts only) Reseller and resold domain must meet the
+            #     following naming requirements:
+            #         * Domain names must start with goog-test.
+            #         * Domain names must include the reseller domain.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. Contact Cloud Channel support.
+            # * UNKNOWN: Any non-user error related to a technical issue in the backend.
+            # Contact Cloud Channel support.
+            #
+            # Return value:
+            # The ID of a long-running operation.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The response will contain
@@ -547,129 +480,172 @@ module Google
             # instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
             rpc :TransferEntitlementsToGoogle, ::Google::Cloud::Channel::V1::TransferEntitlementsToGoogleRequest, ::Google::Longrunning::Operation
             # List [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s belonging to a distributor.
-            # To call this method, you must be a distributor.
+            # You must be a distributor to call this method.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the reseller account making the request and the
-            # reseller account being queried for are different.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
+            # * PERMISSION_DENIED: The reseller account making the request is different
+            # from the reseller account in the API request.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             #
-            # Return Value:
-            # <br/> If successful, returns the list of [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources
-            # for the distributor account, otherwise returns an error.
+            # 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.
-            # To call this method, you must be a distributor.
+            # You must be a distributor to call this method.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the reseller account making the request and the
-            # reseller account being queried for are different.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
-            # * NOT_FOUND: ChannelPartnerLink resource not found. Results
-            # due invalid channel partner link name.
+            # * PERMISSION_DENIED: The reseller account making the request is different
+            # from the reseller account in the API request.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+            # * NOT_FOUND: ChannelPartnerLink resource not found because of an
+            # invalid channel partner link name.
             #
-            # Return Value:
-            # <br/> [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if found, otherwise returns an error.
+            # Return value:
+            # The [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
             rpc :GetChannelPartnerLink, ::Google::Cloud::Channel::V1::GetChannelPartnerLinkRequest, ::Google::Cloud::Channel::V1::ChannelPartnerLink
-            # Initiates a channel partner link between a distributor and a reseller or
+            # Initiates a channel partner link between a distributor and a reseller, or
             # between resellers in an n-tier reseller channel.
-            # To accept the invite, the invited partner should follow the invite_link_uri
-            # provided in the response. If the link creation is accepted, a valid link is
-            # set up between the two involved parties.
-            # To call this method, you must be a distributor.
-            #
-            # Possible Error Codes:
-            #
-            # * PERMISSION_DENIED: If the reseller account making the request and the
-            # reseller account being queried for are different.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
-            # * ALREADY_EXISTS: If the ChannelPartnerLink sent in the request already
+            # Invited partners need to follow the invite_link_uri provided in the
+            # response to accept. After accepting the invitation, a link is set up
+            # between the two parties.
+            # You must be a distributor to call this method.
+            #
+            # Possible error codes:
+            #
+            # * PERMISSION_DENIED: The reseller account making the request is different
+            # from the reseller account in the API request.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+            # * ALREADY_EXISTS: The ChannelPartnerLink sent in the request already
             # exists.
-            # * NOT_FOUND: If no Cloud Identity customer exists for domain provided.
+            # * NOT_FOUND: No Cloud Identity customer exists for provided domain.
             # * INTERNAL: Any non-user error related to a technical issue in the
-            # backend. In this case, contact Cloud Channel support.
-            # * UNKNOWN: Any non-user error related to a technical issue in
-            # the backend. In this case, contact Cloud Channel support.
+            # backend. Contact Cloud Channel support.
+            # * UNKNOWN: Any non-user error related to a technical issue in the backend.
+            # Contact Cloud Channel support.
             #
-            # Return Value:
-            # <br/> Newly created [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if successful,
-            # otherwise error is returned.
+            # Return value:
+            # The new [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
             rpc :CreateChannelPartnerLink, ::Google::Cloud::Channel::V1::CreateChannelPartnerLinkRequest, ::Google::Cloud::Channel::V1::ChannelPartnerLink
-            # Updates a channel partner link. A distributor calls this method to change a
-            # link's status. For example, suspend a partner link.
-            # To call this method, you must be a distributor.
-            #
-            # Possible Error Codes:
-            # <ul>
-            # <li> PERMISSION_DENIED: If the reseller account making the request and the
-            # reseller account being queried for are different. </li>
-            # <li> INVALID_ARGUMENT:
-            # <ul>
-            #   <li> Missing or invalid required parameters in the request. </li>
-            #   <li> Updating link state from invited to active or suspended. </li>
-            #   <li> Sending reseller_cloud_identity_id, invite_url or name in update
-            #   mask. </li>
-            # </ul>
-            # </li>
-            # <li> NOT_FOUND: ChannelPartnerLink resource not found.</li>
-            # <li> INTERNAL: Any non-user error related to a technical issue in the
-            # backend. In this case, contact Cloud Channel support. </li>
-            # <li> UNKNOWN: Any non-user error related to a technical issue in the
-            # backend. In this case, contact Cloud Channel support.</li>
-            # </ul>
-            #
-            # Return Value:
-            # <br/> If successful, the updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource, otherwise
-            # returns an error.
+            # Updates a channel partner link. Distributors call this method to change a
+            # link's status. For example, to suspend a partner link.
+            # You must be a distributor to call this method.
+            #
+            # Possible error codes:
+            #
+            # * PERMISSION_DENIED: The reseller account making the request is different
+            # from the reseller account in the API request.
+            # * INVALID_ARGUMENT:
+            #     * Required request parameters are missing or invalid.
+            #     * Link state cannot change from invited to active or suspended.
+            #     * Cannot send reseller_cloud_identity_id, invite_url, or name in update
+            #     mask.
+            # * NOT_FOUND: ChannelPartnerLink resource not found.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. Contact Cloud Channel support.
+            # * UNKNOWN: Any non-user error related to a technical issue in the backend.
+            # Contact Cloud Channel support.
+            #
+            # Return value:
+            # The updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
             rpc :UpdateChannelPartnerLink, ::Google::Cloud::Channel::V1::UpdateChannelPartnerLinkRequest, ::Google::Cloud::Channel::V1::ChannelPartnerLink
             # Lists the Products the reseller is authorized to sell.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             rpc :ListProducts, ::Google::Cloud::Channel::V1::ListProductsRequest, ::Google::Cloud::Channel::V1::ListProductsResponse
             # Lists the SKUs for a product the reseller is authorized to sell.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             rpc :ListSkus, ::Google::Cloud::Channel::V1::ListSkusRequest, ::Google::Cloud::Channel::V1::ListSkusResponse
             # Lists the Offers the reseller can sell.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             rpc :ListOffers, ::Google::Cloud::Channel::V1::ListOffersRequest, ::Google::Cloud::Channel::V1::ListOffersResponse
-            # Lists the Purchasable SKUs for following cases:
+            # Lists the following:
             #
-            # * SKUs that can be newly purchased for a customer
-            # * SKUs that can be upgraded/downgraded to, for an entitlement.
+            # * SKUs that you can purchase for a customer
+            # * SKUs that you can upgrade or downgrade for an entitlement.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the customer doesn't belong to the reseller
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
+            # * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             rpc :ListPurchasableSkus, ::Google::Cloud::Channel::V1::ListPurchasableSkusRequest, ::Google::Cloud::Channel::V1::ListPurchasableSkusResponse
-            # Lists the Purchasable Offers for the following cases:
+            # Lists the following:
             #
-            # * Offers that can be newly purchased for a customer
-            # * Offers that can be changed to, for an entitlement.
+            # * Offers that you can purchase for a customer.
+            # * Offers that you can change for an entitlement.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the customer doesn't belong to the reseller
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
+            # * PERMISSION_DENIED: The customer doesn't belong to the reseller
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             rpc :ListPurchasableOffers, ::Google::Cloud::Channel::V1::ListPurchasableOffersRequest, ::Google::Cloud::Channel::V1::ListPurchasableOffersResponse
+            # 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 [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent]
+            #
+            # Possible error codes:
+            #
+            # * PERMISSION_DENIED: The reseller account making the request and the
+            # provided reseller account are different, or the impersonated user
+            # is not a super admin.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. Contact Cloud Channel support.
+            # * UNKNOWN: Any non-user error related to a technical issue in the backend.
+            # Contact Cloud Channel support.
+            #
+            # Return value:
+            # The topic name with the registered service email address.
+            rpc :RegisterSubscriber, ::Google::Cloud::Channel::V1::RegisterSubscriberRequest, ::Google::Cloud::Channel::V1::RegisterSubscriberResponse
+            # Unregisters a service account with subscriber privileges on the Cloud
+            # Pub/Sub topic created for this Channel Services account. If there are no
+            # service accounts left with subscriber privileges, this deletes the topic.
+            # You can call ListSubscribers to check for these accounts.
+            #
+            # Possible error codes:
+            #
+            # * PERMISSION_DENIED: The reseller account making the request and the
+            # provided reseller account are different, or the impersonated user
+            # is not a super admin.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+            # * NOT_FOUND: The topic resource doesn't exist.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. Contact Cloud Channel support.
+            # * UNKNOWN: Any non-user error related to a technical issue in the backend.
+            # Contact Cloud Channel support.
+            #
+            # Return value:
+            # The topic name that unregistered the service email address.
+            # Returns a success response if the service email address wasn't registered
+            # with the topic.
+            rpc :UnregisterSubscriber, ::Google::Cloud::Channel::V1::UnregisterSubscriberRequest, ::Google::Cloud::Channel::V1::UnregisterSubscriberResponse
+            # Lists service accounts with subscriber privileges on the Cloud Pub/Sub
+            # topic created for this Channel Services account.
+            #
+            # Possible error codes:
+            #
+            # * PERMISSION_DENIED: The reseller account making the request and the
+            # provided reseller account are different, or the impersonated user
+            # is not a super admin.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+            # * NOT_FOUND: The topic resource doesn't exist.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. Contact Cloud Channel support.
+            # * UNKNOWN: Any non-user error related to a technical issue in the backend.
+            # Contact Cloud Channel support.
+            #
+            # Return value:
+            # A list of service email addresses.
+            rpc :ListSubscribers, ::Google::Cloud::Channel::V1::ListSubscribersRequest, ::Google::Cloud::Channel::V1::ListSubscribersResponse
           end
 
           Stub = Service.rpc_stub_class