google-cloud-channel-v1 0.3.0 → 0.7.1

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

@@ -32,27 +32,25 @@ module Google
     module Channel
       module V1
         ##
-        # 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:
-        # - {::Google::Cloud::Channel::V1::Customer 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:
+        # - {::Google::Cloud::Channel::V1::Customer Customer}s: An entity—usually an enterprise—managed by a reseller or
+        # distributor.
         #
-        # - {::Google::Cloud::Channel::V1::Entitlement 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.
+        # - {::Google::Cloud::Channel::V1::Entitlement 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.
         #
-        # - {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink}s: A ChannelPartnerLink is an entity that identifies
-        # links between distributors and their indirect resellers in a channel.
+        # - {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink}s: An entity that identifies links between
+        # distributors and their indirect resellers in a channel.
         #
         # To load this service and instantiate a client:
         #

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

@@ -27,27 +27,25 @@ module Google
           ##
           # Client for the CloudChannelService service.
           #
-          # 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:
-          # - {::Google::Cloud::Channel::V1::Customer 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:
+          # - {::Google::Cloud::Channel::V1::Customer Customer}s: An entity—usually an enterprise—managed by a reseller or
+          # distributor.
           #
-          # - {::Google::Cloud::Channel::V1::Entitlement 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.
+          # - {::Google::Cloud::Channel::V1::Entitlement 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.
           #
-          # - {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink}s: A ChannelPartnerLink is an entity that identifies
-          # links between distributors and their indirect resellers in a channel.
+          # - {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink}s: An entity that identifies links between
+          # distributors and their indirect resellers in a channel.
           #
           class Client
             include Paths
@@ -80,17 +78,14 @@ module Google
                 parent_config = while namespace.any?
                                   parent_name = namespace.join "::"
                                   parent_const = const_get parent_name
-                                  break parent_const.configure if parent_const&.respond_to? :configure
+                                  break parent_const.configure if parent_const.respond_to? :configure
                                   namespace.pop
                                 end
                 default_config = Client::Configuration.new parent_config
 
                 default_config.timeout = 60.0
                 default_config.retry_policy = {
-                  initial_delay: 1.0,
-                  max_delay:     10.0,
-                  multiplier:    1.3,
-                  retry_codes:   [14]
+                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config.rpcs.provision_cloud_identity.timeout = 60.0
@@ -181,9 +176,9 @@ module Google
               enable_self_signed_jwt = @config.scope == Client.configure.scope &&
                                        @config.endpoint == Client.configure.endpoint &&
                                        !@config.endpoint.split(".").first.include?("-")
-              credentials ||= Credentials.default scope:                  @config.scope,
+              credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
-              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
@@ -213,18 +208,16 @@ module Google
             # Service calls
 
             ##
-            # List downstream {::Google::Cloud::Channel::V1::Customer Customer}s.
+            # List {::Google::Cloud::Channel::V1::Customer 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 {::Google::Cloud::Channel::V1::Customer Customer}s pertaining to the reseller or empty list if
-            # there are none.
+            # Return value:
+            # List of {::Google::Cloud::Channel::V1::Customer Customer}s, or an empty list if there are no customers.
             #
             # @overload list_customers(request, options = nil)
             #   Pass arguments to `list_customers` via a request object, either of type
@@ -242,15 +235,15 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The resource name of the reseller account from which to list customers.
-            #     The parent takes the format: accounts/\\{account_id}.
+            #     Required. The resource name of the reseller account to list customers from.
+            #     Parent uses the format: accounts/\\{account_id}.
             #   @param page_size [::Integer]
             #     Optional. The maximum number of customers to return. The service may return fewer
-            #     than this value. If unspecified, at most 10 customers will be returned. The
-            #     maximum value is 50; values about 50 will be coerced to 50.
+            #     than this value. If unspecified, returns at most 10 customers. The
+            #     maximum value is 50.
             #   @param page_token [::String]
-            #     Optional. A token identifying a page of results, if other than the first one.
-            #     Typically obtained via
+            #     Optional. A token identifying a page of results other than the first page.
+            #     Obtained through
             #     {::Google::Cloud::Channel::V1::ListCustomersResponse#next_page_token ListCustomersResponse.next_page_token} of the previous
             #     {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_customers CloudChannelService.ListCustomers} call.
             #
@@ -301,19 +294,18 @@ module Google
             end
 
             ##
-            # Returns a requested {::Google::Cloud::Channel::V1::Customer Customer} resource.
+            # Returns the requested {::Google::Cloud::Channel::V1::Customer 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/> {::Google::Cloud::Channel::V1::Customer Customer} resource if found, error otherwise.
+            # Return value:
+            # The {::Google::Cloud::Channel::V1::Customer Customer} resource.
             #
             # @overload get_customer(request, options = nil)
             #   Pass arguments to `get_customer` via a request object, either of type
@@ -332,7 +324,7 @@ module Google
             #
             #   @param name [::String]
             #     Required. The resource name of the customer to retrieve.
-            #     The name takes the format: accounts/\\{account_id}/customers/\\{customer_id}
+            #     Name uses the format: accounts/\\{account_id}/customers/\\{customer_id}
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Channel::V1::Customer]
@@ -380,22 +372,22 @@ module Google
             end
 
             ##
-            # 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 {::Google::Cloud::Channel::V1::CloudIdentityCustomerAccount CloudIdentityCustomerAccount} customer
-            # for the domain specified in the request.
             #
-            # Return Value:
-            # <br/> List of {::Google::Cloud::Channel::V1::CloudIdentityCustomerAccount CloudIdentityCustomerAccount} resources if any exist for
-            # the domain, otherwise an error is returned.
+            # Return value:
+            # A list of {::Google::Cloud::Channel::V1::CloudIdentityCustomerAccount CloudIdentityCustomerAccount} resources for the domain (may be
+            # empty)
+            #
+            # Note: in the v1alpha1 version of the API, a NOT_FOUND error returns if
+            # no {::Google::Cloud::Channel::V1::CloudIdentityCustomerAccount CloudIdentityCustomerAccount} resources match the domain.
             #
             # @overload check_cloud_identity_accounts_exist(request, options = nil)
             #   Pass arguments to `check_cloud_identity_accounts_exist` via a request object, either of type
@@ -413,10 +405,10 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The resource name of the reseller account.
-            #     The parent takes the format: accounts/\\{account_id}
+            #     Required. The reseller account's resource name.
+            #     Parent uses the format: accounts/\\{account_id}
             #   @param domain [::String]
-            #     Required. Domain for which the Cloud Identity account customer is fetched.
+            #     Required. Domain to fetch for Cloud Identity account customer.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Channel::V1::CheckCloudIdentityAccountsExistResponse]
@@ -467,22 +459,16 @@ module Google
             # Creates a new {::Google::Cloud::Channel::V1::Customer 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 {::Google::Cloud::Channel::V1::Customer 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 {::Google::Cloud::Channel::V1::Customer Customer} resource.
             #
             # @overload create_customer(request, options = nil)
             #   Pass arguments to `create_customer` via a request object, either of type
@@ -501,7 +487,7 @@ module Google
             #
             #   @param parent [::String]
             #     Required. The resource name of reseller account in which to create the customer.
-            #     The parent takes the format: accounts/\\{account_id}
+            #     Parent uses the format: accounts/\\{account_id}
             #   @param customer [::Google::Cloud::Channel::V1::Customer, ::Hash]
             #     Required. The customer to create.
             #
@@ -551,21 +537,18 @@ module Google
             end
 
             ##
-            # Updates an existing {::Google::Cloud::Channel::V1::Customer Customer} resource belonging to the reseller or
+            # Updates an existing {::Google::Cloud::Channel::V1::Customer 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 {::Google::Cloud::Channel::V1::Customer 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 {::Google::Cloud::Channel::V1::Customer Customer} resource found for the name in the request.
             #
-            # Return Value:
-            # <br/> If successful, the updated {::Google::Cloud::Channel::V1::Customer Customer} resource, otherwise returns
-            # an error.
+            # Return value:
+            # The updated {::Google::Cloud::Channel::V1::Customer Customer} resource.
             #
             # @overload update_customer(request, options = nil)
             #   Pass arguments to `update_customer` via a request object, either of type
@@ -634,17 +617,15 @@ module Google
             end
 
             ##
-            # Deletes the given {::Google::Cloud::Channel::V1::Customer Customer} permanently and irreversibly.
+            # Deletes the given {::Google::Cloud::Channel::V1::Customer Customer} permanently.
             #
-            # 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 {::Google::Cloud::Channel::V1::Customer 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 {::Google::Cloud::Channel::V1::Customer Customer} resource found for the name in the request.
             #
             # @overload delete_customer(request, options = nil)
             #   Pass arguments to `delete_customer` via a request object, either of type
@@ -711,25 +692,25 @@ module Google
 
             ##
             # 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 {::Google::Cloud::Channel::V1::OperationMetadata OperationMetadata}.
             #
             # @overload provision_cloud_identity(request, options = nil)
@@ -755,8 +736,7 @@ module Google
             #   @param user [::Google::Cloud::Channel::V1::AdminUser, ::Hash]
             #     Admin user information.
             #   @param validate_only [::Boolean]
-            #     If set, validate the request and preview the review, but do not actually
-            #     post it.
+            #     Validate the request and preview the review, but do not post it.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -805,16 +785,15 @@ module Google
             end
 
             ##
-            # List {::Google::Cloud::Channel::V1::Entitlement Entitlement}s belonging to a customer.
+            # Lists {::Google::Cloud::Channel::V1::Entitlement 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 {::Google::Cloud::Channel::V1::Entitlement Entitlement}s belonging to the customer, or empty list if
-            # there are none.
+            # Return value:
+            # A list of the customer's {::Google::Cloud::Channel::V1::Entitlement Entitlement}s.
             #
             # @overload list_entitlements(request, options = nil)
             #   Pass arguments to `list_entitlements` via a request object, either of type
@@ -832,16 +811,16 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The resource name of the reseller's customer account for which to list
-            #     entitlements.
-            #     The parent takes the format: accounts/\\{account_id}/customers/\\{customer_id}
+            #     Required. The resource name of the reseller's customer account to list
+            #     entitlements for.
+            #     Parent uses the format: accounts/\\{account_id}/customers/\\{customer_id}
             #   @param page_size [::Integer]
             #     Optional. Requested page size. Server might return fewer results than requested.
-            #     If unspecified, at most 50 entitlements will be returned.
-            #     The maximum value is 100; values above 100 will be coerced to 100.
+            #     If unspecified, return at most 50 entitlements.
+            #     The maximum value is 100; the server will coerce values above 100.
             #   @param page_token [::String]
-            #     Optional. A token identifying a page of results, if other than the first one.
-            #     Typically obtained via
+            #     Optional. A token for a page of results other than the first page.
+            #     Obtained using
             #     {::Google::Cloud::Channel::V1::ListEntitlementsResponse#next_page_token ListEntitlementsResponse.next_page_token} of the previous
             #     {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_entitlements CloudChannelService.ListEntitlements} call.
             #
@@ -892,29 +871,24 @@ module Google
             end
 
             ##
-            # List {::Google::Cloud::Channel::V1::TransferableSku TransferableSku}s of a customer based on Cloud Identity ID or
+            # List {::Google::Cloud::Channel::V1::TransferableSku 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 {::Google::Cloud::Channel::V1::TransferableSku 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 {::Google::Cloud::Channel::V1::TransferableSku TransferableSku}.
             #
             # @overload list_transferable_skus(request, options = nil)
             #   Pass arguments to `list_transferable_skus` via a request object, either of type
@@ -936,32 +910,31 @@ module Google
             #   @param customer_name [::String]
             #     A reseller is required to create a customer and use the resource name of
             #     the created customer here.
-            #     The customer_name takes the format:
+            #     Customer_name uses the format:
             #     accounts/\\{account_id}/customers/\\{customer_id}
             #   @param parent [::String]
-            #     Required. The resource name of the reseller's account.
-            #     The parent takes the format: accounts/\\{account_id}
+            #     Required. The reseller account's resource name.
+            #     Parent uses the format: accounts/\\{account_id}
             #   @param page_size [::Integer]
-            #     Requested page size. Server might return fewer results than requested.
-            #     If unspecified, at most 100 SKUs will be returned.
-            #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+            #     The requested page size. Server might return fewer results than requested.
+            #     If unspecified, returns at most 100 SKUs.
+            #     The maximum value is 1000; the server will coerce values above 1000.
             #     Optional.
             #   @param page_token [::String]
-            #     A token identifying a page of results, if other than the first one.
-            #     Typically obtained via
+            #     A token for a page of results other than the first page.
+            #     Obtained using
             #     {::Google::Cloud::Channel::V1::ListTransferableSkusResponse#next_page_token ListTransferableSkusResponse.next_page_token} of the previous
             #     {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_transferable_skus CloudChannelService.ListTransferableSkus} call.
             #     Optional.
             #   @param auth_token [::String]
-            #     This token is generated by the Super Admin of the resold customer to
+            #     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. This token can be omitted once the
-            #     authorization is generated. See https://support.google.com/a/answer/7643790
-            #     for more details.
+            #     entitlements on their behalf. You can omit this token after authorization.
+            #     See https://support.google.com/a/answer/7643790 for more details.
             #   @param language_code [::String]
-            #     The BCP-47 language code, such as "en-US".  If specified, the
-            #     response will be localized to the corresponding language code. Default is
-            #     "en-US".
+            #     The BCP-47 language code. For example, "en-US". The
+            #     response will localize in the corresponding language code, if specified.
+            #     The default value is "en-US".
             #     Optional.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -1014,20 +987,20 @@ module Google
             # List {::Google::Cloud::Channel::V1::TransferableOffer 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 {::Google::Cloud::Channel::V1::TransferableOffer TransferableOffer} for the given customer and SKU.
             #
             # @overload list_transferable_offers(request, options = nil)
@@ -1049,24 +1022,24 @@ module Google
             #     Customer's Cloud Identity ID
             #   @param customer_name [::String]
             #     A reseller should create a customer and use the resource name of
-            #     the created customer here.
+            #     that customer here.
             #   @param parent [::String]
             #     Required. The resource name of the reseller's account.
             #   @param page_size [::Integer]
             #     Requested page size. Server might return fewer results than requested.
-            #     If unspecified, at most 100 Offers will be returned.
-            #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+            #     If unspecified, returns at most 100 offers.
+            #     The maximum value is 1000; the server will coerce values above 1000.
             #   @param page_token [::String]
-            #     A token identifying a page of results, if other than the first one.
-            #     Typically obtained via
+            #     A token for a page of results other than the first page.
+            #     Obtained using
             #     {::Google::Cloud::Channel::V1::ListTransferableOffersResponse#next_page_token ListTransferableOffersResponse.next_page_token} of the previous
             #     {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_transferable_offers CloudChannelService.ListTransferableOffers} call.
             #   @param sku [::String]
-            #     Required. SKU for which the Offers are being looked up.
+            #     Required. The SKU to look up Offers for.
             #   @param language_code [::String]
-            #     The BCP-47 language code, such as "en-US".  If specified, the
-            #     response will be localized to the corresponding language code. Default is
-            #     "en-US".
+            #     The BCP-47 language code. For example, "en-US". The
+            #     response will localize in the corresponding language code, if specified.
+            #     The default value is "en-US".
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Channel::V1::TransferableOffer>]
@@ -1115,18 +1088,16 @@ module Google
             end
 
             ##
-            # Returns a requested {::Google::Cloud::Channel::V1::Entitlement Entitlement} resource.
+            # Returns the requested {::Google::Cloud::Channel::V1::Entitlement 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 {::Google::Cloud::Channel::V1::Entitlement Entitlement} resource, otherwise returns
-            # an error.
+            # Return value:
+            # The requested {::Google::Cloud::Channel::V1::Entitlement Entitlement} resource.
             #
             # @overload get_entitlement(request, options = nil)
             #   Pass arguments to `get_entitlement` via a request object, either of type
@@ -1145,8 +1116,8 @@ module Google
             #
             #   @param name [::String]
             #     Required. The resource name of the entitlement to retrieve.
-            #     The name takes the format:
-            #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{id}
+            #     Name uses the format:
+            #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Channel::V1::Entitlement]
@@ -1196,52 +1167,36 @@ module Google
             ##
             # 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
@@ -1263,20 +1218,19 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The resource name of reseller's customer account in which to create the
+            #     Required. The resource name of the reseller's customer account in which to create the
             #     entitlement.
-            #     The parent takes the format: accounts/\\{account_id}/customers/\\{customer_id}
+            #     Parent uses the format: accounts/\\{account_id}/customers/\\{customer_id}
             #   @param entitlement [::Google::Cloud::Channel::V1::Entitlement, ::Hash]
             #     Required. The entitlement to create.
             #   @param request_id [::String]
-            #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-            #     that if you must retry your request, the server will know to ignore the
-            #     request if it has already been completed.
+            #     Optional. You can specify an optional unique request ID, and if you need to retry
+            #     your request, the server will know to ignore the request if it's complete.
             #
-            #     For example, consider a situation where you make an initial request and
-            #     the request times out. If you make the request again with the same
-            #     request ID, the server can check if the original operation with the same
-            #     request ID was received, and if so, will ignore the second request.
+            #     For example, you make an initial request and the request times out. If you
+            #     make the request again with the same request ID, the server can check if
+            #     it received the original operation with the same request ID. If it did, it
+            #     will ignore the second request.
             #
             #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
             #     with the exception that zero UUID is not supported
@@ -1329,26 +1283,25 @@ module Google
             end
 
             ##
-            # 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
@@ -1371,24 +1324,21 @@ module Google
             #
             #   @param name [::String]
             #     Required. The name of the entitlement to update.
-            #     The name takes the format:
+            #     Name uses the format:
             #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
             #   @param parameters [::Array<::Google::Cloud::Channel::V1::Parameter, ::Hash>]
-            #     Required. Entitlement parameters to update. Only editable parameters are allowed to
-            #     be changed.
+            #     Required. Entitlement parameters to update. You can only change editable parameters.
             #   @param request_id [::String]
-            #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-            #     that if you must retry your request, the server will know to ignore the
-            #     request if it has already been completed.
-            #
-            #     For example, consider a situation where you make an initial request and
-            #     the request times out. If you make the request again with the same
-            #     request ID, the server can check if the original operation with the same
-            #     request ID was received, and if so, will ignore the second request.
-            #
-            #     The request ID must be
-            #     a valid [UUID](https://tools.ietf.org/html/rfc4122) with the exception that
-            #     zero UUID is not supported
+            #     Optional. You can specify an optional unique request ID, and if you need to retry
+            #     your request, the server will know to ignore the request if it's complete.
+            #
+            #     For example, you make an initial request and the request times out. If you
+            #     make the request again with the same request ID, the server can check if
+            #     it received the original operation with the same request ID. If it did, it
+            #     will ignore the second request.
+            #
+            #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
+            #     with the exception that zero UUID is not supported
             #     (`00000000-0000-0000-0000-000000000000`).
             #   @param purchase_order_id [::String]
             #     Optional. Purchase order ID provided by the reseller.
@@ -1442,24 +1392,23 @@ module Google
             ##
             # 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
@@ -1482,19 +1431,18 @@ module Google
             #
             #   @param name [::String]
             #     Required. The name of the entitlement to update.
-            #     The name takes the format:
+            #     Name uses the format:
             #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
             #   @param renewal_settings [::Google::Cloud::Channel::V1::RenewalSettings, ::Hash]
             #     Required. New renewal settings.
             #   @param request_id [::String]
-            #     Optional. A request ID to identify requests. Specify a unique request ID so
-            #     that if you must retry your request, the server will know to ignore the
-            #     request if it has already been completed.
+            #     Optional. You can specify an optional unique request ID, and if you need to retry
+            #     your request, the server will know to ignore the request if it's complete.
             #
-            #     For example, consider a situation where you make an initial request and
-            #     the request times out. If you make the request again with the same
-            #     request ID, the server can check if the original operation with the same
-            #     request ID was received, and if so, will ignore the second request.
+            #     For example, you make an initial request and the request times out. If you
+            #     make the request again with the same request ID, the server can check if
+            #     it received the original operation with the same request ID. If it did, it
+            #     will ignore the second request.
             #
             #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
             #     with the exception that zero UUID is not supported
@@ -1549,22 +1497,21 @@ module Google
             ##
             # 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
@@ -1586,8 +1533,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the entitlement to update.
-            #     Format:
+            #     Required. The resource name of the entitlement to update.
+            #     Name uses the format:
             #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
             #   @param offer [::String]
             #     Required. New Offer.
@@ -1597,14 +1544,13 @@ module Google
             #   @param purchase_order_id [::String]
             #     Optional. Purchase order id provided by the reseller.
             #   @param request_id [::String]
-            #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-            #     that if you must retry your request, the server will know to ignore the
-            #     request if it has already been completed.
+            #     Optional. You can specify an optional unique request ID, and if you need to retry
+            #     your request, the server will know to ignore the request if it's complete.
             #
-            #     For example, consider a situation where you make an initial request and
-            #     the request times out. If you make the request again with the same
-            #     request ID, the server can check if the original operation with the same
-            #     request ID was received, and if so, will ignore the second request.
+            #     For example, you make an initial request and the request times out. If you
+            #     make the request again with the same request ID, the server can check if
+            #     it received the original operation with the same request ID. If it did, it
+            #     will ignore the second request.
             #
             #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
             #     with the exception that zero UUID is not supported
@@ -1660,24 +1606,23 @@ 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
@@ -1699,18 +1644,17 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the entitlement for which paid service is being started.
-            #     The name takes the format:
+            #     Required. The name of the entitlement to start a paid service for.
+            #     Name uses the format:
             #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
             #   @param request_id [::String]
-            #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-            #     that if you must retry your request, the server will know to ignore the
-            #     request if it has already been completed.
+            #     Optional. You can specify an optional unique request ID, and if you need to retry
+            #     your request, the server will know to ignore the request if it's complete.
             #
-            #     For example, consider a situation where you make an initial request and
-            #     the request times out. If you make the request again with the same
-            #     request ID, the server can check if the original operation with the same
-            #     request ID was received, and if so, will ignore the second request.
+            #     For example, you make an initial request and the request times out. If you
+            #     make the request again with the same request ID, the server can check if
+            #     it received the original operation with the same request ID. If it did, it
+            #     will ignore the second request.
             #
             #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
             #     with the exception that zero UUID is not supported
@@ -1764,22 +1708,22 @@ module Google
 
             ##
             # 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
@@ -1802,17 +1746,16 @@ module Google
             #
             #   @param name [::String]
             #     Required. The resource name of the entitlement to suspend.
-            #     The name takes the format:
+            #     Name uses the format:
             #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
             #   @param request_id [::String]
-            #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-            #     that if you must retry your request, the server will know to ignore the
-            #     request if it has already been completed.
+            #     Optional. You can specify an optional unique request ID, and if you need to retry
+            #     your request, the server will know to ignore the request if it's complete.
             #
-            #     For example, consider a situation where you make an initial request and
-            #     the request times out. If you make the request again with the same
-            #     request ID, the server can check if the original operation with the same
-            #     request ID was received, and if so, will ignore the second request.
+            #     For example, you make an initial request and the request times out. If you
+            #     make the request again with the same request ID, the server can check if
+            #     it received the original operation with the same request ID. If it did, it
+            #     will ignore the second request.
             #
             #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
             #     with the exception that zero UUID is not supported
@@ -1866,27 +1809,26 @@ module Google
 
             ##
             # 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
@@ -1910,17 +1852,16 @@ module Google
             #
             #   @param name [::String]
             #     Required. The resource name of the entitlement to cancel.
-            #     The name takes the format:
+            #     Name uses the format:
             #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
             #   @param request_id [::String]
-            #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-            #     that if you must retry your request, the server will know to ignore the
-            #     request if it has already been completed.
+            #     Optional. You can specify an optional unique request ID, and if you need to retry
+            #     your request, the server will know to ignore the request if it's complete.
             #
-            #     For example, consider a situation where you make an initial request and
-            #     the request times out. If you make the request again with the same
-            #     request ID, the server can check if the original operation with the same
-            #     request ID was received, and if so, will ignore the second request.
+            #     For example, you make an initial request and the request times out. If you
+            #     make the request again with the same request ID, the server can check if
+            #     it received the original operation with the same request ID. If it did, it
+            #     will ignore the second request.
             #
             #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
             #     with the exception that zero UUID is not supported
@@ -1973,32 +1914,29 @@ module Google
             end
 
             ##
-            # 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
@@ -2021,17 +1959,16 @@ module Google
             #
             #   @param name [::String]
             #     Required. The resource name of the entitlement to activate.
-            #     The name takes the format:
+            #     Name uses the format:
             #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
             #   @param request_id [::String]
-            #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-            #     that if you must retry your request, the server will know to ignore the
-            #     request if it has already been completed.
+            #     Optional. You can specify an optional unique request ID, and if you need to retry
+            #     your request, the server will know to ignore the request if it's complete.
             #
-            #     For example, consider a situation where you make an initial request and
-            #     the request times out. If you make the request again with the same
-            #     request ID, the server can check if the original operation with the same
-            #     request ID was received, and if so, will ignore the second request.
+            #     For example, you make an initial request and the request times out. If you
+            #     make the request again with the same request ID, the server can check if
+            #     it received the original operation with the same request ID. If it did, it
+            #     will ignore the second request.
             #
             #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
             #     with the exception that zero UUID is not supported
@@ -2086,37 +2023,29 @@ module Google
             ##
             # 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
@@ -2138,26 +2067,24 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The resource name of reseller's customer account where the entitlements
-            #     transfer to.
-            #     The parent takes the format: accounts/\\{account_id}/customers/\\{customer_id}
+            #     Required. The resource name of the reseller's customer account that will receive
+            #     transferred entitlements.
+            #     Parent uses the format: accounts/\\{account_id}/customers/\\{customer_id}
             #   @param entitlements [::Array<::Google::Cloud::Channel::V1::Entitlement, ::Hash>]
-            #     Required. The new entitlements to be created or transferred.
+            #     Required. The new entitlements to create or transfer.
             #   @param auth_token [::String]
-            #     This token is generated by the Super Admin of the resold customer to
+            #     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. This token can be omitted once the
-            #     authorization is generated. See https://support.google.com/a/answer/7643790
-            #     for more details.
+            #     entitlements on their behalf. You can omit this token after authorization.
+            #     See https://support.google.com/a/answer/7643790 for more details.
             #   @param request_id [::String]
-            #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-            #     that if you must retry your request, the server will know to ignore the
-            #     request if it has already been completed.
+            #     Optional. You can specify an optional unique request ID, and if you need to retry
+            #     your request, the server will know to ignore the request if it's complete.
             #
-            #     For example, consider a situation where you make an initial request and
-            #     the request times out. If you make the request again with the same
-            #     request ID, the server can check if the original operation with the same
-            #     request ID was received, and if so, will ignore the second request.
+            #     For example, you make an initial request and the request times out. If you
+            #     make the request again with the same request ID, the server can check if
+            #     it received the original operation with the same request ID. If it did, it
+            #     will ignore the second request.
             #
             #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
             #     with the exception that zero UUID is not supported
@@ -2210,41 +2137,30 @@ module Google
             end
 
             ##
-            # 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
@@ -2267,20 +2183,19 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The resource name of reseller's customer account where the entitlements
+            #     Required. The resource name of the reseller's customer account where the entitlements
             #     transfer from.
-            #     The parent takes the format: accounts/\\{account_id}/customers/\\{customer_id}
+            #     Parent uses the format: accounts/\\{account_id}/customers/\\{customer_id}
             #   @param entitlements [::Array<::Google::Cloud::Channel::V1::Entitlement, ::Hash>]
-            #     Required. The entitlements to be transferred to Google.
+            #     Required. The entitlements to transfer to Google.
             #   @param request_id [::String]
-            #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-            #     that if you must retry your request, the server will know to ignore the
-            #     request if it has already been completed.
+            #     Optional. You can specify an optional unique request ID, and if you need to retry
+            #     your request, the server will know to ignore the request if it's complete.
             #
-            #     For example, consider a situation where you make an initial request and
-            #     the request times out. If you make the request again with the same
-            #     request ID, the server can check if the original operation with the same
-            #     request ID was received, and if so, will ignore the second request.
+            #     For example, you make an initial request and the request times out. If you
+            #     make the request again with the same request ID, the server can check if
+            #     it received the original operation with the same request ID. If it did, it
+            #     will ignore the second request.
             #
             #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
             #     with the exception that zero UUID is not supported
@@ -2334,18 +2249,16 @@ module Google
 
             ##
             # List {::Google::Cloud::Channel::V1::ChannelPartnerLink 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 {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resources
-            # for the distributor account, otherwise returns an error.
+            # Return value:
+            # The list of the distributor account's {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resources.
             #
             # @overload list_channel_partner_links(request, options = nil)
             #   Pass arguments to `list_channel_partner_links` via a request object, either of type
@@ -2365,14 +2278,14 @@ module Google
             #   @param parent [::String]
             #     Required. The resource name of the reseller account for listing channel partner
             #     links.
-            #     The parent takes the format: accounts/\\{account_id}
+            #     Parent uses the format: accounts/\\{account_id}
             #   @param page_size [::Integer]
             #     Optional. Requested page size. Server might return fewer results than requested.
             #     If unspecified, server will pick a default size (25).
-            #     The maximum value is 200, values above 200 will be coerced to 200.
+            #     The maximum value is 200; the server will coerce values above 200.
             #   @param page_token [::String]
-            #     Optional. A token identifying a page of results, if other than the first one.
-            #     Typically obtained via
+            #     Optional. A token for a page of results other than the first page.
+            #     Obtained using
             #     {::Google::Cloud::Channel::V1::ListChannelPartnerLinksResponse#next_page_token ListChannelPartnerLinksResponse.next_page_token} of the previous
             #     {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_channel_partner_links CloudChannelService.ListChannelPartnerLinks} call.
             #   @param view [::Google::Cloud::Channel::V1::ChannelPartnerLinkView]
@@ -2425,20 +2338,19 @@ module Google
             end
 
             ##
-            # Returns a requested {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resource.
-            # To call this method, you must be a distributor.
+            # Returns the requested {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resource.
+            # 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/> {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resource if found, otherwise returns an error.
+            # Return value:
+            # The {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resource.
             #
             # @overload get_channel_partner_link(request, options = nil)
             #   Pass arguments to `get_channel_partner_link` via a request object, either of type
@@ -2457,7 +2369,7 @@ module Google
             #
             #   @param name [::String]
             #     Required. The resource name of the channel partner link to retrieve.
-            #     The name takes the format: accounts/\\{account_id}/channelPartnerLinks/\\{id}
+            #     Name uses the format: accounts/\\{account_id}/channelPartnerLinks/\\{id}
             #     where \\{id} is the Cloud Identity ID of the partner.
             #   @param view [::Google::Cloud::Channel::V1::ChannelPartnerLinkView]
             #     Optional. The level of granularity the ChannelPartnerLink will display.
@@ -2508,30 +2420,28 @@ module Google
             end
 
             ##
-            # 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 {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resource if successful,
-            # otherwise error is returned.
+            # Return value:
+            # The new {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resource.
             #
             # @overload create_channel_partner_link(request, options = nil)
             #   Pass arguments to `create_channel_partner_link` via a request object, either of type
@@ -2543,23 +2453,19 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload create_channel_partner_link(parent: nil, channel_partner_link: nil, domain: nil)
+            # @overload create_channel_partner_link(parent: nil, channel_partner_link: nil)
             #   Pass arguments to `create_channel_partner_link` 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 parent [::String]
-            #     Required. The resource name of reseller's account for which to create a channel
-            #     partner link.
-            #     The parent takes the format: accounts/\\{account_id}
+            #     Required. Create a channel partner link for the provided reseller account's
+            #     resource name.
+            #     Parent uses the format: accounts/\\{account_id}
             #   @param channel_partner_link [::Google::Cloud::Channel::V1::ChannelPartnerLink, ::Hash]
             #     Required. The channel partner link to create.
             #     Either channel_partner_link.reseller_cloud_identity_id or domain can be
             #     used to create a link.
-            #   @param domain [::String]
-            #     Optional. The invited partner's domain. Either domain or
-            #     channel_partner_link.reseller_cloud_identity_id can be used to create a
-            #     link.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Channel::V1::ChannelPartnerLink]
@@ -2607,32 +2513,27 @@ module Google
             end
 
             ##
-            # 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 {::Google::Cloud::Channel::V1::ChannelPartnerLink 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 {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resource.
             #
             # @overload update_channel_partner_link(request, options = nil)
             #   Pass arguments to `update_channel_partner_link` via a request object, either of type
@@ -2651,14 +2552,14 @@ module Google
             #
             #   @param name [::String]
             #     Required. The resource name of the channel partner link to cancel.
-            #     The name takes the format: accounts/\\{account_id}/channelPartnerLinks/\\{id}
+            #     Name uses the format: accounts/\\{account_id}/channelPartnerLinks/\\{id}
             #     where \\{id} is the Cloud Identity ID of the partner.
             #   @param channel_partner_link [::Google::Cloud::Channel::V1::ChannelPartnerLink, ::Hash]
-            #     Required. The channel partner link to update. Only field
-            #     channel_partner_link.link_state is allowed to be updated.
+            #     Required. The channel partner link to update. Only channel_partner_link.link_state
+            #     is allowed for updates.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Required. The update mask that applies to the resource.
-            #     The only allowable value for update mask is
+            #     The only allowable value for an update mask is
             #     channel_partner_link.link_state.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -2706,13 +2607,89 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Returns the requested {::Google::Cloud::Channel::V1::Offer 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 {::Google::Cloud::Channel::V1::Offer Offer} resource.
+            #
+            # @overload lookup_offer(request, options = nil)
+            #   Pass arguments to `lookup_offer` via a request object, either of type
+            #   {::Google::Cloud::Channel::V1::LookupOfferRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Channel::V1::LookupOfferRequest, ::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 lookup_offer(entitlement: nil)
+            #   Pass arguments to `lookup_offer` 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 entitlement [::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}
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::Channel::V1::Offer]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::Channel::V1::Offer]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def lookup_offer request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Channel::V1::LookupOfferRequest
+
+              # 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.lookup_offer.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
+
+              header_params = {
+                "entitlement" => request.entitlement
+              }
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.lookup_offer.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.lookup_offer.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @cloud_channel_service_stub.call_rpc :lookup_offer, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # 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.
             #
             # @overload list_products(request, options = nil)
             #   Pass arguments to `list_products` via a request object, either of type
@@ -2734,14 +2711,14 @@ module Google
             #     Format: accounts/\\{account_id}.
             #   @param page_size [::Integer]
             #     Optional. Requested page size. Server might return fewer results than requested.
-            #     If unspecified, at most 100 Products will be returned.
-            #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+            #     If unspecified, returns at most 100 Products.
+            #     The maximum value is 1000; the server will coerce values above 1000.
             #   @param page_token [::String]
-            #     Optional. A token identifying a page of results, if other than the first one.
+            #     Optional. A token for a page of results other than the first page.
             #   @param language_code [::String]
-            #     Optional. The BCP-47 language code, such as "en-US".  If specified, the
-            #     response will be localized to the corresponding language code. Default is
-            #     "en-US".
+            #     Optional. The BCP-47 language code. For example, "en-US". The
+            #     response will localize in the corresponding language code, if specified.
+            #     The default value is "en-US".
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Channel::V1::Product>]
@@ -2786,10 +2763,9 @@ module Google
             ##
             # 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.
             #
             # @overload list_skus(request, options = nil)
             #   Pass arguments to `list_skus` via a request object, either of type
@@ -2807,23 +2783,23 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The resource name of the Product for which to list SKUs.
-            #     The parent takes the format: products/\\{product_id}.
+            #     Required. The resource name of the Product to list SKUs for.
+            #     Parent uses the format: products/\\{product_id}.
             #     Supports products/- to retrieve SKUs for all products.
             #   @param account [::String]
             #     Required. Resource name of the reseller.
             #     Format: accounts/\\{account_id}.
             #   @param page_size [::Integer]
             #     Optional. Requested page size. Server might return fewer results than requested.
-            #     If unspecified, at most 100 SKUs will be returned.
-            #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+            #     If unspecified, returns at most 100 SKUs.
+            #     The maximum value is 1000; the server will coerce values above 1000.
             #   @param page_token [::String]
-            #     Optional. A token identifying a page of results, if other than the first one.
+            #     Optional. A token for a page of results other than the first page.
             #     Optional.
             #   @param language_code [::String]
-            #     Optional. The BCP-47 language code, such as "en-US".  If specified, the
-            #     response will be localized to the corresponding language code. Default is
-            #     "en-US".
+            #     Optional. The BCP-47 language code. For example, "en-US". The
+            #     response will localize in the corresponding language code, if specified.
+            #     The default value is "en-US".
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Channel::V1::Sku>]
@@ -2874,10 +2850,9 @@ module Google
             ##
             # 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.
             #
             # @overload list_offers(request, options = nil)
             #   Pass arguments to `list_offers` via a request object, either of type
@@ -2896,23 +2871,23 @@ module Google
             #
             #   @param parent [::String]
             #     Required. The resource name of the reseller account from which to list Offers.
-            #     The parent takes the format: accounts/\\{account_id}.
+            #     Parent uses the format: accounts/\\{account_id}.
             #   @param page_size [::Integer]
             #     Optional. Requested page size. Server might return fewer results than requested.
-            #     If unspecified, at most 500 Offers will be returned.
-            #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+            #     If unspecified, returns at most 500 Offers.
+            #     The maximum value is 1000; the server will coerce values above 1000.
             #   @param page_token [::String]
-            #     Optional. A token identifying a page of results, if other than the first one.
+            #     Optional. A token for a page of results other than the first page.
             #   @param filter [::String]
             #     Optional. The expression to filter results by name (name of
-            #     the Offer), sku.name (name of the SKU) or sku.product.name (name of the
+            #     the Offer), sku.name (name of the SKU), or sku.product.name (name of the
             #     Product).
             #     Example 1: sku.product.name=products/p1 AND sku.name!=products/p1/skus/s1
             #     Example 2: name=accounts/a1/offers/o1
             #   @param language_code [::String]
-            #     Optional. The BCP-47 language code, such as "en-US".  If specified, the
-            #     response will be localized to the corresponding language code. Default is
-            #     "en-US".
+            #     Optional. The BCP-47 language code. For example, "en-US". The
+            #     response will localize in the corresponding language code, if specified.
+            #     The default value is "en-US".
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Channel::V1::Offer>]
@@ -2961,16 +2936,15 @@ module Google
             end
 
             ##
-            # 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.
             #
             # @overload list_purchasable_skus(request, options = nil)
             #   Pass arguments to `list_purchasable_skus` via a request object, either of type
@@ -2992,18 +2966,18 @@ module Google
             #   @param change_offer_purchase [::Google::Cloud::Channel::V1::ListPurchasableSkusRequest::ChangeOfferPurchase, ::Hash]
             #     List SKUs for ChangeOffer purchase with a new SKU.
             #   @param customer [::String]
-            #     Required. The resource name of the customer for which to list SKUs.
+            #     Required. The resource name of the customer to list SKUs for.
             #     Format: accounts/\\{account_id}/customers/\\{customer_id}.
             #   @param page_size [::Integer]
             #     Optional. Requested page size. Server might return fewer results than requested.
-            #     If unspecified, at most 100 SKUs will be returned.
-            #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+            #     If unspecified, returns at most 100 SKUs.
+            #     The maximum value is 1000; the server will coerce values above 1000.
             #   @param page_token [::String]
-            #     Optional. A token identifying a page of results, if other than the first one.
+            #     Optional. A token for a page of results other than the first page.
             #   @param language_code [::String]
-            #     Optional. The BCP-47 language code, such as "en-US".  If specified, the
-            #     response will be localized to the corresponding language code. Default is
-            #     "en-US".
+            #     Optional. The BCP-47 language code. For example, "en-US". The
+            #     response will localize in the corresponding language code, if specified.
+            #     The default value is "en-US".
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Channel::V1::PurchasableSku>]
@@ -3052,16 +3026,15 @@ module Google
             end
 
             ##
-            # 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.
             #
             # @overload list_purchasable_offers(request, options = nil)
             #   Pass arguments to `list_purchasable_offers` via a request object, either of type
@@ -3083,18 +3056,18 @@ module Google
             #   @param change_offer_purchase [::Google::Cloud::Channel::V1::ListPurchasableOffersRequest::ChangeOfferPurchase, ::Hash]
             #     List Offers for ChangeOffer purchase.
             #   @param customer [::String]
-            #     Required. The resource name of the customer for which to list Offers.
+            #     Required. The resource name of the customer to list Offers for.
             #     Format: accounts/\\{account_id}/customers/\\{customer_id}.
             #   @param page_size [::Integer]
             #     Optional. Requested page size. Server might return fewer results than requested.
-            #     If unspecified, at most 100 Offers will be returned.
-            #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+            #     If unspecified, returns at most 100 Offers.
+            #     The maximum value is 1000; the server will coerce values above 1000.
             #   @param page_token [::String]
-            #     Optional. A token identifying a page of results, if other than the first one.
+            #     Optional. A token for a page of results other than the first page.
             #   @param language_code [::String]
-            #     Optional. The BCP-47 language code, such as "en-US".  If specified, the
-            #     response will be localized to the corresponding language code. Default is
-            #     "en-US".
+            #     Optional. The BCP-47 language code. For example, "en-US". The
+            #     response will localize in the corresponding language code, if specified.
+            #     The default value is "en-US".
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Channel::V1::PurchasableOffer>]
@@ -3144,24 +3117,22 @@ module Google
 
             ##
             # Registers a service account with subscriber privileges on the Cloud Pub/Sub
-            # topic created for this Channel Services account. Once you create a
-            # subscriber, you will get the events as per {::Google::Cloud::Channel::V1::SubscriberEvent SubscriberEvent}
+            # topic for this Channel Services account. After you create a
+            # subscriber, you get the events through {::Google::Cloud::Channel::V1::SubscriberEvent SubscriberEvent}
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the reseller account making the request and the
-            # reseller account being provided are different, or if the impersonated user
+            # * 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: Missing or invalid required parameters in the
-            # request.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
             # * 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:
-            # Topic name with service email address registered if successful,
-            # otherwise error is returned.
+            # Return value:
+            # The topic name with the registered service email address.
             #
             # @overload register_subscriber(request, options = nil)
             #   Pass arguments to `register_subscriber` via a request object, either of type
@@ -3181,8 +3152,7 @@ module Google
             #   @param account [::String]
             #     Required. Resource name of the account.
             #   @param service_account [::String]
-            #     Required. Service account which will provide subscriber access to the
-            #     registered topic.
+            #     Required. Service account that provides subscriber access to the registered topic.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Channel::V1::RegisterSubscriberResponse]
@@ -3232,26 +3202,25 @@ module Google
             ##
             # Unregisters a service account with subscriber privileges on the Cloud
             # Pub/Sub topic created for this Channel Services account. If there are no
-            # more service account left with sunbscriber privileges, the topic will be
-            # deleted. You can check this by calling ListSubscribers api.
+            # service accounts left with subscriber privileges, this deletes the topic.
+            # You can call ListSubscribers to check for these accounts.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the reseller account making the request and the
-            # reseller account being provided are different, or if the impersonated user
+            # * 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: Missing or invalid required parameters in the
-            # request.
-            # * NOT_FOUND: If the topic resource doesn't exist.
+            # * 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. 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:
-            # Topic name from which service email address has been unregistered if
-            # successful, otherwise error is returned. If the service email was already
-            # not associated with the topic, the success response will be returned.
+            # 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.
             #
             # @overload unregister_subscriber(request, options = nil)
             #   Pass arguments to `unregister_subscriber` via a request object, either of type
@@ -3271,8 +3240,7 @@ module Google
             #   @param account [::String]
             #     Required. Resource name of the account.
             #   @param service_account [::String]
-            #     Required. Service account which will be unregistered from getting subscriber access
-            #     to the topic.
+            #     Required. Service account to unregister from subscriber access to the topic.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Channel::V1::UnregisterSubscriberResponse]
@@ -3323,22 +3291,20 @@ module Google
             # Lists service accounts with subscriber privileges on the Cloud Pub/Sub
             # topic created for this Channel Services account.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the reseller account making the request and the
-            # reseller account being provided are different, or if the account is not
-            # a super admin.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
-            # * NOT_FOUND: If the topic resource doesn't exist.
+            # * 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. 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:
-            # List of service email addresses if successful, otherwise error is
-            # returned.
+            # Return value:
+            # A list of service email addresses.
             #
             # @overload list_subscribers(request, options = nil)
             #   Pass arguments to `list_subscribers` via a request object, either of type
@@ -3360,14 +3326,14 @@ module Google
             #   @param page_size [::Integer]
             #     Optional. The maximum number of service accounts to return. The service may return
             #     fewer than this value.
-            #     If unspecified, at most 100 service accounts will be returned.
-            #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+            #     If unspecified, returns at most 100 service accounts.
+            #     The maximum value is 1000; the server will coerce values above 1000.
             #   @param page_token [::String]
             #     Optional. A page token, received from a previous `ListSubscribers` call.
             #     Provide this to retrieve the subsequent page.
             #
             #     When paginating, all other parameters provided to `ListSubscribers` must
-            #      match the call that provided the page token.
+            #     match the call that provided the page token.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Channel::V1::ListSubscribersResponse]
@@ -3506,7 +3472,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
@@ -3527,7 +3493,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
@@ -3676,6 +3642,11 @@ module Google
                 #
                 attr_reader :update_channel_partner_link
                 ##
+                # RPC-specific configuration for `lookup_offer`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :lookup_offer
+                ##
                 # RPC-specific configuration for `list_products`
                 # @return [::Gapic::Config::Method]
                 #
@@ -3718,71 +3689,73 @@ module Google
 
                 # @private
                 def initialize parent_rpcs = nil
-                  list_customers_config = parent_rpcs&.list_customers if parent_rpcs&.respond_to? :list_customers
+                  list_customers_config = parent_rpcs.list_customers if parent_rpcs.respond_to? :list_customers
                   @list_customers = ::Gapic::Config::Method.new list_customers_config
-                  get_customer_config = parent_rpcs&.get_customer if parent_rpcs&.respond_to? :get_customer
+                  get_customer_config = parent_rpcs.get_customer if parent_rpcs.respond_to? :get_customer
                   @get_customer = ::Gapic::Config::Method.new get_customer_config
-                  check_cloud_identity_accounts_exist_config = parent_rpcs&.check_cloud_identity_accounts_exist if parent_rpcs&.respond_to? :check_cloud_identity_accounts_exist
+                  check_cloud_identity_accounts_exist_config = parent_rpcs.check_cloud_identity_accounts_exist if parent_rpcs.respond_to? :check_cloud_identity_accounts_exist
                   @check_cloud_identity_accounts_exist = ::Gapic::Config::Method.new check_cloud_identity_accounts_exist_config
-                  create_customer_config = parent_rpcs&.create_customer if parent_rpcs&.respond_to? :create_customer
+                  create_customer_config = parent_rpcs.create_customer if parent_rpcs.respond_to? :create_customer
                   @create_customer = ::Gapic::Config::Method.new create_customer_config
-                  update_customer_config = parent_rpcs&.update_customer if parent_rpcs&.respond_to? :update_customer
+                  update_customer_config = parent_rpcs.update_customer if parent_rpcs.respond_to? :update_customer
                   @update_customer = ::Gapic::Config::Method.new update_customer_config
-                  delete_customer_config = parent_rpcs&.delete_customer if parent_rpcs&.respond_to? :delete_customer
+                  delete_customer_config = parent_rpcs.delete_customer if parent_rpcs.respond_to? :delete_customer
                   @delete_customer = ::Gapic::Config::Method.new delete_customer_config
-                  provision_cloud_identity_config = parent_rpcs&.provision_cloud_identity if parent_rpcs&.respond_to? :provision_cloud_identity
+                  provision_cloud_identity_config = parent_rpcs.provision_cloud_identity if parent_rpcs.respond_to? :provision_cloud_identity
                   @provision_cloud_identity = ::Gapic::Config::Method.new provision_cloud_identity_config
-                  list_entitlements_config = parent_rpcs&.list_entitlements if parent_rpcs&.respond_to? :list_entitlements
+                  list_entitlements_config = parent_rpcs.list_entitlements if parent_rpcs.respond_to? :list_entitlements
                   @list_entitlements = ::Gapic::Config::Method.new list_entitlements_config
-                  list_transferable_skus_config = parent_rpcs&.list_transferable_skus if parent_rpcs&.respond_to? :list_transferable_skus
+                  list_transferable_skus_config = parent_rpcs.list_transferable_skus if parent_rpcs.respond_to? :list_transferable_skus
                   @list_transferable_skus = ::Gapic::Config::Method.new list_transferable_skus_config
-                  list_transferable_offers_config = parent_rpcs&.list_transferable_offers if parent_rpcs&.respond_to? :list_transferable_offers
+                  list_transferable_offers_config = parent_rpcs.list_transferable_offers if parent_rpcs.respond_to? :list_transferable_offers
                   @list_transferable_offers = ::Gapic::Config::Method.new list_transferable_offers_config
-                  get_entitlement_config = parent_rpcs&.get_entitlement if parent_rpcs&.respond_to? :get_entitlement
+                  get_entitlement_config = parent_rpcs.get_entitlement if parent_rpcs.respond_to? :get_entitlement
                   @get_entitlement = ::Gapic::Config::Method.new get_entitlement_config
-                  create_entitlement_config = parent_rpcs&.create_entitlement if parent_rpcs&.respond_to? :create_entitlement
+                  create_entitlement_config = parent_rpcs.create_entitlement if parent_rpcs.respond_to? :create_entitlement
                   @create_entitlement = ::Gapic::Config::Method.new create_entitlement_config
-                  change_parameters_config = parent_rpcs&.change_parameters if parent_rpcs&.respond_to? :change_parameters
+                  change_parameters_config = parent_rpcs.change_parameters if parent_rpcs.respond_to? :change_parameters
                   @change_parameters = ::Gapic::Config::Method.new change_parameters_config
-                  change_renewal_settings_config = parent_rpcs&.change_renewal_settings if parent_rpcs&.respond_to? :change_renewal_settings
+                  change_renewal_settings_config = parent_rpcs.change_renewal_settings if parent_rpcs.respond_to? :change_renewal_settings
                   @change_renewal_settings = ::Gapic::Config::Method.new change_renewal_settings_config
-                  change_offer_config = parent_rpcs&.change_offer if parent_rpcs&.respond_to? :change_offer
+                  change_offer_config = parent_rpcs.change_offer if parent_rpcs.respond_to? :change_offer
                   @change_offer = ::Gapic::Config::Method.new change_offer_config
-                  start_paid_service_config = parent_rpcs&.start_paid_service if parent_rpcs&.respond_to? :start_paid_service
+                  start_paid_service_config = parent_rpcs.start_paid_service if parent_rpcs.respond_to? :start_paid_service
                   @start_paid_service = ::Gapic::Config::Method.new start_paid_service_config
-                  suspend_entitlement_config = parent_rpcs&.suspend_entitlement if parent_rpcs&.respond_to? :suspend_entitlement
+                  suspend_entitlement_config = parent_rpcs.suspend_entitlement if parent_rpcs.respond_to? :suspend_entitlement
                   @suspend_entitlement = ::Gapic::Config::Method.new suspend_entitlement_config
-                  cancel_entitlement_config = parent_rpcs&.cancel_entitlement if parent_rpcs&.respond_to? :cancel_entitlement
+                  cancel_entitlement_config = parent_rpcs.cancel_entitlement if parent_rpcs.respond_to? :cancel_entitlement
                   @cancel_entitlement = ::Gapic::Config::Method.new cancel_entitlement_config
-                  activate_entitlement_config = parent_rpcs&.activate_entitlement if parent_rpcs&.respond_to? :activate_entitlement
+                  activate_entitlement_config = parent_rpcs.activate_entitlement if parent_rpcs.respond_to? :activate_entitlement
                   @activate_entitlement = ::Gapic::Config::Method.new activate_entitlement_config
-                  transfer_entitlements_config = parent_rpcs&.transfer_entitlements if parent_rpcs&.respond_to? :transfer_entitlements
+                  transfer_entitlements_config = parent_rpcs.transfer_entitlements if parent_rpcs.respond_to? :transfer_entitlements
                   @transfer_entitlements = ::Gapic::Config::Method.new transfer_entitlements_config
-                  transfer_entitlements_to_google_config = parent_rpcs&.transfer_entitlements_to_google if parent_rpcs&.respond_to? :transfer_entitlements_to_google
+                  transfer_entitlements_to_google_config = parent_rpcs.transfer_entitlements_to_google if parent_rpcs.respond_to? :transfer_entitlements_to_google
                   @transfer_entitlements_to_google = ::Gapic::Config::Method.new transfer_entitlements_to_google_config
-                  list_channel_partner_links_config = parent_rpcs&.list_channel_partner_links if parent_rpcs&.respond_to? :list_channel_partner_links
+                  list_channel_partner_links_config = parent_rpcs.list_channel_partner_links if parent_rpcs.respond_to? :list_channel_partner_links
                   @list_channel_partner_links = ::Gapic::Config::Method.new list_channel_partner_links_config
-                  get_channel_partner_link_config = parent_rpcs&.get_channel_partner_link if parent_rpcs&.respond_to? :get_channel_partner_link
+                  get_channel_partner_link_config = parent_rpcs.get_channel_partner_link if parent_rpcs.respond_to? :get_channel_partner_link
                   @get_channel_partner_link = ::Gapic::Config::Method.new get_channel_partner_link_config
-                  create_channel_partner_link_config = parent_rpcs&.create_channel_partner_link if parent_rpcs&.respond_to? :create_channel_partner_link
+                  create_channel_partner_link_config = parent_rpcs.create_channel_partner_link if parent_rpcs.respond_to? :create_channel_partner_link
                   @create_channel_partner_link = ::Gapic::Config::Method.new create_channel_partner_link_config
-                  update_channel_partner_link_config = parent_rpcs&.update_channel_partner_link if parent_rpcs&.respond_to? :update_channel_partner_link
+                  update_channel_partner_link_config = parent_rpcs.update_channel_partner_link if parent_rpcs.respond_to? :update_channel_partner_link
                   @update_channel_partner_link = ::Gapic::Config::Method.new update_channel_partner_link_config
-                  list_products_config = parent_rpcs&.list_products if parent_rpcs&.respond_to? :list_products
+                  lookup_offer_config = parent_rpcs.lookup_offer if parent_rpcs.respond_to? :lookup_offer
+                  @lookup_offer = ::Gapic::Config::Method.new lookup_offer_config
+                  list_products_config = parent_rpcs.list_products if parent_rpcs.respond_to? :list_products
                   @list_products = ::Gapic::Config::Method.new list_products_config
-                  list_skus_config = parent_rpcs&.list_skus if parent_rpcs&.respond_to? :list_skus
+                  list_skus_config = parent_rpcs.list_skus if parent_rpcs.respond_to? :list_skus
                   @list_skus = ::Gapic::Config::Method.new list_skus_config
-                  list_offers_config = parent_rpcs&.list_offers if parent_rpcs&.respond_to? :list_offers
+                  list_offers_config = parent_rpcs.list_offers if parent_rpcs.respond_to? :list_offers
                   @list_offers = ::Gapic::Config::Method.new list_offers_config
-                  list_purchasable_skus_config = parent_rpcs&.list_purchasable_skus if parent_rpcs&.respond_to? :list_purchasable_skus
+                  list_purchasable_skus_config = parent_rpcs.list_purchasable_skus if parent_rpcs.respond_to? :list_purchasable_skus
                   @list_purchasable_skus = ::Gapic::Config::Method.new list_purchasable_skus_config
-                  list_purchasable_offers_config = parent_rpcs&.list_purchasable_offers if parent_rpcs&.respond_to? :list_purchasable_offers
+                  list_purchasable_offers_config = parent_rpcs.list_purchasable_offers if parent_rpcs.respond_to? :list_purchasable_offers
                   @list_purchasable_offers = ::Gapic::Config::Method.new list_purchasable_offers_config
-                  register_subscriber_config = parent_rpcs&.register_subscriber if parent_rpcs&.respond_to? :register_subscriber
+                  register_subscriber_config = parent_rpcs.register_subscriber if parent_rpcs.respond_to? :register_subscriber
                   @register_subscriber = ::Gapic::Config::Method.new register_subscriber_config
-                  unregister_subscriber_config = parent_rpcs&.unregister_subscriber if parent_rpcs&.respond_to? :unregister_subscriber
+                  unregister_subscriber_config = parent_rpcs.unregister_subscriber if parent_rpcs.respond_to? :unregister_subscriber
                   @unregister_subscriber = ::Gapic::Config::Method.new unregister_subscriber_config
-                  list_subscribers_config = parent_rpcs&.list_subscribers if parent_rpcs&.respond_to? :list_subscribers
+                  list_subscribers_config = parent_rpcs.list_subscribers if parent_rpcs.respond_to? :list_subscribers
                   @list_subscribers = ::Gapic::Config::Method.new list_subscribers_config
 
                   yield self if block_given?