google-cloud-channel-v1 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3260a1de5aa7d4c0fbe7e22d532c7d9ebde5284a9bc097a8a0c944ccbc86e27
-  data.tar.gz: 7f68f7c8800ee237f407bbc7d5f307071d9d3793ae3a4a281a105bac744123ad
+  metadata.gz: 1920f9872e068419e07b8e12f7e89da67827e4fd599c6d9b3f61488b8e98f374
+  data.tar.gz: e0606dd541251e3ef1eeb4241eff2a2f87dd8b9235e2e87625d27f97dfed065e
 SHA512:
-  metadata.gz: 86c20b359847f1a3de48ba140e727ab8f57e5b34cf5b42cf303826ed677cac79118315d2ae48e11cec3feb5eaf68f17ab443b37248eb3ac4c54d04818cc498e2
-  data.tar.gz: f91916ecc820390663e5e2ec20b4574cda2020d492e1544c871a7b0c8b890437b91284dc47a965a20d142d5da26eb1933f22ce163912393fc60dd338c33174fc
+  metadata.gz: a30e188b05f7a61707306df4c53a79bfea5d815cadb71778f0d10104fba2a3e80b0bd447fe40b2e6af2999da505800ce0a4a617f0e38362eadfe5f5258e73416
+  data.tar.gz: b82010ddebc0d89beef5b81fa60c25ff5202867833a1caaa13c5566aed7dd3258fa7f42ee5cb6ae5571f1f201ad3dcc82e015d974e83bafada48f4c27c16728f

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
@@ -213,18 +211,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:
-            # 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 +238,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.
             #
@@ -303,17 +299,16 @@ module Google
             ##
             # Returns a 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:
-            # {::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 +327,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 +375,21 @@ 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.
             #
-            # Return Value:
-            # List of {::Google::Cloud::Channel::V1::CloudIdentityCustomerAccount CloudIdentityCustomerAccount} resources for the domain.
-            # List may be empty.
+            # 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 is returned if
+            # 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)
@@ -414,10 +408,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]
@@ -468,18 +462,16 @@ module Google
             # Creates a new {::Google::Cloud::Channel::V1::Customer Customer} resource under the reseller or distributor
             # account.
             #
-            # 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: It can happen in following scenarios -
-            #     * Missing or invalid required parameters in the request.
-            #     * Domain field value doesn't match the domain specified in primary
-            #     email.
+            # * 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:
-            # If successful, the newly created {::Google::Cloud::Channel::V1::Customer Customer} resource, otherwise
-            # returns an error.
+            # 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
@@ -498,7 +490,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.
             #
@@ -548,21 +540,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:
-            # 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
@@ -633,15 +622,13 @@ module Google
             ##
             # Deletes the given {::Google::Cloud::Channel::V1::Customer Customer} permanently and irreversibly.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the account making the request does not own
+            # * PERMISSION_DENIED: The account making the request does not own
             # this customer.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
-            # * FAILED_PRECONDITION: If the customer has existing entitlements.
-            # * NOT_FOUND: No {::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
@@ -708,25 +695,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:
-            # 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)
@@ -752,8 +739,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]
@@ -802,16 +788,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:
-            # 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
@@ -829,16 +814,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.
             #
@@ -889,24 +874,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.
+            # 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:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: Appears because of one of the following -
-            #     * The customer doesn't belong to the reseller and no auth token.
+            # * 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 and the queries reseller
-            #     account are different.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the request.
+            #     * 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:
-            # List of {::Google::Cloud::Channel::V1::TransferableSku TransferableSku} for the given customer.
+            # 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
@@ -928,32 +913,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
@@ -1006,21 +990,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: Appears because of one of the following:
-            #     * If the customer doesn't belong to the reseller and no auth token or
-            #     invalid auth token is supplied.
-            #     * 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)
@@ -1042,24 +1025,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>]
@@ -1110,16 +1093,14 @@ module Google
             ##
             # Returns a 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:
-            # 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
@@ -1138,8 +1119,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]
@@ -1189,39 +1170,36 @@ module Google
             ##
             # Creates an entitlement for a customer.
             #
-            # Possible Error Codes:
-            #
-            # * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-            # * INVALID_ARGUMENT: It can happen in below scenarios -
-            #     * Missing or invalid required parameters in the request.
-            #     * Cannot purchase an entitlement if there is already an entitlement for
-            #     customer, for a SKU from the same product family.
-            #     * 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.
-            # * NOT_FOUND: If the customer or offer resource is not found for the
-            # reseller.
-            # * ALREADY_EXISTS: This failure can happen in the following cases:
-            #     * If the SKU has been already purchased for the customer.
-            #     * If the customer's primary email already exists. In this case retry
+            # 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: This failure can happen in the
-            # following cases:
-            #     * Purchasing a SKU that requires domain verification and the domain has
-            #     not been verified.
-            #     * Purchasing an Add-On SKU like Vault or Drive without purchasing the
-            #     pre-requisite SKU, such as Google Workspace Business Starter.
-            #     * Applicable only for developer accounts: reseller and resold domain.
-            #     Must meet the following domain naming requirements:
+            # * 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.
-            #         * Resold domain names must include the reseller domain.
+            #         * Domain names must include the reseller domain.
             # * 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.
+            # backend. Contact Cloud Channel support.
+            # * UNKNOWN: Any non-user error related to a technical issue in the backend.
+            # Contact Cloud Channel support.
             #
-            # Return Value:
-            # 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
@@ -1243,20 +1221,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
@@ -1309,26 +1286,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:
-            # 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
@@ -1351,24 +1327,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.
@@ -1422,24 +1395,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:
-            # 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
@@ -1462,19 +1434,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
@@ -1529,22 +1500,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:
-            # 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
@@ -1566,8 +1536,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.
@@ -1577,14 +1547,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
@@ -1640,24 +1609,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:
-            # 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
@@ -1679,18 +1647,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
@@ -1744,22 +1711,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:
-            # 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
@@ -1782,17 +1749,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
@@ -1846,27 +1812,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:
-            # 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
@@ -1890,17 +1855,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
@@ -1953,32 +1917,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:
-            # 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
@@ -2001,17 +1962,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
@@ -2066,31 +2026,29 @@ module Google
             ##
             # Transfers customer entitlements to new reseller.
             #
-            # 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 or offer resource is not found for the
-            # reseller.
-            # * ALREADY_EXISTS: If the SKU has been already transferred for the customer.
-            # * CONDITION_NOT_MET or FAILED_PRECONDITION: This failure can happen in the
-            # following cases:
-            #     * Transferring a SKU that requires domain verification and the domain
-            #     has not been verified.
-            #     * Transferring an Add-On SKU like Vault or Drive without transferring
-            #     the pre-requisite SKU, such as G Suite Basic.
-            #     * Applicable only for developer accounts: reseller and resold domain
-            #     must follow the domain naming convention as follows:
+            # 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.
-            #         * Resold domain names must include the reseller domain.
-            #     * All transferring entitlements must be specified.
-            # * INTERNAL: Any non-user error related to a technical issue in the backend.
-            # Please contact Cloud Channel Support in this case.
+            #         * 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.
-            # Please contact Cloud Channel Support in this case.
+            # Contact Cloud Channel support.
             #
-            # Return Value:
-            # 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
@@ -2112,26 +2070,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
@@ -2184,32 +2140,30 @@ module Google
             end
 
             ##
-            # Transfers customer entitlements from current reseller to Google.
-            #
-            # 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 or offer resource is not found for the
-            # reseller.
-            # * ALREADY_EXISTS: If the SKU has been already transferred for the customer.
-            # * CONDITION_NOT_MET or FAILED_PRECONDITION: This failure can happen in
-            # the following cases:
-            #     * Transferring a SKU that requires domain verification and the domain
-            #     has not been verified.
-            #     * Transferring an Add-On SKU like Vault or Drive without purchasing the
-            #     pre-requisite SKU, such as G Suite Basic.
-            #     * Applicable only for developer accounts: reseller and resold domain
-            #     must follow the domain naming convention as follows:
+            # 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.
-            #         * Resold domain names must include the reseller domain.
-            # * INTERNAL: Any non-user error related to a technical issue in the backend.
-            # Please contact Cloud Channel Support in this case.
+            #         * 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.
-            # Please contact Cloud Channel Support in this case.
+            # Contact Cloud Channel support.
             #
-            # Return Value:
-            # 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
@@ -2232,20 +2186,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
@@ -2299,18 +2252,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:
-            # 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
@@ -2330,14 +2281,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]
@@ -2391,19 +2342,18 @@ module Google
 
             ##
             # Returns a requested {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resource.
-            # To call this method, you must be a distributor.
+            # You must be a distributor to call this method.
             #
-            # Possible Error Codes:
+            # Possible error codes:
             #
-            # * PERMISSION_DENIED: If the reseller account making the request and the
-            # reseller account being queried for are different.
-            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.
-            # * NOT_FOUND: ChannelPartnerLink resource not found. Results
-            # due invalid channel partner link name.
+            # * PERMISSION_DENIED: The reseller account making the request is different
+            # from the reseller account in the API request.
+            # * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+            # * NOT_FOUND: ChannelPartnerLink resource not found because of an
+            # invalid channel partner link name.
             #
-            # Return Value:
-            # {::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
@@ -2422,7 +2372,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.
@@ -2473,30 +2423,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:
-            # 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
@@ -2514,9 +2462,9 @@ 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 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
@@ -2568,28 +2516,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:
-            #
-            # * PERMISSION_DENIED: If the reseller account making the request and the
-            # reseller account being queried for are different.
-            # * INVALID_ARGUMENT: It can happen in following scenarios -
-            #     * Missing or invalid required parameters in the request.
-            #     * Updating link state from invited to active or suspended.
-            #     * Sending reseller_cloud_identity_id, invite_url or name in update
+            # 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.
-            # 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:
-            # If successful, the updated {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink} resource, otherwise
-            # returns an error.
+            # 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
@@ -2608,14 +2555,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
@@ -2666,10 +2613,9 @@ module Google
             ##
             # 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
@@ -2691,14 +2637,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>]
@@ -2743,10 +2689,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
@@ -2764,23 +2709,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>]
@@ -2831,10 +2776,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
@@ -2853,23 +2797,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>]
@@ -2918,16 +2862,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
@@ -2949,18 +2892,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>]
@@ -3009,16 +2952,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
@@ -3040,18 +2982,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>]
@@ -3101,24 +3043,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
@@ -3138,8 +3078,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]
@@ -3189,26 +3128,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
@@ -3228,8 +3166,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]
@@ -3280,22 +3217,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
@@ -3317,14 +3252,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]