From 3e0defedb743a243e78fc307ae325ab939056dde Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Fri, 9 Apr 2021 10:36:19 -0700 Subject: [PATCH] docs: Update documentation comments to match tone and style with the rest of Cloud documentation (#69) This PR was generated using Autosynth. :rainbow: Synth log will be available here: https://source.cloud.google.com/results/invocations/d04c2fb0-ffe0-420e-b55b-f8d549dbb501/targets - [ ] To automatically regenerate this PR, check this box. (May take up to 24 hours.) PiperOrigin-RevId: 367097700 Source-Link: https://github.com/googleapis/googleapis/commit/ddb4f289890694d97902b0558f192a796e02728f feat: Adding customer level pubsub events for primary domain verification and primary domain change feat: Enabled support for boolean as an allowed parameter value feat: Added legacy_sku field to TransferableSku --- .../channel/v1/CloudChannelServiceClient.java | 1807 +++++----- .../google/cloud/channel/v1/package-info.java | 28 +- .../channel/v1/CloudChannelServiceGrpc.java | 3058 ++++++++--------- .../v1/ActivateEntitlementRequest.java | 105 +- .../ActivateEntitlementRequestOrBuilder.java | 30 +- .../channel/v1/CancelEntitlementRequest.java | 105 +- .../v1/CancelEntitlementRequestOrBuilder.java | 30 +- .../cloud/channel/v1/ChangeOfferRequest.java | 119 +- .../v1/ChangeOfferRequestOrBuilder.java | 34 +- .../channel/v1/ChangeParametersRequest.java | 209 +- .../v1/ChangeParametersRequestOrBuilder.java | 55 +- .../v1/ChangeRenewalSettingsRequest.java | 105 +- ...ChangeRenewalSettingsRequestOrBuilder.java | 30 +- ...heckCloudIdentityAccountsExistRequest.java | 42 +- ...IdentityAccountsExistRequestOrBuilder.java | 12 +- .../v1/CloudIdentityCustomerAccount.java | 91 +- ...CloudIdentityCustomerAccountOrBuilder.java | 24 +- .../cloud/channel/v1/CloudIdentityInfo.java | 32 +- .../v1/CloudIdentityInfoOrBuilder.java | 8 +- .../google/cloud/channel/v1/CommonProto.java | 34 +- .../v1/CreateChannelPartnerLinkRequest.java | 42 +- ...ateChannelPartnerLinkRequestOrBuilder.java | 12 +- .../channel/v1/CreateCustomerRequest.java | 14 +- .../v1/CreateCustomerRequestOrBuilder.java | 4 +- .../channel/v1/CreateEntitlementRequest.java | 119 +- .../v1/CreateEntitlementRequestOrBuilder.java | 34 +- .../cloud/channel/v1/CustomerEvent.java | 44 + .../cloud/channel/v1/EntitlementsProto.java | 27 +- .../v1/GetChannelPartnerLinkRequest.java | 14 +- ...GetChannelPartnerLinkRequestOrBuilder.java | 4 +- .../cloud/channel/v1/GetCustomerRequest.java | 14 +- .../v1/GetCustomerRequestOrBuilder.java | 4 +- .../channel/v1/GetEntitlementRequest.java | 28 +- .../v1/GetEntitlementRequestOrBuilder.java | 8 +- .../v1/ListChannelPartnerLinksRequest.java | 50 +- ...stChannelPartnerLinksRequestOrBuilder.java | 14 +- .../channel/v1/ListCustomersRequest.java | 72 +- .../v1/ListCustomersRequestOrBuilder.java | 20 +- .../channel/v1/ListCustomersResponse.java | 46 +- .../v1/ListCustomersResponseOrBuilder.java | 10 +- .../channel/v1/ListEntitlementsRequest.java | 86 +- .../v1/ListEntitlementsRequestOrBuilder.java | 24 +- .../channel/v1/ListEntitlementsResponse.java | 60 +- .../v1/ListEntitlementsResponseOrBuilder.java | 14 +- .../cloud/channel/v1/ListOffersRequest.java | 100 +- .../v1/ListOffersRequestOrBuilder.java | 28 +- .../cloud/channel/v1/ListProductsRequest.java | 72 +- .../v1/ListProductsRequestOrBuilder.java | 20 +- .../v1/ListPurchasableOffersRequest.java | 104 +- ...ListPurchasableOffersRequestOrBuilder.java | 24 +- .../v1/ListPurchasableSkusRequest.java | 86 +- .../ListPurchasableSkusRequestOrBuilder.java | 24 +- .../cloud/channel/v1/ListSkusRequest.java | 100 +- .../channel/v1/ListSkusRequestOrBuilder.java | 28 +- .../channel/v1/ListSubscribersRequest.java | 30 +- .../v1/ListSubscribersRequestOrBuilder.java | 8 +- .../v1/ListTransferableOffersRequest.java | 118 +- ...istTransferableOffersRequestOrBuilder.java | 34 +- .../v1/ListTransferableSkusRequest.java | 189 +- .../ListTransferableSkusRequestOrBuilder.java | 54 +- .../v1/ListTransferableSkusResponse.java | 69 +- ...ListTransferableSkusResponseOrBuilder.java | 15 +- .../v1/ProvisionCloudIdentityRequest.java | 12 +- ...rovisionCloudIdentityRequestOrBuilder.java | 3 +- .../cloud/channel/v1/PurchasableOffer.java | 4 +- .../cloud/channel/v1/PurchasableSku.java | 4 +- .../channel/v1/RegisterSubscriberRequest.java | 21 +- .../RegisterSubscriberRequestOrBuilder.java | 6 +- .../v1/RegisterSubscriberResponse.java | 14 +- .../RegisterSubscriberResponseOrBuilder.java | 4 +- .../channel/v1/StartPaidServiceRequest.java | 119 +- .../v1/StartPaidServiceRequestOrBuilder.java | 34 +- .../channel/v1/SubscriberEventProto.java | 43 +- .../channel/v1/SuspendEntitlementRequest.java | 105 +- .../SuspendEntitlementRequestOrBuilder.java | 30 +- .../v1/TransferEntitlementsRequest.java | 228 +- .../TransferEntitlementsRequestOrBuilder.java | 62 +- .../v1/TransferEntitlementsResponse.java | 50 +- ...TransferEntitlementsResponseOrBuilder.java | 10 +- .../TransferEntitlementsToGoogleRequest.java | 165 +- ...rEntitlementsToGoogleRequestOrBuilder.java | 44 +- .../cloud/channel/v1/TransferableSku.java | 286 ++ .../channel/v1/TransferableSkuOrBuilder.java | 38 + .../v1/UnregisterSubscriberRequest.java | 21 +- .../UnregisterSubscriberRequestOrBuilder.java | 6 +- .../v1/UnregisterSubscriberResponse.java | 21 +- ...UnregisterSubscriberResponseOrBuilder.java | 6 +- .../v1/UpdateChannelPartnerLinkRequest.java | 86 +- ...ateChannelPartnerLinkRequestOrBuilder.java | 22 +- .../com/google/cloud/channel/v1/Value.java | 136 + .../cloud/channel/v1/ValueOrBuilder.java | 25 + .../google/cloud/channel/v1/common.proto | 11 +- .../cloud/channel/v1/entitlements.proto | 3 + .../google/cloud/channel/v1/service.proto | 1204 +++---- .../cloud/channel/v1/subscriber_event.proto | 6 + synth.metadata | 6 +- 96 files changed, 5349 insertions(+), 5311 deletions(-) diff --git a/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/CloudChannelServiceClient.java b/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/CloudChannelServiceClient.java index 0844ac8a..ad720298 100644 --- a/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/CloudChannelServiceClient.java +++ b/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/CloudChannelServiceClient.java @@ -41,25 +41,23 @@ // AUTO-GENERATED DOCUMENTATION AND CLASS. /** - * Service Description: CloudChannelService enables Google cloud resellers and distributors to - * manage their customers, channel partners, entitlements and reports. + * Service Description: 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. + *

Using this service: 1. Resellers and distributors can manage a customer entity. 2. + * Distributors can register an authorized reseller in their channel and provide them with delegated + * admin access. 3. Resellers and distributors can manage customer entitlements. * - *

The service primarily exposes the following resources: - - * [Customer][google.cloud.channel.v1.Customer]s: A Customer represents an entity managed by a - * reseller or distributor. A customer typically represents an enterprise. In an n-tier resale - * channel hierarchy, customers are generally represented as leaf nodes. Customers primarily have an - * Entitlement sub-resource discussed below. + *

CloudChannelService exposes the following resources: - + * [Customer][google.cloud.channel.v1.Customer]s: An entity?usually an enterprise?managed by a + * reseller or distributor. * - *

- [Entitlement][google.cloud.channel.v1.Entitlement]s: An Entitlement represents an entity - * which provides a customer means to start using a service. Entitlements are created or updated as - * a result of a successful fulfillment. + *

- [Entitlement][google.cloud.channel.v1.Entitlement]s: An entity that provides a customer with + * the means to use a service. Entitlements are created or updated as a result of a successful + * fulfillment. * - *

- [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: A ChannelPartnerLink is - * an entity that identifies links between distributors and their indirect resellers in a channel. + *

- [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: An entity that identifies + * links between distributors and their indirect resellers in a channel. * *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: @@ -186,18 +184,18 @@ public final OperationsClient getOperationsClient() { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * List downstream [Customer][google.cloud.channel.v1.Customer]s. + * List [Customer][google.cloud.channel.v1.Customer]s. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: List of [Customer][google.cloud.channel.v1.Customer]s pertaining to the - * reseller or empty list if there are none. + *

Return value: List of [Customer][google.cloud.channel.v1.Customer]s, or an empty list if + * there are no customers. * *

Sample code: * @@ -224,18 +222,18 @@ public final ListCustomersPagedResponse listCustomers(ListCustomersRequest reque // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * List downstream [Customer][google.cloud.channel.v1.Customer]s. + * List [Customer][google.cloud.channel.v1.Customer]s. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: List of [Customer][google.cloud.channel.v1.Customer]s pertaining to the - * reseller or empty list if there are none. + *

Return value: List of [Customer][google.cloud.channel.v1.Customer]s, or an empty list if + * there are no customers. * *

Sample code: * @@ -263,18 +261,18 @@ public final ListCustomersPagedResponse listCustomers(ListCustomersRequest reque // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * List downstream [Customer][google.cloud.channel.v1.Customer]s. + * List [Customer][google.cloud.channel.v1.Customer]s. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: List of [Customer][google.cloud.channel.v1.Customer]s pertaining to the - * reseller or empty list if there are none. + *

Return value: List of [Customer][google.cloud.channel.v1.Customer]s, or an empty list if + * there are no customers. * *

Sample code: * @@ -310,18 +308,17 @@ public final UnaryCallable listCust /** * Returns a requested [Customer][google.cloud.channel.v1.Customer] resource. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: [Customer][google.cloud.channel.v1.Customer] resource if found, error - * otherwise. + *

Return value: The [Customer][google.cloud.channel.v1.Customer] resource. * *

Sample code: * @@ -332,7 +329,7 @@ public final UnaryCallable listCust * } * } * - * @param name Required. The resource name of the customer to retrieve. The name takes the format: + * @param name Required. The resource name of the customer to retrieve. Name uses the format: * accounts/{account_id}/customers/{customer_id} * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -346,18 +343,17 @@ public final Customer getCustomer(CustomerName name) { /** * Returns a requested [Customer][google.cloud.channel.v1.Customer] resource. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: [Customer][google.cloud.channel.v1.Customer] resource if found, error - * otherwise. + *

Return value: The [Customer][google.cloud.channel.v1.Customer] resource. * *

Sample code: * @@ -368,7 +364,7 @@ public final Customer getCustomer(CustomerName name) { * } * } * - * @param name Required. The resource name of the customer to retrieve. The name takes the format: + * @param name Required. The resource name of the customer to retrieve. Name uses the format: * accounts/{account_id}/customers/{customer_id} * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -381,18 +377,17 @@ public final Customer getCustomer(String name) { /** * Returns a requested [Customer][google.cloud.channel.v1.Customer] resource. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: [Customer][google.cloud.channel.v1.Customer] resource if found, error - * otherwise. + *

Return value: The [Customer][google.cloud.channel.v1.Customer] resource. * *

Sample code: * @@ -417,18 +412,17 @@ public final Customer getCustomer(GetCustomerRequest request) { /** * Returns a requested [Customer][google.cloud.channel.v1.Customer] resource. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: [Customer][google.cloud.channel.v1.Customer] resource if found, error - * otherwise. + *

Return value: The [Customer][google.cloud.channel.v1.Customer] resource. * *

Sample code: * @@ -451,23 +445,23 @@ public final UnaryCallable getCustomerCallable() { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * 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: * *

* - *

Return Value: List of + *

Return value: A list of * [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources - * for the domain. List may be empty. + * for the domain (may be empty) * - *

Note: in the v1alpha1 version of the API, a NOT_FOUND error is returned if no + *

Note: in the v1alpha1 version of the API, a NOT_FOUND error returns if no * [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources * match the domain. * @@ -495,23 +489,23 @@ public final CheckCloudIdentityAccountsExistResponse checkCloudIdentityAccountsE // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * 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: * *

* - *

Return Value: List of + *

Return value: A list of * [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources - * for the domain. List may be empty. + * for the domain (may be empty) * - *

Note: in the v1alpha1 version of the API, a NOT_FOUND error is returned if no + *

Note: in the v1alpha1 version of the API, a NOT_FOUND error returns if no * [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources * match the domain. * @@ -542,18 +536,16 @@ public final CheckCloudIdentityAccountsExistResponse checkCloudIdentityAccountsE * Creates a new [Customer][google.cloud.channel.v1.Customer] resource under the reseller or * distributor account. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: If successful, the newly created [Customer][google.cloud.channel.v1.Customer] - * resource, otherwise returns an error. + *

Return value: The newly created [Customer][google.cloud.channel.v1.Customer] resource. * *

Sample code: * @@ -580,18 +572,16 @@ public final Customer createCustomer(CreateCustomerRequest request) { * Creates a new [Customer][google.cloud.channel.v1.Customer] resource under the reseller or * distributor account. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: If successful, the newly created [Customer][google.cloud.channel.v1.Customer] - * resource, otherwise returns an error. + *

Return value: The newly created [Customer][google.cloud.channel.v1.Customer] resource. * *

Sample code: * @@ -615,21 +605,20 @@ public final UnaryCallable createCustomerCallab // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Updates an existing [Customer][google.cloud.channel.v1.Customer] resource belonging to the - * reseller or distributor. + * Updates an existing [Customer][google.cloud.channel.v1.Customer] resource for the reseller or + * distributor. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: If successful, the updated [Customer][google.cloud.channel.v1.Customer] - * resource, otherwise returns an error. + *

Return value: The updated [Customer][google.cloud.channel.v1.Customer] resource. * *

Sample code: * @@ -653,21 +642,20 @@ public final Customer updateCustomer(UpdateCustomerRequest request) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Updates an existing [Customer][google.cloud.channel.v1.Customer] resource belonging to the - * reseller or distributor. + * Updates an existing [Customer][google.cloud.channel.v1.Customer] resource for the reseller or + * distributor. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: If successful, the updated [Customer][google.cloud.channel.v1.Customer] - * resource, otherwise returns an error. + *

Return value: The updated [Customer][google.cloud.channel.v1.Customer] resource. * *

Sample code: * @@ -693,14 +681,14 @@ public final UnaryCallable updateCustomerCallab /** * Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently and irreversibly. * - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -725,14 +713,14 @@ public final void deleteCustomer(CustomerName name) { /** * Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently and irreversibly. * - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -756,14 +744,14 @@ public final void deleteCustomer(String name) { /** * Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently and irreversibly. * - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -789,14 +777,14 @@ public final void deleteCustomer(DeleteCustomerRequest request) { /** * Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently and irreversibly. * - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -820,27 +808,27 @@ public final UnaryCallable deleteCustomerCallable( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Creates a Cloud Identity for the given customer using the customer's information or the - * information provided here, if present. + * Creates a Cloud Identity for the given customer using the customer's information, or the + * information provided here. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 instance of + * CloudChannelOperationsService. The Operation metadata contains an instance of * [OperationMetadata][google.cloud.channel.v1.OperationMetadata]. * *

Sample code: @@ -868,27 +856,27 @@ public final OperationFuture provisionCloudIdentity // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Creates a Cloud Identity for the given customer using the customer's information or the - * information provided here, if present. + * Creates a Cloud Identity for the given customer using the customer's information, or the + * information provided here. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 instance of + * CloudChannelOperationsService. The Operation metadata contains an instance of * [OperationMetadata][google.cloud.channel.v1.OperationMetadata]. * *

Sample code: @@ -916,27 +904,27 @@ public final OperationFuture provisionCloudIdentity // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Creates a Cloud Identity for the given customer using the customer's information or the - * information provided here, if present. + * Creates a Cloud Identity for the given customer using the customer's information, or the + * information provided here. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 instance of + * CloudChannelOperationsService. The Operation metadata contains an instance of * [OperationMetadata][google.cloud.channel.v1.OperationMetadata]. * *

Sample code: @@ -964,17 +952,16 @@ public final OperationFuture provisionCloudIdentity // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * List [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer. + * Lists [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: List of [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to the - * customer, or empty list if there are none. + *

Return value: A list of the customer's [Entitlement][google.cloud.channel.v1.Entitlement]s. * *

Sample code: * @@ -1001,17 +988,16 @@ public final ListEntitlementsPagedResponse listEntitlements(ListEntitlementsRequ // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * List [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer. + * Lists [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: List of [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to the - * customer, or empty list if there are none. + *

Return value: A list of the customer's [Entitlement][google.cloud.channel.v1.Entitlement]s. * *

Sample code: * @@ -1039,17 +1025,16 @@ public final ListEntitlementsPagedResponse listEntitlements(ListEntitlementsRequ // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * List [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer. + * Lists [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: List of [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to the - * customer, or empty list if there are none. + *

Return value: A list of the customer's [Entitlement][google.cloud.channel.v1.Entitlement]s. * *

Sample code: * @@ -1084,23 +1069,23 @@ public final ListEntitlementsPagedResponse listEntitlements(ListEntitlementsRequ // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on Cloud - * Identity ID or Customer Name in the request. + * List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on the + * Cloud Identity ID or Customer Name in the request. * - *

This method is used when a reseller lists the entitlements information of a customer that is - * not owned. The reseller should provide the customer's Cloud Identity ID or Customer Name. + *

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: * *

* - *

Return Value: List of [TransferableSku][google.cloud.channel.v1.TransferableSku] for the - * given customer. + *

Return value: A list of the customer's + * [TransferableSku][google.cloud.channel.v1.TransferableSku]. * *

Sample code: * @@ -1131,23 +1116,23 @@ public final ListTransferableSkusPagedResponse listTransferableSkus( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on Cloud - * Identity ID or Customer Name in the request. + * List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on the + * Cloud Identity ID or Customer Name in the request. * - *

This method is used when a reseller lists the entitlements information of a customer that is - * not owned. The reseller should provide the customer's Cloud Identity ID or Customer Name. + *

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: * *

* - *

Return Value: List of [TransferableSku][google.cloud.channel.v1.TransferableSku] for the - * given customer. + *

Return value: A list of the customer's + * [TransferableSku][google.cloud.channel.v1.TransferableSku]. * *

Sample code: * @@ -1177,23 +1162,23 @@ public final ListTransferableSkusPagedResponse listTransferableSkus( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on Cloud - * Identity ID or Customer Name in the request. + * List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on the + * Cloud Identity ID or Customer Name in the request. * - *

This method is used when a reseller lists the entitlements information of a customer that is - * not owned. The reseller should provide the customer's Cloud Identity ID or Customer Name. + *

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: * *

* - *

Return Value: List of [TransferableSku][google.cloud.channel.v1.TransferableSku] for the - * given customer. + *

Return value: A list of the customer's + * [TransferableSku][google.cloud.channel.v1.TransferableSku]. * *

Sample code: * @@ -1233,20 +1218,19 @@ public final ListTransferableSkusPagedResponse listTransferableSkus( * List [TransferableOffer][google.cloud.channel.v1.TransferableOffer]s of a customer based on * Cloud Identity ID or Customer Name in the request. * - *

This method is used when a reseller gets the entitlement information of a customer that is - * not owned. The reseller should provide the customer's Cloud Identity ID or Customer Name. + *

Use this method when a reseller gets the entitlement information of an unowned customer. The + * reseller should provide the customer's Cloud Identity ID or Customer Name. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: List of [TransferableOffer][google.cloud.channel.v1.TransferableOffer] for the + *

Return value: List of [TransferableOffer][google.cloud.channel.v1.TransferableOffer] for the * given customer and SKU. * *

Sample code: @@ -1281,20 +1265,19 @@ public final ListTransferableOffersPagedResponse listTransferableOffers( * List [TransferableOffer][google.cloud.channel.v1.TransferableOffer]s of a customer based on * Cloud Identity ID or Customer Name in the request. * - *

This method is used when a reseller gets the entitlement information of a customer that is - * not owned. The reseller should provide the customer's Cloud Identity ID or Customer Name. + *

Use this method when a reseller gets the entitlement information of an unowned customer. The + * reseller should provide the customer's Cloud Identity ID or Customer Name. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: List of [TransferableOffer][google.cloud.channel.v1.TransferableOffer] for the + *

Return value: List of [TransferableOffer][google.cloud.channel.v1.TransferableOffer] for the * given customer and SKU. * *

Sample code: @@ -1328,20 +1311,19 @@ public final ListTransferableOffersPagedResponse listTransferableOffers( * List [TransferableOffer][google.cloud.channel.v1.TransferableOffer]s of a customer based on * Cloud Identity ID or Customer Name in the request. * - *

This method is used when a reseller gets the entitlement information of a customer that is - * not owned. The reseller should provide the customer's Cloud Identity ID or Customer Name. + *

Use this method when a reseller gets the entitlement information of an unowned customer. The + * reseller should provide the customer's Cloud Identity ID or Customer Name. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: List of [TransferableOffer][google.cloud.channel.v1.TransferableOffer] for the + *

Return value: List of [TransferableOffer][google.cloud.channel.v1.TransferableOffer] for the * given customer and SKU. * *

Sample code: @@ -1381,16 +1363,15 @@ public final ListTransferableOffersPagedResponse listTransferableOffers( /** * Returns a requested [Entitlement][google.cloud.channel.v1.Entitlement] resource. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: If found, the requested [Entitlement][google.cloud.channel.v1.Entitlement] - * resource, otherwise returns an error. + *

Return value: The requested [Entitlement][google.cloud.channel.v1.Entitlement] resource. * *

Sample code: * @@ -1415,16 +1396,15 @@ public final Entitlement getEntitlement(GetEntitlementRequest request) { /** * Returns a requested [Entitlement][google.cloud.channel.v1.Entitlement] resource. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: If found, the requested [Entitlement][google.cloud.channel.v1.Entitlement] - * resource, otherwise returns an error. + *

Return value: The requested [Entitlement][google.cloud.channel.v1.Entitlement] resource. * *

Sample code: * @@ -1449,33 +1429,31 @@ public final UnaryCallable getEntitlementCal /** * Creates an entitlement for a customer. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 instance of @@ -1507,33 +1485,31 @@ public final OperationFuture createEntitlementAs /** * Creates an entitlement for a customer. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 instance of @@ -1565,33 +1541,31 @@ public final OperationFuture createEntitlementAs /** * Creates an entitlement for a customer. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 instance of @@ -1620,26 +1594,26 @@ public final UnaryCallable createEntitlemen // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * 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: * *

* - *

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 instance of @@ -1670,26 +1644,26 @@ public final OperationFuture changeParametersAsy // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * 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: * *

* - *

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 instance of @@ -1720,26 +1694,26 @@ public final OperationFuture changeParametersAsy // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * 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: * *

* - *

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 instance of @@ -1771,24 +1745,24 @@ public final UnaryCallable changeParametersC /** * 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: * *

* - *

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 instance of @@ -1820,24 +1794,24 @@ public final OperationFuture changeRenewalSettin /** * 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: * *

* - *

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 instance of @@ -1869,24 +1843,24 @@ public final OperationFuture changeRenewalSettin /** * 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: * *

* - *

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 instance of @@ -1918,22 +1892,22 @@ public final OperationFuture changeRenewalSettin /** * 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: * *

* - *

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 instance of @@ -1967,22 +1941,22 @@ public final OperationFuture changeOfferAsync( /** * 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: * *

* - *

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 instance of @@ -2016,22 +1990,22 @@ public final OperationFuture changeOfferAsync( /** * 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: * *

* - *

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 instance of @@ -2065,22 +2039,22 @@ public final UnaryCallable changeOfferCallable() * 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. + * plan is set up for a trial entitlement but has some trial days remaining. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 instance of @@ -2112,22 +2086,22 @@ public final OperationFuture startPaidServiceAsy * 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. + * plan is set up for a trial entitlement but has some trial days remaining. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 instance of @@ -2159,22 +2133,22 @@ public final OperationFuture startPaidServiceAsy * 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. + * plan is set up for a trial entitlement but has some trial days remaining. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 instance of @@ -2202,23 +2176,24 @@ public final UnaryCallable startPaidServiceC // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Suspends a previously fulfilled entitlement. An entitlement suspension is a long-running - * operation. + * Suspends a previously fulfilled entitlement. + * + *

An entitlement suspension is a long-running operation. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 instance of @@ -2247,23 +2222,24 @@ public final OperationFuture suspendEntitlementA // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Suspends a previously fulfilled entitlement. An entitlement suspension is a long-running - * operation. + * Suspends a previously fulfilled entitlement. + * + *

An entitlement suspension is a long-running operation. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 instance of @@ -2292,23 +2268,24 @@ public final OperationFuture suspendEntitlementA // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Suspends a previously fulfilled entitlement. An entitlement suspension is a long-running - * operation. + * Suspends a previously fulfilled entitlement. + * + *

An entitlement suspension is a long-running operation. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 instance of @@ -2336,27 +2313,28 @@ public final UnaryCallable suspendEntitlem // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Cancels a previously fulfilled entitlement. An entitlement cancellation is a long-running - * operation. + * Cancels a previously fulfilled entitlement. + * + *

An entitlement cancellation is a long-running operation. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 google.protobuf.Empty on success. The @@ -2386,27 +2364,28 @@ public final OperationFuture cancelEntitlementAsync( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Cancels a previously fulfilled entitlement. An entitlement cancellation is a long-running - * operation. + * Cancels a previously fulfilled entitlement. + * + *

An entitlement cancellation is a long-running operation. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 google.protobuf.Empty on success. The @@ -2436,27 +2415,28 @@ public final OperationFuture cancelEntitlementAsync( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Cancels a previously fulfilled entitlement. An entitlement cancellation is a long-running - * operation. + * Cancels a previously fulfilled entitlement. + * + *

An entitlement cancellation is a long-running operation. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 google.protobuf.Empty on success. The @@ -2485,29 +2465,29 @@ public final UnaryCallable cancelEntitlemen // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * 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 - * the state of the customer entitlement. + * 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: * *

* - *

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 instance of @@ -2536,29 +2516,29 @@ public final OperationFuture activateEntitlement // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * 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 - * the state of the customer entitlement. + * 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: * *

* - *

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 instance of @@ -2587,29 +2567,29 @@ public final OperationFuture activateEntitlement // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * 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 - * the state of the customer entitlement. + * 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: * *

* - *

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 instance of @@ -2639,27 +2619,26 @@ public final UnaryCallable activateEntitl /** * Transfers customer entitlements to new reseller. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 instance of @@ -2693,27 +2672,26 @@ public final UnaryCallable activateEntitl /** * Transfers customer entitlements to new reseller. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 instance of @@ -2747,27 +2725,26 @@ public final UnaryCallable activateEntitl /** * Transfers customer entitlements to new reseller. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 instance of @@ -2798,29 +2775,28 @@ public final UnaryCallable activateEntitl // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Transfers customer entitlements from current reseller to Google. + * Transfers customer entitlements from their current reseller to Google. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 google.protobuf.Empty on success. The @@ -2851,29 +2827,28 @@ public final OperationFuture transferEntitlementsToGoo // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Transfers customer entitlements from current reseller to Google. + * Transfers customer entitlements from their current reseller to Google. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 google.protobuf.Empty on success. The @@ -2906,29 +2881,28 @@ public final OperationFuture transferEntitlementsToGoo // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Transfers customer entitlements from current reseller to Google. + * Transfers customer entitlements from their current reseller to Google. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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 google.protobuf.Empty on success. The @@ -2960,19 +2934,18 @@ public final OperationFuture transferEntitlementsToGoo // AUTO-GENERATED DOCUMENTATION AND METHOD. /** * List [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s belonging to a - * distributor. To call this method, you must be a distributor. + * distributor. You must be a distributor to call this method. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: If successful, returns the list of - * [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources for the distributor - * account, otherwise returns an error. + *

Return value: The list of the distributor account's + * [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources. * *

Sample code: * @@ -3003,19 +2976,18 @@ public final ListChannelPartnerLinksPagedResponse listChannelPartnerLinks( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** * List [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s belonging to a - * distributor. To call this method, you must be a distributor. + * distributor. You must be a distributor to call this method. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: If successful, returns the list of - * [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources for the distributor - * account, otherwise returns an error. + *

Return value: The list of the distributor account's + * [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources. * *

Sample code: * @@ -3045,19 +3017,18 @@ public final ListChannelPartnerLinksPagedResponse listChannelPartnerLinks( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** * List [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s belonging to a - * distributor. To call this method, you must be a distributor. + * distributor. You must be a distributor to call this method. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: If successful, returns the list of - * [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources for the distributor - * account, otherwise returns an error. + *

Return value: The list of the distributor account's + * [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources. * *

Sample code: * @@ -3094,20 +3065,19 @@ public final ListChannelPartnerLinksPagedResponse listChannelPartnerLinks( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** * Returns a requested [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource. - * To call this method, you must be a distributor. + * You must be a distributor to call this method. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if - * found, otherwise returns an error. + *

Return value: The [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource. * *

Sample code: * @@ -3132,20 +3102,19 @@ public final ChannelPartnerLink getChannelPartnerLink(GetChannelPartnerLinkReque // AUTO-GENERATED DOCUMENTATION AND METHOD. /** * Returns a requested [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource. - * To call this method, you must be a distributor. + * You must be a distributor to call this method. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if - * found, otherwise returns an error. + *

Return value: The [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource. * *

Sample code: * @@ -3170,27 +3139,27 @@ public final ChannelPartnerLink getChannelPartnerLink(GetChannelPartnerLinkReque // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * 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. + * Initiates a channel partner link between a distributor and a reseller, or between resellers in + * an n-tier reseller channel. 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: + *

Possible error codes: * *

* - *

Return Value: Newly created [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] - * resource if successful, otherwise error is returned. + *

Return value: The new [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] + * resource. * *

Sample code: * @@ -3215,27 +3184,27 @@ public final ChannelPartnerLink createChannelPartnerLink( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * 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. + * Initiates a channel partner link between a distributor and a reseller, or between resellers in + * an n-tier reseller channel. 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: + *

Possible error codes: * *

* - *

Return Value: Newly created [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] - * resource if successful, otherwise error is returned. + *

Return value: The new [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] + * resource. * *

Sample code: * @@ -3260,27 +3229,26 @@ public final ChannelPartnerLink createChannelPartnerLink( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * 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. + * 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: + *

Possible error codes: * *

* - *

Return Value: If successful, the updated - * [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource, otherwise returns an - * error. + *

Return value: The updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] + * resource. * *

Sample code: * @@ -3306,27 +3274,26 @@ public final ChannelPartnerLink updateChannelPartnerLink( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * 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. + * 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: + *

Possible error codes: * *

* - *

Return Value: If successful, the updated - * [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource, otherwise returns an - * error. + *

Return value: The updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] + * resource. * *

Sample code: * @@ -3354,10 +3321,10 @@ public final ChannelPartnerLink updateChannelPartnerLink( /** * Lists the Products the reseller is authorized to sell. * - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -3388,10 +3355,10 @@ public final ListProductsPagedResponse listProducts(ListProductsRequest request) /** * Lists the Products the reseller is authorized to sell. * - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -3423,10 +3390,10 @@ public final ListProductsPagedResponse listProducts(ListProductsRequest request) /** * Lists the Products the reseller is authorized to sell. * - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -3464,10 +3431,10 @@ public final UnaryCallable listProduc /** * Lists the SKUs for a product the reseller is authorized to sell. * - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -3499,10 +3466,10 @@ public final ListSkusPagedResponse listSkus(ListSkusRequest request) { /** * Lists the SKUs for a product the reseller is authorized to sell. * - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -3533,10 +3500,10 @@ public final UnaryCallable listSkusPaged /** * Lists the SKUs for a product the reseller is authorized to sell. * - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -3574,10 +3541,10 @@ public final UnaryCallable listSkusCallable() /** * Lists the Offers the reseller can sell. * - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -3609,10 +3576,10 @@ public final ListOffersPagedResponse listOffers(ListOffersRequest request) { /** * Lists the Offers the reseller can sell. * - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -3644,10 +3611,10 @@ public final UnaryCallable listOffer /** * Lists the Offers the reseller can sell. * - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -3683,18 +3650,18 @@ public final UnaryCallable listOffersCall // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Lists the Purchasable SKUs for following cases: + * Lists the following: * *

* - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -3725,18 +3692,18 @@ public final ListPurchasableSkusPagedResponse listPurchasableSkus( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Lists the Purchasable SKUs for following cases: + * Lists the following: * *

* - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -3766,18 +3733,18 @@ public final ListPurchasableSkusPagedResponse listPurchasableSkus( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Lists the Purchasable SKUs for following cases: + * Lists the following: * *

* - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -3814,18 +3781,18 @@ public final ListPurchasableSkusPagedResponse listPurchasableSkus( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Lists the Purchasable Offers for the following cases: + * Lists the following: * *

* - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -3856,18 +3823,18 @@ public final ListPurchasableOffersPagedResponse listPurchasableOffers( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Lists the Purchasable Offers for the following cases: + * Lists the following: * *

* - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -3897,18 +3864,18 @@ public final ListPurchasableOffersPagedResponse listPurchasableOffers( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Lists the Purchasable Offers for the following cases: + * Lists the following: * *

* - *

Possible Error Codes: + *

Possible error codes: * *

* *

Sample code: @@ -3945,24 +3912,23 @@ public final ListPurchasableOffersPagedResponse listPurchasableOffers( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * 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 + * Registers a service account with subscriber privileges on the Cloud Pub/Sub topic for this + * Channel Services account. After you create a subscriber, you get the events through * [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent] * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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. * *

Sample code: * @@ -3986,24 +3952,23 @@ public final RegisterSubscriberResponse registerSubscriber(RegisterSubscriberReq // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * 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 + * Registers a service account with subscriber privileges on the Cloud Pub/Sub topic for this + * Channel Services account. After you create a subscriber, you get the events through * [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent] * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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. * *

Sample code: * @@ -4029,25 +3994,24 @@ public final RegisterSubscriberResponse registerSubscriber(RegisterSubscriberReq // AUTO-GENERATED DOCUMENTATION AND METHOD. /** * 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. + * this Channel Services account. If there are no service accounts left with subscriber + * privileges, this deletes the topic. You can call ListSubscribers to check for these accounts. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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. * *

Sample code: * @@ -4074,25 +4038,24 @@ public final UnregisterSubscriberResponse unregisterSubscriber( // AUTO-GENERATED DOCUMENTATION AND METHOD. /** * 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. + * this Channel Services account. If there are no service accounts left with subscriber + * privileges, this deletes the topic. You can call ListSubscribers to check for these accounts. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

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. * *

Sample code: * @@ -4120,20 +4083,20 @@ public final UnregisterSubscriberResponse unregisterSubscriber( * Lists service accounts with subscriber privileges on the Cloud Pub/Sub topic created for this * Channel Services account. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: List of service email addresses if successful, otherwise error is returned. + *

Return value: A list of service email addresses. * *

Sample code: * @@ -4163,20 +4126,20 @@ public final ListSubscribersPagedResponse listSubscribers(ListSubscribersRequest * Lists service accounts with subscriber privileges on the Cloud Pub/Sub topic created for this * Channel Services account. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: List of service email addresses if successful, otherwise error is returned. + *

Return value: A list of service email addresses. * *

Sample code: * @@ -4207,20 +4170,20 @@ public final ListSubscribersPagedResponse listSubscribers(ListSubscribersRequest * Lists service accounts with subscriber privileges on the Cloud Pub/Sub topic created for this * Channel Services account. * - *

Possible Error Codes: + *

Possible error codes: * *

* - *

Return Value: List of service email addresses if successful, otherwise error is returned. + *

Return value: A list of service email addresses. * *

Sample code: * diff --git a/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/package-info.java b/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/package-info.java index 5edb495d..229a2617 100644 --- a/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/package-info.java +++ b/google-cloud-channel/src/main/java/com/google/cloud/channel/v1/package-info.java @@ -19,25 +19,23 @@ * *

======================= CloudChannelServiceClient ======================= * - *

Service Description: CloudChannelService enables Google cloud resellers and distributors to - * manage their customers, channel partners, entitlements and reports. + *

Service Description: 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. + *

Using this service: 1. Resellers and distributors can manage a customer entity. 2. + * Distributors can register an authorized reseller in their channel and provide them with delegated + * admin access. 3. Resellers and distributors can manage customer entitlements. * - *

The service primarily exposes the following resources: - - * [Customer][google.cloud.channel.v1.Customer]s: A Customer represents an entity managed by a - * reseller or distributor. A customer typically represents an enterprise. In an n-tier resale - * channel hierarchy, customers are generally represented as leaf nodes. Customers primarily have an - * Entitlement sub-resource discussed below. + *

CloudChannelService exposes the following resources: - + * [Customer][google.cloud.channel.v1.Customer]s: An entity?usually an enterprise?managed by a + * reseller or distributor. * - *

- [Entitlement][google.cloud.channel.v1.Entitlement]s: An Entitlement represents an entity - * which provides a customer means to start using a service. Entitlements are created or updated as - * a result of a successful fulfillment. + *

- [Entitlement][google.cloud.channel.v1.Entitlement]s: An entity that provides a customer with + * the means to use a service. Entitlements are created or updated as a result of a successful + * fulfillment. * - *

- [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: A ChannelPartnerLink is - * an entity that identifies links between distributors and their indirect resellers in a channel. + *

- [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: An entity that identifies + * links between distributors and their indirect resellers in a channel. * *

Sample for CloudChannelServiceClient: * diff --git a/grpc-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudChannelServiceGrpc.java b/grpc-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudChannelServiceGrpc.java index 1c271981..c68390f2 100644 --- a/grpc-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudChannelServiceGrpc.java +++ b/grpc-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudChannelServiceGrpc.java @@ -21,23 +21,21 @@ * * * 

- * 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.
- * The service primarily exposes the following resources:
- * - [Customer][google.cloud.channel.v1.Customer]s: A Customer represents an entity managed by a reseller or
- * distributor. A customer typically represents an enterprise. In an n-tier
- * resale channel hierarchy, customers are generally represented as leaf nodes.
- * Customers primarily have an Entitlement sub-resource discussed below.
- * - [Entitlement][google.cloud.channel.v1.Entitlement]s: An Entitlement represents an entity which provides a
- * customer means to start using a service. Entitlements are created or updated
- * as a result of a successful fulfillment.
- * - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: A ChannelPartnerLink is an entity that identifies
- * links between distributors and their indirect resellers in a channel.
+ * 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.
+ * CloudChannelService exposes the following resources:
+ * - [Customer][google.cloud.channel.v1.Customer]s: An entity—usually an enterprise—managed by a reseller or
+ * distributor.
+ * - [Entitlement][google.cloud.channel.v1.Entitlement]s: An entity that provides a customer with the means to use
+ * a service. Entitlements are created or updated as a result of a successful
+ * fulfillment.
+ * - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: An entity that identifies links between
+ * distributors and their indirect resellers in a channel.
  *
*/ @javax.annotation.Generated( @@ -1658,23 +1656,21 @@ public CloudChannelServiceFutureStub newStub( * * * 
-   * 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.
-   * The service primarily exposes the following resources:
-   * - [Customer][google.cloud.channel.v1.Customer]s: A Customer represents an entity managed by a reseller or
-   * distributor. A customer typically represents an enterprise. In an n-tier
-   * resale channel hierarchy, customers are generally represented as leaf nodes.
-   * Customers primarily have an Entitlement sub-resource discussed below.
-   * - [Entitlement][google.cloud.channel.v1.Entitlement]s: An Entitlement represents an entity which provides a
-   * customer means to start using a service. Entitlements are created or updated
-   * as a result of a successful fulfillment.
-   * - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: A ChannelPartnerLink is an entity that identifies
-   * links between distributors and their indirect resellers in a channel.
+   * 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.
+   * CloudChannelService exposes the following resources:
+   * - [Customer][google.cloud.channel.v1.Customer]s: An entity—usually an enterprise—managed by a reseller or
+   * distributor.
+   * - [Entitlement][google.cloud.channel.v1.Entitlement]s: An entity that provides a customer with the means to use
+   * a service. Entitlements are created or updated as a result of a successful
+   * fulfillment.
+   * - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: An entity that identifies links between
+   * distributors and their indirect resellers in a channel.
    *
*/ public abstract static class CloudChannelServiceImplBase implements io.grpc.BindableService { @@ -1683,15 +1679,13 @@ public abstract static class CloudChannelServiceImplBase implements io.grpc.Bind * * * 
-     * List downstream [Customer][google.cloud.channel.v1.Customer]s.
-     * 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.
-     * Return Value:
-     * List of [Customer][google.cloud.channel.v1.Customer]s pertaining to the reseller or empty list if
-     * there are none.
+     * List [Customer][google.cloud.channel.v1.Customer]s.
+     * 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.
+     * Return value:
+     * List of [Customer][google.cloud.channel.v1.Customer]s, or an empty list if there are no customers.
      *
*/ public void listCustomers( @@ -1707,15 +1701,14 @@ public void listCustomers( * * 
      * Returns a requested [Customer][google.cloud.channel.v1.Customer] resource.
-     * 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.
-     * Return Value:
-     * [Customer][google.cloud.channel.v1.Customer] resource if found, error otherwise.
+     * 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.
+     * * NOT_FOUND: The customer resource doesn't exist. Usually the result of an
+     * invalid name parameter.
+     * Return value:
+     * The [Customer][google.cloud.channel.v1.Customer] resource.
      *
*/ public void getCustomer( @@ -1729,18 +1722,17 @@ public void getCustomer( * * * 
-     * Confirms the existence of Cloud Identity accounts, based on the domain and
-     * whether the Cloud Identity accounts are owned by the reseller.
-     * 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.
+     * 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:
+     * * 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 [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources for the domain.
-     * List may be empty.
-     * Note: in the v1alpha1 version of the API, a NOT_FOUND error is returned if
+     * Return value:
+     * A list of [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources for the domain (may be
+     * empty)
+     * Note: in the v1alpha1 version of the API, a NOT_FOUND error returns if
      * no [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources match the domain.
      *
*/ @@ -1759,16 +1751,14 @@ public void checkCloudIdentityAccountsExist( * 
      * Creates a new [Customer][google.cloud.channel.v1.Customer] resource under the reseller or distributor
      * account.
-     * 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.
-     * Return Value:
-     * If successful, the newly created [Customer][google.cloud.channel.v1.Customer] resource, otherwise
-     * returns an error.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request is different
+     * from the reseller account in the API request.
+     * * INVALID_ARGUMENT:
+     *     * Required request parameters are missing or invalid.
+     *     * Domain field value doesn't match the primary email domain.
+     * Return value:
+     * The newly created [Customer][google.cloud.channel.v1.Customer] resource.
      *
*/ public void createCustomer( @@ -1782,18 +1772,15 @@ public void createCustomer( * * * 
-     * Updates an existing [Customer][google.cloud.channel.v1.Customer] resource belonging to the reseller or
+     * Updates an existing [Customer][google.cloud.channel.v1.Customer] resource for the reseller or
      * distributor.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the reseller account making the request and the
-     * reseller account being queried for are different.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
-     * * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name
-     * specified in the request.
-     * Return Value:
-     * If successful, the updated [Customer][google.cloud.channel.v1.Customer] resource, otherwise returns
-     * an error.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request is different
+     * from the reseller account in the API request.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name in the request.
+     * Return value:
+     * The updated [Customer][google.cloud.channel.v1.Customer] resource.
      *
*/ public void updateCustomer( @@ -1808,14 +1795,12 @@ public void updateCustomer( * * 
      * Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently and irreversibly.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the account making the request does not own
+     * Possible error codes:
+     * * PERMISSION_DENIED: The account making the request does not own
      * this customer.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
-     * * FAILED_PRECONDITION: If the customer has existing entitlements.
-     * * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name
-     * specified in the request.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * * FAILED_PRECONDITION: The customer has existing entitlements.
+     * * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name in the request.
      *
*/ public void deleteCustomer( @@ -1830,21 +1815,21 @@ public void deleteCustomer( * * 
      * Creates a Cloud Identity for the given customer using the customer's
-     * information or the information provided here, if present.
-     * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * information, or the information provided here.
+     * 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 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:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
-     * CloudChannelOperationsService. The Operation metadata will contain an
+     * CloudChannelOperationsService. The Operation metadata contains an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
      *
*/ @@ -1859,13 +1844,12 @@ public void provisionCloudIdentity( * * * 
-     * List [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the request.
-     * Return Value:
-     * List of [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to the customer, or empty list if
-     * there are none.
+     * Lists [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * Return value:
+     * A list of the customer's [Entitlement][google.cloud.channel.v1.Entitlement]s.
      *
*/ public void listEntitlements( @@ -1880,20 +1864,20 @@ public void listEntitlements( * * * 
-     * List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on Cloud Identity ID or
+     * List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on the Cloud Identity ID or
      * Customer Name in the request.
-     * This method is used when a reseller lists the entitlements
-     * information of a customer that is not owned. The reseller should provide
-     * the customer's Cloud Identity ID or Customer Name.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: Appears because of one of the following -
-     *     * The customer doesn't belong to the reseller and no auth token.
+     * Use this method to list the entitlements information of an
+     * unowned customer. You should provide the customer's
+     * Cloud Identity ID or Customer Name.
+     * Possible error codes:
+     * * PERMISSION_DENIED:
+     *     * The customer doesn't belong to the reseller and has no auth token.
      *     * The supplied auth token is invalid.
-     *     * The reseller account making the request and the queries reseller
-     *     account are different.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the request.
-     * Return Value:
-     * List of [TransferableSku][google.cloud.channel.v1.TransferableSku] for the given customer.
+     *     * The reseller account making the request is different
+     *     from the reseller account in the query.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * Return value:
+     * A list of the customer's [TransferableSku][google.cloud.channel.v1.TransferableSku].
      *
*/ public void listTransferableSkus( @@ -1910,18 +1894,17 @@ public void listTransferableSkus( * 
      * List [TransferableOffer][google.cloud.channel.v1.TransferableOffer]s of a customer based on Cloud Identity ID or
      * Customer Name in the request.
-     * This method is used when a reseller gets the entitlement
-     * information of a customer that is not owned. The reseller should provide
-     * the customer's Cloud Identity ID or Customer Name.
-     * 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.
-     * Return Value:
+     * 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:
+     * * 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:
      * List of [TransferableOffer][google.cloud.channel.v1.TransferableOffer] for the given customer and SKU.
      *
*/ @@ -1938,14 +1921,12 @@ public void listTransferableOffers( * * 
      * Returns a requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
-     * 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.
-     * Return Value:
-     * If found, the requested [Entitlement][google.cloud.channel.v1.Entitlement] resource, otherwise returns
-     * an error.
+     * 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 entitlement was not found.
+     * Return value:
+     * The requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
      *
*/ public void getEntitlement( @@ -1960,37 +1941,34 @@ public void getEntitlement( * * 
      * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -2007,22 +1985,21 @@ public void createEntitlement(
      *
      *
      * 
-     * 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.
-     * 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.
+     * Change parameters of the entitlement.
+     * An entitlement update is a long-running operation and it updates the
+     * entitlement as a result of fulfillment.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -2040,21 +2017,20 @@ public void changeParameters(
      *
      * 
      * 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.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * An entitlement update is a long-running operation and it updates the
+     * entitlement as a result of fulfillment.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * 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:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -2072,19 +2048,18 @@ public void changeRenewalSettings(
      *
      * 
      * 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.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * An entitlement update is a long-running operation and it updates the
+     * entitlement as a result of fulfillment.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -2103,21 +2078,20 @@ public void changeOffer(
      * 
      * 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.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * only applicable if a plan is set up for a trial entitlement but has some
+     * trial days remaining.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * * INTERNAL: Any non-user error related to a technical issue in the
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -2136,18 +2110,17 @@ public void startPaidService(
      * 
      * Suspends a previously fulfilled entitlement.
      * An entitlement suspension is a long-running operation.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -2166,23 +2139,21 @@ public void suspendEntitlement(
      * 
      * Cancels a previously fulfilled entitlement.
      * An entitlement cancellation is a long-running operation.
-     * 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
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The response will contain
      * google.protobuf.Empty on success. The Operation metadata will contain an
@@ -2200,29 +2171,25 @@ public void cancelEntitlement(
      *
      *
      * 
-     * 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:
-     * * 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.
+     * 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.
      * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -2240,29 +2207,27 @@ public void activateEntitlement(
      *
      * 
      * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -2279,29 +2244,27 @@ public void transferEntitlements(
      *
      *
      * 
-     * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The response will contain
      * google.protobuf.Empty on success. The Operation metadata will contain an
@@ -2320,15 +2283,13 @@ public void transferEntitlementsToGoogle(
      *
      * 
      * List [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s belonging to a distributor.
-     * 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.
-     * Return Value:
-     * If successful, returns the list of [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources
-     * for the distributor account, otherwise returns an error.
+     * 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.
+     * Return value:
+     * The list of the distributor account's [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources.
      * 

      */
     public void listChannelPartnerLinks(
@@ -2344,16 +2305,15 @@ public void listChannelPartnerLinks(
      *
      * 
      * Returns a requested [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
-     * 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.
-     * * NOT_FOUND: ChannelPartnerLink resource not found. Results
-     * due invalid channel partner link name.
-     * Return Value:
-     * [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if found, otherwise returns an error.
+     * 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.
+     * * NOT_FOUND: ChannelPartnerLink resource not found because of an
+     * invalid channel partner link name.
+     * Return value:
+     * The [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
      * 

      */
     public void getChannelPartnerLink(
@@ -2368,27 +2328,25 @@ public void getChannelPartnerLink(
      *
      *
      * 
-     * 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.
-     * Return Value:
-     * Newly created [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if successful,
-     * otherwise error is returned.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The new [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
      * 

      */
     public void createChannelPartnerLink(
@@ -2403,25 +2361,24 @@ public void createChannelPartnerLink(
      *
      *
      * 
-     * 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.
-     * Return Value:
-     * If successful, the updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource, otherwise
-     * returns an error.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
      * 

      */
     public void updateChannelPartnerLink(
@@ -2437,9 +2394,8 @@ public void updateChannelPartnerLink(
      *
      * 
      * Lists the Products the reseller is authorized to sell.
-     * Possible Error Codes:
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Possible error codes:
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public void listProducts(
@@ -2455,9 +2411,8 @@ public void listProducts(
      *
      * 
      * Lists the SKUs for a product the reseller is authorized to sell.
-     * Possible Error Codes:
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Possible error codes:
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public void listSkus(
@@ -2472,9 +2427,8 @@ public void listSkus(
      *
      * 
      * Lists the Offers the reseller can sell.
-     * Possible Error Codes:
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Possible error codes:
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public void listOffers(
@@ -2488,13 +2442,12 @@ public void listOffers(
      *
      *
      * 
-     * Lists the Purchasable SKUs for following cases:
-     * * SKUs that can be newly purchased for a customer
-     * * SKUs that can be upgraded/downgraded to, for an entitlement.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Lists the following:
+     * * SKUs that you can purchase for a customer
+     * * SKUs that you can upgrade or downgrade for an entitlement.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public void listPurchasableSkus(
@@ -2509,13 +2462,12 @@ public void listPurchasableSkus(
      *
      *
      * 
-     * Lists the Purchasable Offers for the following cases:
-     * * Offers that can be newly purchased for a customer
-     * * Offers that can be changed to, for an entitlement.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Lists the following:
+     * * Offers that you can purchase for a customer.
+     * * Offers that you can change for an entitlement.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The customer doesn't belong to the reseller
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public void listPurchasableOffers(
@@ -2531,21 +2483,19 @@ public void listPurchasableOffers(
      *
      * 
      * 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 [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent]
-     * 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
+     * topic for this Channel Services account. After you create a
+     * subscriber, you get the events through [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent]
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request and the
+     * provided reseller account are different, or the impersonated user
      * is not a super admin.
-     * * INVALID_ARGUMENT: 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.
-     * Return Value:
-     * Topic name with service email address registered if successful,
-     * otherwise error is returned.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The topic name with the registered service email address.
      * 

      */
     public void registerSubscriber(
@@ -2562,23 +2512,22 @@ public void registerSubscriber(
      * 
      * 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.
-     * 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
+     * service accounts left with subscriber privileges, this deletes the topic.
+     * You can call ListSubscribers to check for these accounts.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request and the
+     * provided reseller account are different, or the impersonated user
      * is not a super admin.
-     * * INVALID_ARGUMENT: 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.
-     * 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.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The topic name that unregistered the service email address.
+     * Returns a success response if the service email address wasn't registered
+     * with the topic.
      * 

      */
     public void unregisterSubscriber(
@@ -2595,20 +2544,18 @@ public void unregisterSubscriber(
      * 
      * Lists service accounts with subscriber privileges on the Cloud Pub/Sub
      * topic created for this Channel Services account.
-     * 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.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request and the
+     * provided reseller account are different, or the impersonated user
+     * is not a super admin.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * * NOT_FOUND: The topic resource doesn't exist.
      * * INTERNAL: Any non-user error related to a technical issue in the
-     * backend. 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.
-     * Return Value:
-     * List of service email addresses if successful, otherwise error is
-     * returned.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * A list of service email addresses.
      * 

      */
     public void listSubscribers(
@@ -2844,23 +2791,21 @@ public final io.grpc.ServerServiceDefinition bindService() {
    *
    *
    * 
-   * 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.
-   * The service primarily exposes the following resources:
-   * - [Customer][google.cloud.channel.v1.Customer]s: A Customer represents an entity managed by a reseller or
-   * distributor. A customer typically represents an enterprise. In an n-tier
-   * resale channel hierarchy, customers are generally represented as leaf nodes.
-   * Customers primarily have an Entitlement sub-resource discussed below.
-   * - [Entitlement][google.cloud.channel.v1.Entitlement]s: An Entitlement represents an entity which provides a
-   * customer means to start using a service. Entitlements are created or updated
-   * as a result of a successful fulfillment.
-   * - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: A ChannelPartnerLink is an entity that identifies
-   * links between distributors and their indirect resellers in a channel.
+   * 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.
+   * CloudChannelService exposes the following resources:
+   * - [Customer][google.cloud.channel.v1.Customer]s: An entity—usually an enterprise—managed by a reseller or
+   * distributor.
+   * - [Entitlement][google.cloud.channel.v1.Entitlement]s: An entity that provides a customer with the means to use
+   * a service. Entitlements are created or updated as a result of a successful
+   * fulfillment.
+   * - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: An entity that identifies links between
+   * distributors and their indirect resellers in a channel.
    * 

    */
   public static final class CloudChannelServiceStub
@@ -2879,15 +2824,13 @@ protected CloudChannelServiceStub build(
      *
      *
      * 
-     * List downstream [Customer][google.cloud.channel.v1.Customer]s.
-     * 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.
-     * Return Value:
-     * List of [Customer][google.cloud.channel.v1.Customer]s pertaining to the reseller or empty list if
-     * there are none.
+     * List [Customer][google.cloud.channel.v1.Customer]s.
+     * 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.
+     * Return value:
+     * List of [Customer][google.cloud.channel.v1.Customer]s, or an empty list if there are no customers.
      * 

      */
     public void listCustomers(
@@ -2905,15 +2848,14 @@ public void listCustomers(
      *
      * 
      * Returns a requested [Customer][google.cloud.channel.v1.Customer] resource.
-     * 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.
-     * Return Value:
-     * [Customer][google.cloud.channel.v1.Customer] resource if found, error otherwise.
+     * 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.
+     * * NOT_FOUND: The customer resource doesn't exist. Usually the result of an
+     * invalid name parameter.
+     * Return value:
+     * The [Customer][google.cloud.channel.v1.Customer] resource.
      * 

      */
     public void getCustomer(
@@ -2929,18 +2871,17 @@ public void getCustomer(
      *
      *
      * 
-     * Confirms the existence of Cloud Identity accounts, based on the domain and
-     * whether the Cloud Identity accounts are owned by the reseller.
-     * 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.
+     * 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:
+     * * 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 [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources for the domain.
-     * List may be empty.
-     * Note: in the v1alpha1 version of the API, a NOT_FOUND error is returned if
+     * Return value:
+     * A list of [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources for the domain (may be
+     * empty)
+     * Note: in the v1alpha1 version of the API, a NOT_FOUND error returns if
      * no [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources match the domain.
      * 

      */
@@ -2961,16 +2902,14 @@ public void checkCloudIdentityAccountsExist(
      * 
      * Creates a new [Customer][google.cloud.channel.v1.Customer] resource under the reseller or distributor
      * account.
-     * 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.
-     * Return Value:
-     * If successful, the newly created [Customer][google.cloud.channel.v1.Customer] resource, otherwise
-     * returns an error.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request is different
+     * from the reseller account in the API request.
+     * * INVALID_ARGUMENT:
+     *     * Required request parameters are missing or invalid.
+     *     * Domain field value doesn't match the primary email domain.
+     * Return value:
+     * The newly created [Customer][google.cloud.channel.v1.Customer] resource.
      * 

      */
     public void createCustomer(
@@ -2986,18 +2925,15 @@ public void createCustomer(
      *
      *
      * 
-     * Updates an existing [Customer][google.cloud.channel.v1.Customer] resource belonging to the reseller or
+     * Updates an existing [Customer][google.cloud.channel.v1.Customer] resource for the reseller or
      * distributor.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the reseller account making the request and the
-     * reseller account being queried for are different.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
-     * * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name
-     * specified in the request.
-     * Return Value:
-     * If successful, the updated [Customer][google.cloud.channel.v1.Customer] resource, otherwise returns
-     * an error.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request is different
+     * from the reseller account in the API request.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name in the request.
+     * Return value:
+     * The updated [Customer][google.cloud.channel.v1.Customer] resource.
      * 

      */
     public void updateCustomer(
@@ -3014,14 +2950,12 @@ public void updateCustomer(
      *
      * 
      * Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently and irreversibly.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the account making the request does not own
+     * Possible error codes:
+     * * PERMISSION_DENIED: The account making the request does not own
      * this customer.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
-     * * FAILED_PRECONDITION: If the customer has existing entitlements.
-     * * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name
-     * specified in the request.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * * FAILED_PRECONDITION: The customer has existing entitlements.
+     * * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name in the request.
      * 

      */
     public void deleteCustomer(
@@ -3038,21 +2972,21 @@ public void deleteCustomer(
      *
      * 
      * Creates a Cloud Identity for the given customer using the customer's
-     * information or the information provided here, if present.
-     * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * information, or the information provided here.
+     * 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 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:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
-     * CloudChannelOperationsService. The Operation metadata will contain an
+     * CloudChannelOperationsService. The Operation metadata contains an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
      * 

      */
@@ -3069,13 +3003,12 @@ public void provisionCloudIdentity(
      *
      *
      * 
-     * List [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the request.
-     * Return Value:
-     * List of [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to the customer, or empty list if
-     * there are none.
+     * Lists [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * Return value:
+     * A list of the customer's [Entitlement][google.cloud.channel.v1.Entitlement]s.
      * 

      */
     public void listEntitlements(
@@ -3092,20 +3025,20 @@ public void listEntitlements(
      *
      *
      * 
-     * List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on Cloud Identity ID or
+     * List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on the Cloud Identity ID or
      * Customer Name in the request.
-     * This method is used when a reseller lists the entitlements
-     * information of a customer that is not owned. The reseller should provide
-     * the customer's Cloud Identity ID or Customer Name.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: Appears because of one of the following -
-     *     * The customer doesn't belong to the reseller and no auth token.
+     * Use this method to list the entitlements information of an
+     * unowned customer. You should provide the customer's
+     * Cloud Identity ID or Customer Name.
+     * Possible error codes:
+     * * PERMISSION_DENIED:
+     *     * The customer doesn't belong to the reseller and has no auth token.
      *     * The supplied auth token is invalid.
-     *     * The reseller account making the request and the queries reseller
-     *     account are different.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the request.
-     * Return Value:
-     * List of [TransferableSku][google.cloud.channel.v1.TransferableSku] for the given customer.
+     *     * The reseller account making the request is different
+     *     from the reseller account in the query.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * Return value:
+     * A list of the customer's [TransferableSku][google.cloud.channel.v1.TransferableSku].
      * 

      */
     public void listTransferableSkus(
@@ -3124,18 +3057,17 @@ public void listTransferableSkus(
      * 
      * List [TransferableOffer][google.cloud.channel.v1.TransferableOffer]s of a customer based on Cloud Identity ID or
      * Customer Name in the request.
-     * This method is used when a reseller gets the entitlement
-     * information of a customer that is not owned. The reseller should provide
-     * the customer's Cloud Identity ID or Customer Name.
-     * 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.
-     * Return Value:
+     * 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:
+     * * 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:
      * List of [TransferableOffer][google.cloud.channel.v1.TransferableOffer] for the given customer and SKU.
      * 

      */
@@ -3154,14 +3086,12 @@ public void listTransferableOffers(
      *
      * 
      * Returns a requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
-     * 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.
-     * Return Value:
-     * If found, the requested [Entitlement][google.cloud.channel.v1.Entitlement] resource, otherwise returns
-     * an error.
+     * 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 entitlement was not found.
+     * Return value:
+     * The requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
      * 

      */
     public void getEntitlement(
@@ -3178,37 +3108,34 @@ public void getEntitlement(
      *
      * 
      * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -3227,22 +3154,21 @@ public void createEntitlement(
      *
      *
      * 
-     * 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.
-     * 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.
+     * Change parameters of the entitlement.
+     * An entitlement update is a long-running operation and it updates the
+     * entitlement as a result of fulfillment.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -3262,21 +3188,20 @@ public void changeParameters(
      *
      * 
      * 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.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * An entitlement update is a long-running operation and it updates the
+     * entitlement as a result of fulfillment.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * 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:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -3296,19 +3221,18 @@ public void changeRenewalSettings(
      *
      * 
      * 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.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * An entitlement update is a long-running operation and it updates the
+     * entitlement as a result of fulfillment.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -3329,21 +3253,20 @@ public void changeOffer(
      * 
      * 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.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * only applicable if a plan is set up for a trial entitlement but has some
+     * trial days remaining.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * * INTERNAL: Any non-user error related to a technical issue in the
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -3364,18 +3287,17 @@ public void startPaidService(
      * 
      * Suspends a previously fulfilled entitlement.
      * An entitlement suspension is a long-running operation.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -3396,23 +3318,21 @@ public void suspendEntitlement(
      * 
      * Cancels a previously fulfilled entitlement.
      * An entitlement cancellation is a long-running operation.
-     * 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
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The response will contain
      * google.protobuf.Empty on success. The Operation metadata will contain an
@@ -3432,29 +3352,25 @@ public void cancelEntitlement(
      *
      *
      * 
-     * 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:
-     * * 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.
+     * 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.
      * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -3474,29 +3390,27 @@ public void activateEntitlement(
      *
      * 
      * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -3515,29 +3429,27 @@ public void transferEntitlements(
      *
      *
      * 
-     * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The response will contain
      * google.protobuf.Empty on success. The Operation metadata will contain an
@@ -3558,15 +3470,13 @@ public void transferEntitlementsToGoogle(
      *
      * 
      * List [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s belonging to a distributor.
-     * 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.
-     * Return Value:
-     * If successful, returns the list of [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources
-     * for the distributor account, otherwise returns an error.
+     * 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.
+     * Return value:
+     * The list of the distributor account's [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources.
      * 

      */
     public void listChannelPartnerLinks(
@@ -3584,16 +3494,15 @@ public void listChannelPartnerLinks(
      *
      * 
      * Returns a requested [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
-     * 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.
-     * * NOT_FOUND: ChannelPartnerLink resource not found. Results
-     * due invalid channel partner link name.
-     * Return Value:
-     * [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if found, otherwise returns an error.
+     * 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.
+     * * NOT_FOUND: ChannelPartnerLink resource not found because of an
+     * invalid channel partner link name.
+     * Return value:
+     * The [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
      * 

      */
     public void getChannelPartnerLink(
@@ -3610,27 +3519,25 @@ public void getChannelPartnerLink(
      *
      *
      * 
-     * 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.
-     * Return Value:
-     * Newly created [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if successful,
-     * otherwise error is returned.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The new [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
      * 

      */
     public void createChannelPartnerLink(
@@ -3647,25 +3554,24 @@ public void createChannelPartnerLink(
      *
      *
      * 
-     * 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.
-     * Return Value:
-     * If successful, the updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource, otherwise
-     * returns an error.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
      * 

      */
     public void updateChannelPartnerLink(
@@ -3683,9 +3589,8 @@ public void updateChannelPartnerLink(
      *
      * 
      * Lists the Products the reseller is authorized to sell.
-     * Possible Error Codes:
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Possible error codes:
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public void listProducts(
@@ -3703,9 +3608,8 @@ public void listProducts(
      *
      * 
      * Lists the SKUs for a product the reseller is authorized to sell.
-     * Possible Error Codes:
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Possible error codes:
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public void listSkus(
@@ -3721,9 +3625,8 @@ public void listSkus(
      *
      * 
      * Lists the Offers the reseller can sell.
-     * Possible Error Codes:
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Possible error codes:
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public void listOffers(
@@ -3738,13 +3641,12 @@ public void listOffers(
      *
      *
      * 
-     * Lists the Purchasable SKUs for following cases:
-     * * SKUs that can be newly purchased for a customer
-     * * SKUs that can be upgraded/downgraded to, for an entitlement.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Lists the following:
+     * * SKUs that you can purchase for a customer
+     * * SKUs that you can upgrade or downgrade for an entitlement.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public void listPurchasableSkus(
@@ -3761,13 +3663,12 @@ public void listPurchasableSkus(
      *
      *
      * 
-     * Lists the Purchasable Offers for the following cases:
-     * * Offers that can be newly purchased for a customer
-     * * Offers that can be changed to, for an entitlement.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Lists the following:
+     * * Offers that you can purchase for a customer.
+     * * Offers that you can change for an entitlement.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The customer doesn't belong to the reseller
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public void listPurchasableOffers(
@@ -3785,21 +3686,19 @@ public void listPurchasableOffers(
      *
      * 
      * 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 [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent]
-     * 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
+     * topic for this Channel Services account. After you create a
+     * subscriber, you get the events through [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent]
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request and the
+     * provided reseller account are different, or the impersonated user
      * is not a super admin.
-     * * INVALID_ARGUMENT: 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.
-     * Return Value:
-     * Topic name with service email address registered if successful,
-     * otherwise error is returned.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The topic name with the registered service email address.
      * 

      */
     public void registerSubscriber(
@@ -3818,23 +3717,22 @@ public void registerSubscriber(
      * 
      * 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.
-     * 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
+     * service accounts left with subscriber privileges, this deletes the topic.
+     * You can call ListSubscribers to check for these accounts.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request and the
+     * provided reseller account are different, or the impersonated user
      * is not a super admin.
-     * * INVALID_ARGUMENT: 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.
-     * 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.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The topic name that unregistered the service email address.
+     * Returns a success response if the service email address wasn't registered
+     * with the topic.
      * 

      */
     public void unregisterSubscriber(
@@ -3853,20 +3751,18 @@ public void unregisterSubscriber(
      * 
      * Lists service accounts with subscriber privileges on the Cloud Pub/Sub
      * topic created for this Channel Services account.
-     * 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.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request and the
+     * provided reseller account are different, or the impersonated user
+     * is not a super admin.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * * NOT_FOUND: The topic resource doesn't exist.
      * * INTERNAL: Any non-user error related to a technical issue in the
-     * backend. 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.
-     * Return Value:
-     * List of service email addresses if successful, otherwise error is
-     * returned.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * A list of service email addresses.
      * 

      */
     public void listSubscribers(
@@ -3884,23 +3780,21 @@ public void listSubscribers(
    *
    *
    * 
-   * 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.
-   * The service primarily exposes the following resources:
-   * - [Customer][google.cloud.channel.v1.Customer]s: A Customer represents an entity managed by a reseller or
-   * distributor. A customer typically represents an enterprise. In an n-tier
-   * resale channel hierarchy, customers are generally represented as leaf nodes.
-   * Customers primarily have an Entitlement sub-resource discussed below.
-   * - [Entitlement][google.cloud.channel.v1.Entitlement]s: An Entitlement represents an entity which provides a
-   * customer means to start using a service. Entitlements are created or updated
-   * as a result of a successful fulfillment.
-   * - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: A ChannelPartnerLink is an entity that identifies
-   * links between distributors and their indirect resellers in a channel.
+   * 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.
+   * CloudChannelService exposes the following resources:
+   * - [Customer][google.cloud.channel.v1.Customer]s: An entity—usually an enterprise—managed by a reseller or
+   * distributor.
+   * - [Entitlement][google.cloud.channel.v1.Entitlement]s: An entity that provides a customer with the means to use
+   * a service. Entitlements are created or updated as a result of a successful
+   * fulfillment.
+   * - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: An entity that identifies links between
+   * distributors and their indirect resellers in a channel.
    * 

    */
   public static final class CloudChannelServiceBlockingStub
@@ -3920,15 +3814,13 @@ protected CloudChannelServiceBlockingStub build(
      *
      *
      * 
-     * List downstream [Customer][google.cloud.channel.v1.Customer]s.
-     * 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.
-     * Return Value:
-     * List of [Customer][google.cloud.channel.v1.Customer]s pertaining to the reseller or empty list if
-     * there are none.
+     * List [Customer][google.cloud.channel.v1.Customer]s.
+     * 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.
+     * Return value:
+     * List of [Customer][google.cloud.channel.v1.Customer]s, or an empty list if there are no customers.
      * 

      */
     public com.google.cloud.channel.v1.ListCustomersResponse listCustomers(
@@ -3942,15 +3834,14 @@ public com.google.cloud.channel.v1.ListCustomersResponse listCustomers(
      *
      * 
      * Returns a requested [Customer][google.cloud.channel.v1.Customer] resource.
-     * 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.
-     * Return Value:
-     * [Customer][google.cloud.channel.v1.Customer] resource if found, error otherwise.
+     * 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.
+     * * NOT_FOUND: The customer resource doesn't exist. Usually the result of an
+     * invalid name parameter.
+     * Return value:
+     * The [Customer][google.cloud.channel.v1.Customer] resource.
      * 

      */
     public com.google.cloud.channel.v1.Customer getCustomer(
@@ -3963,18 +3854,17 @@ public com.google.cloud.channel.v1.Customer getCustomer(
      *
      *
      * 
-     * Confirms the existence of Cloud Identity accounts, based on the domain and
-     * whether the Cloud Identity accounts are owned by the reseller.
-     * 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.
+     * 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:
+     * * 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 [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources for the domain.
-     * List may be empty.
-     * Note: in the v1alpha1 version of the API, a NOT_FOUND error is returned if
+     * Return value:
+     * A list of [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources for the domain (may be
+     * empty)
+     * Note: in the v1alpha1 version of the API, a NOT_FOUND error returns if
      * no [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources match the domain.
      * 

      */
@@ -3991,16 +3881,14 @@ public com.google.cloud.channel.v1.Customer getCustomer(
      * 
      * Creates a new [Customer][google.cloud.channel.v1.Customer] resource under the reseller or distributor
      * account.
-     * 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.
-     * Return Value:
-     * If successful, the newly created [Customer][google.cloud.channel.v1.Customer] resource, otherwise
-     * returns an error.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request is different
+     * from the reseller account in the API request.
+     * * INVALID_ARGUMENT:
+     *     * Required request parameters are missing or invalid.
+     *     * Domain field value doesn't match the primary email domain.
+     * Return value:
+     * The newly created [Customer][google.cloud.channel.v1.Customer] resource.
      * 

      */
     public com.google.cloud.channel.v1.Customer createCustomer(
@@ -4013,18 +3901,15 @@ public com.google.cloud.channel.v1.Customer createCustomer(
      *
      *
      * 
-     * Updates an existing [Customer][google.cloud.channel.v1.Customer] resource belonging to the reseller or
+     * Updates an existing [Customer][google.cloud.channel.v1.Customer] resource for the reseller or
      * distributor.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the reseller account making the request and the
-     * reseller account being queried for are different.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
-     * * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name
-     * specified in the request.
-     * Return Value:
-     * If successful, the updated [Customer][google.cloud.channel.v1.Customer] resource, otherwise returns
-     * an error.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request is different
+     * from the reseller account in the API request.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name in the request.
+     * Return value:
+     * The updated [Customer][google.cloud.channel.v1.Customer] resource.
      * 

      */
     public com.google.cloud.channel.v1.Customer updateCustomer(
@@ -4038,14 +3923,12 @@ public com.google.cloud.channel.v1.Customer updateCustomer(
      *
      * 
      * Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently and irreversibly.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the account making the request does not own
+     * Possible error codes:
+     * * PERMISSION_DENIED: The account making the request does not own
      * this customer.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
-     * * FAILED_PRECONDITION: If the customer has existing entitlements.
-     * * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name
-     * specified in the request.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * * FAILED_PRECONDITION: The customer has existing entitlements.
+     * * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name in the request.
      * 

      */
     public com.google.protobuf.Empty deleteCustomer(
@@ -4059,21 +3942,21 @@ public com.google.protobuf.Empty deleteCustomer(
      *
      * 
      * Creates a Cloud Identity for the given customer using the customer's
-     * information or the information provided here, if present.
-     * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * information, or the information provided here.
+     * 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 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:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
-     * CloudChannelOperationsService. The Operation metadata will contain an
+     * CloudChannelOperationsService. The Operation metadata contains an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
      * 

      */
@@ -4087,13 +3970,12 @@ public com.google.longrunning.Operation provisionCloudIdentity(
      *
      *
      * 
-     * List [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the request.
-     * Return Value:
-     * List of [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to the customer, or empty list if
-     * there are none.
+     * Lists [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * Return value:
+     * A list of the customer's [Entitlement][google.cloud.channel.v1.Entitlement]s.
      * 

      */
     public com.google.cloud.channel.v1.ListEntitlementsResponse listEntitlements(
@@ -4106,20 +3988,20 @@ public com.google.cloud.channel.v1.ListEntitlementsResponse listEntitlements(
      *
      *
      * 
-     * List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on Cloud Identity ID or
+     * List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on the Cloud Identity ID or
      * Customer Name in the request.
-     * This method is used when a reseller lists the entitlements
-     * information of a customer that is not owned. The reseller should provide
-     * the customer's Cloud Identity ID or Customer Name.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: Appears because of one of the following -
-     *     * The customer doesn't belong to the reseller and no auth token.
+     * Use this method to list the entitlements information of an
+     * unowned customer. You should provide the customer's
+     * Cloud Identity ID or Customer Name.
+     * Possible error codes:
+     * * PERMISSION_DENIED:
+     *     * The customer doesn't belong to the reseller and has no auth token.
      *     * The supplied auth token is invalid.
-     *     * The reseller account making the request and the queries reseller
-     *     account are different.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the request.
-     * Return Value:
-     * List of [TransferableSku][google.cloud.channel.v1.TransferableSku] for the given customer.
+     *     * The reseller account making the request is different
+     *     from the reseller account in the query.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * Return value:
+     * A list of the customer's [TransferableSku][google.cloud.channel.v1.TransferableSku].
      * 

      */
     public com.google.cloud.channel.v1.ListTransferableSkusResponse listTransferableSkus(
@@ -4134,18 +4016,17 @@ public com.google.cloud.channel.v1.ListTransferableSkusResponse listTransferable
      * 
      * List [TransferableOffer][google.cloud.channel.v1.TransferableOffer]s of a customer based on Cloud Identity ID or
      * Customer Name in the request.
-     * This method is used when a reseller gets the entitlement
-     * information of a customer that is not owned. The reseller should provide
-     * the customer's Cloud Identity ID or Customer Name.
-     * 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.
-     * Return Value:
+     * 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:
+     * * 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:
      * List of [TransferableOffer][google.cloud.channel.v1.TransferableOffer] for the given customer and SKU.
      * 

      */
@@ -4160,14 +4041,12 @@ public com.google.cloud.channel.v1.ListTransferableOffersResponse listTransferab
      *
      * 
      * Returns a requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
-     * 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.
-     * Return Value:
-     * If found, the requested [Entitlement][google.cloud.channel.v1.Entitlement] resource, otherwise returns
-     * an error.
+     * 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 entitlement was not found.
+     * Return value:
+     * The requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
      * 

      */
     public com.google.cloud.channel.v1.Entitlement getEntitlement(
@@ -4181,37 +4060,34 @@ public com.google.cloud.channel.v1.Entitlement getEntitlement(
      *
      * 
      * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -4227,22 +4103,21 @@ public com.google.longrunning.Operation createEntitlement(
      *
      *
      * 
-     * 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.
-     * 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.
+     * Change parameters of the entitlement.
+     * An entitlement update is a long-running operation and it updates the
+     * entitlement as a result of fulfillment.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -4259,21 +4134,20 @@ public com.google.longrunning.Operation changeParameters(
      *
      * 
      * 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.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * An entitlement update is a long-running operation and it updates the
+     * entitlement as a result of fulfillment.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * 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:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -4290,19 +4164,18 @@ public com.google.longrunning.Operation changeRenewalSettings(
      *
      * 
      * 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.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * An entitlement update is a long-running operation and it updates the
+     * entitlement as a result of fulfillment.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -4320,21 +4193,20 @@ public com.google.longrunning.Operation changeOffer(
      * 
      * 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.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * only applicable if a plan is set up for a trial entitlement but has some
+     * trial days remaining.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * * INTERNAL: Any non-user error related to a technical issue in the
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -4352,18 +4224,17 @@ public com.google.longrunning.Operation startPaidService(
      * 
      * Suspends a previously fulfilled entitlement.
      * An entitlement suspension is a long-running operation.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -4381,23 +4252,21 @@ public com.google.longrunning.Operation suspendEntitlement(
      * 
      * Cancels a previously fulfilled entitlement.
      * An entitlement cancellation is a long-running operation.
-     * 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
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The response will contain
      * google.protobuf.Empty on success. The Operation metadata will contain an
@@ -4414,29 +4283,25 @@ public com.google.longrunning.Operation cancelEntitlement(
      *
      *
      * 
-     * 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:
-     * * 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.
+     * 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.
      * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -4453,29 +4318,27 @@ public com.google.longrunning.Operation activateEntitlement(
      *
      * 
      * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -4491,29 +4354,27 @@ public com.google.longrunning.Operation transferEntitlements(
      *
      *
      * 
-     * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The response will contain
      * google.protobuf.Empty on success. The Operation metadata will contain an
@@ -4531,15 +4392,13 @@ public com.google.longrunning.Operation transferEntitlementsToGoogle(
      *
      * 
      * List [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s belonging to a distributor.
-     * 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.
-     * Return Value:
-     * If successful, returns the list of [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources
-     * for the distributor account, otherwise returns an error.
+     * 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.
+     * Return value:
+     * The list of the distributor account's [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources.
      * 

      */
     public com.google.cloud.channel.v1.ListChannelPartnerLinksResponse listChannelPartnerLinks(
@@ -4553,16 +4412,15 @@ public com.google.cloud.channel.v1.ListChannelPartnerLinksResponse listChannelPa
      *
      * 
      * Returns a requested [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
-     * 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.
-     * * NOT_FOUND: ChannelPartnerLink resource not found. Results
-     * due invalid channel partner link name.
-     * Return Value:
-     * [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if found, otherwise returns an error.
+     * 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.
+     * * NOT_FOUND: ChannelPartnerLink resource not found because of an
+     * invalid channel partner link name.
+     * Return value:
+     * The [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
      * 

      */
     public com.google.cloud.channel.v1.ChannelPartnerLink getChannelPartnerLink(
@@ -4575,27 +4433,25 @@ public com.google.cloud.channel.v1.ChannelPartnerLink getChannelPartnerLink(
      *
      *
      * 
-     * 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.
-     * Return Value:
-     * Newly created [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if successful,
-     * otherwise error is returned.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The new [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
      * 

      */
     public com.google.cloud.channel.v1.ChannelPartnerLink createChannelPartnerLink(
@@ -4608,25 +4464,24 @@ public com.google.cloud.channel.v1.ChannelPartnerLink createChannelPartnerLink(
      *
      *
      * 
-     * 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.
-     * Return Value:
-     * If successful, the updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource, otherwise
-     * returns an error.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
      * 

      */
     public com.google.cloud.channel.v1.ChannelPartnerLink updateChannelPartnerLink(
@@ -4640,9 +4495,8 @@ public com.google.cloud.channel.v1.ChannelPartnerLink updateChannelPartnerLink(
      *
      * 
      * Lists the Products the reseller is authorized to sell.
-     * Possible Error Codes:
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Possible error codes:
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public com.google.cloud.channel.v1.ListProductsResponse listProducts(
@@ -4656,9 +4510,8 @@ public com.google.cloud.channel.v1.ListProductsResponse listProducts(
      *
      * 
      * Lists the SKUs for a product the reseller is authorized to sell.
-     * Possible Error Codes:
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Possible error codes:
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public com.google.cloud.channel.v1.ListSkusResponse listSkus(
@@ -4672,9 +4525,8 @@ public com.google.cloud.channel.v1.ListSkusResponse listSkus(
      *
      * 
      * Lists the Offers the reseller can sell.
-     * Possible Error Codes:
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Possible error codes:
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public com.google.cloud.channel.v1.ListOffersResponse listOffers(
@@ -4687,13 +4539,12 @@ public com.google.cloud.channel.v1.ListOffersResponse listOffers(
      *
      *
      * 
-     * Lists the Purchasable SKUs for following cases:
-     * * SKUs that can be newly purchased for a customer
-     * * SKUs that can be upgraded/downgraded to, for an entitlement.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Lists the following:
+     * * SKUs that you can purchase for a customer
+     * * SKUs that you can upgrade or downgrade for an entitlement.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public com.google.cloud.channel.v1.ListPurchasableSkusResponse listPurchasableSkus(
@@ -4706,13 +4557,12 @@ public com.google.cloud.channel.v1.ListPurchasableSkusResponse listPurchasableSk
      *
      *
      * 
-     * Lists the Purchasable Offers for the following cases:
-     * * Offers that can be newly purchased for a customer
-     * * Offers that can be changed to, for an entitlement.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Lists the following:
+     * * Offers that you can purchase for a customer.
+     * * Offers that you can change for an entitlement.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The customer doesn't belong to the reseller
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public com.google.cloud.channel.v1.ListPurchasableOffersResponse listPurchasableOffers(
@@ -4726,21 +4576,19 @@ public com.google.cloud.channel.v1.ListPurchasableOffersResponse listPurchasable
      *
      * 
      * 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 [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent]
-     * 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
+     * topic for this Channel Services account. After you create a
+     * subscriber, you get the events through [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent]
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request and the
+     * provided reseller account are different, or the impersonated user
      * is not a super admin.
-     * * INVALID_ARGUMENT: 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.
-     * Return Value:
-     * Topic name with service email address registered if successful,
-     * otherwise error is returned.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The topic name with the registered service email address.
      * 

      */
     public com.google.cloud.channel.v1.RegisterSubscriberResponse registerSubscriber(
@@ -4755,23 +4603,22 @@ public com.google.cloud.channel.v1.RegisterSubscriberResponse registerSubscriber
      * 
      * 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.
-     * 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
+     * service accounts left with subscriber privileges, this deletes the topic.
+     * You can call ListSubscribers to check for these accounts.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request and the
+     * provided reseller account are different, or the impersonated user
      * is not a super admin.
-     * * INVALID_ARGUMENT: 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.
-     * 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.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The topic name that unregistered the service email address.
+     * Returns a success response if the service email address wasn't registered
+     * with the topic.
      * 

      */
     public com.google.cloud.channel.v1.UnregisterSubscriberResponse unregisterSubscriber(
@@ -4786,20 +4633,18 @@ public com.google.cloud.channel.v1.UnregisterSubscriberResponse unregisterSubscr
      * 
      * Lists service accounts with subscriber privileges on the Cloud Pub/Sub
      * topic created for this Channel Services account.
-     * 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.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request and the
+     * provided reseller account are different, or the impersonated user
+     * is not a super admin.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * * NOT_FOUND: The topic resource doesn't exist.
      * * INTERNAL: Any non-user error related to a technical issue in the
-     * backend. 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.
-     * Return Value:
-     * List of service email addresses if successful, otherwise error is
-     * returned.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * A list of service email addresses.
      * 

      */
     public com.google.cloud.channel.v1.ListSubscribersResponse listSubscribers(
@@ -4813,23 +4658,21 @@ public com.google.cloud.channel.v1.ListSubscribersResponse listSubscribers(
    *
    *
    * 
-   * 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.
-   * The service primarily exposes the following resources:
-   * - [Customer][google.cloud.channel.v1.Customer]s: A Customer represents an entity managed by a reseller or
-   * distributor. A customer typically represents an enterprise. In an n-tier
-   * resale channel hierarchy, customers are generally represented as leaf nodes.
-   * Customers primarily have an Entitlement sub-resource discussed below.
-   * - [Entitlement][google.cloud.channel.v1.Entitlement]s: An Entitlement represents an entity which provides a
-   * customer means to start using a service. Entitlements are created or updated
-   * as a result of a successful fulfillment.
-   * - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: A ChannelPartnerLink is an entity that identifies
-   * links between distributors and their indirect resellers in a channel.
+   * 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.
+   * CloudChannelService exposes the following resources:
+   * - [Customer][google.cloud.channel.v1.Customer]s: An entity—usually an enterprise—managed by a reseller or
+   * distributor.
+   * - [Entitlement][google.cloud.channel.v1.Entitlement]s: An entity that provides a customer with the means to use
+   * a service. Entitlements are created or updated as a result of a successful
+   * fulfillment.
+   * - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: An entity that identifies links between
+   * distributors and their indirect resellers in a channel.
    * 

    */
   public static final class CloudChannelServiceFutureStub
@@ -4849,15 +4692,13 @@ protected CloudChannelServiceFutureStub build(
      *
      *
      * 
-     * List downstream [Customer][google.cloud.channel.v1.Customer]s.
-     * 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.
-     * Return Value:
-     * List of [Customer][google.cloud.channel.v1.Customer]s pertaining to the reseller or empty list if
-     * there are none.
+     * List [Customer][google.cloud.channel.v1.Customer]s.
+     * 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.
+     * Return value:
+     * List of [Customer][google.cloud.channel.v1.Customer]s, or an empty list if there are no customers.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -4872,15 +4713,14 @@ protected CloudChannelServiceFutureStub build(
      *
      * 
      * Returns a requested [Customer][google.cloud.channel.v1.Customer] resource.
-     * 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.
-     * Return Value:
-     * [Customer][google.cloud.channel.v1.Customer] resource if found, error otherwise.
+     * 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.
+     * * NOT_FOUND: The customer resource doesn't exist. Usually the result of an
+     * invalid name parameter.
+     * Return value:
+     * The [Customer][google.cloud.channel.v1.Customer] resource.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -4893,18 +4733,17 @@ protected CloudChannelServiceFutureStub build(
      *
      *
      * 
-     * Confirms the existence of Cloud Identity accounts, based on the domain and
-     * whether the Cloud Identity accounts are owned by the reseller.
-     * 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.
+     * 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:
+     * * 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 [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources for the domain.
-     * List may be empty.
-     * Note: in the v1alpha1 version of the API, a NOT_FOUND error is returned if
+     * Return value:
+     * A list of [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources for the domain (may be
+     * empty)
+     * Note: in the v1alpha1 version of the API, a NOT_FOUND error returns if
      * no [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources match the domain.
      * 

      */
@@ -4923,16 +4762,14 @@ protected CloudChannelServiceFutureStub build(
      * 
      * Creates a new [Customer][google.cloud.channel.v1.Customer] resource under the reseller or distributor
      * account.
-     * 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.
-     * Return Value:
-     * If successful, the newly created [Customer][google.cloud.channel.v1.Customer] resource, otherwise
-     * returns an error.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request is different
+     * from the reseller account in the API request.
+     * * INVALID_ARGUMENT:
+     *     * Required request parameters are missing or invalid.
+     *     * Domain field value doesn't match the primary email domain.
+     * Return value:
+     * The newly created [Customer][google.cloud.channel.v1.Customer] resource.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -4945,18 +4782,15 @@ protected CloudChannelServiceFutureStub build(
      *
      *
      * 
-     * Updates an existing [Customer][google.cloud.channel.v1.Customer] resource belonging to the reseller or
+     * Updates an existing [Customer][google.cloud.channel.v1.Customer] resource for the reseller or
      * distributor.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the reseller account making the request and the
-     * reseller account being queried for are different.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
-     * * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name
-     * specified in the request.
-     * Return Value:
-     * If successful, the updated [Customer][google.cloud.channel.v1.Customer] resource, otherwise returns
-     * an error.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request is different
+     * from the reseller account in the API request.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name in the request.
+     * Return value:
+     * The updated [Customer][google.cloud.channel.v1.Customer] resource.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -4970,14 +4804,12 @@ protected CloudChannelServiceFutureStub build(
      *
      * 
      * Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently and irreversibly.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the account making the request does not own
+     * Possible error codes:
+     * * PERMISSION_DENIED: The account making the request does not own
      * this customer.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
-     * * FAILED_PRECONDITION: If the customer has existing entitlements.
-     * * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name
-     * specified in the request.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * * FAILED_PRECONDITION: The customer has existing entitlements.
+     * * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name in the request.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -4991,21 +4823,21 @@ protected CloudChannelServiceFutureStub build(
      *
      * 
      * Creates a Cloud Identity for the given customer using the customer's
-     * information or the information provided here, if present.
-     * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * information, or the information provided here.
+     * 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 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:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
-     * CloudChannelOperationsService. The Operation metadata will contain an
+     * CloudChannelOperationsService. The Operation metadata contains an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
      * 

      */
@@ -5019,13 +4851,12 @@ protected CloudChannelServiceFutureStub build(
      *
      *
      * 
-     * List [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the request.
-     * Return Value:
-     * List of [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to the customer, or empty list if
-     * there are none.
+     * Lists [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * Return value:
+     * A list of the customer's [Entitlement][google.cloud.channel.v1.Entitlement]s.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -5039,20 +4870,20 @@ protected CloudChannelServiceFutureStub build(
      *
      *
      * 
-     * List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on Cloud Identity ID or
+     * List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on the Cloud Identity ID or
      * Customer Name in the request.
-     * This method is used when a reseller lists the entitlements
-     * information of a customer that is not owned. The reseller should provide
-     * the customer's Cloud Identity ID or Customer Name.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: Appears because of one of the following -
-     *     * The customer doesn't belong to the reseller and no auth token.
+     * Use this method to list the entitlements information of an
+     * unowned customer. You should provide the customer's
+     * Cloud Identity ID or Customer Name.
+     * Possible error codes:
+     * * PERMISSION_DENIED:
+     *     * The customer doesn't belong to the reseller and has no auth token.
      *     * The supplied auth token is invalid.
-     *     * The reseller account making the request and the queries reseller
-     *     account are different.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the request.
-     * Return Value:
-     * List of [TransferableSku][google.cloud.channel.v1.TransferableSku] for the given customer.
+     *     * The reseller account making the request is different
+     *     from the reseller account in the query.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * Return value:
+     * A list of the customer's [TransferableSku][google.cloud.channel.v1.TransferableSku].
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -5068,18 +4899,17 @@ protected CloudChannelServiceFutureStub build(
      * 
      * List [TransferableOffer][google.cloud.channel.v1.TransferableOffer]s of a customer based on Cloud Identity ID or
      * Customer Name in the request.
-     * This method is used when a reseller gets the entitlement
-     * information of a customer that is not owned. The reseller should provide
-     * the customer's Cloud Identity ID or Customer Name.
-     * 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.
-     * Return Value:
+     * 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:
+     * * 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:
      * List of [TransferableOffer][google.cloud.channel.v1.TransferableOffer] for the given customer and SKU.
      * 

      */
@@ -5095,14 +4925,12 @@ protected CloudChannelServiceFutureStub build(
      *
      * 
      * Returns a requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
-     * 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.
-     * Return Value:
-     * If found, the requested [Entitlement][google.cloud.channel.v1.Entitlement] resource, otherwise returns
-     * an error.
+     * 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 entitlement was not found.
+     * Return value:
+     * The requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -5117,37 +4945,34 @@ protected CloudChannelServiceFutureStub build(
      *
      * 
      * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -5163,22 +4988,21 @@ protected CloudChannelServiceFutureStub build(
      *
      *
      * 
-     * 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.
-     * 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.
+     * Change parameters of the entitlement.
+     * An entitlement update is a long-running operation and it updates the
+     * entitlement as a result of fulfillment.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -5195,21 +5019,20 @@ protected CloudChannelServiceFutureStub build(
      *
      * 
      * 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.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * An entitlement update is a long-running operation and it updates the
+     * entitlement as a result of fulfillment.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * 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:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -5226,19 +5049,18 @@ protected CloudChannelServiceFutureStub build(
      *
      * 
      * 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.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * An entitlement update is a long-running operation and it updates the
+     * entitlement as a result of fulfillment.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -5256,21 +5078,20 @@ protected CloudChannelServiceFutureStub build(
      * 
      * 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.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * only applicable if a plan is set up for a trial entitlement but has some
+     * trial days remaining.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * * INTERNAL: Any non-user error related to a technical issue in the
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -5288,18 +5109,17 @@ protected CloudChannelServiceFutureStub build(
      * 
      * Suspends a previously fulfilled entitlement.
      * An entitlement suspension is a long-running operation.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -5317,23 +5137,21 @@ protected CloudChannelServiceFutureStub build(
      * 
      * Cancels a previously fulfilled entitlement.
      * An entitlement cancellation is a long-running operation.
-     * 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
+     * Possible error codes:
+     * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The response will contain
      * google.protobuf.Empty on success. The Operation metadata will contain an
@@ -5350,29 +5168,25 @@ protected CloudChannelServiceFutureStub build(
      *
      *
      * 
-     * 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:
-     * * 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.
+     * 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.
      * * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -5389,29 +5203,27 @@ protected CloudChannelServiceFutureStub build(
      *
      * 
      * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The Operation metadata will contain an
      * instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
@@ -5427,29 +5239,27 @@ protected CloudChannelServiceFutureStub build(
      *
      *
      * 
-     * 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.
-     * Return Value:
-     * Long Running Operation ID.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The ID of a long-running operation.
      * To get the results of the operation, call the GetOperation method of
      * CloudChannelOperationsService. The response will contain
      * google.protobuf.Empty on success. The Operation metadata will contain an
@@ -5468,15 +5278,13 @@ protected CloudChannelServiceFutureStub build(
      *
      * 
      * List [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s belonging to a distributor.
-     * 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.
-     * Return Value:
-     * If successful, returns the list of [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources
-     * for the distributor account, otherwise returns an error.
+     * 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.
+     * Return value:
+     * The list of the distributor account's [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -5492,16 +5300,15 @@ protected CloudChannelServiceFutureStub build(
      *
      * 
      * Returns a requested [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
-     * 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.
-     * * NOT_FOUND: ChannelPartnerLink resource not found. Results
-     * due invalid channel partner link name.
-     * Return Value:
-     * [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if found, otherwise returns an error.
+     * 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.
+     * * NOT_FOUND: ChannelPartnerLink resource not found because of an
+     * invalid channel partner link name.
+     * Return value:
+     * The [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -5515,27 +5322,25 @@ protected CloudChannelServiceFutureStub build(
      *
      *
      * 
-     * 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.
-     * Return Value:
-     * Newly created [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if successful,
-     * otherwise error is returned.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The new [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -5550,25 +5355,24 @@ protected CloudChannelServiceFutureStub build(
      *
      *
      * 
-     * 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.
-     * Return Value:
-     * If successful, the updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource, otherwise
-     * returns an error.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -5584,9 +5388,8 @@ protected CloudChannelServiceFutureStub build(
      *
      * 
      * Lists the Products the reseller is authorized to sell.
-     * Possible Error Codes:
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Possible error codes:
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -5601,9 +5404,8 @@ protected CloudChannelServiceFutureStub build(
      *
      * 
      * Lists the SKUs for a product the reseller is authorized to sell.
-     * Possible Error Codes:
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Possible error codes:
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -5618,9 +5420,8 @@ protected CloudChannelServiceFutureStub build(
      *
      * 
      * Lists the Offers the reseller can sell.
-     * Possible Error Codes:
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Possible error codes:
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -5634,13 +5435,12 @@ protected CloudChannelServiceFutureStub build(
      *
      *
      * 
-     * Lists the Purchasable SKUs for following cases:
-     * * SKUs that can be newly purchased for a customer
-     * * SKUs that can be upgraded/downgraded to, for an entitlement.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Lists the following:
+     * * SKUs that you can purchase for a customer
+     * * SKUs that you can upgrade or downgrade for an entitlement.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -5654,13 +5454,12 @@ protected CloudChannelServiceFutureStub build(
      *
      *
      * 
-     * Lists the Purchasable Offers for the following cases:
-     * * Offers that can be newly purchased for a customer
-     * * Offers that can be changed to, for an entitlement.
-     * Possible Error Codes:
-     * * PERMISSION_DENIED: If the customer doesn't belong to the reseller
-     * * INVALID_ARGUMENT: Missing or invalid required parameters in the
-     * request.
+     * Lists the following:
+     * * Offers that you can purchase for a customer.
+     * * Offers that you can change for an entitlement.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The customer doesn't belong to the reseller
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -5675,21 +5474,19 @@ protected CloudChannelServiceFutureStub build(
      *
      * 
      * 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 [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent]
-     * 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
+     * topic for this Channel Services account. After you create a
+     * subscriber, you get the events through [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent]
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request and the
+     * provided reseller account are different, or the impersonated user
      * is not a super admin.
-     * * INVALID_ARGUMENT: 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.
-     * Return Value:
-     * Topic name with service email address registered if successful,
-     * otherwise error is returned.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The topic name with the registered service email address.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -5705,23 +5502,22 @@ protected CloudChannelServiceFutureStub build(
      * 
      * 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.
-     * 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
+     * service accounts left with subscriber privileges, this deletes the topic.
+     * You can call ListSubscribers to check for these accounts.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request and the
+     * provided reseller account are different, or the impersonated user
      * is not a super admin.
-     * * INVALID_ARGUMENT: 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.
-     * 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.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * The topic name that unregistered the service email address.
+     * Returns a success response if the service email address wasn't registered
+     * with the topic.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -5737,20 +5533,18 @@ protected CloudChannelServiceFutureStub build(
      * 
      * Lists service accounts with subscriber privileges on the Cloud Pub/Sub
      * topic created for this Channel Services account.
-     * 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.
+     * Possible error codes:
+     * * PERMISSION_DENIED: The reseller account making the request and the
+     * provided reseller account are different, or the impersonated user
+     * is not a super admin.
+     * * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+     * * NOT_FOUND: The topic resource doesn't exist.
      * * INTERNAL: Any non-user error related to a technical issue in the
-     * backend. 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.
-     * Return Value:
-     * List of service email addresses if successful, otherwise error is
-     * returned.
+     * backend. Contact Cloud Channel support.
+     * * UNKNOWN: Any non-user error related to a technical issue in the backend.
+     * Contact Cloud Channel support.
+     * Return value:
+     * A list of service email addresses.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ActivateEntitlementRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ActivateEntitlementRequest.java
index 72363d59..bfa70872 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ActivateEntitlementRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ActivateEntitlementRequest.java
@@ -126,7 +126,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
    * 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}
    * 

    *
@@ -151,7 +151,7 @@ public java.lang.String getName() {
    *
    * 
    * 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}
    * 

    *
@@ -178,13 +178,12 @@ public com.google.protobuf.ByteString getNameBytes() {
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -210,13 +209,12 @@ public java.lang.String getRequestId() {
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -580,7 +578,7 @@ public Builder mergeFrom(
      *
      * 
      * 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}
      * 

      *
@@ -604,7 +602,7 @@ public java.lang.String getName() {
      *
      * 
      * 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}
      * 

      *
@@ -628,7 +626,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      * 
      * 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}
      * 

      *
@@ -651,7 +649,7 @@ public Builder setName(java.lang.String value) {
      *
      * 
      * 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}
      * 

      *
@@ -670,7 +668,7 @@ public Builder clearName() {
      *
      * 
      * 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}
      * 

      *
@@ -695,13 +693,12 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -726,13 +723,12 @@ public java.lang.String getRequestId() {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -757,13 +753,12 @@ public com.google.protobuf.ByteString getRequestIdBytes() {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -787,13 +782,12 @@ public Builder setRequestId(java.lang.String value) {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -813,13 +807,12 @@ public Builder clearRequestId() {
      *
      *
      * 
-     * 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.
+     * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ActivateEntitlementRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ActivateEntitlementRequestOrBuilder.java
index 573aeb6a..e8d2133a 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ActivateEntitlementRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ActivateEntitlementRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface ActivateEntitlementRequestOrBuilder
    *
    * 
    * 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}
    * 

    *
@@ -42,7 +42,7 @@ public interface ActivateEntitlementRequestOrBuilder
    *
    * 
    * 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}
    * 

    *
@@ -56,13 +56,12 @@ public interface ActivateEntitlementRequestOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -77,13 +76,12 @@ public interface ActivateEntitlementRequestOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CancelEntitlementRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CancelEntitlementRequest.java
index e05d58aa..22df4feb 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CancelEntitlementRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CancelEntitlementRequest.java
@@ -126,7 +126,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
    * 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}
    * 

    *
@@ -151,7 +151,7 @@ public java.lang.String getName() {
    *
    * 
    * 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}
    * 

    *
@@ -178,13 +178,12 @@ public com.google.protobuf.ByteString getNameBytes() {
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -210,13 +209,12 @@ public java.lang.String getRequestId() {
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -579,7 +577,7 @@ public Builder mergeFrom(
      *
      * 
      * 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}
      * 

      *
@@ -603,7 +601,7 @@ public java.lang.String getName() {
      *
      * 
      * 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}
      * 

      *
@@ -627,7 +625,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      * 
      * 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}
      * 

      *
@@ -650,7 +648,7 @@ public Builder setName(java.lang.String value) {
      *
      * 
      * 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}
      * 

      *
@@ -669,7 +667,7 @@ public Builder clearName() {
      *
      * 
      * 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}
      * 

      *
@@ -694,13 +692,12 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -725,13 +722,12 @@ public java.lang.String getRequestId() {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -756,13 +752,12 @@ public com.google.protobuf.ByteString getRequestIdBytes() {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -786,13 +781,12 @@ public Builder setRequestId(java.lang.String value) {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -812,13 +806,12 @@ public Builder clearRequestId() {
      *
      *
      * 
-     * 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.
+     * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CancelEntitlementRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CancelEntitlementRequestOrBuilder.java
index 9269965b..ae34aa4a 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CancelEntitlementRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CancelEntitlementRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface CancelEntitlementRequestOrBuilder
    *
    * 
    * 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}
    * 

    *
@@ -42,7 +42,7 @@ public interface CancelEntitlementRequestOrBuilder
    *
    * 
    * 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}
    * 

    *
@@ -56,13 +56,12 @@ public interface CancelEntitlementRequestOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -77,13 +76,12 @@ public interface CancelEntitlementRequestOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeOfferRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeOfferRequest.java
index d9937615..d1431e6c 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeOfferRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeOfferRequest.java
@@ -157,8 +157,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * 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}
    * 

    *
@@ -182,8 +182,8 @@ public java.lang.String getName() {
    *
    *
    * 
-   * 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}
    * 

    *
@@ -393,13 +393,12 @@ public com.google.protobuf.ByteString getPurchaseOrderIdBytes() {
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -425,13 +424,12 @@ public java.lang.String getRequestId() {
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -881,8 +879,8 @@ public Builder mergeFrom(
      *
      *
      * 
-     * 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}
      * 

      *
@@ -905,8 +903,8 @@ public java.lang.String getName() {
      *
      *
      * 
-     * 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}
      * 

      *
@@ -929,8 +927,8 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      *
      * 
-     * 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}
      * 

      *
@@ -952,8 +950,8 @@ public Builder setName(java.lang.String value) {
      *
      *
      * 
-     * 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}
      * 

      *
@@ -971,8 +969,8 @@ public Builder clearName() {
      *
      *
      * 
-     * 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}
      * 

      *
@@ -1609,13 +1607,12 @@ public Builder setPurchaseOrderIdBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -1640,13 +1637,12 @@ public java.lang.String getRequestId() {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -1671,13 +1667,12 @@ public com.google.protobuf.ByteString getRequestIdBytes() {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -1701,13 +1696,12 @@ public Builder setRequestId(java.lang.String value) {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -1727,13 +1721,12 @@ public Builder clearRequestId() {
      *
      *
      * 
-     * 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.
+     * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeOfferRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeOfferRequestOrBuilder.java
index 9ba93eba..403f6bdd 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeOfferRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeOfferRequestOrBuilder.java
@@ -27,8 +27,8 @@ public interface ChangeOfferRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
@@ -41,8 +41,8 @@ public interface ChangeOfferRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
@@ -174,13 +174,12 @@ public interface ChangeOfferRequestOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -195,13 +194,12 @@ public interface ChangeOfferRequestOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeParametersRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeParametersRequest.java
index 75330107..aeb9d353 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeParametersRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeParametersRequest.java
@@ -150,7 +150,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
    * 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}
    * 

    *
@@ -175,7 +175,7 @@ public java.lang.String getName() {
    *
    * 
    * 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}
    * 

    *
@@ -202,8 +202,7 @@ public com.google.protobuf.ByteString getNameBytes() {
    *
    *
    * 
-   * Required. Entitlement parameters to update. Only editable parameters are allowed to
-   * be changed.
+   * Required. Entitlement parameters to update. You can only change editable parameters.
    * 

    *
    * 
@@ -218,8 +217,7 @@ public java.util.List getParametersList()
    *
    *
    * 
-   * Required. Entitlement parameters to update. Only editable parameters are allowed to
-   * be changed.
+   * Required. Entitlement parameters to update. You can only change editable parameters.
    * 

    *
    * 
@@ -235,8 +233,7 @@ public java.util.List getParametersList()
    *
    *
    * 
-   * Required. Entitlement parameters to update. Only editable parameters are allowed to
-   * be changed.
+   * Required. Entitlement parameters to update. You can only change editable parameters.
    * 

    *
    * 
@@ -251,8 +248,7 @@ public int getParametersCount() {
    *
    *
    * 
-   * Required. Entitlement parameters to update. Only editable parameters are allowed to
-   * be changed.
+   * Required. Entitlement parameters to update. You can only change editable parameters.
    * 

    *
    * 
@@ -267,8 +263,7 @@ public com.google.cloud.channel.v1.Parameter getParameters(int index) {
    *
    *
    * 
-   * Required. Entitlement parameters to update. Only editable parameters are allowed to
-   * be changed.
+   * Required. Entitlement parameters to update. You can only change editable parameters.
    * 

    *
    * 
@@ -286,16 +281,14 @@ public com.google.cloud.channel.v1.ParameterOrBuilder getParametersOrBuilder(int
    *
    *
    * 
-   * 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`).
    * 

    *
@@ -319,16 +312,14 @@ public java.lang.String getRequestId() {
    *
    *
    * 
-   * 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`).
    * 

    *
@@ -812,7 +803,7 @@ public Builder mergeFrom(
      *
      * 
      * 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}
      * 

      *
@@ -836,7 +827,7 @@ public java.lang.String getName() {
      *
      * 
      * 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}
      * 

      *
@@ -860,7 +851,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      * 
      * 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}
      * 

      *
@@ -883,7 +874,7 @@ public Builder setName(java.lang.String value) {
      *
      * 
      * 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}
      * 

      *
@@ -902,7 +893,7 @@ public Builder clearName() {
      *
      * 
      * 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}
      * 

      *
@@ -942,8 +933,7 @@ private void ensureParametersIsMutable() {
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -961,8 +951,7 @@ public java.util.List getParametersList()
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -980,8 +969,7 @@ public int getParametersCount() {
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -999,8 +987,7 @@ public com.google.cloud.channel.v1.Parameter getParameters(int index) {
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -1024,8 +1011,7 @@ public Builder setParameters(int index, com.google.cloud.channel.v1.Parameter va
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -1047,8 +1033,7 @@ public Builder setParameters(
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -1072,8 +1057,7 @@ public Builder addParameters(com.google.cloud.channel.v1.Parameter value) {
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -1097,8 +1081,7 @@ public Builder addParameters(int index, com.google.cloud.channel.v1.Parameter va
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -1119,8 +1102,7 @@ public Builder addParameters(com.google.cloud.channel.v1.Parameter.Builder build
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -1142,8 +1124,7 @@ public Builder addParameters(
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -1165,8 +1146,7 @@ public Builder addAllParameters(
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -1187,8 +1167,7 @@ public Builder clearParameters() {
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -1209,8 +1188,7 @@ public Builder removeParameters(int index) {
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -1224,8 +1202,7 @@ public com.google.cloud.channel.v1.Parameter.Builder getParametersBuilder(int in
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -1243,8 +1220,7 @@ public com.google.cloud.channel.v1.ParameterOrBuilder getParametersOrBuilder(int
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -1263,8 +1239,7 @@ public com.google.cloud.channel.v1.ParameterOrBuilder getParametersOrBuilder(int
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -1279,8 +1254,7 @@ public com.google.cloud.channel.v1.Parameter.Builder addParametersBuilder() {
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -1295,8 +1269,7 @@ public com.google.cloud.channel.v1.Parameter.Builder addParametersBuilder(int in
      *
      *
      * 
-     * Required. Entitlement parameters to update. Only editable parameters are allowed to
-     * be changed.
+     * Required. Entitlement parameters to update. You can only change editable parameters.
      * 

      *
      * 
@@ -1330,16 +1303,14 @@ public com.google.cloud.channel.v1.Parameter.Builder addParametersBuilder(int in
      *
      *
      * 
-     * 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`).
      * 

      *
@@ -1362,16 +1333,14 @@ public java.lang.String getRequestId() {
      *
      *
      * 
-     * 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`).
      * 

      *
@@ -1394,16 +1363,14 @@ public com.google.protobuf.ByteString getRequestIdBytes() {
      *
      *
      * 
-     * 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`).
      * 

      *
@@ -1425,16 +1392,14 @@ public Builder setRequestId(java.lang.String value) {
      *
      *
      * 
-     * 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`).
      * 

      *
@@ -1452,16 +1417,14 @@ public Builder clearRequestId() {
      *
      *
      * 
-     * 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`).
      * 

      *
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeParametersRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeParametersRequestOrBuilder.java
index 650b2edb..1d269f9c 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeParametersRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeParametersRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface ChangeParametersRequestOrBuilder
    *
    * 
    * 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}
    * 

    *
@@ -42,7 +42,7 @@ public interface ChangeParametersRequestOrBuilder
    *
    * 
    * 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}
    * 

    *
@@ -56,8 +56,7 @@ public interface ChangeParametersRequestOrBuilder
    *
    *
    * 
-   * Required. Entitlement parameters to update. Only editable parameters are allowed to
-   * be changed.
+   * Required. Entitlement parameters to update. You can only change editable parameters.
    * 

    *
    * 
@@ -69,8 +68,7 @@ public interface ChangeParametersRequestOrBuilder
    *
    *
    * 
-   * Required. Entitlement parameters to update. Only editable parameters are allowed to
-   * be changed.
+   * Required. Entitlement parameters to update. You can only change editable parameters.
    * 

    *
    * 
@@ -82,8 +80,7 @@ public interface ChangeParametersRequestOrBuilder
    *
    *
    * 
-   * Required. Entitlement parameters to update. Only editable parameters are allowed to
-   * be changed.
+   * Required. Entitlement parameters to update. You can only change editable parameters.
    * 

    *
    * 
@@ -95,8 +92,7 @@ public interface ChangeParametersRequestOrBuilder
    *
    *
    * 
-   * Required. Entitlement parameters to update. Only editable parameters are allowed to
-   * be changed.
+   * Required. Entitlement parameters to update. You can only change editable parameters.
    * 

    *
    * 
@@ -109,8 +105,7 @@ public interface ChangeParametersRequestOrBuilder
    *
    *
    * 
-   * Required. Entitlement parameters to update. Only editable parameters are allowed to
-   * be changed.
+   * Required. Entitlement parameters to update. You can only change editable parameters.
    * 

    *
    * 
@@ -123,16 +118,14 @@ public interface ChangeParametersRequestOrBuilder
    *
    *
    * 
-   * 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`).
    * 

    *
@@ -145,16 +138,14 @@ public interface ChangeParametersRequestOrBuilder
    *
    *
    * 
-   * 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`).
    * 

    *
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeRenewalSettingsRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeRenewalSettingsRequest.java
index 97fa6850..34e9861d 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeRenewalSettingsRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeRenewalSettingsRequest.java
@@ -142,7 +142,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
    * 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}
    * 

    *
@@ -167,7 +167,7 @@ public java.lang.String getName() {
    *
    * 
    * 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}
    * 

    *
@@ -248,13 +248,12 @@ public com.google.cloud.channel.v1.RenewalSettingsOrBuilder getRenewalSettingsOr
    *
    *
    * 
-   * 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.
-   * 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.
+   * 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`).
@@ -280,13 +279,12 @@ public java.lang.String getRequestId() {
    *
    *
    * 
-   * 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.
-   * 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.
+   * 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`).
@@ -678,7 +676,7 @@ public Builder mergeFrom(
      *
      * 
      * 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}
      * 

      *
@@ -702,7 +700,7 @@ public java.lang.String getName() {
      *
      * 
      * 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}
      * 

      *
@@ -726,7 +724,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      * 
      * 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}
      * 

      *
@@ -749,7 +747,7 @@ public Builder setName(java.lang.String value) {
      *
      * 
      * 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}
      * 

      *
@@ -768,7 +766,7 @@ public Builder clearName() {
      *
      * 
      * 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}
      * 

      *
@@ -997,13 +995,12 @@ public com.google.cloud.channel.v1.RenewalSettingsOrBuilder getRenewalSettingsOr
      *
      *
      * 
-     * 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.
-     * 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.
+     * 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`).
@@ -1028,13 +1025,12 @@ public java.lang.String getRequestId() {
      *
      *
      * 
-     * 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.
-     * 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.
+     * 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`).
@@ -1059,13 +1055,12 @@ public com.google.protobuf.ByteString getRequestIdBytes() {
      *
      *
      * 
-     * 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.
-     * 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.
+     * 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`).
@@ -1089,13 +1084,12 @@ public Builder setRequestId(java.lang.String value) {
      *
      *
      * 
-     * 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.
-     * 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.
+     * 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`).
@@ -1115,13 +1109,12 @@ public Builder clearRequestId() {
      *
      *
      * 
-     * 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.
-     * 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.
+     * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeRenewalSettingsRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeRenewalSettingsRequestOrBuilder.java
index e39e9de1..4432570c 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeRenewalSettingsRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ChangeRenewalSettingsRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface ChangeRenewalSettingsRequestOrBuilder
    *
    * 
    * 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}
    * 

    *
@@ -42,7 +42,7 @@ public interface ChangeRenewalSettingsRequestOrBuilder
    *
    * 
    * 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}
    * 

    *
@@ -97,13 +97,12 @@ public interface ChangeRenewalSettingsRequestOrBuilder
    *
    *
    * 
-   * 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.
-   * 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.
+   * 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`).
@@ -118,13 +117,12 @@ public interface ChangeRenewalSettingsRequestOrBuilder
    *
    *
    * 
-   * 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.
-   * 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.
+   * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CheckCloudIdentityAccountsExistRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CheckCloudIdentityAccountsExistRequest.java
index b0ab1936..d1b1303d 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CheckCloudIdentityAccountsExistRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CheckCloudIdentityAccountsExistRequest.java
@@ -127,8 +127,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -151,8 +151,8 @@ public java.lang.String getParent() {
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -178,7 +178,7 @@ public com.google.protobuf.ByteString getParentBytes() {
    *
    *
    * 
-   * Required. Domain for which the Cloud Identity account customer is fetched.
+   * Required. Domain to fetch for Cloud Identity account customer.
    * 

    *
    * string domain = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -201,7 +201,7 @@ public java.lang.String getDomain() {
    *
    *
    * 
-   * Required. Domain for which the Cloud Identity account customer is fetched.
+   * Required. Domain to fetch for Cloud Identity account customer.
    * 

    *
    * string domain = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -569,8 +569,8 @@ public Builder mergeFrom(
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -592,8 +592,8 @@ public java.lang.String getParent() {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -615,8 +615,8 @@ public com.google.protobuf.ByteString getParentBytes() {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -637,8 +637,8 @@ public Builder setParent(java.lang.String value) {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -655,8 +655,8 @@ public Builder clearParent() {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -680,7 +680,7 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * Required. Domain for which the Cloud Identity account customer is fetched.
+     * Required. Domain to fetch for Cloud Identity account customer.
      * 

      *
      * string domain = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -702,7 +702,7 @@ public java.lang.String getDomain() {
      *
      *
      * 
-     * Required. Domain for which the Cloud Identity account customer is fetched.
+     * Required. Domain to fetch for Cloud Identity account customer.
      * 

      *
      * string domain = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -724,7 +724,7 @@ public com.google.protobuf.ByteString getDomainBytes() {
      *
      *
      * 
-     * Required. Domain for which the Cloud Identity account customer is fetched.
+     * Required. Domain to fetch for Cloud Identity account customer.
      * 

      *
      * string domain = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -745,7 +745,7 @@ public Builder setDomain(java.lang.String value) {
      *
      *
      * 
-     * Required. Domain for which the Cloud Identity account customer is fetched.
+     * Required. Domain to fetch for Cloud Identity account customer.
      * 

      *
      * string domain = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -762,7 +762,7 @@ public Builder clearDomain() {
      *
      *
      * 
-     * Required. Domain for which the Cloud Identity account customer is fetched.
+     * Required. Domain to fetch for Cloud Identity account customer.
      * 

      *
      * string domain = 2 [(.google.api.field_behavior) = REQUIRED];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CheckCloudIdentityAccountsExistRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CheckCloudIdentityAccountsExistRequestOrBuilder.java
index fed7a571..1d92410b 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CheckCloudIdentityAccountsExistRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CheckCloudIdentityAccountsExistRequestOrBuilder.java
@@ -27,8 +27,8 @@ public interface CheckCloudIdentityAccountsExistRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -40,8 +40,8 @@ public interface CheckCloudIdentityAccountsExistRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -54,7 +54,7 @@ public interface CheckCloudIdentityAccountsExistRequestOrBuilder
    *
    *
    * 
-   * Required. Domain for which the Cloud Identity account customer is fetched.
+   * Required. Domain to fetch for Cloud Identity account customer.
    * 

    *
    * string domain = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -66,7 +66,7 @@ public interface CheckCloudIdentityAccountsExistRequestOrBuilder
    *
    *
    * 
-   * Required. Domain for which the Cloud Identity account customer is fetched.
+   * Required. Domain to fetch for Cloud Identity account customer.
    * 

    *
    * string domain = 2 [(.google.api.field_behavior) = REQUIRED];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudIdentityCustomerAccount.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudIdentityCustomerAccount.java
index 658d6d78..e4a4c061 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudIdentityCustomerAccount.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudIdentityCustomerAccount.java
@@ -22,7 +22,7 @@
  *
  *
  * 
- * Entity representing a Cloud Identity account which may or may not be
+ * Entity representing a Cloud Identity account that may be
  * associated with a Channel Services API partner.
  * 

  *
@@ -136,7 +136,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * True if a Cloud Identity account exists for a specific domain.
+   * Returns true if a Cloud Identity account exists for a specific domain.
    * 

    *
    * bool existing = 1;
@@ -154,8 +154,8 @@ public boolean getExisting() {
    *
    *
    * 
-   * True if the Cloud Identity account is associated with a customer
-   * belonging to the Channel Services partner making the API call.
+   * Returns true if the Cloud Identity account is associated with a customer
+   * of the Channel Services partner.
    * 

    *
    * bool owned = 2;
@@ -173,9 +173,9 @@ public boolean getOwned() {
    *
    *
    * 
-   * Name of the customer that owns the Cloud Identity account. This field is
-   * populated ONLY if owned = true.
-   * The customer_name takes the format:
+   * If owned = true, the name of the customer that owns the Cloud Identity
+   * account.
+   * Customer_name uses the format:
    * accounts/{account_id}/customers/{customer_id}
    * 

    *
@@ -199,9 +199,9 @@ public java.lang.String getCustomerName() {
    *
    *
    * 
-   * Name of the customer that owns the Cloud Identity account. This field is
-   * populated ONLY if owned = true.
-   * The customer_name takes the format:
+   * If owned = true, the name of the customer that owns the Cloud Identity
+   * account.
+   * Customer_name uses the format:
    * accounts/{account_id}/customers/{customer_id}
    * 

    *
@@ -228,8 +228,7 @@ public com.google.protobuf.ByteString getCustomerNameBytes() {
    *
    *
    * 
-   * Cloud Identity ID of the customer. This field is populated ONLY if
-   * existing = true.
+   * If existing = true, the Cloud Identity ID of the customer.
    * 

    *
    * string customer_cloud_identity_id = 4;
@@ -252,8 +251,7 @@ public java.lang.String getCustomerCloudIdentityId() {
    *
    *
    * 
-   * Cloud Identity ID of the customer. This field is populated ONLY if
-   * existing = true.
+   * If existing = true, the Cloud Identity ID of the customer.
    * 

    *
    * string customer_cloud_identity_id = 4;
@@ -464,7 +462,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
-   * Entity representing a Cloud Identity account which may or may not be
+   * Entity representing a Cloud Identity account that may be
    * associated with a Channel Services API partner.
    * 

    *
@@ -644,7 +642,7 @@ public Builder mergeFrom(
      *
      *
      * 
-     * True if a Cloud Identity account exists for a specific domain.
+     * Returns true if a Cloud Identity account exists for a specific domain.
      * 

      *
      * bool existing = 1;
@@ -659,7 +657,7 @@ public boolean getExisting() {
      *
      *
      * 
-     * True if a Cloud Identity account exists for a specific domain.
+     * Returns true if a Cloud Identity account exists for a specific domain.
      * 

      *
      * bool existing = 1;
@@ -677,7 +675,7 @@ public Builder setExisting(boolean value) {
      *
      *
      * 
-     * True if a Cloud Identity account exists for a specific domain.
+     * Returns true if a Cloud Identity account exists for a specific domain.
      * 

      *
      * bool existing = 1;
@@ -696,8 +694,8 @@ public Builder clearExisting() {
      *
      *
      * 
-     * True if the Cloud Identity account is associated with a customer
-     * belonging to the Channel Services partner making the API call.
+     * Returns true if the Cloud Identity account is associated with a customer
+     * of the Channel Services partner.
      * 

      *
      * bool owned = 2;
@@ -712,8 +710,8 @@ public boolean getOwned() {
      *
      *
      * 
-     * True if the Cloud Identity account is associated with a customer
-     * belonging to the Channel Services partner making the API call.
+     * Returns true if the Cloud Identity account is associated with a customer
+     * of the Channel Services partner.
      * 

      *
      * bool owned = 2;
@@ -731,8 +729,8 @@ public Builder setOwned(boolean value) {
      *
      *
      * 
-     * True if the Cloud Identity account is associated with a customer
-     * belonging to the Channel Services partner making the API call.
+     * Returns true if the Cloud Identity account is associated with a customer
+     * of the Channel Services partner.
      * 

      *
      * bool owned = 2;
@@ -751,9 +749,9 @@ public Builder clearOwned() {
      *
      *
      * 
-     * Name of the customer that owns the Cloud Identity account. This field is
-     * populated ONLY if owned = true.
-     * The customer_name takes the format:
+     * If owned = true, the name of the customer that owns the Cloud Identity
+     * account.
+     * Customer_name uses the format:
      * accounts/{account_id}/customers/{customer_id}
      * 

      *
@@ -776,9 +774,9 @@ public java.lang.String getCustomerName() {
      *
      *
      * 
-     * Name of the customer that owns the Cloud Identity account. This field is
-     * populated ONLY if owned = true.
-     * The customer_name takes the format:
+     * If owned = true, the name of the customer that owns the Cloud Identity
+     * account.
+     * Customer_name uses the format:
      * accounts/{account_id}/customers/{customer_id}
      * 

      *
@@ -801,9 +799,9 @@ public com.google.protobuf.ByteString getCustomerNameBytes() {
      *
      *
      * 
-     * Name of the customer that owns the Cloud Identity account. This field is
-     * populated ONLY if owned = true.
-     * The customer_name takes the format:
+     * If owned = true, the name of the customer that owns the Cloud Identity
+     * account.
+     * Customer_name uses the format:
      * accounts/{account_id}/customers/{customer_id}
      * 

      *
@@ -825,9 +823,9 @@ public Builder setCustomerName(java.lang.String value) {
      *
      *
      * 
-     * Name of the customer that owns the Cloud Identity account. This field is
-     * populated ONLY if owned = true.
-     * The customer_name takes the format:
+     * If owned = true, the name of the customer that owns the Cloud Identity
+     * account.
+     * Customer_name uses the format:
      * accounts/{account_id}/customers/{customer_id}
      * 

      *
@@ -845,9 +843,9 @@ public Builder clearCustomerName() {
      *
      *
      * 
-     * Name of the customer that owns the Cloud Identity account. This field is
-     * populated ONLY if owned = true.
-     * The customer_name takes the format:
+     * If owned = true, the name of the customer that owns the Cloud Identity
+     * account.
+     * Customer_name uses the format:
      * accounts/{account_id}/customers/{customer_id}
      * 

      *
@@ -872,8 +870,7 @@ public Builder setCustomerNameBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * Cloud Identity ID of the customer. This field is populated ONLY if
-     * existing = true.
+     * If existing = true, the Cloud Identity ID of the customer.
      * 

      *
      * string customer_cloud_identity_id = 4;
@@ -895,8 +892,7 @@ public java.lang.String getCustomerCloudIdentityId() {
      *
      *
      * 
-     * Cloud Identity ID of the customer. This field is populated ONLY if
-     * existing = true.
+     * If existing = true, the Cloud Identity ID of the customer.
      * 

      *
      * string customer_cloud_identity_id = 4;
@@ -918,8 +914,7 @@ public com.google.protobuf.ByteString getCustomerCloudIdentityIdBytes() {
      *
      *
      * 
-     * Cloud Identity ID of the customer. This field is populated ONLY if
-     * existing = true.
+     * If existing = true, the Cloud Identity ID of the customer.
      * 

      *
      * string customer_cloud_identity_id = 4;
@@ -940,8 +935,7 @@ public Builder setCustomerCloudIdentityId(java.lang.String value) {
      *
      *
      * 
-     * Cloud Identity ID of the customer. This field is populated ONLY if
-     * existing = true.
+     * If existing = true, the Cloud Identity ID of the customer.
      * 

      *
      * string customer_cloud_identity_id = 4;
@@ -958,8 +952,7 @@ public Builder clearCustomerCloudIdentityId() {
      *
      *
      * 
-     * Cloud Identity ID of the customer. This field is populated ONLY if
-     * existing = true.
+     * If existing = true, the Cloud Identity ID of the customer.
      * 

      *
      * string customer_cloud_identity_id = 4;
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudIdentityCustomerAccountOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudIdentityCustomerAccountOrBuilder.java
index 39852e48..0aa5be0a 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudIdentityCustomerAccountOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudIdentityCustomerAccountOrBuilder.java
@@ -27,7 +27,7 @@ public interface CloudIdentityCustomerAccountOrBuilder
    *
    *
    * 
-   * True if a Cloud Identity account exists for a specific domain.
+   * Returns true if a Cloud Identity account exists for a specific domain.
    * 

    *
    * bool existing = 1;
@@ -40,8 +40,8 @@ public interface CloudIdentityCustomerAccountOrBuilder
    *
    *
    * 
-   * True if the Cloud Identity account is associated with a customer
-   * belonging to the Channel Services partner making the API call.
+   * Returns true if the Cloud Identity account is associated with a customer
+   * of the Channel Services partner.
    * 

    *
    * bool owned = 2;
@@ -54,9 +54,9 @@ public interface CloudIdentityCustomerAccountOrBuilder
    *
    *
    * 
-   * Name of the customer that owns the Cloud Identity account. This field is
-   * populated ONLY if owned = true.
-   * The customer_name takes the format:
+   * If owned = true, the name of the customer that owns the Cloud Identity
+   * account.
+   * Customer_name uses the format:
    * accounts/{account_id}/customers/{customer_id}
    * 

    *
@@ -69,9 +69,9 @@ public interface CloudIdentityCustomerAccountOrBuilder
    *
    *
    * 
-   * Name of the customer that owns the Cloud Identity account. This field is
-   * populated ONLY if owned = true.
-   * The customer_name takes the format:
+   * If owned = true, the name of the customer that owns the Cloud Identity
+   * account.
+   * Customer_name uses the format:
    * accounts/{account_id}/customers/{customer_id}
    * 

    *
@@ -85,8 +85,7 @@ public interface CloudIdentityCustomerAccountOrBuilder
    *
    *
    * 
-   * Cloud Identity ID of the customer. This field is populated ONLY if
-   * existing = true.
+   * If existing = true, the Cloud Identity ID of the customer.
    * 

    *
    * string customer_cloud_identity_id = 4;
@@ -98,8 +97,7 @@ public interface CloudIdentityCustomerAccountOrBuilder
    *
    *
    * 
-   * Cloud Identity ID of the customer. This field is populated ONLY if
-   * existing = true.
+   * If existing = true, the Cloud Identity ID of the customer.
    * 

    *
    * string customer_cloud_identity_id = 4;
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudIdentityInfo.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudIdentityInfo.java
index 2214e25e..cc1b535f 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudIdentityInfo.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudIdentityInfo.java
@@ -422,10 +422,14 @@ public com.google.protobuf.ByteString getPrimaryDomainBytes() {
    *
    *
    * 
-   * Whether the domain is verified.
+   * Output only. Whether the domain is verified.
+   * This field is not returned for a Customer's cloud_identity_info resource.
+   * Partners can use the domains.get() method of the Workspace SDK's
+   * Directory API, or listen to the PRIMARY_DOMAIN_VERIFIED Pub/Sub event in
+   * to track domain verification of their resolve Workspace customers.
    * 

    *
-   * bool is_domain_verified = 4;
+   * bool is_domain_verified = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
    *
    * @return The isDomainVerified.
    */
@@ -1323,10 +1327,14 @@ public Builder setPrimaryDomainBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * Whether the domain is verified.
+     * Output only. Whether the domain is verified.
+     * This field is not returned for a Customer's cloud_identity_info resource.
+     * Partners can use the domains.get() method of the Workspace SDK's
+     * Directory API, or listen to the PRIMARY_DOMAIN_VERIFIED Pub/Sub event in
+     * to track domain verification of their resolve Workspace customers.
      * 

      *
-     * bool is_domain_verified = 4;
+     * bool is_domain_verified = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
      *
      * @return The isDomainVerified.
      */
@@ -1338,10 +1346,14 @@ public boolean getIsDomainVerified() {
      *
      *
      * 
-     * Whether the domain is verified.
+     * Output only. Whether the domain is verified.
+     * This field is not returned for a Customer's cloud_identity_info resource.
+     * Partners can use the domains.get() method of the Workspace SDK's
+     * Directory API, or listen to the PRIMARY_DOMAIN_VERIFIED Pub/Sub event in
+     * to track domain verification of their resolve Workspace customers.
      * 

      *
-     * bool is_domain_verified = 4;
+     * bool is_domain_verified = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
      *
      * @param value The isDomainVerified to set.
      * @return This builder for chaining.
@@ -1356,10 +1368,14 @@ public Builder setIsDomainVerified(boolean value) {
      *
      *
      * 
-     * Whether the domain is verified.
+     * Output only. Whether the domain is verified.
+     * This field is not returned for a Customer's cloud_identity_info resource.
+     * Partners can use the domains.get() method of the Workspace SDK's
+     * Directory API, or listen to the PRIMARY_DOMAIN_VERIFIED Pub/Sub event in
+     * to track domain verification of their resolve Workspace customers.
      * 

      *
-     * bool is_domain_verified = 4;
+     * bool is_domain_verified = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
      *
      * @return This builder for chaining.
      */
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudIdentityInfoOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudIdentityInfoOrBuilder.java
index e462bf8b..16e283f8 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudIdentityInfoOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CloudIdentityInfoOrBuilder.java
@@ -77,10 +77,14 @@ public interface CloudIdentityInfoOrBuilder
    *
    *
    * 
-   * Whether the domain is verified.
+   * Output only. Whether the domain is verified.
+   * This field is not returned for a Customer's cloud_identity_info resource.
+   * Partners can use the domains.get() method of the Workspace SDK's
+   * Directory API, or listen to the PRIMARY_DOMAIN_VERIFIED Pub/Sub event in
+   * to track domain verification of their resolve Workspace customers.
    * 

    *
-   * bool is_domain_verified = 4;
+   * bool is_domain_verified = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
    *
    * @return The isDomainVerified.
    */
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CommonProto.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CommonProto.java
index 07f8b477..1b681970 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CommonProto.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CommonProto.java
@@ -66,25 +66,25 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "PECIFIED\020\000\022\016\n\nSIZE_1_100\020\001\022\020\n\014SIZE_101_5"
           + "00\020\002\022\021\n\rSIZE_501_1000\020\003\022\022\n\016SIZE_1001_200"
           + "0\020\004\022\022\n\016SIZE_2001_5000\020\005\022\023\n\017SIZE_5001_100"
-          + "00\020\006\022\026\n\022SIZE_10001_OR_MORE\020\007\"\373\002\n\021CloudId"
+          + "00\020\006\022\026\n\022SIZE_10001_OR_MORE\020\007\"\200\003\n\021CloudId"
           + "entityInfo\022N\n\rcustomer_type\030\001 \001(\01627.goog"
           + "le.cloud.channel.v1.CloudIdentityInfo.Cu"
           + "stomerType\022\033\n\016primary_domain\030\t \001(\tB\003\340A\003\022"
-          + "\032\n\022is_domain_verified\030\004 \001(\010\022\027\n\017alternate"
-          + "_email\030\006 \001(\t\022\024\n\014phone_number\030\007 \001(\t\022\025\n\rla"
-          + "nguage_code\030\010 \001(\t\022\036\n\021admin_console_uri\030\n"
-          + " \001(\tB\003\340A\003\0222\n\010edu_data\030\026 \001(\0132 .google.clo"
-          + "ud.channel.v1.EduData\"C\n\014CustomerType\022\035\n"
-          + "\031CUSTOMER_TYPE_UNSPECIFIED\020\000\022\n\n\006DOMAIN\020\001"
-          + "\022\010\n\004TEAM\020\002\"\203\001\n\005Value\022\025\n\013int64_value\030\001 \001("
-          + "\003H\000\022\026\n\014string_value\030\002 \001(\tH\000\022\026\n\014double_va"
-          + "lue\030\003 \001(\001H\000\022+\n\013proto_value\030\004 \001(\0132\024.googl"
-          + "e.protobuf.AnyH\000B\006\n\004kind\"C\n\tAdminUser\022\r\n"
-          + "\005email\030\001 \001(\t\022\022\n\ngiven_name\030\002 \001(\t\022\023\n\013fami"
-          + "ly_name\030\003 \001(\tBl\n\033com.google.cloud.channe"
-          + "l.v1B\013CommonProtoP\001Z>google.golang.org/g"
-          + "enproto/googleapis/cloud/channel/v1;chan"
-          + "nelb\006proto3"
+          + "\037\n\022is_domain_verified\030\004 \001(\010B\003\340A\003\022\027\n\017alte"
+          + "rnate_email\030\006 \001(\t\022\024\n\014phone_number\030\007 \001(\t\022"
+          + "\025\n\rlanguage_code\030\010 \001(\t\022\036\n\021admin_console_"
+          + "uri\030\n \001(\tB\003\340A\003\0222\n\010edu_data\030\026 \001(\0132 .googl"
+          + "e.cloud.channel.v1.EduData\"C\n\014CustomerTy"
+          + "pe\022\035\n\031CUSTOMER_TYPE_UNSPECIFIED\020\000\022\n\n\006DOM"
+          + "AIN\020\001\022\010\n\004TEAM\020\002\"\231\001\n\005Value\022\025\n\013int64_value"
+          + "\030\001 \001(\003H\000\022\026\n\014string_value\030\002 \001(\tH\000\022\026\n\014doub"
+          + "le_value\030\003 \001(\001H\000\022+\n\013proto_value\030\004 \001(\0132\024."
+          + "google.protobuf.AnyH\000\022\024\n\nbool_value\030\005 \001("
+          + "\010H\000B\006\n\004kind\"C\n\tAdminUser\022\r\n\005email\030\001 \001(\t\022"
+          + "\022\n\ngiven_name\030\002 \001(\t\022\023\n\013family_name\030\003 \001(\t"
+          + "Bl\n\033com.google.cloud.channel.v1B\013CommonP"
+          + "rotoP\001Z>google.golang.org/genproto/googl"
+          + "eapis/cloud/channel/v1;channelb\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
@@ -123,7 +123,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_channel_v1_Value_descriptor,
             new java.lang.String[] {
-              "Int64Value", "StringValue", "DoubleValue", "ProtoValue", "Kind",
+              "Int64Value", "StringValue", "DoubleValue", "ProtoValue", "BoolValue", "Kind",
             });
     internal_static_google_cloud_channel_v1_AdminUser_descriptor =
         getDescriptor().getMessageTypes().get(3);
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateChannelPartnerLinkRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateChannelPartnerLinkRequest.java
index 2aa509dc..e6068bcc 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateChannelPartnerLinkRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateChannelPartnerLinkRequest.java
@@ -134,9 +134,9 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -159,9 +159,9 @@ public java.lang.String getParent() {
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -593,9 +593,9 @@ public Builder mergeFrom(
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -617,9 +617,9 @@ public java.lang.String getParent() {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -641,9 +641,9 @@ public com.google.protobuf.ByteString getParentBytes() {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -664,9 +664,9 @@ public Builder setParent(java.lang.String value) {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -683,9 +683,9 @@ public Builder clearParent() {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateChannelPartnerLinkRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateChannelPartnerLinkRequestOrBuilder.java
index 644f5b15..a41b0d46 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateChannelPartnerLinkRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateChannelPartnerLinkRequestOrBuilder.java
@@ -27,9 +27,9 @@ public interface CreateChannelPartnerLinkRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -41,9 +41,9 @@ public interface CreateChannelPartnerLinkRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateCustomerRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateCustomerRequest.java
index d55f12c9..57155326 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateCustomerRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateCustomerRequest.java
@@ -134,7 +134,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
    * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -158,7 +158,7 @@ public java.lang.String getParent() {
    *
    * 
    * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -581,7 +581,7 @@ public Builder mergeFrom(
      *
      * 
      * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -604,7 +604,7 @@ public java.lang.String getParent() {
      *
      * 
      * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -627,7 +627,7 @@ public com.google.protobuf.ByteString getParentBytes() {
      *
      * 
      * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -649,7 +649,7 @@ public Builder setParent(java.lang.String value) {
      *
      * 
      * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -667,7 +667,7 @@ public Builder clearParent() {
      *
      * 
      * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateCustomerRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateCustomerRequestOrBuilder.java
index 7e1a5a58..4a6f5102 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateCustomerRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateCustomerRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface CreateCustomerRequestOrBuilder
    *
    * 
    * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -41,7 +41,7 @@ public interface CreateCustomerRequestOrBuilder
    *
    * 
    * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateEntitlementRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateEntitlementRequest.java
index f7503d23..3d20ce7b 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateEntitlementRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateEntitlementRequest.java
@@ -141,9 +141,9 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * 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}
    * 

    *
    * 
@@ -168,9 +168,9 @@ public java.lang.String getParent() {
    *
    *
    * 
-   * 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}
    * 

    *
    * 
@@ -252,13 +252,12 @@ public com.google.cloud.channel.v1.EntitlementOrBuilder getEntitlementOrBuilder(
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -284,13 +283,12 @@ public java.lang.String getRequestId() {
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -680,9 +678,9 @@ public Builder mergeFrom(
      *
      *
      * 
-     * 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}
      * 

      *
      * 
@@ -706,9 +704,9 @@ public java.lang.String getParent() {
      *
      *
      * 
-     * 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}
      * 

      *
      * 
@@ -732,9 +730,9 @@ public com.google.protobuf.ByteString getParentBytes() {
      *
      *
      * 
-     * 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}
      * 

      *
      * 
@@ -757,9 +755,9 @@ public Builder setParent(java.lang.String value) {
      *
      *
      * 
-     * 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}
      * 

      *
      * 
@@ -778,9 +776,9 @@ public Builder clearParent() {
      *
      *
      * 
-     * 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}
      * 

      *
      * 
@@ -1009,13 +1007,12 @@ public com.google.cloud.channel.v1.EntitlementOrBuilder getEntitlementOrBuilder(
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -1040,13 +1037,12 @@ public java.lang.String getRequestId() {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -1071,13 +1067,12 @@ public com.google.protobuf.ByteString getRequestIdBytes() {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -1101,13 +1096,12 @@ public Builder setRequestId(java.lang.String value) {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -1127,13 +1121,12 @@ public Builder clearRequestId() {
      *
      *
      * 
-     * 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.
+     * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateEntitlementRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateEntitlementRequestOrBuilder.java
index 87f0b4e8..75ba5ddf 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateEntitlementRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CreateEntitlementRequestOrBuilder.java
@@ -27,9 +27,9 @@ public interface CreateEntitlementRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
    * 
@@ -43,9 +43,9 @@ public interface CreateEntitlementRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
    * 
@@ -101,13 +101,12 @@ public interface CreateEntitlementRequestOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -122,13 +121,12 @@ public interface CreateEntitlementRequestOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CustomerEvent.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CustomerEvent.java
index 3481d25d..5f290201 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CustomerEvent.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/CustomerEvent.java
@@ -139,6 +139,26 @@ public enum Type implements com.google.protobuf.ProtocolMessageEnum {
      * TYPE_UNSPECIFIED = 0;
      */
     TYPE_UNSPECIFIED(0),
+    /**
+     *
+     *
+     * 
+     * Primary domain for customer was changed.
+     * 

+     *
+     * PRIMARY_DOMAIN_CHANGED = 1;
+     */
+    PRIMARY_DOMAIN_CHANGED(1),
+    /**
+     *
+     *
+     * 
+     * Primary domain of the customer has been verified.
+     * 

+     *
+     * PRIMARY_DOMAIN_VERIFIED = 2;
+     */
+    PRIMARY_DOMAIN_VERIFIED(2),
     UNRECOGNIZED(-1),
     ;
 
@@ -152,6 +172,26 @@ public enum Type implements com.google.protobuf.ProtocolMessageEnum {
      * TYPE_UNSPECIFIED = 0;
      */
     public static final int TYPE_UNSPECIFIED_VALUE = 0;
+    /**
+     *
+     *
+     * 
+     * Primary domain for customer was changed.
+     * 

+     *
+     * PRIMARY_DOMAIN_CHANGED = 1;
+     */
+    public static final int PRIMARY_DOMAIN_CHANGED_VALUE = 1;
+    /**
+     *
+     *
+     * 
+     * Primary domain of the customer has been verified.
+     * 

+     *
+     * PRIMARY_DOMAIN_VERIFIED = 2;
+     */
+    public static final int PRIMARY_DOMAIN_VERIFIED_VALUE = 2;
 
     public final int getNumber() {
       if (this == UNRECOGNIZED) {
@@ -179,6 +219,10 @@ public static Type forNumber(int value) {
       switch (value) {
         case 0:
           return TYPE_UNSPECIFIED;
+        case 1:
+          return PRIMARY_DOMAIN_CHANGED;
+        case 2:
+          return PRIMARY_DOMAIN_VERIFIED;
         default:
           return null;
       }
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/EntitlementsProto.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/EntitlementsProto.java
index 6b2b9795..5cd98b0f 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/EntitlementsProto.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/EntitlementsProto.java
@@ -127,20 +127,21 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\rpayment_cycle\030\006 \001(\0132\037.google.cloud.chan"
           + "nel.v1.Period\"L\n\rTrialSettings\022\r\n\005trial\030"
           + "\001 \001(\010\022,\n\010end_time\030\002 \001(\0132\032.google.protobu"
-          + "f.Timestamp\"\210\001\n\017TransferableSku\022J\n\024trans"
+          + "f.Timestamp\"\277\001\n\017TransferableSku\022J\n\024trans"
           + "fer_eligibility\030\t \001(\0132,.google.cloud.cha"
           + "nnel.v1.TransferEligibility\022)\n\003sku\030\013 \001(\013"
-          + "2\034.google.cloud.channel.v1.Sku\"\371\001\n\023Trans"
-          + "ferEligibility\022\023\n\013is_eligible\030\001 \001(\010\022\023\n\013d"
-          + "escription\030\002 \001(\t\022Q\n\024ineligibility_reason"
-          + "\030\003 \001(\01623.google.cloud.channel.v1.Transfe"
-          + "rEligibility.Reason\"e\n\006Reason\022\026\n\022REASON_"
-          + "UNSPECIFIED\020\000\022\032\n\026PENDING_TOS_ACCEPTANCE\020"
-          + "\001\022\024\n\020SKU_NOT_ELIGIBLE\020\002\022\021\n\rSKU_SUSPENDED"
-          + "\020\003Br\n\033com.google.cloud.channel.v1B\021Entit"
-          + "lementsProtoP\001Z>google.golang.org/genpro"
-          + "to/googleapis/cloud/channel/v1;channelb\006"
-          + "proto3"
+          + "2\034.google.cloud.channel.v1.Sku\0225\n\nlegacy"
+          + "_sku\030\014 \001(\0132\034.google.cloud.channel.v1.Sku"
+          + "B\003\340A\001\"\371\001\n\023TransferEligibility\022\023\n\013is_elig"
+          + "ible\030\001 \001(\010\022\023\n\013description\030\002 \001(\t\022Q\n\024ineli"
+          + "gibility_reason\030\003 \001(\01623.google.cloud.cha"
+          + "nnel.v1.TransferEligibility.Reason\"e\n\006Re"
+          + "ason\022\026\n\022REASON_UNSPECIFIED\020\000\022\032\n\026PENDING_"
+          + "TOS_ACCEPTANCE\020\001\022\024\n\020SKU_NOT_ELIGIBLE\020\002\022\021"
+          + "\n\rSKU_SUSPENDED\020\003Br\n\033com.google.cloud.ch"
+          + "annel.v1B\021EntitlementsProtoP\001Z>google.go"
+          + "lang.org/genproto/googleapis/cloud/chann"
+          + "el/v1;channelb\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
@@ -228,7 +229,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_channel_v1_TransferableSku_descriptor,
             new java.lang.String[] {
-              "TransferEligibility", "Sku",
+              "TransferEligibility", "Sku", "LegacySku",
             });
     internal_static_google_cloud_channel_v1_TransferEligibility_descriptor =
         getDescriptor().getMessageTypes().get(8);
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetChannelPartnerLinkRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetChannelPartnerLinkRequest.java
index b51b9ee9..ef09a01f 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetChannelPartnerLinkRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetChannelPartnerLinkRequest.java
@@ -126,7 +126,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
    * 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.
    * 

    *
@@ -151,7 +151,7 @@ public java.lang.String getName() {
    *
    * 
    * 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.
    * 

    *
@@ -554,7 +554,7 @@ public Builder mergeFrom(
      *
      * 
      * 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.
      * 

      *
@@ -578,7 +578,7 @@ public java.lang.String getName() {
      *
      * 
      * 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.
      * 

      *
@@ -602,7 +602,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      * 
      * 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.
      * 

      *
@@ -625,7 +625,7 @@ public Builder setName(java.lang.String value) {
      *
      * 
      * 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.
      * 

      *
@@ -644,7 +644,7 @@ public Builder clearName() {
      *
      * 
      * 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.
      * 

      *
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetChannelPartnerLinkRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetChannelPartnerLinkRequestOrBuilder.java
index 36330912..a026f314 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetChannelPartnerLinkRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetChannelPartnerLinkRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface GetChannelPartnerLinkRequestOrBuilder
    *
    * 
    * 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.
    * 

    *
@@ -42,7 +42,7 @@ public interface GetChannelPartnerLinkRequestOrBuilder
    *
    * 
    * 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.
    * 

    *
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetCustomerRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetCustomerRequest.java
index e0afabb3..3bdb5674 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetCustomerRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetCustomerRequest.java
@@ -118,7 +118,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
    * 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}
    * 

    *
    * 
@@ -144,7 +144,7 @@ public java.lang.String getName() {
    *
    * 
    * 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}
    * 

    *
    * 
@@ -488,7 +488,7 @@ public Builder mergeFrom(
      *
      * 
      * 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}
      * 

      *
      * 
@@ -513,7 +513,7 @@ public java.lang.String getName() {
      *
      * 
      * 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}
      * 

      *
      * 
@@ -538,7 +538,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      * 
      * 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}
      * 

      *
      * 
@@ -562,7 +562,7 @@ public Builder setName(java.lang.String value) {
      *
      * 
      * 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}
      * 

      *
      * 
@@ -582,7 +582,7 @@ public Builder clearName() {
      *
      * 
      * 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}
      * 

      *
      * 
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetCustomerRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetCustomerRequestOrBuilder.java
index d3ffba98..b153896b 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetCustomerRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetCustomerRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface GetCustomerRequestOrBuilder
    *
    * 
    * 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}
    * 

    *
    * 
@@ -43,7 +43,7 @@ public interface GetCustomerRequestOrBuilder
    *
    * 
    * 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}
    * 

    *
    * 
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetEntitlementRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetEntitlementRequest.java
index c80f5f36..7091335a 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetEntitlementRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetEntitlementRequest.java
@@ -118,8 +118,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
    * 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}
    * 

    *
    * 
@@ -145,8 +145,8 @@ public java.lang.String getName() {
    *
    * 
    * 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}
    * 

    *
    * 
@@ -492,8 +492,8 @@ public Builder mergeFrom(
      *
      * 
      * 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}
      * 

      *
      * 
@@ -518,8 +518,8 @@ public java.lang.String getName() {
      *
      * 
      * 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}
      * 

      *
      * 
@@ -544,8 +544,8 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      * 
      * 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}
      * 

      *
      * 
@@ -569,8 +569,8 @@ public Builder setName(java.lang.String value) {
      *
      * 
      * 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}
      * 

      *
      * 
@@ -590,8 +590,8 @@ public Builder clearName() {
      *
      * 
      * 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}
      * 

      *
      * 
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetEntitlementRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetEntitlementRequestOrBuilder.java
index b9398a20..92ac2af0 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetEntitlementRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/GetEntitlementRequestOrBuilder.java
@@ -28,8 +28,8 @@ public interface GetEntitlementRequestOrBuilder
    *
    * 
    * 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}
    * 

    *
    * 
@@ -44,8 +44,8 @@ public interface GetEntitlementRequestOrBuilder
    *
    * 
    * 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}
    * 

    *
    * 
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListChannelPartnerLinksRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListChannelPartnerLinksRequest.java
index 3fb021cc..b51f1805 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListChannelPartnerLinksRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListChannelPartnerLinksRequest.java
@@ -141,7 +141,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * 
    * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -166,7 +166,7 @@ public java.lang.String getParent() {
    * 
    * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -194,7 +194,7 @@ public com.google.protobuf.ByteString getParentBytes() {
    * 
    * 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.
    * 

    *
    * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -212,8 +212,8 @@ public int getPageSize() {
    *
    *
    * 
-   * 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
    * [ListChannelPartnerLinksResponse.next_page_token][google.cloud.channel.v1.ListChannelPartnerLinksResponse.next_page_token] of the previous
    * [CloudChannelService.ListChannelPartnerLinks][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerLinks] call.
    * 

@@ -238,8 +238,8 @@ public java.lang.String getPageToken() {
    *
    *
    * 
-   * 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
    * [ListChannelPartnerLinksResponse.next_page_token][google.cloud.channel.v1.ListChannelPartnerLinksResponse.next_page_token] of the previous
    * [CloudChannelService.ListChannelPartnerLinks][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerLinks] call.
    * 

@@ -675,7 +675,7 @@ public Builder mergeFrom(
      * 
      * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -699,7 +699,7 @@ public java.lang.String getParent() {
      * 
      * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -723,7 +723,7 @@ public com.google.protobuf.ByteString getParentBytes() {
      * 
      * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -746,7 +746,7 @@ public Builder setParent(java.lang.String value) {
      * 
      * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -765,7 +765,7 @@ public Builder clearParent() {
      * 
      * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -791,7 +791,7 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -808,7 +808,7 @@ public int getPageSize() {
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -828,7 +828,7 @@ public Builder setPageSize(int value) {
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -847,8 +847,8 @@ public Builder clearPageSize() {
      *
      *
      * 
-     * 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
      * [ListChannelPartnerLinksResponse.next_page_token][google.cloud.channel.v1.ListChannelPartnerLinksResponse.next_page_token] of the previous
      * [CloudChannelService.ListChannelPartnerLinks][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerLinks] call.
      * 

@@ -872,8 +872,8 @@ public java.lang.String getPageToken() {
      *
      *
      * 
-     * 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
      * [ListChannelPartnerLinksResponse.next_page_token][google.cloud.channel.v1.ListChannelPartnerLinksResponse.next_page_token] of the previous
      * [CloudChannelService.ListChannelPartnerLinks][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerLinks] call.
      * 

@@ -897,8 +897,8 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
      *
      *
      * 
-     * 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
      * [ListChannelPartnerLinksResponse.next_page_token][google.cloud.channel.v1.ListChannelPartnerLinksResponse.next_page_token] of the previous
      * [CloudChannelService.ListChannelPartnerLinks][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerLinks] call.
      * 

@@ -921,8 +921,8 @@ public Builder setPageToken(java.lang.String value) {
      *
      *
      * 
-     * 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
      * [ListChannelPartnerLinksResponse.next_page_token][google.cloud.channel.v1.ListChannelPartnerLinksResponse.next_page_token] of the previous
      * [CloudChannelService.ListChannelPartnerLinks][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerLinks] call.
      * 

@@ -941,8 +941,8 @@ public Builder clearPageToken() {
      *
      *
      * 
-     * 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
      * [ListChannelPartnerLinksResponse.next_page_token][google.cloud.channel.v1.ListChannelPartnerLinksResponse.next_page_token] of the previous
      * [CloudChannelService.ListChannelPartnerLinks][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerLinks] call.
      * 

diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListChannelPartnerLinksRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListChannelPartnerLinksRequestOrBuilder.java
index 3f4eed99..d06af6b7 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListChannelPartnerLinksRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListChannelPartnerLinksRequestOrBuilder.java
@@ -29,7 +29,7 @@ public interface ListChannelPartnerLinksRequestOrBuilder
    * 
    * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -43,7 +43,7 @@ public interface ListChannelPartnerLinksRequestOrBuilder
    * 
    * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -58,7 +58,7 @@ public interface ListChannelPartnerLinksRequestOrBuilder
    * 
    * 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.
    * 

    *
    * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -71,8 +71,8 @@ public interface ListChannelPartnerLinksRequestOrBuilder
    *
    *
    * 
-   * 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
    * [ListChannelPartnerLinksResponse.next_page_token][google.cloud.channel.v1.ListChannelPartnerLinksResponse.next_page_token] of the previous
    * [CloudChannelService.ListChannelPartnerLinks][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerLinks] call.
    * 

@@ -86,8 +86,8 @@ public interface ListChannelPartnerLinksRequestOrBuilder
    *
    *
    * 
-   * 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
    * [ListChannelPartnerLinksResponse.next_page_token][google.cloud.channel.v1.ListChannelPartnerLinksResponse.next_page_token] of the previous
    * [CloudChannelService.ListChannelPartnerLinks][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerLinks] call.
    * 

diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListCustomersRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListCustomersRequest.java
index 7c257fde..dc9ab72f 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListCustomersRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListCustomersRequest.java
@@ -130,8 +130,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * 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}.
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -154,8 +154,8 @@ public java.lang.String getParent() {
    *
    *
    * 
-   * 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}.
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -182,8 +182,8 @@ public com.google.protobuf.ByteString getParentBytes() {
    *
    * 
    * 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.
    * 

    *
    * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -201,8 +201,8 @@ public int getPageSize() {
    *
    *
    * 
-   * 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
    * [ListCustomersResponse.next_page_token][google.cloud.channel.v1.ListCustomersResponse.next_page_token] of the previous
    * [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers] call.
    * 

@@ -227,8 +227,8 @@ public java.lang.String getPageToken() {
    *
    *
    * 
-   * 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
    * [ListCustomersResponse.next_page_token][google.cloud.channel.v1.ListCustomersResponse.next_page_token] of the previous
    * [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers] call.
    * 

@@ -603,8 +603,8 @@ public Builder mergeFrom(
      *
      *
      * 
-     * 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}.
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -626,8 +626,8 @@ public java.lang.String getParent() {
      *
      *
      * 
-     * 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}.
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -649,8 +649,8 @@ public com.google.protobuf.ByteString getParentBytes() {
      *
      *
      * 
-     * 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}.
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -671,8 +671,8 @@ public Builder setParent(java.lang.String value) {
      *
      *
      * 
-     * 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}.
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -689,8 +689,8 @@ public Builder clearParent() {
      *
      *
      * 
-     * 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}.
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -715,8 +715,8 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -732,8 +732,8 @@ public int getPageSize() {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -752,8 +752,8 @@ public Builder setPageSize(int value) {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -772,8 +772,8 @@ public Builder clearPageSize() {
      *
      *
      * 
-     * 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
      * [ListCustomersResponse.next_page_token][google.cloud.channel.v1.ListCustomersResponse.next_page_token] of the previous
      * [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers] call.
      * 

@@ -797,8 +797,8 @@ public java.lang.String getPageToken() {
      *
      *
      * 
-     * 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
      * [ListCustomersResponse.next_page_token][google.cloud.channel.v1.ListCustomersResponse.next_page_token] of the previous
      * [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers] call.
      * 

@@ -822,8 +822,8 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
      *
      *
      * 
-     * 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
      * [ListCustomersResponse.next_page_token][google.cloud.channel.v1.ListCustomersResponse.next_page_token] of the previous
      * [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers] call.
      * 

@@ -846,8 +846,8 @@ public Builder setPageToken(java.lang.String value) {
      *
      *
      * 
-     * 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
      * [ListCustomersResponse.next_page_token][google.cloud.channel.v1.ListCustomersResponse.next_page_token] of the previous
      * [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers] call.
      * 

@@ -866,8 +866,8 @@ public Builder clearPageToken() {
      *
      *
      * 
-     * 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
      * [ListCustomersResponse.next_page_token][google.cloud.channel.v1.ListCustomersResponse.next_page_token] of the previous
      * [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers] call.
      * 

diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListCustomersRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListCustomersRequestOrBuilder.java
index 0abdbc91..d5ec352e 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListCustomersRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListCustomersRequestOrBuilder.java
@@ -27,8 +27,8 @@ public interface ListCustomersRequestOrBuilder
    *
    *
    * 
-   * 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}.
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -40,8 +40,8 @@ public interface ListCustomersRequestOrBuilder
    *
    *
    * 
-   * 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}.
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -55,8 +55,8 @@ public interface ListCustomersRequestOrBuilder
    *
    * 
    * 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.
    * 

    *
    * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -69,8 +69,8 @@ public interface ListCustomersRequestOrBuilder
    *
    *
    * 
-   * 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
    * [ListCustomersResponse.next_page_token][google.cloud.channel.v1.ListCustomersResponse.next_page_token] of the previous
    * [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers] call.
    * 

@@ -84,8 +84,8 @@ public interface ListCustomersRequestOrBuilder
    *
    *
    * 
-   * 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
    * [ListCustomersResponse.next_page_token][google.cloud.channel.v1.ListCustomersResponse.next_page_token] of the previous
    * [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers] call.
    * 

diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListCustomersResponse.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListCustomersResponse.java
index 088ab36d..98e11a30 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListCustomersResponse.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListCustomersResponse.java
@@ -133,7 +133,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * The customers belonging to the reseller or distributor.
+   * The customers belonging to a reseller or distributor.
    * 

    *
    * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -146,7 +146,7 @@ public java.util.List getCustomersList() {
    *
    *
    * 
-   * The customers belonging to the reseller or distributor.
+   * The customers belonging to a reseller or distributor.
    * 

    *
    * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -160,7 +160,7 @@ public java.util.List getCustomersList() {
    *
    *
    * 
-   * The customers belonging to the reseller or distributor.
+   * The customers belonging to a reseller or distributor.
    * 

    *
    * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -173,7 +173,7 @@ public int getCustomersCount() {
    *
    *
    * 
-   * The customers belonging to the reseller or distributor.
+   * The customers belonging to a reseller or distributor.
    * 

    *
    * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -186,7 +186,7 @@ public com.google.cloud.channel.v1.Customer getCustomers(int index) {
    *
    *
    * 
-   * The customers belonging to the reseller or distributor.
+   * The customers belonging to a reseller or distributor.
    * 

    *
    * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -643,7 +643,7 @@ private void ensureCustomersIsMutable() {
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -659,7 +659,7 @@ public java.util.List getCustomersList() {
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -675,7 +675,7 @@ public int getCustomersCount() {
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -691,7 +691,7 @@ public com.google.cloud.channel.v1.Customer getCustomers(int index) {
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -713,7 +713,7 @@ public Builder setCustomers(int index, com.google.cloud.channel.v1.Customer valu
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -733,7 +733,7 @@ public Builder setCustomers(
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -755,7 +755,7 @@ public Builder addCustomers(com.google.cloud.channel.v1.Customer value) {
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -777,7 +777,7 @@ public Builder addCustomers(int index, com.google.cloud.channel.v1.Customer valu
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -796,7 +796,7 @@ public Builder addCustomers(com.google.cloud.channel.v1.Customer.Builder builder
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -816,7 +816,7 @@ public Builder addCustomers(
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -836,7 +836,7 @@ public Builder addAllCustomers(
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -855,7 +855,7 @@ public Builder clearCustomers() {
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -874,7 +874,7 @@ public Builder removeCustomers(int index) {
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -886,7 +886,7 @@ public com.google.cloud.channel.v1.Customer.Builder getCustomersBuilder(int inde
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -902,7 +902,7 @@ public com.google.cloud.channel.v1.CustomerOrBuilder getCustomersOrBuilder(int i
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -919,7 +919,7 @@ public com.google.cloud.channel.v1.CustomerOrBuilder getCustomersOrBuilder(int i
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -932,7 +932,7 @@ public com.google.cloud.channel.v1.Customer.Builder addCustomersBuilder() {
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -945,7 +945,7 @@ public com.google.cloud.channel.v1.Customer.Builder addCustomersBuilder(int inde
      *
      *
      * 
-     * The customers belonging to the reseller or distributor.
+     * The customers belonging to a reseller or distributor.
      * 

      *
      * repeated .google.cloud.channel.v1.Customer customers = 1;
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListCustomersResponseOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListCustomersResponseOrBuilder.java
index 722a96cc..fa355933 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListCustomersResponseOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListCustomersResponseOrBuilder.java
@@ -27,7 +27,7 @@ public interface ListCustomersResponseOrBuilder
    *
    *
    * 
-   * The customers belonging to the reseller or distributor.
+   * The customers belonging to a reseller or distributor.
    * 

    *
    * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -37,7 +37,7 @@ public interface ListCustomersResponseOrBuilder
    *
    *
    * 
-   * The customers belonging to the reseller or distributor.
+   * The customers belonging to a reseller or distributor.
    * 

    *
    * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -47,7 +47,7 @@ public interface ListCustomersResponseOrBuilder
    *
    *
    * 
-   * The customers belonging to the reseller or distributor.
+   * The customers belonging to a reseller or distributor.
    * 

    *
    * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -57,7 +57,7 @@ public interface ListCustomersResponseOrBuilder
    *
    *
    * 
-   * The customers belonging to the reseller or distributor.
+   * The customers belonging to a reseller or distributor.
    * 

    *
    * repeated .google.cloud.channel.v1.Customer customers = 1;
@@ -68,7 +68,7 @@ public interface ListCustomersResponseOrBuilder
    *
    *
    * 
-   * The customers belonging to the reseller or distributor.
+   * The customers belonging to a reseller or distributor.
    * 

    *
    * repeated .google.cloud.channel.v1.Customer customers = 1;
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListEntitlementsRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListEntitlementsRequest.java
index aea20db4..9df528a4 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListEntitlementsRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListEntitlementsRequest.java
@@ -130,9 +130,9 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * 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}
    * 

    *
    * 
@@ -157,9 +157,9 @@ public java.lang.String getParent() {
    *
    *
    * 
-   * 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}
    * 

    *
    * 
@@ -188,8 +188,8 @@ public com.google.protobuf.ByteString getParentBytes() {
    *
    * 
    * 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.
    * 

    *
    * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -207,8 +207,8 @@ public int getPageSize() {
    *
    *
    * 
-   * 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
    * [ListEntitlementsResponse.next_page_token][google.cloud.channel.v1.ListEntitlementsResponse.next_page_token] of the previous
    * [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements] call.
    * 

@@ -233,8 +233,8 @@ public java.lang.String getPageToken() {
    *
    *
    * 
-   * 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
    * [ListEntitlementsResponse.next_page_token][google.cloud.channel.v1.ListEntitlementsResponse.next_page_token] of the previous
    * [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements] call.
    * 

@@ -610,9 +610,9 @@ public Builder mergeFrom(
      *
      *
      * 
-     * 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}
      * 

      *
      * 
@@ -636,9 +636,9 @@ public java.lang.String getParent() {
      *
      *
      * 
-     * 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}
      * 

      *
      * 
@@ -662,9 +662,9 @@ public com.google.protobuf.ByteString getParentBytes() {
      *
      *
      * 
-     * 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}
      * 

      *
      * 
@@ -687,9 +687,9 @@ public Builder setParent(java.lang.String value) {
      *
      *
      * 
-     * 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}
      * 

      *
      * 
@@ -708,9 +708,9 @@ public Builder clearParent() {
      *
      *
      * 
-     * 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}
      * 

      *
      * 
@@ -737,8 +737,8 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -754,8 +754,8 @@ public int getPageSize() {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -774,8 +774,8 @@ public Builder setPageSize(int value) {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -794,8 +794,8 @@ public Builder clearPageSize() {
      *
      *
      * 
-     * 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
      * [ListEntitlementsResponse.next_page_token][google.cloud.channel.v1.ListEntitlementsResponse.next_page_token] of the previous
      * [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements] call.
      * 

@@ -819,8 +819,8 @@ public java.lang.String getPageToken() {
      *
      *
      * 
-     * 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
      * [ListEntitlementsResponse.next_page_token][google.cloud.channel.v1.ListEntitlementsResponse.next_page_token] of the previous
      * [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements] call.
      * 

@@ -844,8 +844,8 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
      *
      *
      * 
-     * 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
      * [ListEntitlementsResponse.next_page_token][google.cloud.channel.v1.ListEntitlementsResponse.next_page_token] of the previous
      * [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements] call.
      * 

@@ -868,8 +868,8 @@ public Builder setPageToken(java.lang.String value) {
      *
      *
      * 
-     * 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
      * [ListEntitlementsResponse.next_page_token][google.cloud.channel.v1.ListEntitlementsResponse.next_page_token] of the previous
      * [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements] call.
      * 

@@ -888,8 +888,8 @@ public Builder clearPageToken() {
      *
      *
      * 
-     * 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
      * [ListEntitlementsResponse.next_page_token][google.cloud.channel.v1.ListEntitlementsResponse.next_page_token] of the previous
      * [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements] call.
      * 

diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListEntitlementsRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListEntitlementsRequestOrBuilder.java
index f830c043..61bcf3b9 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListEntitlementsRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListEntitlementsRequestOrBuilder.java
@@ -27,9 +27,9 @@ public interface ListEntitlementsRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
    * 
@@ -43,9 +43,9 @@ public interface ListEntitlementsRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
    * 
@@ -61,8 +61,8 @@ public interface ListEntitlementsRequestOrBuilder
    *
    * 
    * 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.
    * 

    *
    * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -75,8 +75,8 @@ public interface ListEntitlementsRequestOrBuilder
    *
    *
    * 
-   * 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
    * [ListEntitlementsResponse.next_page_token][google.cloud.channel.v1.ListEntitlementsResponse.next_page_token] of the previous
    * [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements] call.
    * 

@@ -90,8 +90,8 @@ public interface ListEntitlementsRequestOrBuilder
    *
    *
    * 
-   * 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
    * [ListEntitlementsResponse.next_page_token][google.cloud.channel.v1.ListEntitlementsResponse.next_page_token] of the previous
    * [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements] call.
    * 

diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListEntitlementsResponse.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListEntitlementsResponse.java
index 2c91c946..2c38e2c1 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListEntitlementsResponse.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListEntitlementsResponse.java
@@ -133,7 +133,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * The entitlements belonging to the reseller's customer.
+   * The reseller customer's entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -146,7 +146,7 @@ public java.util.List getEntitlementsLi
    *
    *
    * 
-   * The entitlements belonging to the reseller's customer.
+   * The reseller customer's entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -160,7 +160,7 @@ public java.util.List getEntitlementsLi
    *
    *
    * 
-   * The entitlements belonging to the reseller's customer.
+   * The reseller customer's entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -173,7 +173,7 @@ public int getEntitlementsCount() {
    *
    *
    * 
-   * The entitlements belonging to the reseller's customer.
+   * The reseller customer's entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -186,7 +186,7 @@ public com.google.cloud.channel.v1.Entitlement getEntitlements(int index) {
    *
    *
    * 
-   * The entitlements belonging to the reseller's customer.
+   * The reseller customer's entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -202,7 +202,7 @@ public com.google.cloud.channel.v1.EntitlementOrBuilder getEntitlementsOrBuilder
    *
    *
    * 
-   * A token to List next page of results.
+   * A token to list the next page of results.
    * Pass to [ListEntitlementsRequest.page_token][google.cloud.channel.v1.ListEntitlementsRequest.page_token] to obtain that page.
    * 

    *
@@ -226,7 +226,7 @@ public java.lang.String getNextPageToken() {
    *
    *
    * 
-   * A token to List next page of results.
+   * A token to list the next page of results.
    * Pass to [ListEntitlementsRequest.page_token][google.cloud.channel.v1.ListEntitlementsRequest.page_token] to obtain that page.
    * 

    *
@@ -644,7 +644,7 @@ private void ensureEntitlementsIsMutable() {
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -660,7 +660,7 @@ public java.util.List getEntitlementsLi
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -676,7 +676,7 @@ public int getEntitlementsCount() {
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -692,7 +692,7 @@ public com.google.cloud.channel.v1.Entitlement getEntitlements(int index) {
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -714,7 +714,7 @@ public Builder setEntitlements(int index, com.google.cloud.channel.v1.Entitlemen
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -734,7 +734,7 @@ public Builder setEntitlements(
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -756,7 +756,7 @@ public Builder addEntitlements(com.google.cloud.channel.v1.Entitlement value) {
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -778,7 +778,7 @@ public Builder addEntitlements(int index, com.google.cloud.channel.v1.Entitlemen
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -798,7 +798,7 @@ public Builder addEntitlements(
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -818,7 +818,7 @@ public Builder addEntitlements(
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -838,7 +838,7 @@ public Builder addAllEntitlements(
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -857,7 +857,7 @@ public Builder clearEntitlements() {
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -876,7 +876,7 @@ public Builder removeEntitlements(int index) {
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -888,7 +888,7 @@ public com.google.cloud.channel.v1.Entitlement.Builder getEntitlementsBuilder(in
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -904,7 +904,7 @@ public com.google.cloud.channel.v1.EntitlementOrBuilder getEntitlementsOrBuilder
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -921,7 +921,7 @@ public com.google.cloud.channel.v1.EntitlementOrBuilder getEntitlementsOrBuilder
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -934,7 +934,7 @@ public com.google.cloud.channel.v1.Entitlement.Builder addEntitlementsBuilder()
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -947,7 +947,7 @@ public com.google.cloud.channel.v1.Entitlement.Builder addEntitlementsBuilder(in
      *
      *
      * 
-     * The entitlements belonging to the reseller's customer.
+     * The reseller customer's entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -979,7 +979,7 @@ public com.google.cloud.channel.v1.Entitlement.Builder addEntitlementsBuilder(in
      *
      *
      * 
-     * A token to List next page of results.
+     * A token to list the next page of results.
      * Pass to [ListEntitlementsRequest.page_token][google.cloud.channel.v1.ListEntitlementsRequest.page_token] to obtain that page.
      * 

      *
@@ -1002,7 +1002,7 @@ public java.lang.String getNextPageToken() {
      *
      *
      * 
-     * A token to List next page of results.
+     * A token to list the next page of results.
      * Pass to [ListEntitlementsRequest.page_token][google.cloud.channel.v1.ListEntitlementsRequest.page_token] to obtain that page.
      * 

      *
@@ -1025,7 +1025,7 @@ public com.google.protobuf.ByteString getNextPageTokenBytes() {
      *
      *
      * 
-     * A token to List next page of results.
+     * A token to list the next page of results.
      * Pass to [ListEntitlementsRequest.page_token][google.cloud.channel.v1.ListEntitlementsRequest.page_token] to obtain that page.
      * 

      *
@@ -1047,7 +1047,7 @@ public Builder setNextPageToken(java.lang.String value) {
      *
      *
      * 
-     * A token to List next page of results.
+     * A token to list the next page of results.
      * Pass to [ListEntitlementsRequest.page_token][google.cloud.channel.v1.ListEntitlementsRequest.page_token] to obtain that page.
      * 

      *
@@ -1065,7 +1065,7 @@ public Builder clearNextPageToken() {
      *
      *
      * 
-     * A token to List next page of results.
+     * A token to list the next page of results.
      * Pass to [ListEntitlementsRequest.page_token][google.cloud.channel.v1.ListEntitlementsRequest.page_token] to obtain that page.
      * 

      *
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListEntitlementsResponseOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListEntitlementsResponseOrBuilder.java
index 10b4ebda..94ca6a76 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListEntitlementsResponseOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListEntitlementsResponseOrBuilder.java
@@ -27,7 +27,7 @@ public interface ListEntitlementsResponseOrBuilder
    *
    *
    * 
-   * The entitlements belonging to the reseller's customer.
+   * The reseller customer's entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -37,7 +37,7 @@ public interface ListEntitlementsResponseOrBuilder
    *
    *
    * 
-   * The entitlements belonging to the reseller's customer.
+   * The reseller customer's entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -47,7 +47,7 @@ public interface ListEntitlementsResponseOrBuilder
    *
    *
    * 
-   * The entitlements belonging to the reseller's customer.
+   * The reseller customer's entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -57,7 +57,7 @@ public interface ListEntitlementsResponseOrBuilder
    *
    *
    * 
-   * The entitlements belonging to the reseller's customer.
+   * The reseller customer's entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -68,7 +68,7 @@ public interface ListEntitlementsResponseOrBuilder
    *
    *
    * 
-   * The entitlements belonging to the reseller's customer.
+   * The reseller customer's entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -79,7 +79,7 @@ public interface ListEntitlementsResponseOrBuilder
    *
    *
    * 
-   * A token to List next page of results.
+   * A token to list the next page of results.
    * Pass to [ListEntitlementsRequest.page_token][google.cloud.channel.v1.ListEntitlementsRequest.page_token] to obtain that page.
    * 

    *
@@ -92,7 +92,7 @@ public interface ListEntitlementsResponseOrBuilder
    *
    *
    * 
-   * A token to List next page of results.
+   * A token to list the next page of results.
    * Pass to [ListEntitlementsRequest.page_token][google.cloud.channel.v1.ListEntitlementsRequest.page_token] to obtain that page.
    * 

    *
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListOffersRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListOffersRequest.java
index ac0e753d..02891cc7 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListOffersRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListOffersRequest.java
@@ -147,7 +147,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
    * 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}.
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -171,7 +171,7 @@ public java.lang.String getParent() {
    *
    * 
    * 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}.
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -198,8 +198,8 @@ public com.google.protobuf.ByteString getParentBytes() {
    *
    * 
    * 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.
    * 

    *
    * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -217,7 +217,7 @@ public int getPageSize() {
    *
    *
    * 
-   * 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.
    * 

    *
    * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -240,7 +240,7 @@ public java.lang.String getPageToken() {
    *
    *
    * 
-   * 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.
    * 

    *
    * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -267,7 +267,7 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
    *
    * 
    * 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
@@ -294,7 +294,7 @@ public java.lang.String getFilter() {
    *
    * 
    * 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
@@ -323,9 +323,9 @@ public com.google.protobuf.ByteString getFilterBytes() {
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -348,9 +348,9 @@ public java.lang.String getLanguageCode() {
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -755,7 +755,7 @@ public Builder mergeFrom(
      *
      * 
      * 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}.
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -778,7 +778,7 @@ public java.lang.String getParent() {
      *
      * 
      * 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}.
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -801,7 +801,7 @@ public com.google.protobuf.ByteString getParentBytes() {
      *
      * 
      * 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}.
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -823,7 +823,7 @@ public Builder setParent(java.lang.String value) {
      *
      * 
      * 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}.
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -841,7 +841,7 @@ public Builder clearParent() {
      *
      * 
      * 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}.
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -866,8 +866,8 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -883,8 +883,8 @@ public int getPageSize() {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -903,8 +903,8 @@ public Builder setPageSize(int value) {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -923,7 +923,7 @@ public Builder clearPageSize() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -945,7 +945,7 @@ public java.lang.String getPageToken() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -967,7 +967,7 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -988,7 +988,7 @@ public Builder setPageToken(java.lang.String value) {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1005,7 +1005,7 @@ public Builder clearPageToken() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1030,7 +1030,7 @@ public Builder setPageTokenBytes(com.google.protobuf.ByteString value) {
      *
      * 
      * 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
@@ -1056,7 +1056,7 @@ public java.lang.String getFilter() {
      *
      * 
      * 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
@@ -1082,7 +1082,7 @@ public com.google.protobuf.ByteString getFilterBytes() {
      *
      * 
      * 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
@@ -1107,7 +1107,7 @@ public Builder setFilter(java.lang.String value) {
      *
      * 
      * 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
@@ -1128,7 +1128,7 @@ public Builder clearFilter() {
      *
      * 
      * 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
@@ -1155,9 +1155,9 @@ public Builder setFilterBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -1179,9 +1179,9 @@ public java.lang.String getLanguageCode() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -1203,9 +1203,9 @@ public com.google.protobuf.ByteString getLanguageCodeBytes() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -1226,9 +1226,9 @@ public Builder setLanguageCode(java.lang.String value) {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -1245,9 +1245,9 @@ public Builder clearLanguageCode() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListOffersRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListOffersRequestOrBuilder.java
index 37232cd0..9f25af28 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListOffersRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListOffersRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface ListOffersRequestOrBuilder
    *
    * 
    * 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}.
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -41,7 +41,7 @@ public interface ListOffersRequestOrBuilder
    *
    * 
    * 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}.
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -55,8 +55,8 @@ public interface ListOffersRequestOrBuilder
    *
    * 
    * 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.
    * 

    *
    * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -69,7 +69,7 @@ public interface ListOffersRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -81,7 +81,7 @@ public interface ListOffersRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -95,7 +95,7 @@ public interface ListOffersRequestOrBuilder
    *
    * 
    * 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
@@ -111,7 +111,7 @@ public interface ListOffersRequestOrBuilder
    *
    * 
    * 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
@@ -127,9 +127,9 @@ public interface ListOffersRequestOrBuilder
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -141,9 +141,9 @@ public interface ListOffersRequestOrBuilder
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListProductsRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListProductsRequest.java
index f445f825..ad0a7827 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListProductsRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListProductsRequest.java
@@ -190,8 +190,8 @@ public com.google.protobuf.ByteString getAccountBytes() {
    *
    * 
    * 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.
    * 

    *
    * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -209,7 +209,7 @@ public int getPageSize() {
    *
    *
    * 
-   * 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.
    * 

    *
    * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -232,7 +232,7 @@ public java.lang.String getPageToken() {
    *
    *
    * 
-   * 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.
    * 

    *
    * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -258,9 +258,9 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -283,9 +283,9 @@ public java.lang.String getLanguageCode() {
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -786,8 +786,8 @@ public Builder setAccountBytes(com.google.protobuf.ByteString value) {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -803,8 +803,8 @@ public int getPageSize() {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -823,8 +823,8 @@ public Builder setPageSize(int value) {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -843,7 +843,7 @@ public Builder clearPageSize() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -865,7 +865,7 @@ public java.lang.String getPageToken() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -887,7 +887,7 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -908,7 +908,7 @@ public Builder setPageToken(java.lang.String value) {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -925,7 +925,7 @@ public Builder clearPageToken() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -949,9 +949,9 @@ public Builder setPageTokenBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -973,9 +973,9 @@ public java.lang.String getLanguageCode() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -997,9 +997,9 @@ public com.google.protobuf.ByteString getLanguageCodeBytes() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -1020,9 +1020,9 @@ public Builder setLanguageCode(java.lang.String value) {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -1039,9 +1039,9 @@ public Builder clearLanguageCode() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 4 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListProductsRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListProductsRequestOrBuilder.java
index 7095b209..060de000 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListProductsRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListProductsRequestOrBuilder.java
@@ -55,8 +55,8 @@ public interface ListProductsRequestOrBuilder
    *
    * 
    * 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.
    * 

    *
    * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -69,7 +69,7 @@ public interface ListProductsRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -81,7 +81,7 @@ public interface ListProductsRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -94,9 +94,9 @@ public interface ListProductsRequestOrBuilder
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -108,9 +108,9 @@ public interface ListProductsRequestOrBuilder
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 4 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListPurchasableOffersRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListPurchasableOffersRequest.java
index 32ee12d9..ae5dd747 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListPurchasableOffersRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListPurchasableOffersRequest.java
@@ -920,7 +920,7 @@ public interface ChangeOfferPurchaseOrBuilder
      *
      *
      * 
-     * Optional. Resource name of the SKU that is being changed to. Should be provided if
+     * Optional. Resource name of the new target SKU. Provide this SKU when
      * upgrading or downgrading an entitlement. Format:
      * products/{product_id}/skus/{sku_id}
      * 

@@ -934,7 +934,7 @@ public interface ChangeOfferPurchaseOrBuilder
      *
      *
      * 
-     * Optional. Resource name of the SKU that is being changed to. Should be provided if
+     * Optional. Resource name of the new target SKU. Provide this SKU when
      * upgrading or downgrading an entitlement. Format:
      * products/{product_id}/skus/{sku_id}
      * 

@@ -1106,7 +1106,7 @@ public com.google.protobuf.ByteString getEntitlementBytes() {
      *
      *
      * 
-     * Optional. Resource name of the SKU that is being changed to. Should be provided if
+     * Optional. Resource name of the new target SKU. Provide this SKU when
      * upgrading or downgrading an entitlement. Format:
      * products/{product_id}/skus/{sku_id}
      * 

@@ -1131,7 +1131,7 @@ public java.lang.String getNewSku() {
      *
      *
      * 
-     * Optional. Resource name of the SKU that is being changed to. Should be provided if
+     * Optional. Resource name of the new target SKU. Provide this SKU when
      * upgrading or downgrading an entitlement. Format:
      * products/{product_id}/skus/{sku_id}
      * 

@@ -1635,7 +1635,7 @@ public Builder setEntitlementBytes(com.google.protobuf.ByteString value) {
        *
        *
        * 
-       * Optional. Resource name of the SKU that is being changed to. Should be provided if
+       * Optional. Resource name of the new target SKU. Provide this SKU when
        * upgrading or downgrading an entitlement. Format:
        * products/{product_id}/skus/{sku_id}
        * 

@@ -1659,7 +1659,7 @@ public java.lang.String getNewSku() {
        *
        *
        * 
-       * Optional. Resource name of the SKU that is being changed to. Should be provided if
+       * Optional. Resource name of the new target SKU. Provide this SKU when
        * upgrading or downgrading an entitlement. Format:
        * products/{product_id}/skus/{sku_id}
        * 

@@ -1683,7 +1683,7 @@ public com.google.protobuf.ByteString getNewSkuBytes() {
        *
        *
        * 
-       * Optional. Resource name of the SKU that is being changed to. Should be provided if
+       * Optional. Resource name of the new target SKU. Provide this SKU when
        * upgrading or downgrading an entitlement. Format:
        * products/{product_id}/skus/{sku_id}
        * 

@@ -1706,7 +1706,7 @@ public Builder setNewSku(java.lang.String value) {
        *
        *
        * 
-       * Optional. Resource name of the SKU that is being changed to. Should be provided if
+       * Optional. Resource name of the new target SKU. Provide this SKU when
        * upgrading or downgrading an entitlement. Format:
        * products/{product_id}/skus/{sku_id}
        * 

@@ -1725,7 +1725,7 @@ public Builder clearNewSku() {
        *
        *
        * 
-       * Optional. Resource name of the SKU that is being changed to. Should be provided if
+       * Optional. Resource name of the new target SKU. Provide this SKU when
        * upgrading or downgrading an entitlement. Format:
        * products/{product_id}/skus/{sku_id}
        * 

@@ -1982,7 +1982,7 @@ public boolean hasChangeOfferPurchase() {
    *
    *
    * 
-   * 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}.
    * 

    *
@@ -2008,7 +2008,7 @@ public java.lang.String getCustomer() {
    *
    *
    * 
-   * 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}.
    * 

    *
@@ -2038,8 +2038,8 @@ public com.google.protobuf.ByteString getCustomerBytes() {
    *
    * 
    * 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.
    * 

    *
    * int32 page_size = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -2057,7 +2057,7 @@ public int getPageSize() {
    *
    *
    * 
-   * 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.
    * 

    *
    * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -2080,7 +2080,7 @@ public java.lang.String getPageToken() {
    *
    *
    * 
-   * 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.
    * 

    *
    * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -2106,9 +2106,9 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -2131,9 +2131,9 @@ public java.lang.String getLanguageCode() {
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -3124,7 +3124,7 @@ public Builder clearChangeOfferPurchase() {
      *
      *
      * 
-     * 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}.
      * 

      *
@@ -3149,7 +3149,7 @@ public java.lang.String getCustomer() {
      *
      *
      * 
-     * 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}.
      * 

      *
@@ -3174,7 +3174,7 @@ public com.google.protobuf.ByteString getCustomerBytes() {
      *
      *
      * 
-     * 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}.
      * 

      *
@@ -3198,7 +3198,7 @@ public Builder setCustomer(java.lang.String value) {
      *
      *
      * 
-     * 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}.
      * 

      *
@@ -3218,7 +3218,7 @@ public Builder clearCustomer() {
      *
      *
      * 
-     * 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}.
      * 

      *
@@ -3246,8 +3246,8 @@ public Builder setCustomerBytes(com.google.protobuf.ByteString value) {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -3263,8 +3263,8 @@ public int getPageSize() {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -3283,8 +3283,8 @@ public Builder setPageSize(int value) {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -3303,7 +3303,7 @@ public Builder clearPageSize() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -3325,7 +3325,7 @@ public java.lang.String getPageToken() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -3347,7 +3347,7 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -3368,7 +3368,7 @@ public Builder setPageToken(java.lang.String value) {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -3385,7 +3385,7 @@ public Builder clearPageToken() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -3409,9 +3409,9 @@ public Builder setPageTokenBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -3433,9 +3433,9 @@ public java.lang.String getLanguageCode() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -3457,9 +3457,9 @@ public com.google.protobuf.ByteString getLanguageCodeBytes() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -3480,9 +3480,9 @@ public Builder setLanguageCode(java.lang.String value) {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -3499,9 +3499,9 @@ public Builder clearLanguageCode() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListPurchasableOffersRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListPurchasableOffersRequestOrBuilder.java
index 5e376603..850718c7 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListPurchasableOffersRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListPurchasableOffersRequestOrBuilder.java
@@ -113,7 +113,7 @@ public interface ListPurchasableOffersRequestOrBuilder
    *
    *
    * 
-   * 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}.
    * 

    *
@@ -128,7 +128,7 @@ public interface ListPurchasableOffersRequestOrBuilder
    *
    *
    * 
-   * 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}.
    * 

    *
@@ -145,8 +145,8 @@ public interface ListPurchasableOffersRequestOrBuilder
    *
    * 
    * 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.
    * 

    *
    * int32 page_size = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -159,7 +159,7 @@ public interface ListPurchasableOffersRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -171,7 +171,7 @@ public interface ListPurchasableOffersRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -184,9 +184,9 @@ public interface ListPurchasableOffersRequestOrBuilder
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -198,9 +198,9 @@ public interface ListPurchasableOffersRequestOrBuilder
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListPurchasableSkusRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListPurchasableSkusRequest.java
index 8e04f755..0cf26690 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListPurchasableSkusRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListPurchasableSkusRequest.java
@@ -2141,7 +2141,7 @@ public boolean hasChangeOfferPurchase() {
    *
    *
    * 
-   * 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}.
    * 

    *
@@ -2167,7 +2167,7 @@ public java.lang.String getCustomer() {
    *
    *
    * 
-   * 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}.
    * 

    *
@@ -2197,8 +2197,8 @@ public com.google.protobuf.ByteString getCustomerBytes() {
    *
    * 
    * 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.
    * 

    *
    * int32 page_size = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -2216,7 +2216,7 @@ public int getPageSize() {
    *
    *
    * 
-   * 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.
    * 

    *
    * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -2239,7 +2239,7 @@ public java.lang.String getPageToken() {
    *
    *
    * 
-   * 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.
    * 

    *
    * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -2265,9 +2265,9 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -2290,9 +2290,9 @@ public java.lang.String getLanguageCode() {
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -3277,7 +3277,7 @@ public Builder clearChangeOfferPurchase() {
      *
      *
      * 
-     * 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}.
      * 

      *
@@ -3302,7 +3302,7 @@ public java.lang.String getCustomer() {
      *
      *
      * 
-     * 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}.
      * 

      *
@@ -3327,7 +3327,7 @@ public com.google.protobuf.ByteString getCustomerBytes() {
      *
      *
      * 
-     * 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}.
      * 

      *
@@ -3351,7 +3351,7 @@ public Builder setCustomer(java.lang.String value) {
      *
      *
      * 
-     * 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}.
      * 

      *
@@ -3371,7 +3371,7 @@ public Builder clearCustomer() {
      *
      *
      * 
-     * 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}.
      * 

      *
@@ -3399,8 +3399,8 @@ public Builder setCustomerBytes(com.google.protobuf.ByteString value) {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -3416,8 +3416,8 @@ public int getPageSize() {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -3436,8 +3436,8 @@ public Builder setPageSize(int value) {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -3456,7 +3456,7 @@ public Builder clearPageSize() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -3478,7 +3478,7 @@ public java.lang.String getPageToken() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -3500,7 +3500,7 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -3521,7 +3521,7 @@ public Builder setPageToken(java.lang.String value) {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -3538,7 +3538,7 @@ public Builder clearPageToken() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -3562,9 +3562,9 @@ public Builder setPageTokenBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -3586,9 +3586,9 @@ public java.lang.String getLanguageCode() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -3610,9 +3610,9 @@ public com.google.protobuf.ByteString getLanguageCodeBytes() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -3633,9 +3633,9 @@ public Builder setLanguageCode(java.lang.String value) {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -3652,9 +3652,9 @@ public Builder clearLanguageCode() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListPurchasableSkusRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListPurchasableSkusRequestOrBuilder.java
index d6d96762..e43f580c 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListPurchasableSkusRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListPurchasableSkusRequestOrBuilder.java
@@ -113,7 +113,7 @@ public interface ListPurchasableSkusRequestOrBuilder
    *
    *
    * 
-   * 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}.
    * 

    *
@@ -128,7 +128,7 @@ public interface ListPurchasableSkusRequestOrBuilder
    *
    *
    * 
-   * 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}.
    * 

    *
@@ -145,8 +145,8 @@ public interface ListPurchasableSkusRequestOrBuilder
    *
    * 
    * 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.
    * 

    *
    * int32 page_size = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -159,7 +159,7 @@ public interface ListPurchasableSkusRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -171,7 +171,7 @@ public interface ListPurchasableSkusRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * string page_token = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -184,9 +184,9 @@ public interface ListPurchasableSkusRequestOrBuilder
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
@@ -198,9 +198,9 @@ public interface ListPurchasableSkusRequestOrBuilder
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 6 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListSkusRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListSkusRequest.java
index dace2af7..28409b5a 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListSkusRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListSkusRequest.java
@@ -146,8 +146,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * 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.
    * 

    *
@@ -173,8 +173,8 @@ public java.lang.String getParent() {
    *
    *
    * 
-   * 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.
    * 

    *
@@ -255,8 +255,8 @@ public com.google.protobuf.ByteString getAccountBytes() {
    *
    * 
    * 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.
    * 

    *
    * int32 page_size = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -274,7 +274,7 @@ public int getPageSize() {
    *
    *
    * 
-   * 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.
    * 

    *
@@ -298,7 +298,7 @@ public java.lang.String getPageToken() {
    *
    *
    * 
-   * 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.
    * 

    *
@@ -325,9 +325,9 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -350,9 +350,9 @@ public java.lang.String getLanguageCode() {
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -756,8 +756,8 @@ public Builder mergeFrom(
      *
      *
      * 
-     * 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.
      * 

      *
@@ -782,8 +782,8 @@ public java.lang.String getParent() {
      *
      *
      * 
-     * 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.
      * 

      *
@@ -808,8 +808,8 @@ public com.google.protobuf.ByteString getParentBytes() {
      *
      *
      * 
-     * 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.
      * 

      *
@@ -833,8 +833,8 @@ public Builder setParent(java.lang.String value) {
      *
      *
      * 
-     * 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.
      * 

      *
@@ -854,8 +854,8 @@ public Builder clearParent() {
      *
      *
      * 
-     * 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.
      * 

      *
@@ -994,8 +994,8 @@ public Builder setAccountBytes(com.google.protobuf.ByteString value) {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1011,8 +1011,8 @@ public int getPageSize() {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1031,8 +1031,8 @@ public Builder setPageSize(int value) {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1051,7 +1051,7 @@ public Builder clearPageSize() {
      *
      *
      * 
-     * 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.
      * 

      *
@@ -1074,7 +1074,7 @@ public java.lang.String getPageToken() {
      *
      *
      * 
-     * 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.
      * 

      *
@@ -1097,7 +1097,7 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
      *
      *
      * 
-     * 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.
      * 

      *
@@ -1119,7 +1119,7 @@ public Builder setPageToken(java.lang.String value) {
      *
      *
      * 
-     * 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.
      * 

      *
@@ -1137,7 +1137,7 @@ public Builder clearPageToken() {
      *
      *
      * 
-     * 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.
      * 

      *
@@ -1162,9 +1162,9 @@ public Builder setPageTokenBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -1186,9 +1186,9 @@ public java.lang.String getLanguageCode() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -1210,9 +1210,9 @@ public com.google.protobuf.ByteString getLanguageCodeBytes() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -1233,9 +1233,9 @@ public Builder setLanguageCode(java.lang.String value) {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -1252,9 +1252,9 @@ public Builder clearLanguageCode() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListSkusRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListSkusRequestOrBuilder.java
index eaaf6fd9..c315d541 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListSkusRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListSkusRequestOrBuilder.java
@@ -27,8 +27,8 @@ public interface ListSkusRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
@@ -43,8 +43,8 @@ public interface ListSkusRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
@@ -88,8 +88,8 @@ public interface ListSkusRequestOrBuilder
    *
    * 
    * 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.
    * 

    *
    * int32 page_size = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -102,7 +102,7 @@ public interface ListSkusRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
@@ -115,7 +115,7 @@ public interface ListSkusRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
@@ -129,9 +129,9 @@ public interface ListSkusRequestOrBuilder
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -143,9 +143,9 @@ public interface ListSkusRequestOrBuilder
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 5 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListSubscribersRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListSubscribersRequest.java
index 3b73c137..94de7469 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListSubscribersRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListSubscribersRequest.java
@@ -181,8 +181,8 @@ public com.google.protobuf.ByteString getAccountBytes() {
    * 
    * 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.
    * 

    *
    * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -203,7 +203,7 @@ public int getPageSize() {
    * 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.
    * 

    *
    * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -229,7 +229,7 @@ public java.lang.String getPageToken() {
    * 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.
    * 

    *
    * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -711,8 +711,8 @@ public Builder setAccountBytes(com.google.protobuf.ByteString value) {
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -729,8 +729,8 @@ public int getPageSize() {
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -750,8 +750,8 @@ public Builder setPageSize(int value) {
      * 
      * 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.
      * 

      *
      * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -773,7 +773,7 @@ public Builder clearPageSize() {
      * 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.
      * 

      *
      * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -798,7 +798,7 @@ public java.lang.String getPageToken() {
      * 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.
      * 

      *
      * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -823,7 +823,7 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
      * 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.
      * 

      *
      * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -847,7 +847,7 @@ public Builder setPageToken(java.lang.String value) {
      * 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.
      * 

      *
      * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -867,7 +867,7 @@ public Builder clearPageToken() {
      * 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.
      * 

      *
      * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListSubscribersRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListSubscribersRequestOrBuilder.java
index f5c78057..5426586d 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListSubscribersRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListSubscribersRequestOrBuilder.java
@@ -54,8 +54,8 @@ public interface ListSubscribersRequestOrBuilder
    * 
    * 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.
    * 

    *
    * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -71,7 +71,7 @@ public interface ListSubscribersRequestOrBuilder
    * 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.
    * 

    *
    * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -86,7 +86,7 @@ public interface ListSubscribersRequestOrBuilder
    * 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.
    * 

    *
    * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableOffersRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableOffersRequest.java
index 36b167b4..975478dc 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableOffersRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableOffersRequest.java
@@ -277,7 +277,7 @@ public com.google.protobuf.ByteString getCloudIdentityIdBytes() {
    *
    * 
    * A reseller should create a customer and use the resource name of
-   * the created customer here.
+   * that customer here.
    * 

    *
    * string customer_name = 5;
@@ -292,7 +292,7 @@ public boolean hasCustomerName() {
    *
    * 
    * A reseller should create a customer and use the resource name of
-   * the created customer here.
+   * that customer here.
    * 

    *
    * string customer_name = 5;
@@ -320,7 +320,7 @@ public java.lang.String getCustomerName() {
    *
    * 
    * A reseller should create a customer and use the resource name of
-   * the created customer here.
+   * that customer here.
    * 

    *
    * string customer_name = 5;
@@ -400,8 +400,8 @@ public com.google.protobuf.ByteString getParentBytes() {
    *
    * 
    * 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.
    * 

    *
    * int32 page_size = 2;
@@ -419,8 +419,8 @@ public int getPageSize() {
    *
    *
    * 
-   * 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
    * [ListTransferableOffersResponse.next_page_token][google.cloud.channel.v1.ListTransferableOffersResponse.next_page_token] of the previous
    * [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers] call.
    * 

@@ -445,8 +445,8 @@ public java.lang.String getPageToken() {
    *
    *
    * 
-   * 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
    * [ListTransferableOffersResponse.next_page_token][google.cloud.channel.v1.ListTransferableOffersResponse.next_page_token] of the previous
    * [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers] call.
    * 

@@ -474,7 +474,7 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
    *
    *
    * 
-   * Required. SKU for which the Offers are being looked up.
+   * Required. The SKU to look up Offers for.
    * 

    *
    * string sku = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -497,7 +497,7 @@ public java.lang.String getSku() {
    *
    *
    * 
-   * Required. SKU for which the Offers are being looked up.
+   * Required. The SKU to look up Offers for.
    * 

    *
    * string sku = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -523,9 +523,9 @@ public com.google.protobuf.ByteString getSkuBytes() {
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 7;
@@ -548,9 +548,9 @@ public java.lang.String getLanguageCode() {
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 7;
@@ -1172,7 +1172,7 @@ public Builder setCloudIdentityIdBytes(com.google.protobuf.ByteString value) {
      *
      * 
      * A reseller should create a customer and use the resource name of
-     * the created customer here.
+     * that customer here.
      * 

      *
      * string customer_name = 5;
@@ -1188,7 +1188,7 @@ public boolean hasCustomerName() {
      *
      * 
      * A reseller should create a customer and use the resource name of
-     * the created customer here.
+     * that customer here.
      * 

      *
      * string customer_name = 5;
@@ -1217,7 +1217,7 @@ public java.lang.String getCustomerName() {
      *
      * 
      * A reseller should create a customer and use the resource name of
-     * the created customer here.
+     * that customer here.
      * 

      *
      * string customer_name = 5;
@@ -1246,7 +1246,7 @@ public com.google.protobuf.ByteString getCustomerNameBytes() {
      *
      * 
      * A reseller should create a customer and use the resource name of
-     * the created customer here.
+     * that customer here.
      * 

      *
      * string customer_name = 5;
@@ -1268,7 +1268,7 @@ public Builder setCustomerName(java.lang.String value) {
      *
      * 
      * A reseller should create a customer and use the resource name of
-     * the created customer here.
+     * that customer here.
      * 

      *
      * string customer_name = 5;
@@ -1288,7 +1288,7 @@ public Builder clearCustomerName() {
      *
      * 
      * A reseller should create a customer and use the resource name of
-     * the created customer here.
+     * that customer here.
      * 

      *
      * string customer_name = 5;
@@ -1419,8 +1419,8 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 2;
@@ -1436,8 +1436,8 @@ public int getPageSize() {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 2;
@@ -1456,8 +1456,8 @@ public Builder setPageSize(int value) {
      *
      * 
      * 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.
      * 

      *
      * int32 page_size = 2;
@@ -1476,8 +1476,8 @@ public Builder clearPageSize() {
      *
      *
      * 
-     * 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
      * [ListTransferableOffersResponse.next_page_token][google.cloud.channel.v1.ListTransferableOffersResponse.next_page_token] of the previous
      * [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers] call.
      * 

@@ -1501,8 +1501,8 @@ public java.lang.String getPageToken() {
      *
      *
      * 
-     * 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
      * [ListTransferableOffersResponse.next_page_token][google.cloud.channel.v1.ListTransferableOffersResponse.next_page_token] of the previous
      * [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers] call.
      * 

@@ -1526,8 +1526,8 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
      *
      *
      * 
-     * 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
      * [ListTransferableOffersResponse.next_page_token][google.cloud.channel.v1.ListTransferableOffersResponse.next_page_token] of the previous
      * [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers] call.
      * 

@@ -1550,8 +1550,8 @@ public Builder setPageToken(java.lang.String value) {
      *
      *
      * 
-     * 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
      * [ListTransferableOffersResponse.next_page_token][google.cloud.channel.v1.ListTransferableOffersResponse.next_page_token] of the previous
      * [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers] call.
      * 

@@ -1570,8 +1570,8 @@ public Builder clearPageToken() {
      *
      *
      * 
-     * 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
      * [ListTransferableOffersResponse.next_page_token][google.cloud.channel.v1.ListTransferableOffersResponse.next_page_token] of the previous
      * [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers] call.
      * 

@@ -1597,7 +1597,7 @@ public Builder setPageTokenBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * Required. SKU for which the Offers are being looked up.
+     * Required. The SKU to look up Offers for.
      * 

      *
      * string sku = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -1619,7 +1619,7 @@ public java.lang.String getSku() {
      *
      *
      * 
-     * Required. SKU for which the Offers are being looked up.
+     * Required. The SKU to look up Offers for.
      * 

      *
      * string sku = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -1641,7 +1641,7 @@ public com.google.protobuf.ByteString getSkuBytes() {
      *
      *
      * 
-     * Required. SKU for which the Offers are being looked up.
+     * Required. The SKU to look up Offers for.
      * 

      *
      * string sku = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -1662,7 +1662,7 @@ public Builder setSku(java.lang.String value) {
      *
      *
      * 
-     * Required. SKU for which the Offers are being looked up.
+     * Required. The SKU to look up Offers for.
      * 

      *
      * string sku = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -1679,7 +1679,7 @@ public Builder clearSku() {
      *
      *
      * 
-     * Required. SKU for which the Offers are being looked up.
+     * Required. The SKU to look up Offers for.
      * 

      *
      * string sku = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -1703,9 +1703,9 @@ public Builder setSkuBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 7;
@@ -1727,9 +1727,9 @@ public java.lang.String getLanguageCode() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 7;
@@ -1751,9 +1751,9 @@ public com.google.protobuf.ByteString getLanguageCodeBytes() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 7;
@@ -1774,9 +1774,9 @@ public Builder setLanguageCode(java.lang.String value) {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 7;
@@ -1793,9 +1793,9 @@ public Builder clearLanguageCode() {
      *
      *
      * 
-     * 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".
      * 

      *
      * string language_code = 7;
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableOffersRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableOffersRequestOrBuilder.java
index 33f9096c..53b7240f 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableOffersRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableOffersRequestOrBuilder.java
@@ -65,7 +65,7 @@ public interface ListTransferableOffersRequestOrBuilder
    *
    * 
    * A reseller should create a customer and use the resource name of
-   * the created customer here.
+   * that customer here.
    * 

    *
    * string customer_name = 5;
@@ -78,7 +78,7 @@ public interface ListTransferableOffersRequestOrBuilder
    *
    * 
    * A reseller should create a customer and use the resource name of
-   * the created customer here.
+   * that customer here.
    * 

    *
    * string customer_name = 5;
@@ -91,7 +91,7 @@ public interface ListTransferableOffersRequestOrBuilder
    *
    * 
    * A reseller should create a customer and use the resource name of
-   * the created customer here.
+   * that customer here.
    * 

    *
    * string customer_name = 5;
@@ -130,8 +130,8 @@ public interface ListTransferableOffersRequestOrBuilder
    *
    * 
    * 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.
    * 

    *
    * int32 page_size = 2;
@@ -144,8 +144,8 @@ public interface ListTransferableOffersRequestOrBuilder
    *
    *
    * 
-   * 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
    * [ListTransferableOffersResponse.next_page_token][google.cloud.channel.v1.ListTransferableOffersResponse.next_page_token] of the previous
    * [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers] call.
    * 

@@ -159,8 +159,8 @@ public interface ListTransferableOffersRequestOrBuilder
    *
    *
    * 
-   * 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
    * [ListTransferableOffersResponse.next_page_token][google.cloud.channel.v1.ListTransferableOffersResponse.next_page_token] of the previous
    * [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers] call.
    * 

@@ -175,7 +175,7 @@ public interface ListTransferableOffersRequestOrBuilder
    *
    *
    * 
-   * Required. SKU for which the Offers are being looked up.
+   * Required. The SKU to look up Offers for.
    * 

    *
    * string sku = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -187,7 +187,7 @@ public interface ListTransferableOffersRequestOrBuilder
    *
    *
    * 
-   * Required. SKU for which the Offers are being looked up.
+   * Required. The SKU to look up Offers for.
    * 

    *
    * string sku = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -200,9 +200,9 @@ public interface ListTransferableOffersRequestOrBuilder
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 7;
@@ -214,9 +214,9 @@ public interface ListTransferableOffersRequestOrBuilder
    *
    *
    * 
-   * 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".
    * 

    *
    * string language_code = 7;
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableSkusRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableSkusRequest.java
index 517b8334..c344d003 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableSkusRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableSkusRequest.java
@@ -278,7 +278,7 @@ public com.google.protobuf.ByteString getCloudIdentityIdBytes() {
    * 
    * 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}
    * 

    *
@@ -295,7 +295,7 @@ public boolean hasCustomerName() {
    * 
    * 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}
    * 

    *
@@ -325,7 +325,7 @@ public java.lang.String getCustomerName() {
    * 
    * 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}
    * 

    *
@@ -356,8 +356,8 @@ public com.google.protobuf.ByteString getCustomerNameBytes() {
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -380,8 +380,8 @@ public java.lang.String getParent() {
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -407,9 +407,9 @@ public com.google.protobuf.ByteString getParentBytes() {
    *
    *
    * 
-   * 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.
    * 

    *
@@ -428,8 +428,8 @@ public int getPageSize() {
    *
    *
    * 
-   * 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
    * [ListTransferableSkusResponse.next_page_token][google.cloud.channel.v1.ListTransferableSkusResponse.next_page_token] of the previous
    * [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus] call.
    * Optional.
@@ -455,8 +455,8 @@ public java.lang.String getPageToken() {
    *
    *
    * 
-   * 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
    * [ListTransferableSkusResponse.next_page_token][google.cloud.channel.v1.ListTransferableSkusResponse.next_page_token] of the previous
    * [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus] call.
    * Optional.
@@ -485,11 +485,10 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
    *
    *
    * 
-   * 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.
    * 

    *
    * string auth_token = 5;
@@ -512,11 +511,10 @@ public java.lang.String getAuthToken() {
    *
    *
    * 
-   * 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.
    * 

    *
    * string auth_token = 5;
@@ -542,9 +540,9 @@ public com.google.protobuf.ByteString getAuthTokenBytes() {
    *
    *
    * 
-   * 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.
    * 

    *
@@ -568,9 +566,9 @@ public java.lang.String getLanguageCode() {
    *
    *
    * 
-   * 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.
    * 

    *
@@ -1194,7 +1192,7 @@ public Builder setCloudIdentityIdBytes(com.google.protobuf.ByteString value) {
      * 
      * 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}
      * 

      *
@@ -1212,7 +1210,7 @@ public boolean hasCustomerName() {
      * 
      * 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}
      * 

      *
@@ -1243,7 +1241,7 @@ public java.lang.String getCustomerName() {
      * 
      * 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}
      * 

      *
@@ -1274,7 +1272,7 @@ public com.google.protobuf.ByteString getCustomerNameBytes() {
      * 
      * 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}
      * 

      *
@@ -1298,7 +1296,7 @@ public Builder setCustomerName(java.lang.String value) {
      * 
      * 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}
      * 

      *
@@ -1320,7 +1318,7 @@ public Builder clearCustomerName() {
      * 
      * 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}
      * 

      *
@@ -1345,8 +1343,8 @@ public Builder setCustomerNameBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -1368,8 +1366,8 @@ public java.lang.String getParent() {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -1391,8 +1389,8 @@ public com.google.protobuf.ByteString getParentBytes() {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -1413,8 +1411,8 @@ public Builder setParent(java.lang.String value) {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -1431,8 +1429,8 @@ public Builder clearParent() {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -1456,9 +1454,9 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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.
      * 

      *
@@ -1474,9 +1472,9 @@ public int getPageSize() {
      *
      *
      * 
-     * 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.
      * 

      *
@@ -1495,9 +1493,9 @@ public Builder setPageSize(int value) {
      *
      *
      * 
-     * 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.
      * 

      *
@@ -1517,8 +1515,8 @@ public Builder clearPageSize() {
      *
      *
      * 
-     * 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
      * [ListTransferableSkusResponse.next_page_token][google.cloud.channel.v1.ListTransferableSkusResponse.next_page_token] of the previous
      * [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus] call.
      * Optional.
@@ -1543,8 +1541,8 @@ public java.lang.String getPageToken() {
      *
      *
      * 
-     * 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
      * [ListTransferableSkusResponse.next_page_token][google.cloud.channel.v1.ListTransferableSkusResponse.next_page_token] of the previous
      * [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus] call.
      * Optional.
@@ -1569,8 +1567,8 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
      *
      *
      * 
-     * 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
      * [ListTransferableSkusResponse.next_page_token][google.cloud.channel.v1.ListTransferableSkusResponse.next_page_token] of the previous
      * [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus] call.
      * Optional.
@@ -1594,8 +1592,8 @@ public Builder setPageToken(java.lang.String value) {
      *
      *
      * 
-     * 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
      * [ListTransferableSkusResponse.next_page_token][google.cloud.channel.v1.ListTransferableSkusResponse.next_page_token] of the previous
      * [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus] call.
      * Optional.
@@ -1615,8 +1613,8 @@ public Builder clearPageToken() {
      *
      *
      * 
-     * 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
      * [ListTransferableSkusResponse.next_page_token][google.cloud.channel.v1.ListTransferableSkusResponse.next_page_token] of the previous
      * [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus] call.
      * Optional.
@@ -1643,11 +1641,10 @@ public Builder setPageTokenBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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.
      * 

      *
      * string auth_token = 5;
@@ -1669,11 +1666,10 @@ public java.lang.String getAuthToken() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string auth_token = 5;
@@ -1695,11 +1691,10 @@ public com.google.protobuf.ByteString getAuthTokenBytes() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string auth_token = 5;
@@ -1720,11 +1715,10 @@ public Builder setAuthToken(java.lang.String value) {
      *
      *
      * 
-     * 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.
      * 

      *
      * string auth_token = 5;
@@ -1741,11 +1735,10 @@ public Builder clearAuthToken() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string auth_token = 5;
@@ -1769,9 +1762,9 @@ public Builder setAuthTokenBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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.
      * 

      *
@@ -1794,9 +1787,9 @@ public java.lang.String getLanguageCode() {
      *
      *
      * 
-     * 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.
      * 

      *
@@ -1819,9 +1812,9 @@ public com.google.protobuf.ByteString getLanguageCodeBytes() {
      *
      *
      * 
-     * 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.
      * 

      *
@@ -1843,9 +1836,9 @@ public Builder setLanguageCode(java.lang.String value) {
      *
      *
      * 
-     * 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.
      * 

      *
@@ -1863,9 +1856,9 @@ public Builder clearLanguageCode() {
      *
      *
      * 
-     * 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.
      * 

      *
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableSkusRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableSkusRequestOrBuilder.java
index b509f781..7acea2a3 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableSkusRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableSkusRequestOrBuilder.java
@@ -66,7 +66,7 @@ public interface ListTransferableSkusRequestOrBuilder
    * 
    * 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}
    * 

    *
@@ -81,7 +81,7 @@ public interface ListTransferableSkusRequestOrBuilder
    * 
    * 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}
    * 

    *
@@ -96,7 +96,7 @@ public interface ListTransferableSkusRequestOrBuilder
    * 
    * 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}
    * 

    *
@@ -110,8 +110,8 @@ public interface ListTransferableSkusRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -123,8 +123,8 @@ public interface ListTransferableSkusRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -137,9 +137,9 @@ public interface ListTransferableSkusRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
@@ -153,8 +153,8 @@ public interface ListTransferableSkusRequestOrBuilder
    *
    *
    * 
-   * 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
    * [ListTransferableSkusResponse.next_page_token][google.cloud.channel.v1.ListTransferableSkusResponse.next_page_token] of the previous
    * [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus] call.
    * Optional.
@@ -169,8 +169,8 @@ public interface ListTransferableSkusRequestOrBuilder
    *
    *
    * 
-   * 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
    * [ListTransferableSkusResponse.next_page_token][google.cloud.channel.v1.ListTransferableSkusResponse.next_page_token] of the previous
    * [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus] call.
    * Optional.
@@ -186,11 +186,10 @@ public interface ListTransferableSkusRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * string auth_token = 5;
@@ -202,11 +201,10 @@ public interface ListTransferableSkusRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * string auth_token = 5;
@@ -219,9 +217,9 @@ public interface ListTransferableSkusRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
@@ -234,9 +232,9 @@ public interface ListTransferableSkusRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableSkusResponse.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableSkusResponse.java
index e0f21e11..986a65a6 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableSkusResponse.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableSkusResponse.java
@@ -134,8 +134,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * Information about existing SKUs for a customer that would need to be
-   * transferred.
+   * Information about existing SKUs for a customer that needs a transfer.
    * 

    *
    * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -148,8 +147,7 @@ public java.util.List getTransferab
    *
    *
    * 
-   * Information about existing SKUs for a customer that would need to be
-   * transferred.
+   * Information about existing SKUs for a customer that needs a transfer.
    * 

    *
    * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -163,8 +161,7 @@ public java.util.List getTransferab
    *
    *
    * 
-   * Information about existing SKUs for a customer that would need to be
-   * transferred.
+   * Information about existing SKUs for a customer that needs a transfer.
    * 

    *
    * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -177,8 +174,7 @@ public int getTransferableSkusCount() {
    *
    *
    * 
-   * Information about existing SKUs for a customer that would need to be
-   * transferred.
+   * Information about existing SKUs for a customer that needs a transfer.
    * 

    *
    * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -191,8 +187,7 @@ public com.google.cloud.channel.v1.TransferableSku getTransferableSkus(int index
    *
    *
    * 
-   * Information about existing SKUs for a customer that would need to be
-   * transferred.
+   * Information about existing SKUs for a customer that needs a transfer.
    * 

    *
    * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -654,8 +649,7 @@ private void ensureTransferableSkusIsMutable() {
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -671,8 +665,7 @@ public java.util.List getTransferab
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -688,8 +681,7 @@ public int getTransferableSkusCount() {
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -705,8 +697,7 @@ public com.google.cloud.channel.v1.TransferableSku getTransferableSkus(int index
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -729,8 +720,7 @@ public Builder setTransferableSkus(
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -750,8 +740,7 @@ public Builder setTransferableSkus(
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -773,8 +762,7 @@ public Builder addTransferableSkus(com.google.cloud.channel.v1.TransferableSku v
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -797,8 +785,7 @@ public Builder addTransferableSkus(
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -818,8 +805,7 @@ public Builder addTransferableSkus(
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -839,8 +825,7 @@ public Builder addTransferableSkus(
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -860,8 +845,7 @@ public Builder addAllTransferableSkus(
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -880,8 +864,7 @@ public Builder clearTransferableSkus() {
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -900,8 +883,7 @@ public Builder removeTransferableSkus(int index) {
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -914,8 +896,7 @@ public com.google.cloud.channel.v1.TransferableSku.Builder getTransferableSkusBu
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -932,8 +913,7 @@ public com.google.cloud.channel.v1.TransferableSkuOrBuilder getTransferableSkusO
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -950,8 +930,7 @@ public com.google.cloud.channel.v1.TransferableSkuOrBuilder getTransferableSkusO
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -964,8 +943,7 @@ public com.google.cloud.channel.v1.TransferableSku.Builder addTransferableSkusBu
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -979,8 +957,7 @@ public com.google.cloud.channel.v1.TransferableSku.Builder addTransferableSkusBu
      *
      *
      * 
-     * Information about existing SKUs for a customer that would need to be
-     * transferred.
+     * Information about existing SKUs for a customer that needs a transfer.
      * 

      *
      * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableSkusResponseOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableSkusResponseOrBuilder.java
index 8da32efd..d959f016 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableSkusResponseOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ListTransferableSkusResponseOrBuilder.java
@@ -27,8 +27,7 @@ public interface ListTransferableSkusResponseOrBuilder
    *
    *
    * 
-   * Information about existing SKUs for a customer that would need to be
-   * transferred.
+   * Information about existing SKUs for a customer that needs a transfer.
    * 

    *
    * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -38,8 +37,7 @@ public interface ListTransferableSkusResponseOrBuilder
    *
    *
    * 
-   * Information about existing SKUs for a customer that would need to be
-   * transferred.
+   * Information about existing SKUs for a customer that needs a transfer.
    * 

    *
    * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -49,8 +47,7 @@ public interface ListTransferableSkusResponseOrBuilder
    *
    *
    * 
-   * Information about existing SKUs for a customer that would need to be
-   * transferred.
+   * Information about existing SKUs for a customer that needs a transfer.
    * 

    *
    * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -60,8 +57,7 @@ public interface ListTransferableSkusResponseOrBuilder
    *
    *
    * 
-   * Information about existing SKUs for a customer that would need to be
-   * transferred.
+   * Information about existing SKUs for a customer that needs a transfer.
    * 

    *
    * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
@@ -72,8 +68,7 @@ public interface ListTransferableSkusResponseOrBuilder
    *
    *
    * 
-   * Information about existing SKUs for a customer that would need to be
-   * transferred.
+   * Information about existing SKUs for a customer that needs a transfer.
    * 

    *
    * repeated .google.cloud.channel.v1.TransferableSku transferable_skus = 1;
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ProvisionCloudIdentityRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ProvisionCloudIdentityRequest.java
index 1026d6fa..1e902824 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ProvisionCloudIdentityRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ProvisionCloudIdentityRequest.java
@@ -303,8 +303,7 @@ public com.google.cloud.channel.v1.AdminUserOrBuilder getUserOrBuilder() {
    *
    *
    * 
-   * 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.
    * 

    *
    * bool validate_only = 4;
@@ -1199,8 +1198,7 @@ public com.google.cloud.channel.v1.AdminUserOrBuilder getUserOrBuilder() {
      *
      *
      * 
-     * 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.
      * 

      *
      * bool validate_only = 4;
@@ -1215,8 +1213,7 @@ public boolean getValidateOnly() {
      *
      *
      * 
-     * 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.
      * 

      *
      * bool validate_only = 4;
@@ -1234,8 +1231,7 @@ public Builder setValidateOnly(boolean value) {
      *
      *
      * 
-     * 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.
      * 

      *
      * bool validate_only = 4;
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ProvisionCloudIdentityRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ProvisionCloudIdentityRequestOrBuilder.java
index 6b53c16b..86b242bb 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ProvisionCloudIdentityRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ProvisionCloudIdentityRequestOrBuilder.java
@@ -128,8 +128,7 @@ public interface ProvisionCloudIdentityRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * bool validate_only = 4;
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/PurchasableOffer.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/PurchasableOffer.java
index 8c8cd15c..0e7ce4a0 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/PurchasableOffer.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/PurchasableOffer.java
@@ -22,7 +22,7 @@
  *
  *
  * 
- * Offer that can be puchased for a customer. This is used in
+ * Offer that you can purchase for a customer. This is used in the
  * ListPurchasableOffer API response.
  * 

  *
@@ -332,7 +332,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
-   * Offer that can be puchased for a customer. This is used in
+   * Offer that you can purchase for a customer. This is used in the
    * ListPurchasableOffer API response.
    * 

    *
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/PurchasableSku.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/PurchasableSku.java
index 04fc9bef..b3dde8c9 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/PurchasableSku.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/PurchasableSku.java
@@ -22,7 +22,7 @@
  *
  *
  * 
- * SKU that can be used for a puchase. This is used in ListPurchasableSku API
+ * SKU that you can purchase. This is used in ListPurchasableSku API
  * response.
  * 

  *
@@ -331,7 +331,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
-   * SKU that can be used for a puchase. This is used in ListPurchasableSku API
+   * SKU that you can purchase. This is used in ListPurchasableSku API
    * response.
    * 

    *
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/RegisterSubscriberRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/RegisterSubscriberRequest.java
index fc86c706..fdd07fc4 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/RegisterSubscriberRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/RegisterSubscriberRequest.java
@@ -174,8 +174,7 @@ public com.google.protobuf.ByteString getAccountBytes() {
    *
    *
    * 
-   * Required. Service account which will provide subscriber access to the
-   * registered topic.
+   * Required. Service account that provides subscriber access to the registered topic.
    * 

    *
    * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -198,8 +197,7 @@ public java.lang.String getServiceAccount() {
    *
    *
    * 
-   * Required. Service account which will provide subscriber access to the
-   * registered topic.
+   * Required. Service account that provides subscriber access to the registered topic.
    * 

    *
    * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -665,8 +663,7 @@ public Builder setAccountBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * Required. Service account which will provide subscriber access to the
-     * registered topic.
+     * Required. Service account that provides subscriber access to the registered topic.
      * 

      *
      * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -688,8 +685,7 @@ public java.lang.String getServiceAccount() {
      *
      *
      * 
-     * Required. Service account which will provide subscriber access to the
-     * registered topic.
+     * Required. Service account that provides subscriber access to the registered topic.
      * 

      *
      * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -711,8 +707,7 @@ public com.google.protobuf.ByteString getServiceAccountBytes() {
      *
      *
      * 
-     * Required. Service account which will provide subscriber access to the
-     * registered topic.
+     * Required. Service account that provides subscriber access to the registered topic.
      * 

      *
      * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -733,8 +728,7 @@ public Builder setServiceAccount(java.lang.String value) {
      *
      *
      * 
-     * Required. Service account which will provide subscriber access to the
-     * registered topic.
+     * Required. Service account that provides subscriber access to the registered topic.
      * 

      *
      * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -751,8 +745,7 @@ public Builder clearServiceAccount() {
      *
      *
      * 
-     * Required. Service account which will provide subscriber access to the
-     * registered topic.
+     * Required. Service account that provides subscriber access to the registered topic.
      * 

      *
      * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/RegisterSubscriberRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/RegisterSubscriberRequestOrBuilder.java
index 71cff57a..576543cb 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/RegisterSubscriberRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/RegisterSubscriberRequestOrBuilder.java
@@ -52,8 +52,7 @@ public interface RegisterSubscriberRequestOrBuilder
    *
    *
    * 
-   * Required. Service account which will provide subscriber access to the
-   * registered topic.
+   * Required. Service account that provides subscriber access to the registered topic.
    * 

    *
    * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -65,8 +64,7 @@ public interface RegisterSubscriberRequestOrBuilder
    *
    *
    * 
-   * Required. Service account which will provide subscriber access to the
-   * registered topic.
+   * Required. Service account that provides subscriber access to the registered topic.
    * 

    *
    * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/RegisterSubscriberResponse.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/RegisterSubscriberResponse.java
index b03f5cfe..03896944 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/RegisterSubscriberResponse.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/RegisterSubscriberResponse.java
@@ -117,7 +117,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * Name of the topic to which the subscriber will listen to.
+   * Name of the topic the subscriber will listen to.
    * 

    *
    * string topic = 1;
@@ -140,7 +140,7 @@ public java.lang.String getTopic() {
    *
    *
    * 
-   * Name of the topic to which the subscriber will listen to.
+   * Name of the topic the subscriber will listen to.
    * 

    *
    * string topic = 1;
@@ -484,7 +484,7 @@ public Builder mergeFrom(
      *
      *
      * 
-     * Name of the topic to which the subscriber will listen to.
+     * Name of the topic the subscriber will listen to.
      * 

      *
      * string topic = 1;
@@ -506,7 +506,7 @@ public java.lang.String getTopic() {
      *
      *
      * 
-     * Name of the topic to which the subscriber will listen to.
+     * Name of the topic the subscriber will listen to.
      * 

      *
      * string topic = 1;
@@ -528,7 +528,7 @@ public com.google.protobuf.ByteString getTopicBytes() {
      *
      *
      * 
-     * Name of the topic to which the subscriber will listen to.
+     * Name of the topic the subscriber will listen to.
      * 

      *
      * string topic = 1;
@@ -549,7 +549,7 @@ public Builder setTopic(java.lang.String value) {
      *
      *
      * 
-     * Name of the topic to which the subscriber will listen to.
+     * Name of the topic the subscriber will listen to.
      * 

      *
      * string topic = 1;
@@ -566,7 +566,7 @@ public Builder clearTopic() {
      *
      *
      * 
-     * Name of the topic to which the subscriber will listen to.
+     * Name of the topic the subscriber will listen to.
      * 

      *
      * string topic = 1;
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/RegisterSubscriberResponseOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/RegisterSubscriberResponseOrBuilder.java
index b18bbb1a..e5eb04a2 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/RegisterSubscriberResponseOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/RegisterSubscriberResponseOrBuilder.java
@@ -27,7 +27,7 @@ public interface RegisterSubscriberResponseOrBuilder
    *
    *
    * 
-   * Name of the topic to which the subscriber will listen to.
+   * Name of the topic the subscriber will listen to.
    * 

    *
    * string topic = 1;
@@ -39,7 +39,7 @@ public interface RegisterSubscriberResponseOrBuilder
    *
    *
    * 
-   * Name of the topic to which the subscriber will listen to.
+   * Name of the topic the subscriber will listen to.
    * 

    *
    * string topic = 1;
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/StartPaidServiceRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/StartPaidServiceRequest.java
index 6433bb49..23c2b71b 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/StartPaidServiceRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/StartPaidServiceRequest.java
@@ -125,8 +125,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * 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}
    * 

    *
@@ -150,8 +150,8 @@ public java.lang.String getName() {
    *
    *
    * 
-   * 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}
    * 

    *
@@ -178,13 +178,12 @@ public com.google.protobuf.ByteString getNameBytes() {
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -210,13 +209,12 @@ public java.lang.String getRequestId() {
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -578,8 +576,8 @@ public Builder mergeFrom(
      *
      *
      * 
-     * 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}
      * 

      *
@@ -602,8 +600,8 @@ public java.lang.String getName() {
      *
      *
      * 
-     * 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}
      * 

      *
@@ -626,8 +624,8 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      *
      * 
-     * 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}
      * 

      *
@@ -649,8 +647,8 @@ public Builder setName(java.lang.String value) {
      *
      *
      * 
-     * 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}
      * 

      *
@@ -668,8 +666,8 @@ public Builder clearName() {
      *
      *
      * 
-     * 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}
      * 

      *
@@ -694,13 +692,12 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -725,13 +722,12 @@ public java.lang.String getRequestId() {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -756,13 +752,12 @@ public com.google.protobuf.ByteString getRequestIdBytes() {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -786,13 +781,12 @@ public Builder setRequestId(java.lang.String value) {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -812,13 +806,12 @@ public Builder clearRequestId() {
      *
      *
      * 
-     * 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.
+     * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/StartPaidServiceRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/StartPaidServiceRequestOrBuilder.java
index 3c489410..59e7ecba 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/StartPaidServiceRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/StartPaidServiceRequestOrBuilder.java
@@ -27,8 +27,8 @@ public interface StartPaidServiceRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
@@ -41,8 +41,8 @@ public interface StartPaidServiceRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
@@ -56,13 +56,12 @@ public interface StartPaidServiceRequestOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -77,13 +76,12 @@ public interface StartPaidServiceRequestOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/SubscriberEventProto.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/SubscriberEventProto.java
index 08a8bed8..1136924a 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/SubscriberEventProto.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/SubscriberEventProto.java
@@ -51,29 +51,30 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
       "\n.google/cloud/channel/v1/subscriber_eve"
           + "nt.proto\022\027google.cloud.channel.v1\032\031googl"
           + "e/api/resource.proto\032\034google/api/annotat"
-          + "ions.proto\"\253\001\n\rCustomerEvent\022;\n\010customer"
+          + "ions.proto\"\344\001\n\rCustomerEvent\022;\n\010customer"
           + "\030\001 \001(\tB)\372A&\n$cloudchannel.googleapis.com"
           + "/Customer\022?\n\nevent_type\030\002 \001(\0162+.google.c"
-          + "loud.channel.v1.CustomerEvent.Type\"\034\n\004Ty"
-          + "pe\022\024\n\020TYPE_UNSPECIFIED\020\000\"\230\003\n\020Entitlement"
-          + "Event\022A\n\013entitlement\030\001 \001(\tB,\372A)\n\'cloudch"
-          + "annel.googleapis.com/Entitlement\022B\n\neven"
-          + "t_type\030\002 \001(\0162..google.cloud.channel.v1.E"
-          + "ntitlementEvent.Type\"\374\001\n\004Type\022\024\n\020TYPE_UN"
-          + "SPECIFIED\020\000\022\013\n\007CREATED\020\001\022\027\n\023PRICE_PLAN_S"
-          + "WITCHED\020\003\022\026\n\022COMMITMENT_CHANGED\020\004\022\013\n\007REN"
-          + "EWED\020\005\022\r\n\tSUSPENDED\020\006\022\r\n\tACTIVATED\020\007\022\r\n\t"
-          + "CANCELLED\020\010\022\017\n\013SKU_CHANGED\020\t\022\033\n\027RENEWAL_"
-          + "SETTING_CHANGED\020\n\022\030\n\024PAID_SERVICE_STARTE"
-          + "D\020\013\022\036\n\032LICENSE_ASSIGNMENT_CHANGED\020\014\"\244\001\n\017"
-          + "SubscriberEvent\022@\n\016customer_event\030\001 \001(\0132"
-          + "&.google.cloud.channel.v1.CustomerEventH"
-          + "\000\022F\n\021entitlement_event\030\002 \001(\0132).google.cl"
-          + "oud.channel.v1.EntitlementEventH\000B\007\n\005eve"
-          + "ntBu\n\033com.google.cloud.channel.v1B\024Subsc"
-          + "riberEventProtoP\001Z>google.golang.org/gen"
-          + "proto/googleapis/cloud/channel/v1;channe"
-          + "lb\006proto3"
+          + "loud.channel.v1.CustomerEvent.Type\"U\n\004Ty"
+          + "pe\022\024\n\020TYPE_UNSPECIFIED\020\000\022\032\n\026PRIMARY_DOMA"
+          + "IN_CHANGED\020\001\022\033\n\027PRIMARY_DOMAIN_VERIFIED\020"
+          + "\002\"\230\003\n\020EntitlementEvent\022A\n\013entitlement\030\001 "
+          + "\001(\tB,\372A)\n\'cloudchannel.googleapis.com/En"
+          + "titlement\022B\n\nevent_type\030\002 \001(\0162..google.c"
+          + "loud.channel.v1.EntitlementEvent.Type\"\374\001"
+          + "\n\004Type\022\024\n\020TYPE_UNSPECIFIED\020\000\022\013\n\007CREATED\020"
+          + "\001\022\027\n\023PRICE_PLAN_SWITCHED\020\003\022\026\n\022COMMITMENT"
+          + "_CHANGED\020\004\022\013\n\007RENEWED\020\005\022\r\n\tSUSPENDED\020\006\022\r"
+          + "\n\tACTIVATED\020\007\022\r\n\tCANCELLED\020\010\022\017\n\013SKU_CHAN"
+          + "GED\020\t\022\033\n\027RENEWAL_SETTING_CHANGED\020\n\022\030\n\024PA"
+          + "ID_SERVICE_STARTED\020\013\022\036\n\032LICENSE_ASSIGNME"
+          + "NT_CHANGED\020\014\"\244\001\n\017SubscriberEvent\022@\n\016cust"
+          + "omer_event\030\001 \001(\0132&.google.cloud.channel."
+          + "v1.CustomerEventH\000\022F\n\021entitlement_event\030"
+          + "\002 \001(\0132).google.cloud.channel.v1.Entitlem"
+          + "entEventH\000B\007\n\005eventBu\n\033com.google.cloud."
+          + "channel.v1B\024SubscriberEventProtoP\001Z>goog"
+          + "le.golang.org/genproto/googleapis/cloud/"
+          + "channel/v1;channelb\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/SuspendEntitlementRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/SuspendEntitlementRequest.java
index a62b3dd9..4a2f966e 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/SuspendEntitlementRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/SuspendEntitlementRequest.java
@@ -126,7 +126,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
    * 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}
    * 

    *
@@ -151,7 +151,7 @@ public java.lang.String getName() {
    *
    * 
    * 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}
    * 

    *
@@ -178,13 +178,12 @@ public com.google.protobuf.ByteString getNameBytes() {
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -210,13 +209,12 @@ public java.lang.String getRequestId() {
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -580,7 +578,7 @@ public Builder mergeFrom(
      *
      * 
      * 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}
      * 

      *
@@ -604,7 +602,7 @@ public java.lang.String getName() {
      *
      * 
      * 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}
      * 

      *
@@ -628,7 +626,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      * 
      * 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}
      * 

      *
@@ -651,7 +649,7 @@ public Builder setName(java.lang.String value) {
      *
      * 
      * 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}
      * 

      *
@@ -670,7 +668,7 @@ public Builder clearName() {
      *
      * 
      * 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}
      * 

      *
@@ -695,13 +693,12 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -726,13 +723,12 @@ public java.lang.String getRequestId() {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -757,13 +753,12 @@ public com.google.protobuf.ByteString getRequestIdBytes() {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -787,13 +782,12 @@ public Builder setRequestId(java.lang.String value) {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -813,13 +807,12 @@ public Builder clearRequestId() {
      *
      *
      * 
-     * 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.
+     * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/SuspendEntitlementRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/SuspendEntitlementRequestOrBuilder.java
index b82333f2..f8d00333 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/SuspendEntitlementRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/SuspendEntitlementRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface SuspendEntitlementRequestOrBuilder
    *
    * 
    * 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}
    * 

    *
@@ -42,7 +42,7 @@ public interface SuspendEntitlementRequestOrBuilder
    *
    * 
    * 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}
    * 

    *
@@ -56,13 +56,12 @@ public interface SuspendEntitlementRequestOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -77,13 +76,12 @@ public interface SuspendEntitlementRequestOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsRequest.java
index fdee6ac0..1ea868ec 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsRequest.java
@@ -149,9 +149,9 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -174,9 +174,9 @@ public java.lang.String getParent() {
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -202,7 +202,7 @@ public com.google.protobuf.ByteString getParentBytes() {
    *
    *
    * 
-   * Required. The new entitlements to be created or transferred.
+   * Required. The new entitlements to create or transfer.
    * 

    *
    * 
@@ -217,7 +217,7 @@ public java.util.List getEntitlementsLi
    *
    *
    * 
-   * Required. The new entitlements to be created or transferred.
+   * Required. The new entitlements to create or transfer.
    * 

    *
    * 
@@ -233,7 +233,7 @@ public java.util.List getEntitlementsLi
    *
    *
    * 
-   * Required. The new entitlements to be created or transferred.
+   * Required. The new entitlements to create or transfer.
    * 

    *
    * 
@@ -248,7 +248,7 @@ public int getEntitlementsCount() {
    *
    *
    * 
-   * Required. The new entitlements to be created or transferred.
+   * Required. The new entitlements to create or transfer.
    * 

    *
    * 
@@ -263,7 +263,7 @@ public com.google.cloud.channel.v1.Entitlement getEntitlements(int index) {
    *
    *
    * 
-   * Required. The new entitlements to be created or transferred.
+   * Required. The new entitlements to create or transfer.
    * 

    *
    * 
@@ -281,11 +281,10 @@ public com.google.cloud.channel.v1.EntitlementOrBuilder getEntitlementsOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * string auth_token = 4;
@@ -308,11 +307,10 @@ public java.lang.String getAuthToken() {
    *
    *
    * 
-   * 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.
    * 

    *
    * string auth_token = 4;
@@ -338,13 +336,12 @@ public com.google.protobuf.ByteString getAuthTokenBytes() {
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -370,13 +367,12 @@ public java.lang.String getRequestId() {
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -813,9 +809,9 @@ public Builder mergeFrom(
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -837,9 +833,9 @@ public java.lang.String getParent() {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -861,9 +857,9 @@ public com.google.protobuf.ByteString getParentBytes() {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -884,9 +880,9 @@ public Builder setParent(java.lang.String value) {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -903,9 +899,9 @@ public Builder clearParent() {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -945,7 +941,7 @@ private void ensureEntitlementsIsMutable() {
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -963,7 +959,7 @@ public java.util.List getEntitlementsLi
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -981,7 +977,7 @@ public int getEntitlementsCount() {
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -999,7 +995,7 @@ public com.google.cloud.channel.v1.Entitlement getEntitlements(int index) {
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -1023,7 +1019,7 @@ public Builder setEntitlements(int index, com.google.cloud.channel.v1.Entitlemen
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -1045,7 +1041,7 @@ public Builder setEntitlements(
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -1069,7 +1065,7 @@ public Builder addEntitlements(com.google.cloud.channel.v1.Entitlement value) {
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -1093,7 +1089,7 @@ public Builder addEntitlements(int index, com.google.cloud.channel.v1.Entitlemen
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -1115,7 +1111,7 @@ public Builder addEntitlements(
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -1137,7 +1133,7 @@ public Builder addEntitlements(
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -1159,7 +1155,7 @@ public Builder addAllEntitlements(
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -1180,7 +1176,7 @@ public Builder clearEntitlements() {
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -1201,7 +1197,7 @@ public Builder removeEntitlements(int index) {
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -1215,7 +1211,7 @@ public com.google.cloud.channel.v1.Entitlement.Builder getEntitlementsBuilder(in
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -1233,7 +1229,7 @@ public com.google.cloud.channel.v1.EntitlementOrBuilder getEntitlementsOrBuilder
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -1252,7 +1248,7 @@ public com.google.cloud.channel.v1.EntitlementOrBuilder getEntitlementsOrBuilder
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -1267,7 +1263,7 @@ public com.google.cloud.channel.v1.Entitlement.Builder addEntitlementsBuilder()
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -1282,7 +1278,7 @@ public com.google.cloud.channel.v1.Entitlement.Builder addEntitlementsBuilder(in
      *
      *
      * 
-     * Required. The new entitlements to be created or transferred.
+     * Required. The new entitlements to create or transfer.
      * 

      *
      * 
@@ -1316,11 +1312,10 @@ public com.google.cloud.channel.v1.Entitlement.Builder addEntitlementsBuilder(in
      *
      *
      * 
-     * 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.
      * 

      *
      * string auth_token = 4;
@@ -1342,11 +1337,10 @@ public java.lang.String getAuthToken() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string auth_token = 4;
@@ -1368,11 +1362,10 @@ public com.google.protobuf.ByteString getAuthTokenBytes() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string auth_token = 4;
@@ -1393,11 +1386,10 @@ public Builder setAuthToken(java.lang.String value) {
      *
      *
      * 
-     * 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.
      * 

      *
      * string auth_token = 4;
@@ -1414,11 +1406,10 @@ public Builder clearAuthToken() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string auth_token = 4;
@@ -1442,13 +1433,12 @@ public Builder setAuthTokenBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -1473,13 +1463,12 @@ public java.lang.String getRequestId() {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -1504,13 +1493,12 @@ public com.google.protobuf.ByteString getRequestIdBytes() {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -1534,13 +1522,12 @@ public Builder setRequestId(java.lang.String value) {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -1560,13 +1547,12 @@ public Builder clearRequestId() {
      *
      *
      * 
-     * 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.
+     * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsRequestOrBuilder.java
index 7ef9e6e0..0ff0ef1a 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsRequestOrBuilder.java
@@ -27,9 +27,9 @@ public interface TransferEntitlementsRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -41,9 +41,9 @@ public interface TransferEntitlementsRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -56,7 +56,7 @@ public interface TransferEntitlementsRequestOrBuilder
    *
    *
    * 
-   * Required. The new entitlements to be created or transferred.
+   * Required. The new entitlements to create or transfer.
    * 

    *
    * 
@@ -68,7 +68,7 @@ public interface TransferEntitlementsRequestOrBuilder
    *
    *
    * 
-   * Required. The new entitlements to be created or transferred.
+   * Required. The new entitlements to create or transfer.
    * 

    *
    * 
@@ -80,7 +80,7 @@ public interface TransferEntitlementsRequestOrBuilder
    *
    *
    * 
-   * Required. The new entitlements to be created or transferred.
+   * Required. The new entitlements to create or transfer.
    * 

    *
    * 
@@ -92,7 +92,7 @@ public interface TransferEntitlementsRequestOrBuilder
    *
    *
    * 
-   * Required. The new entitlements to be created or transferred.
+   * Required. The new entitlements to create or transfer.
    * 

    *
    * 
@@ -105,7 +105,7 @@ public interface TransferEntitlementsRequestOrBuilder
    *
    *
    * 
-   * Required. The new entitlements to be created or transferred.
+   * Required. The new entitlements to create or transfer.
    * 

    *
    * 
@@ -118,11 +118,10 @@ public interface TransferEntitlementsRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * string auth_token = 4;
@@ -134,11 +133,10 @@ public interface TransferEntitlementsRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * string auth_token = 4;
@@ -151,13 +149,12 @@ public interface TransferEntitlementsRequestOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -172,13 +169,12 @@ public interface TransferEntitlementsRequestOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsResponse.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsResponse.java
index de2975ea..d9449962 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsResponse.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsResponse.java
@@ -23,7 +23,7 @@
  *
  * 
  * Response message for [CloudChannelService.TransferEntitlements][google.cloud.channel.v1.CloudChannelService.TransferEntitlements].
- * This will be put into the response field of google.longrunning.Operation.
+ * This is put in the response field of google.longrunning.Operation.
  * 

  *
  * Protobuf type {@code google.cloud.channel.v1.TransferEntitlementsResponse}
@@ -126,7 +126,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * The entitlements that have been transferred.
+   * The transferred entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -139,7 +139,7 @@ public java.util.List getEntitlementsLi
    *
    *
    * 
-   * The entitlements that have been transferred.
+   * The transferred entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -153,7 +153,7 @@ public java.util.List getEntitlementsLi
    *
    *
    * 
-   * The entitlements that have been transferred.
+   * The transferred entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -166,7 +166,7 @@ public int getEntitlementsCount() {
    *
    *
    * 
-   * The entitlements that have been transferred.
+   * The transferred entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -179,7 +179,7 @@ public com.google.cloud.channel.v1.Entitlement getEntitlements(int index) {
    *
    *
    * 
-   * The entitlements that have been transferred.
+   * The transferred entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -356,7 +356,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    * 
    * Response message for [CloudChannelService.TransferEntitlements][google.cloud.channel.v1.CloudChannelService.TransferEntitlements].
-   * This will be put into the response field of google.longrunning.Operation.
+   * This is put in the response field of google.longrunning.Operation.
    * 

    *
    * Protobuf type {@code google.cloud.channel.v1.TransferEntitlementsResponse}
@@ -572,7 +572,7 @@ private void ensureEntitlementsIsMutable() {
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -588,7 +588,7 @@ public java.util.List getEntitlementsLi
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -604,7 +604,7 @@ public int getEntitlementsCount() {
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -620,7 +620,7 @@ public com.google.cloud.channel.v1.Entitlement getEntitlements(int index) {
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -642,7 +642,7 @@ public Builder setEntitlements(int index, com.google.cloud.channel.v1.Entitlemen
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -662,7 +662,7 @@ public Builder setEntitlements(
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -684,7 +684,7 @@ public Builder addEntitlements(com.google.cloud.channel.v1.Entitlement value) {
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -706,7 +706,7 @@ public Builder addEntitlements(int index, com.google.cloud.channel.v1.Entitlemen
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -726,7 +726,7 @@ public Builder addEntitlements(
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -746,7 +746,7 @@ public Builder addEntitlements(
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -766,7 +766,7 @@ public Builder addAllEntitlements(
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -785,7 +785,7 @@ public Builder clearEntitlements() {
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -804,7 +804,7 @@ public Builder removeEntitlements(int index) {
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -816,7 +816,7 @@ public com.google.cloud.channel.v1.Entitlement.Builder getEntitlementsBuilder(in
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -832,7 +832,7 @@ public com.google.cloud.channel.v1.EntitlementOrBuilder getEntitlementsOrBuilder
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -849,7 +849,7 @@ public com.google.cloud.channel.v1.EntitlementOrBuilder getEntitlementsOrBuilder
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -862,7 +862,7 @@ public com.google.cloud.channel.v1.Entitlement.Builder addEntitlementsBuilder()
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -875,7 +875,7 @@ public com.google.cloud.channel.v1.Entitlement.Builder addEntitlementsBuilder(in
      *
      *
      * 
-     * The entitlements that have been transferred.
+     * The transferred entitlements.
      * 

      *
      * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsResponseOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsResponseOrBuilder.java
index 70e92c9c..b7969265 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsResponseOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsResponseOrBuilder.java
@@ -27,7 +27,7 @@ public interface TransferEntitlementsResponseOrBuilder
    *
    *
    * 
-   * The entitlements that have been transferred.
+   * The transferred entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -37,7 +37,7 @@ public interface TransferEntitlementsResponseOrBuilder
    *
    *
    * 
-   * The entitlements that have been transferred.
+   * The transferred entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -47,7 +47,7 @@ public interface TransferEntitlementsResponseOrBuilder
    *
    *
    * 
-   * The entitlements that have been transferred.
+   * The transferred entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -57,7 +57,7 @@ public interface TransferEntitlementsResponseOrBuilder
    *
    *
    * 
-   * The entitlements that have been transferred.
+   * The transferred entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
@@ -68,7 +68,7 @@ public interface TransferEntitlementsResponseOrBuilder
    *
    *
    * 
-   * The entitlements that have been transferred.
+   * The transferred entitlements.
    * 

    *
    * repeated .google.cloud.channel.v1.Entitlement entitlements = 1;
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsToGoogleRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsToGoogleRequest.java
index f18a6b86..f1dde4ce 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsToGoogleRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsToGoogleRequest.java
@@ -143,9 +143,9 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -168,9 +168,9 @@ public java.lang.String getParent() {
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -196,7 +196,7 @@ public com.google.protobuf.ByteString getParentBytes() {
    *
    *
    * 
-   * Required. The entitlements to be transferred to Google.
+   * Required. The entitlements to transfer to Google.
    * 

    *
    * 
@@ -211,7 +211,7 @@ public java.util.List getEntitlementsLi
    *
    *
    * 
-   * Required. The entitlements to be transferred to Google.
+   * Required. The entitlements to transfer to Google.
    * 

    *
    * 
@@ -227,7 +227,7 @@ public java.util.List getEntitlementsLi
    *
    *
    * 
-   * Required. The entitlements to be transferred to Google.
+   * Required. The entitlements to transfer to Google.
    * 

    *
    * 
@@ -242,7 +242,7 @@ public int getEntitlementsCount() {
    *
    *
    * 
-   * Required. The entitlements to be transferred to Google.
+   * Required. The entitlements to transfer to Google.
    * 

    *
    * 
@@ -257,7 +257,7 @@ public com.google.cloud.channel.v1.Entitlement getEntitlements(int index) {
    *
    *
    * 
-   * Required. The entitlements to be transferred to Google.
+   * Required. The entitlements to transfer to Google.
    * 

    *
    * 
@@ -275,13 +275,12 @@ public com.google.cloud.channel.v1.EntitlementOrBuilder getEntitlementsOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -307,13 +306,12 @@ public java.lang.String getRequestId() {
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -738,9 +736,9 @@ public Builder mergeFrom(
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -762,9 +760,9 @@ public java.lang.String getParent() {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -786,9 +784,9 @@ public com.google.protobuf.ByteString getParentBytes() {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -809,9 +807,9 @@ public Builder setParent(java.lang.String value) {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -828,9 +826,9 @@ public Builder clearParent() {
      *
      *
      * 
-     * 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}
      * 

      *
      * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -870,7 +868,7 @@ private void ensureEntitlementsIsMutable() {
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -888,7 +886,7 @@ public java.util.List getEntitlementsLi
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -906,7 +904,7 @@ public int getEntitlementsCount() {
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -924,7 +922,7 @@ public com.google.cloud.channel.v1.Entitlement getEntitlements(int index) {
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -948,7 +946,7 @@ public Builder setEntitlements(int index, com.google.cloud.channel.v1.Entitlemen
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -970,7 +968,7 @@ public Builder setEntitlements(
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -994,7 +992,7 @@ public Builder addEntitlements(com.google.cloud.channel.v1.Entitlement value) {
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -1018,7 +1016,7 @@ public Builder addEntitlements(int index, com.google.cloud.channel.v1.Entitlemen
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -1040,7 +1038,7 @@ public Builder addEntitlements(
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -1062,7 +1060,7 @@ public Builder addEntitlements(
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -1084,7 +1082,7 @@ public Builder addAllEntitlements(
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -1105,7 +1103,7 @@ public Builder clearEntitlements() {
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -1126,7 +1124,7 @@ public Builder removeEntitlements(int index) {
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -1140,7 +1138,7 @@ public com.google.cloud.channel.v1.Entitlement.Builder getEntitlementsBuilder(in
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -1158,7 +1156,7 @@ public com.google.cloud.channel.v1.EntitlementOrBuilder getEntitlementsOrBuilder
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -1177,7 +1175,7 @@ public com.google.cloud.channel.v1.EntitlementOrBuilder getEntitlementsOrBuilder
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -1192,7 +1190,7 @@ public com.google.cloud.channel.v1.Entitlement.Builder addEntitlementsBuilder()
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -1207,7 +1205,7 @@ public com.google.cloud.channel.v1.Entitlement.Builder addEntitlementsBuilder(in
      *
      *
      * 
-     * Required. The entitlements to be transferred to Google.
+     * Required. The entitlements to transfer to Google.
      * 

      *
      * 
@@ -1241,13 +1239,12 @@ public com.google.cloud.channel.v1.Entitlement.Builder addEntitlementsBuilder(in
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -1272,13 +1269,12 @@ public java.lang.String getRequestId() {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -1303,13 +1299,12 @@ public com.google.protobuf.ByteString getRequestIdBytes() {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -1333,13 +1328,12 @@ public Builder setRequestId(java.lang.String value) {
      *
      *
      * 
-     * 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.
+     * 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`).
@@ -1359,13 +1353,12 @@ public Builder clearRequestId() {
      *
      *
      * 
-     * 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.
+     * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsToGoogleRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsToGoogleRequestOrBuilder.java
index 596e4098..0584297c 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsToGoogleRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferEntitlementsToGoogleRequestOrBuilder.java
@@ -27,9 +27,9 @@ public interface TransferEntitlementsToGoogleRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -41,9 +41,9 @@ public interface TransferEntitlementsToGoogleRequestOrBuilder
    *
    *
    * 
-   * 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}
    * 

    *
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -56,7 +56,7 @@ public interface TransferEntitlementsToGoogleRequestOrBuilder
    *
    *
    * 
-   * Required. The entitlements to be transferred to Google.
+   * Required. The entitlements to transfer to Google.
    * 

    *
    * 
@@ -68,7 +68,7 @@ public interface TransferEntitlementsToGoogleRequestOrBuilder
    *
    *
    * 
-   * Required. The entitlements to be transferred to Google.
+   * Required. The entitlements to transfer to Google.
    * 

    *
    * 
@@ -80,7 +80,7 @@ public interface TransferEntitlementsToGoogleRequestOrBuilder
    *
    *
    * 
-   * Required. The entitlements to be transferred to Google.
+   * Required. The entitlements to transfer to Google.
    * 

    *
    * 
@@ -92,7 +92,7 @@ public interface TransferEntitlementsToGoogleRequestOrBuilder
    *
    *
    * 
-   * Required. The entitlements to be transferred to Google.
+   * Required. The entitlements to transfer to Google.
    * 

    *
    * 
@@ -105,7 +105,7 @@ public interface TransferEntitlementsToGoogleRequestOrBuilder
    *
    *
    * 
-   * Required. The entitlements to be transferred to Google.
+   * Required. The entitlements to transfer to Google.
    * 

    *
    * 
@@ -118,13 +118,12 @@ public interface TransferEntitlementsToGoogleRequestOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
@@ -139,13 +138,12 @@ public interface TransferEntitlementsToGoogleRequestOrBuilder
    *
    *
    * 
-   * 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.
+   * 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`).
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferableSku.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferableSku.java
index 4c1c4157..af797d2b 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferableSku.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferableSku.java
@@ -98,6 +98,21 @@ private TransferableSku(
                 sku_ = subBuilder.buildPartial();
               }
 
+              break;
+            }
+          case 98:
+            {
+              com.google.cloud.channel.v1.Sku.Builder subBuilder = null;
+              if (legacySku_ != null) {
+                subBuilder = legacySku_.toBuilder();
+              }
+              legacySku_ =
+                  input.readMessage(com.google.cloud.channel.v1.Sku.parser(), extensionRegistry);
+              if (subBuilder != null) {
+                subBuilder.mergeFrom(legacySku_);
+                legacySku_ = subBuilder.buildPartial();
+              }
+
               break;
             }
           default:
@@ -229,6 +244,55 @@ public com.google.cloud.channel.v1.SkuOrBuilder getSkuOrBuilder() {
     return getSku();
   }
 
+  public static final int LEGACY_SKU_FIELD_NUMBER = 12;
+  private com.google.cloud.channel.v1.Sku legacySku_;
+  /**
+   *
+   *
+   * 
+   * Optional. The customer to transfer has an entitlement with the populated legacy SKU.
+   * 

+   *
+   * .google.cloud.channel.v1.Sku legacy_sku = 12 [(.google.api.field_behavior) = OPTIONAL];
+   * 
+   *
+   * @return Whether the legacySku field is set.
+   */
+  @java.lang.Override
+  public boolean hasLegacySku() {
+    return legacySku_ != null;
+  }
+  /**
+   *
+   *
+   * 
+   * Optional. The customer to transfer has an entitlement with the populated legacy SKU.
+   * 

+   *
+   * .google.cloud.channel.v1.Sku legacy_sku = 12 [(.google.api.field_behavior) = OPTIONAL];
+   * 
+   *
+   * @return The legacySku.
+   */
+  @java.lang.Override
+  public com.google.cloud.channel.v1.Sku getLegacySku() {
+    return legacySku_ == null ? com.google.cloud.channel.v1.Sku.getDefaultInstance() : legacySku_;
+  }
+  /**
+   *
+   *
+   * 
+   * Optional. The customer to transfer has an entitlement with the populated legacy SKU.
+   * 

+   *
+   * .google.cloud.channel.v1.Sku legacy_sku = 12 [(.google.api.field_behavior) = OPTIONAL];
+   * 
+   */
+  @java.lang.Override
+  public com.google.cloud.channel.v1.SkuOrBuilder getLegacySkuOrBuilder() {
+    return getLegacySku();
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -249,6 +313,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     if (sku_ != null) {
       output.writeMessage(11, getSku());
     }
+    if (legacySku_ != null) {
+      output.writeMessage(12, getLegacySku());
+    }
     unknownFields.writeTo(output);
   }
 
@@ -264,6 +331,9 @@ public int getSerializedSize() {
     if (sku_ != null) {
       size += com.google.protobuf.CodedOutputStream.computeMessageSize(11, getSku());
     }
+    if (legacySku_ != null) {
+      size += com.google.protobuf.CodedOutputStream.computeMessageSize(12, getLegacySku());
+    }
     size += unknownFields.getSerializedSize();
     memoizedSize = size;
     return size;
@@ -288,6 +358,10 @@ public boolean equals(final java.lang.Object obj) {
     if (hasSku()) {
       if (!getSku().equals(other.getSku())) return false;
     }
+    if (hasLegacySku() != other.hasLegacySku()) return false;
+    if (hasLegacySku()) {
+      if (!getLegacySku().equals(other.getLegacySku())) return false;
+    }
     if (!unknownFields.equals(other.unknownFields)) return false;
     return true;
   }
@@ -307,6 +381,10 @@ public int hashCode() {
       hash = (37 * hash) + SKU_FIELD_NUMBER;
       hash = (53 * hash) + getSku().hashCode();
     }
+    if (hasLegacySku()) {
+      hash = (37 * hash) + LEGACY_SKU_FIELD_NUMBER;
+      hash = (53 * hash) + getLegacySku().hashCode();
+    }
     hash = (29 * hash) + unknownFields.hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -466,6 +544,12 @@ public Builder clear() {
         sku_ = null;
         skuBuilder_ = null;
       }
+      if (legacySkuBuilder_ == null) {
+        legacySku_ = null;
+      } else {
+        legacySku_ = null;
+        legacySkuBuilder_ = null;
+      }
       return this;
     }
 
@@ -503,6 +587,11 @@ public com.google.cloud.channel.v1.TransferableSku buildPartial() {
       } else {
         result.sku_ = skuBuilder_.build();
       }
+      if (legacySkuBuilder_ == null) {
+        result.legacySku_ = legacySku_;
+      } else {
+        result.legacySku_ = legacySkuBuilder_.build();
+      }
       onBuilt();
       return result;
     }
@@ -558,6 +647,9 @@ public Builder mergeFrom(com.google.cloud.channel.v1.TransferableSku other) {
       if (other.hasSku()) {
         mergeSku(other.getSku());
       }
+      if (other.hasLegacySku()) {
+        mergeLegacySku(other.getLegacySku());
+      }
       this.mergeUnknownFields(other.unknownFields);
       onChanged();
       return this;
@@ -952,6 +1044,200 @@ public com.google.cloud.channel.v1.SkuOrBuilder getSkuOrBuilder() {
       return skuBuilder_;
     }
 
+    private com.google.cloud.channel.v1.Sku legacySku_;
+    private com.google.protobuf.SingleFieldBuilderV3<
+            com.google.cloud.channel.v1.Sku,
+            com.google.cloud.channel.v1.Sku.Builder,
+            com.google.cloud.channel.v1.SkuOrBuilder>
+        legacySkuBuilder_;
+    /**
+     *
+     *
+     * 
+     * Optional. The customer to transfer has an entitlement with the populated legacy SKU.
+     * 

+     *
+     * .google.cloud.channel.v1.Sku legacy_sku = 12 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     *
+     * @return Whether the legacySku field is set.
+     */
+    public boolean hasLegacySku() {
+      return legacySkuBuilder_ != null || legacySku_ != null;
+    }
+    /**
+     *
+     *
+     * 
+     * Optional. The customer to transfer has an entitlement with the populated legacy SKU.
+     * 

+     *
+     * .google.cloud.channel.v1.Sku legacy_sku = 12 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     *
+     * @return The legacySku.
+     */
+    public com.google.cloud.channel.v1.Sku getLegacySku() {
+      if (legacySkuBuilder_ == null) {
+        return legacySku_ == null
+            ? com.google.cloud.channel.v1.Sku.getDefaultInstance()
+            : legacySku_;
+      } else {
+        return legacySkuBuilder_.getMessage();
+      }
+    }
+    /**
+     *
+     *
+     * 
+     * Optional. The customer to transfer has an entitlement with the populated legacy SKU.
+     * 

+     *
+     * .google.cloud.channel.v1.Sku legacy_sku = 12 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     */
+    public Builder setLegacySku(com.google.cloud.channel.v1.Sku value) {
+      if (legacySkuBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        legacySku_ = value;
+        onChanged();
+      } else {
+        legacySkuBuilder_.setMessage(value);
+      }
+
+      return this;
+    }
+    /**
+     *
+     *
+     * 
+     * Optional. The customer to transfer has an entitlement with the populated legacy SKU.
+     * 

+     *
+     * .google.cloud.channel.v1.Sku legacy_sku = 12 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     */
+    public Builder setLegacySku(com.google.cloud.channel.v1.Sku.Builder builderForValue) {
+      if (legacySkuBuilder_ == null) {
+        legacySku_ = builderForValue.build();
+        onChanged();
+      } else {
+        legacySkuBuilder_.setMessage(builderForValue.build());
+      }
+
+      return this;
+    }
+    /**
+     *
+     *
+     * 
+     * Optional. The customer to transfer has an entitlement with the populated legacy SKU.
+     * 

+     *
+     * .google.cloud.channel.v1.Sku legacy_sku = 12 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     */
+    public Builder mergeLegacySku(com.google.cloud.channel.v1.Sku value) {
+      if (legacySkuBuilder_ == null) {
+        if (legacySku_ != null) {
+          legacySku_ =
+              com.google.cloud.channel.v1.Sku.newBuilder(legacySku_)
+                  .mergeFrom(value)
+                  .buildPartial();
+        } else {
+          legacySku_ = value;
+        }
+        onChanged();
+      } else {
+        legacySkuBuilder_.mergeFrom(value);
+      }
+
+      return this;
+    }
+    /**
+     *
+     *
+     * 
+     * Optional. The customer to transfer has an entitlement with the populated legacy SKU.
+     * 

+     *
+     * .google.cloud.channel.v1.Sku legacy_sku = 12 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     */
+    public Builder clearLegacySku() {
+      if (legacySkuBuilder_ == null) {
+        legacySku_ = null;
+        onChanged();
+      } else {
+        legacySku_ = null;
+        legacySkuBuilder_ = null;
+      }
+
+      return this;
+    }
+    /**
+     *
+     *
+     * 
+     * Optional. The customer to transfer has an entitlement with the populated legacy SKU.
+     * 

+     *
+     * .google.cloud.channel.v1.Sku legacy_sku = 12 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     */
+    public com.google.cloud.channel.v1.Sku.Builder getLegacySkuBuilder() {
+
+      onChanged();
+      return getLegacySkuFieldBuilder().getBuilder();
+    }
+    /**
+     *
+     *
+     * 
+     * Optional. The customer to transfer has an entitlement with the populated legacy SKU.
+     * 

+     *
+     * .google.cloud.channel.v1.Sku legacy_sku = 12 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     */
+    public com.google.cloud.channel.v1.SkuOrBuilder getLegacySkuOrBuilder() {
+      if (legacySkuBuilder_ != null) {
+        return legacySkuBuilder_.getMessageOrBuilder();
+      } else {
+        return legacySku_ == null
+            ? com.google.cloud.channel.v1.Sku.getDefaultInstance()
+            : legacySku_;
+      }
+    }
+    /**
+     *
+     *
+     * 
+     * Optional. The customer to transfer has an entitlement with the populated legacy SKU.
+     * 

+     *
+     * .google.cloud.channel.v1.Sku legacy_sku = 12 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     */
+    private com.google.protobuf.SingleFieldBuilderV3<
+            com.google.cloud.channel.v1.Sku,
+            com.google.cloud.channel.v1.Sku.Builder,
+            com.google.cloud.channel.v1.SkuOrBuilder>
+        getLegacySkuFieldBuilder() {
+      if (legacySkuBuilder_ == null) {
+        legacySkuBuilder_ =
+            new com.google.protobuf.SingleFieldBuilderV3<
+                com.google.cloud.channel.v1.Sku,
+                com.google.cloud.channel.v1.Sku.Builder,
+                com.google.cloud.channel.v1.SkuOrBuilder>(
+                getLegacySku(), getParentForChildren(), isClean());
+        legacySku_ = null;
+      }
+      return legacySkuBuilder_;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferableSkuOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferableSkuOrBuilder.java
index 5747cdac..0a409444 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferableSkuOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/TransferableSkuOrBuilder.java
@@ -92,4 +92,42 @@ public interface TransferableSkuOrBuilder
    * .google.cloud.channel.v1.Sku sku = 11;
    */
   com.google.cloud.channel.v1.SkuOrBuilder getSkuOrBuilder();
+
+  /**
+   *
+   *
+   * 
+   * Optional. The customer to transfer has an entitlement with the populated legacy SKU.
+   * 

+   *
+   * .google.cloud.channel.v1.Sku legacy_sku = 12 [(.google.api.field_behavior) = OPTIONAL];
+   * 
+   *
+   * @return Whether the legacySku field is set.
+   */
+  boolean hasLegacySku();
+  /**
+   *
+   *
+   * 
+   * Optional. The customer to transfer has an entitlement with the populated legacy SKU.
+   * 

+   *
+   * .google.cloud.channel.v1.Sku legacy_sku = 12 [(.google.api.field_behavior) = OPTIONAL];
+   * 
+   *
+   * @return The legacySku.
+   */
+  com.google.cloud.channel.v1.Sku getLegacySku();
+  /**
+   *
+   *
+   * 
+   * Optional. The customer to transfer has an entitlement with the populated legacy SKU.
+   * 

+   *
+   * .google.cloud.channel.v1.Sku legacy_sku = 12 [(.google.api.field_behavior) = OPTIONAL];
+   * 
+   */
+  com.google.cloud.channel.v1.SkuOrBuilder getLegacySkuOrBuilder();
 }
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UnregisterSubscriberRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UnregisterSubscriberRequest.java
index 3dbed065..73c7fd13 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UnregisterSubscriberRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UnregisterSubscriberRequest.java
@@ -174,8 +174,7 @@ public com.google.protobuf.ByteString getAccountBytes() {
    *
    *
    * 
-   * 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.
    * 

    *
    * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -198,8 +197,7 @@ public java.lang.String getServiceAccount() {
    *
    *
    * 
-   * 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.
    * 

    *
    * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -665,8 +663,7 @@ public Builder setAccountBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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.
      * 

      *
      * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -688,8 +685,7 @@ public java.lang.String getServiceAccount() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -711,8 +707,7 @@ public com.google.protobuf.ByteString getServiceAccountBytes() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -733,8 +728,7 @@ public Builder setServiceAccount(java.lang.String value) {
      *
      *
      * 
-     * 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.
      * 

      *
      * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -751,8 +745,7 @@ public Builder clearServiceAccount() {
      *
      *
      * 
-     * 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.
      * 

      *
      * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UnregisterSubscriberRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UnregisterSubscriberRequestOrBuilder.java
index 61a90ac9..f19241ef 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UnregisterSubscriberRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UnregisterSubscriberRequestOrBuilder.java
@@ -52,8 +52,7 @@ public interface UnregisterSubscriberRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -65,8 +64,7 @@ public interface UnregisterSubscriberRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * string service_account = 2 [(.google.api.field_behavior) = REQUIRED];
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UnregisterSubscriberResponse.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UnregisterSubscriberResponse.java
index a4534be4..27de88cd 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UnregisterSubscriberResponse.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UnregisterSubscriberResponse.java
@@ -117,8 +117,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * Name of the topic from which the service account subscriber access has been
-   * removed.
+   * Name of the topic the service account subscriber access was removed from.
    * 

    *
    * string topic = 1;
@@ -141,8 +140,7 @@ public java.lang.String getTopic() {
    *
    *
    * 
-   * Name of the topic from which the service account subscriber access has been
-   * removed.
+   * Name of the topic the service account subscriber access was removed from.
    * 

    *
    * string topic = 1;
@@ -486,8 +484,7 @@ public Builder mergeFrom(
      *
      *
      * 
-     * Name of the topic from which the service account subscriber access has been
-     * removed.
+     * Name of the topic the service account subscriber access was removed from.
      * 

      *
      * string topic = 1;
@@ -509,8 +506,7 @@ public java.lang.String getTopic() {
      *
      *
      * 
-     * Name of the topic from which the service account subscriber access has been
-     * removed.
+     * Name of the topic the service account subscriber access was removed from.
      * 

      *
      * string topic = 1;
@@ -532,8 +528,7 @@ public com.google.protobuf.ByteString getTopicBytes() {
      *
      *
      * 
-     * Name of the topic from which the service account subscriber access has been
-     * removed.
+     * Name of the topic the service account subscriber access was removed from.
      * 

      *
      * string topic = 1;
@@ -554,8 +549,7 @@ public Builder setTopic(java.lang.String value) {
      *
      *
      * 
-     * Name of the topic from which the service account subscriber access has been
-     * removed.
+     * Name of the topic the service account subscriber access was removed from.
      * 

      *
      * string topic = 1;
@@ -572,8 +566,7 @@ public Builder clearTopic() {
      *
      *
      * 
-     * Name of the topic from which the service account subscriber access has been
-     * removed.
+     * Name of the topic the service account subscriber access was removed from.
      * 

      *
      * string topic = 1;
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UnregisterSubscriberResponseOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UnregisterSubscriberResponseOrBuilder.java
index 68bb23a0..146aabd2 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UnregisterSubscriberResponseOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UnregisterSubscriberResponseOrBuilder.java
@@ -27,8 +27,7 @@ public interface UnregisterSubscriberResponseOrBuilder
    *
    *
    * 
-   * Name of the topic from which the service account subscriber access has been
-   * removed.
+   * Name of the topic the service account subscriber access was removed from.
    * 

    *
    * string topic = 1;
@@ -40,8 +39,7 @@ public interface UnregisterSubscriberResponseOrBuilder
    *
    *
    * 
-   * Name of the topic from which the service account subscriber access has been
-   * removed.
+   * Name of the topic the service account subscriber access was removed from.
    * 

    *
    * string topic = 1;
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UpdateChannelPartnerLinkRequest.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UpdateChannelPartnerLinkRequest.java
index 122d07f0..bf4f3e85 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UpdateChannelPartnerLinkRequest.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UpdateChannelPartnerLinkRequest.java
@@ -150,7 +150,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
    * 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.
    * 

    *
@@ -175,7 +175,7 @@ public java.lang.String getName() {
    *
    * 
    * 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.
    * 

    *
@@ -202,8 +202,8 @@ public com.google.protobuf.ByteString getNameBytes() {
    *
    *
    * 
-   * 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.
    * 

    *
    * 
@@ -220,8 +220,8 @@ public boolean hasChannelPartnerLink() {
    *
    *
    * 
-   * 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.
    * 

    *
    * 
@@ -240,8 +240,8 @@ public com.google.cloud.channel.v1.ChannelPartnerLink getChannelPartnerLink() {
    *
    *
    * 
-   * 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.
    * 

    *
    * 
@@ -260,7 +260,7 @@ public com.google.cloud.channel.v1.ChannelPartnerLinkOrBuilder getChannelPartner
    *
    * 
    * 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.
    * 

    *
@@ -278,7 +278,7 @@ public boolean hasUpdateMask() {
    *
    * 
    * 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.
    * 

    *
@@ -296,7 +296,7 @@ public com.google.protobuf.FieldMask getUpdateMask() {
    *
    * 
    * 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.
    * 

    *
@@ -689,7 +689,7 @@ public Builder mergeFrom(
      *
      * 
      * 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.
      * 

      *
@@ -713,7 +713,7 @@ public java.lang.String getName() {
      *
      * 
      * 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.
      * 

      *
@@ -737,7 +737,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      * 
      * 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.
      * 

      *
@@ -760,7 +760,7 @@ public Builder setName(java.lang.String value) {
      *
      * 
      * 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.
      * 

      *
@@ -779,7 +779,7 @@ public Builder clearName() {
      *
      * 
      * 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.
      * 

      *
@@ -809,8 +809,8 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * 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.
      * 

      *
      * 
@@ -826,8 +826,8 @@ public boolean hasChannelPartnerLink() {
      *
      *
      * 
-     * 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.
      * 

      *
      * 
@@ -849,8 +849,8 @@ public com.google.cloud.channel.v1.ChannelPartnerLink getChannelPartnerLink() {
      *
      *
      * 
-     * 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.
      * 

      *
      * 
@@ -874,8 +874,8 @@ public Builder setChannelPartnerLink(com.google.cloud.channel.v1.ChannelPartnerL
      *
      *
      * 
-     * 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.
      * 

      *
      * 
@@ -897,8 +897,8 @@ public Builder setChannelPartnerLink(
      *
      *
      * 
-     * 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.
      * 

      *
      * 
@@ -926,8 +926,8 @@ public Builder mergeChannelPartnerLink(com.google.cloud.channel.v1.ChannelPartne
      *
      *
      * 
-     * 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.
      * 

      *
      * 
@@ -949,8 +949,8 @@ public Builder clearChannelPartnerLink() {
      *
      *
      * 
-     * 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.
      * 

      *
      * 
@@ -966,8 +966,8 @@ public com.google.cloud.channel.v1.ChannelPartnerLink.Builder getChannelPartnerL
      *
      *
      * 
-     * 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.
      * 

      *
      * 
@@ -988,8 +988,8 @@ public com.google.cloud.channel.v1.ChannelPartnerLink.Builder getChannelPartnerL
      *
      *
      * 
-     * 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.
      * 

      *
      * 
@@ -1024,7 +1024,7 @@ public com.google.cloud.channel.v1.ChannelPartnerLink.Builder getChannelPartnerL
      *
      * 
      * 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.
      * 

      *
@@ -1041,7 +1041,7 @@ public boolean hasUpdateMask() {
      *
      * 
      * 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.
      * 

      *
@@ -1064,7 +1064,7 @@ public com.google.protobuf.FieldMask getUpdateMask() {
      *
      * 
      * 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.
      * 

      *
@@ -1089,7 +1089,7 @@ public Builder setUpdateMask(com.google.protobuf.FieldMask value) {
      *
      * 
      * 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.
      * 

      *
@@ -1111,7 +1111,7 @@ public Builder setUpdateMask(com.google.protobuf.FieldMask.Builder builderForVal
      *
      * 
      * 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.
      * 

      *
@@ -1138,7 +1138,7 @@ public Builder mergeUpdateMask(com.google.protobuf.FieldMask value) {
      *
      * 
      * 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.
      * 

      *
@@ -1161,7 +1161,7 @@ public Builder clearUpdateMask() {
      *
      * 
      * 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.
      * 

      *
@@ -1178,7 +1178,7 @@ public com.google.protobuf.FieldMask.Builder getUpdateMaskBuilder() {
      *
      * 
      * 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.
      * 

      *
@@ -1199,7 +1199,7 @@ public com.google.protobuf.FieldMaskOrBuilder getUpdateMaskOrBuilder() {
      *
      * 
      * 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.
      * 

      *
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UpdateChannelPartnerLinkRequestOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UpdateChannelPartnerLinkRequestOrBuilder.java
index 40ee3ac8..614f2f0f 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UpdateChannelPartnerLinkRequestOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/UpdateChannelPartnerLinkRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface UpdateChannelPartnerLinkRequestOrBuilder
    *
    * 
    * 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.
    * 

    *
@@ -42,7 +42,7 @@ public interface UpdateChannelPartnerLinkRequestOrBuilder
    *
    * 
    * 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.
    * 

    *
@@ -56,8 +56,8 @@ public interface UpdateChannelPartnerLinkRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * 
@@ -71,8 +71,8 @@ public interface UpdateChannelPartnerLinkRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * 
@@ -86,8 +86,8 @@ public interface UpdateChannelPartnerLinkRequestOrBuilder
    *
    *
    * 
-   * 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.
    * 

    *
    * 
@@ -101,7 +101,7 @@ public interface UpdateChannelPartnerLinkRequestOrBuilder
    *
    * 
    * 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.
    * 

    *
@@ -116,7 +116,7 @@ public interface UpdateChannelPartnerLinkRequestOrBuilder
    *
    * 
    * 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.
    * 

    *
@@ -131,7 +131,7 @@ public interface UpdateChannelPartnerLinkRequestOrBuilder
    *
    * 
    * 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.
    * 

    *
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/Value.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/Value.java
index c25587e2..b3674079 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/Value.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/Value.java
@@ -101,6 +101,12 @@ private Value(
               kindCase_ = 4;
               break;
             }
+          case 40:
+            {
+              kindCase_ = 5;
+              kind_ = input.readBool();
+              break;
+            }
           default:
             {
               if (!parseUnknownField(input, unknownFields, extensionRegistry, tag)) {
@@ -146,6 +152,7 @@ public enum KindCase
     STRING_VALUE(2),
     DOUBLE_VALUE(3),
     PROTO_VALUE(4),
+    BOOL_VALUE(5),
     KIND_NOT_SET(0);
     private final int value;
 
@@ -172,6 +179,8 @@ public static KindCase forNumber(int value) {
           return DOUBLE_VALUE;
         case 4:
           return PROTO_VALUE;
+        case 5:
+          return BOOL_VALUE;
         case 0:
           return KIND_NOT_SET;
         default:
@@ -379,6 +388,41 @@ public com.google.protobuf.AnyOrBuilder getProtoValueOrBuilder() {
     return com.google.protobuf.Any.getDefaultInstance();
   }
 
+  public static final int BOOL_VALUE_FIELD_NUMBER = 5;
+  /**
+   *
+   *
+   * 
+   * Represents a boolean value.
+   * 

+   *
+   * bool bool_value = 5;
+   *
+   * @return Whether the boolValue field is set.
+   */
+  @java.lang.Override
+  public boolean hasBoolValue() {
+    return kindCase_ == 5;
+  }
+  /**
+   *
+   *
+   * 
+   * Represents a boolean value.
+   * 

+   *
+   * bool bool_value = 5;
+   *
+   * @return The boolValue.
+   */
+  @java.lang.Override
+  public boolean getBoolValue() {
+    if (kindCase_ == 5) {
+      return (java.lang.Boolean) kind_;
+    }
+    return false;
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -405,6 +449,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     if (kindCase_ == 4) {
       output.writeMessage(4, (com.google.protobuf.Any) kind_);
     }
+    if (kindCase_ == 5) {
+      output.writeBool(5, (boolean) ((java.lang.Boolean) kind_));
+    }
     unknownFields.writeTo(output);
   }
 
@@ -432,6 +479,11 @@ public int getSerializedSize() {
           com.google.protobuf.CodedOutputStream.computeMessageSize(
               4, (com.google.protobuf.Any) kind_);
     }
+    if (kindCase_ == 5) {
+      size +=
+          com.google.protobuf.CodedOutputStream.computeBoolSize(
+              5, (boolean) ((java.lang.Boolean) kind_));
+    }
     size += unknownFields.getSerializedSize();
     memoizedSize = size;
     return size;
@@ -462,6 +514,9 @@ public boolean equals(final java.lang.Object obj) {
       case 4:
         if (!getProtoValue().equals(other.getProtoValue())) return false;
         break;
+      case 5:
+        if (getBoolValue() != other.getBoolValue()) return false;
+        break;
       case 0:
       default:
     }
@@ -496,6 +551,10 @@ public int hashCode() {
         hash = (37 * hash) + PROTO_VALUE_FIELD_NUMBER;
         hash = (53 * hash) + getProtoValue().hashCode();
         break;
+      case 5:
+        hash = (37 * hash) + BOOL_VALUE_FIELD_NUMBER;
+        hash = (53 * hash) + com.google.protobuf.Internal.hashBoolean(getBoolValue());
+        break;
       case 0:
       default:
     }
@@ -687,6 +746,9 @@ public com.google.cloud.channel.v1.Value buildPartial() {
           result.kind_ = protoValueBuilder_.build();
         }
       }
+      if (kindCase_ == 5) {
+        result.kind_ = kind_;
+      }
       result.kindCase_ = kindCase_;
       onBuilt();
       return result;
@@ -760,6 +822,11 @@ public Builder mergeFrom(com.google.cloud.channel.v1.Value other) {
             mergeProtoValue(other.getProtoValue());
             break;
           }
+        case BOOL_VALUE:
+          {
+            setBoolValue(other.getBoolValue());
+            break;
+          }
         case KIND_NOT_SET:
           {
             break;
@@ -1284,6 +1351,75 @@ public com.google.protobuf.AnyOrBuilder getProtoValueOrBuilder() {
       return protoValueBuilder_;
     }
 
+    /**
+     *
+     *
+     * 
+     * Represents a boolean value.
+     * 

+     *
+     * bool bool_value = 5;
+     *
+     * @return Whether the boolValue field is set.
+     */
+    public boolean hasBoolValue() {
+      return kindCase_ == 5;
+    }
+    /**
+     *
+     *
+     * 
+     * Represents a boolean value.
+     * 

+     *
+     * bool bool_value = 5;
+     *
+     * @return The boolValue.
+     */
+    public boolean getBoolValue() {
+      if (kindCase_ == 5) {
+        return (java.lang.Boolean) kind_;
+      }
+      return false;
+    }
+    /**
+     *
+     *
+     * 
+     * Represents a boolean value.
+     * 

+     *
+     * bool bool_value = 5;
+     *
+     * @param value The boolValue to set.
+     * @return This builder for chaining.
+     */
+    public Builder setBoolValue(boolean value) {
+      kindCase_ = 5;
+      kind_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
+     * Represents a boolean value.
+     * 

+     *
+     * bool bool_value = 5;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearBoolValue() {
+      if (kindCase_ == 5) {
+        kindCase_ = 0;
+        kind_ = null;
+        onChanged();
+      }
+      return this;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ValueOrBuilder.java b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ValueOrBuilder.java
index 95b7fe26..1bd8eff1 100644
--- a/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ValueOrBuilder.java
+++ b/proto-google-cloud-channel-v1/src/main/java/com/google/cloud/channel/v1/ValueOrBuilder.java
@@ -145,5 +145,30 @@ public interface ValueOrBuilder
    */
   com.google.protobuf.AnyOrBuilder getProtoValueOrBuilder();
 
+  /**
+   *
+   *
+   * 
+   * Represents a boolean value.
+   * 

+   *
+   * bool bool_value = 5;
+   *
+   * @return Whether the boolValue field is set.
+   */
+  boolean hasBoolValue();
+  /**
+   *
+   *
+   * 
+   * Represents a boolean value.
+   * 

+   *
+   * bool bool_value = 5;
+   *
+   * @return The boolValue.
+   */
+  boolean getBoolValue();
+
   public com.google.cloud.channel.v1.Value.KindCase getKindCase();
 }
diff --git a/proto-google-cloud-channel-v1/src/main/proto/google/cloud/channel/v1/common.proto b/proto-google-cloud-channel-v1/src/main/proto/google/cloud/channel/v1/common.proto
index 91a354ae..9f9e697a 100644
--- a/proto-google-cloud-channel-v1/src/main/proto/google/cloud/channel/v1/common.proto
+++ b/proto-google-cloud-channel-v1/src/main/proto/google/cloud/channel/v1/common.proto
@@ -96,8 +96,12 @@ message CloudIdentityInfo {
   // Output only. The primary domain name.
   string primary_domain = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Whether the domain is verified.
-  bool is_domain_verified = 4;
+  // Output only. Whether the domain is verified.
+  // This field is not returned for a Customer's cloud_identity_info resource.
+  // Partners can use the domains.get() method of the Workspace SDK's
+  // Directory API, or listen to the PRIMARY_DOMAIN_VERIFIED Pub/Sub event in
+  // to track domain verification of their resolve Workspace customers.
+  bool is_domain_verified = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // The alternate email.
   string alternate_email = 6;
@@ -130,6 +134,9 @@ message Value {
 
     // Represents an 'Any' proto value.
     google.protobuf.Any proto_value = 4;
+
+    // Represents a boolean value.
+    bool bool_value = 5;
   }
 }
 
diff --git a/proto-google-cloud-channel-v1/src/main/proto/google/cloud/channel/v1/entitlements.proto b/proto-google-cloud-channel-v1/src/main/proto/google/cloud/channel/v1/entitlements.proto
index 7d9ebeeb..d241722e 100644
--- a/proto-google-cloud-channel-v1/src/main/proto/google/cloud/channel/v1/entitlements.proto
+++ b/proto-google-cloud-channel-v1/src/main/proto/google/cloud/channel/v1/entitlements.proto
@@ -209,6 +209,9 @@ message TransferableSku {
 
   // The SKU pertaining to the provisioning resource as specified in the Offer.
   Sku sku = 11;
+
+  // Optional. The customer to transfer has an entitlement with the populated legacy SKU.
+  Sku legacy_sku = 12 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Specifies transfer eligibility of a SKU.
diff --git a/proto-google-cloud-channel-v1/src/main/proto/google/cloud/channel/v1/service.proto b/proto-google-cloud-channel-v1/src/main/proto/google/cloud/channel/v1/service.proto
index 46333f8b..d8954ee7 100644
--- a/proto-google-cloud-channel-v1/src/main/proto/google/cloud/channel/v1/service.proto
+++ b/proto-google-cloud-channel-v1/src/main/proto/google/cloud/channel/v1/service.proto
@@ -35,43 +35,39 @@ option java_multiple_files = true;
 option java_outer_classname = "ServiceProto";
 option java_package = "com.google.cloud.channel.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:
-// - [Customer][google.cloud.channel.v1.Customer]s: A Customer represents an entity managed by a reseller or
-// distributor. A customer typically represents an enterprise. In an n-tier
-// resale channel hierarchy, customers are generally represented as leaf nodes.
-// Customers primarily have an Entitlement sub-resource discussed below.
+// CloudChannelService exposes the following resources:
+// - [Customer][google.cloud.channel.v1.Customer]s: An entity—usually an enterprise—managed by a reseller or
+// distributor.
 //
-// - [Entitlement][google.cloud.channel.v1.Entitlement]s: An Entitlement represents an entity which provides a
-// customer means to start using a service. Entitlements are created or updated
-// as a result of a successful fulfillment.
+// - [Entitlement][google.cloud.channel.v1.Entitlement]s: An entity that provides a customer with the means to use
+// a service. Entitlements are created or updated as a result of a successful
+// fulfillment.
 //
-// - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: A ChannelPartnerLink is an entity that identifies
-// links between distributors and their indirect resellers in a channel.
+// - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: An entity that identifies links between
+// distributors and their indirect resellers in a channel.
 service CloudChannelService {
   option (google.api.default_host) = "cloudchannel.googleapis.com";
   option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/apps.order";
 
-  // List downstream [Customer][google.cloud.channel.v1.Customer]s.
+  // List [Customer][google.cloud.channel.v1.Customer]s.
   //
-  // Possible Error Codes:
+  // Possible error codes:
   //
-  // * PERMISSION_DENIED: If the reseller account making the request and the
-  // reseller account being queried for are different.
-  // * INVALID_ARGUMENT: Missing or invalid required parameters in the
-  // request.
+  // * PERMISSION_DENIED: The reseller account making the request is different
+  // from the reseller account in the API request.
+  // * INVALID_ARGUMENT: Required request parameters are missing or invalid.
   //
-  // Return Value:
-  // List of [Customer][google.cloud.channel.v1.Customer]s pertaining to the reseller or empty list if
-  // there are none.
+  // Return value:
+  // List of [Customer][google.cloud.channel.v1.Customer]s, or an empty list if there are no customers.
   rpc ListCustomers(ListCustomersRequest) returns (ListCustomersResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=accounts/*}/customers"
@@ -80,17 +76,16 @@ service CloudChannelService {
 
   // Returns a requested [Customer][google.cloud.channel.v1.Customer] resource.
   //
-  // Possible Error Codes:
+  // Possible error codes:
   //
-  // * PERMISSION_DENIED: If the reseller account making the request and the
-  // reseller account being queried for are different.
-  // * INVALID_ARGUMENT: Missing or invalid required parameters in the
-  // request.
-  // * NOT_FOUND: If the customer resource doesn't exist. Usually
-  // the result of an invalid name parameter.
+  // * PERMISSION_DENIED: The reseller account making the request is different
+  // from the reseller account in the API request.
+  // * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+  // * NOT_FOUND: The customer resource doesn't exist. Usually the result of an
+  // invalid name parameter.
   //
-  // Return Value:
-  // [Customer][google.cloud.channel.v1.Customer] resource if found, error otherwise.
+  // Return value:
+  // The [Customer][google.cloud.channel.v1.Customer] resource.
   rpc GetCustomer(GetCustomerRequest) returns (Customer) {
     option (google.api.http) = {
       get: "/v1/{name=accounts/*/customers/*}"
@@ -98,22 +93,21 @@ service CloudChannelService {
     option (google.api.method_signature) = "name";
   }
 
-  // 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 [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources for the domain.
-  // List may be empty.
+  // Return value:
+  // A list of [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources for the domain (may be
+  // empty)
   //
-  // Note: in the v1alpha1 version of the API, a NOT_FOUND error is returned if
+  // Note: in the v1alpha1 version of the API, a NOT_FOUND error returns if
   // no [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources match the domain.
   rpc CheckCloudIdentityAccountsExist(CheckCloudIdentityAccountsExistRequest) returns (CheckCloudIdentityAccountsExistResponse) {
     option (google.api.http) = {
@@ -125,18 +119,16 @@ service CloudChannelService {
   // Creates a new [Customer][google.cloud.channel.v1.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 [Customer][google.cloud.channel.v1.Customer] resource, otherwise
-  // returns an error.
+  // Return value:
+  // The newly created [Customer][google.cloud.channel.v1.Customer] resource.
   rpc CreateCustomer(CreateCustomerRequest) returns (Customer) {
     option (google.api.http) = {
       post: "/v1/{parent=accounts/*}/customers"
@@ -144,21 +136,18 @@ service CloudChannelService {
     };
   }
 
-  // Updates an existing [Customer][google.cloud.channel.v1.Customer] resource belonging to the reseller or
+  // Updates an existing [Customer][google.cloud.channel.v1.Customer] resource for the reseller or
   // distributor.
   //
-  // Possible Error Codes:
+  // Possible error codes:
   //
-  // * PERMISSION_DENIED: If the reseller account making the request and the
-  // reseller account being queried for are different.
-  // * INVALID_ARGUMENT: Missing or invalid required parameters in the
-  // request.
-  // * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name
-  // specified in the request.
+  // * PERMISSION_DENIED: The reseller account making the request is different
+  // from the reseller account in the API request.
+  // * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+  // * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name in the request.
   //
-  // Return Value:
-  // If successful, the updated [Customer][google.cloud.channel.v1.Customer] resource, otherwise returns
-  // an error.
+  // Return value:
+  // The updated [Customer][google.cloud.channel.v1.Customer] resource.
   rpc UpdateCustomer(UpdateCustomerRequest) returns (Customer) {
     option (google.api.http) = {
       patch: "/v1/{customer.name=accounts/*/customers/*}"
@@ -168,15 +157,13 @@ service CloudChannelService {
 
   // Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently and irreversibly.
   //
-  // Possible Error Codes:
+  // Possible error codes:
   //
-  // * PERMISSION_DENIED: If the account making the request does not own
+  // * PERMISSION_DENIED: The account making the request does not own
   // this customer.
-  // * INVALID_ARGUMENT: Missing or invalid required parameters in the
-  // request.
-  // * FAILED_PRECONDITION: If the customer has existing entitlements.
-  // * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name
-  // specified in the request.
+  // * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+  // * FAILED_PRECONDITION: The customer has existing entitlements.
+  // * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name in the request.
   rpc DeleteCustomer(DeleteCustomerRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1/{name=accounts/*/customers/*}"
@@ -185,25 +172,25 @@ service CloudChannelService {
   }
 
   // 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 [OperationMetadata][google.cloud.channel.v1.OperationMetadata].
   rpc ProvisionCloudIdentity(ProvisionCloudIdentityRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -216,40 +203,39 @@ service CloudChannelService {
     };
   }
 
-  // List [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer.
+  // Lists [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer.
   //
-  // Possible Error Codes:
+  // Possible error codes:
   //
-  // * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-  // * INVALID_ARGUMENT: Missing or invalid required parameters in the request.
+  // * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+  // * INVALID_ARGUMENT: Required request parameters are missing or invalid.
   //
-  // Return Value:
-  // List of [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to the customer, or empty list if
-  // there are none.
+  // Return value:
+  // A list of the customer's [Entitlement][google.cloud.channel.v1.Entitlement]s.
   rpc ListEntitlements(ListEntitlementsRequest) returns (ListEntitlementsResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=accounts/*/customers/*}/entitlements"
     };
   }
 
-  // List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on Cloud Identity ID or
+  // List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on the Cloud Identity ID or
   // Customer Name in the request.
   //
-  // This method is used when a reseller lists the entitlements
-  // information of a customer that is not owned. The reseller should provide
-  // the customer's Cloud Identity ID or Customer Name.
+  // 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 [TransferableSku][google.cloud.channel.v1.TransferableSku] for the given customer.
+  // Return value:
+  // A list of the customer's [TransferableSku][google.cloud.channel.v1.TransferableSku].
   rpc ListTransferableSkus(ListTransferableSkusRequest) returns (ListTransferableSkusResponse) {
     option (google.api.http) = {
       post: "/v1/{parent=accounts/*}:listTransferableSkus"
@@ -260,21 +246,20 @@ service CloudChannelService {
   // List [TransferableOffer][google.cloud.channel.v1.TransferableOffer]s of a customer based on Cloud Identity ID or
   // Customer Name in the request.
   //
-  // This method is used when a reseller gets the entitlement
-  // information of a customer that is not owned. The reseller should provide
-  // the customer's Cloud Identity ID or Customer Name.
+  // Use this method when a reseller gets the entitlement information of an
+  // unowned customer. The reseller should provide the customer's
+  // Cloud Identity ID or Customer Name.
   //
-  // Possible Error Codes:
+  // Possible error codes:
   //
-  // * PERMISSION_DENIED: 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 [TransferableOffer][google.cloud.channel.v1.TransferableOffer] for the given customer and SKU.
   rpc ListTransferableOffers(ListTransferableOffersRequest) returns (ListTransferableOffersResponse) {
     option (google.api.http) = {
@@ -285,16 +270,14 @@ service CloudChannelService {
 
   // Returns a requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
   //
-  // Possible Error Codes:
+  // Possible error codes:
   //
-  // * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-  // * INVALID_ARGUMENT: Missing or invalid required parameters in the
-  // request.
-  // * NOT_FOUND: If the entitlement is not found for the customer.
+  // * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+  // * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+  // * NOT_FOUND: The customer entitlement was not found.
   //
-  // Return Value:
-  // If found, the requested [Entitlement][google.cloud.channel.v1.Entitlement] resource, otherwise returns
-  // an error.
+  // Return value:
+  // The requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
   rpc GetEntitlement(GetEntitlementRequest) returns (Entitlement) {
     option (google.api.http) = {
       get: "/v1/{name=accounts/*/customers/*/entitlements/*}"
@@ -303,39 +286,36 @@ service CloudChannelService {
 
   // 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
@@ -351,26 +331,25 @@ service CloudChannelService {
     };
   }
 
-  // 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
@@ -388,24 +367,23 @@ service CloudChannelService {
 
   // 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
@@ -423,22 +401,21 @@ service CloudChannelService {
 
   // 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
@@ -457,24 +434,23 @@ service CloudChannelService {
   // 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
@@ -491,22 +467,22 @@ service CloudChannelService {
   }
 
   // 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
@@ -523,27 +499,26 @@ service CloudChannelService {
   }
 
   // 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
@@ -560,32 +535,29 @@ service CloudChannelService {
     };
   }
 
-  // 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
@@ -603,31 +575,29 @@ service CloudChannelService {
 
   // 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
@@ -643,32 +613,30 @@ service CloudChannelService {
     };
   }
 
-  // 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
@@ -686,18 +654,16 @@ service CloudChannelService {
   }
 
   // List [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s belonging to a distributor.
-  // To call this method, you must be a distributor.
+  // You must be a distributor to call this method.
   //
-  // Possible Error Codes:
+  // Possible error codes:
   //
-  // * PERMISSION_DENIED: If the reseller account making the request and the
-  // reseller account being queried for are different.
-  // * INVALID_ARGUMENT: Missing or invalid required parameters in the
-  // request.
+  // * PERMISSION_DENIED: The reseller account making the request is different
+  // from the reseller account in the API request.
+  // * INVALID_ARGUMENT: Required request parameters are missing or invalid.
   //
-  // Return Value:
-  // If successful, returns the list of [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources
-  // for the distributor account, otherwise returns an error.
+  // Return value:
+  // The list of the distributor account's [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources.
   rpc ListChannelPartnerLinks(ListChannelPartnerLinksRequest) returns (ListChannelPartnerLinksResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=accounts/*}/channelPartnerLinks"
@@ -705,49 +671,46 @@ service CloudChannelService {
   }
 
   // Returns a requested [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
-  // To call this method, you must be a distributor.
+  // You must be a distributor to call this method.
   //
-  // Possible Error Codes:
+  // Possible error codes:
   //
-  // * PERMISSION_DENIED: If the reseller account making the request and the
-  // reseller account being queried for are different.
-  // * INVALID_ARGUMENT: Missing or invalid required parameters in the
-  // request.
-  // * NOT_FOUND: ChannelPartnerLink resource not found. Results
-  // due invalid channel partner link name.
+  // * PERMISSION_DENIED: The reseller account making the request is different
+  // from the reseller account in the API request.
+  // * INVALID_ARGUMENT: Required request parameters are missing or invalid.
+  // * NOT_FOUND: ChannelPartnerLink resource not found because of an
+  // invalid channel partner link name.
   //
-  // Return Value:
-  // [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if found, otherwise returns an error.
+  // Return value:
+  // The [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
   rpc GetChannelPartnerLink(GetChannelPartnerLinkRequest) returns (ChannelPartnerLink) {
     option (google.api.http) = {
       get: "/v1/{name=accounts/*/channelPartnerLinks/*}"
     };
   }
 
-  // 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 [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if successful,
-  // otherwise error is returned.
+  // Return value:
+  // The new [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
   rpc CreateChannelPartnerLink(CreateChannelPartnerLinkRequest) returns (ChannelPartnerLink) {
     option (google.api.http) = {
       post: "/v1/{parent=accounts/*}/channelPartnerLinks"
@@ -755,28 +718,27 @@ service CloudChannelService {
     };
   }
 
-  // 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.
+  // 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:
+  // 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
+  // * 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 [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource, otherwise
-  // returns an error.
+  // Return value:
+  // The updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
   rpc UpdateChannelPartnerLink(UpdateChannelPartnerLinkRequest) returns (ChannelPartnerLink) {
     option (google.api.http) = {
       patch: "/v1/{name=accounts/*/channelPartnerLinks/*}"
@@ -786,10 +748,9 @@ service CloudChannelService {
 
   // Lists the Products the reseller is authorized to sell.
   //
-  // Possible Error Codes:
+  // Possible error codes:
   //
-  // * INVALID_ARGUMENT: Missing or invalid required parameters in the
-  // request.
+  // * INVALID_ARGUMENT: Required request parameters are missing or invalid.
   rpc ListProducts(ListProductsRequest) returns (ListProductsResponse) {
     option (google.api.http) = {
       get: "/v1/products"
@@ -798,10 +759,9 @@ service CloudChannelService {
 
   // Lists the SKUs for a product the reseller is authorized to sell.
   //
-  // Possible Error Codes:
+  // Possible error codes:
   //
-  // * INVALID_ARGUMENT: Missing or invalid required parameters in the
-  // request.
+  // * INVALID_ARGUMENT: Required request parameters are missing or invalid.
   rpc ListSkus(ListSkusRequest) returns (ListSkusResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=products/*}/skus"
@@ -810,42 +770,39 @@ service CloudChannelService {
 
   // Lists the Offers the reseller can sell.
   //
-  // Possible Error Codes:
+  // Possible error codes:
   //
-  // * INVALID_ARGUMENT: Missing or invalid required parameters in the
-  // request.
+  // * INVALID_ARGUMENT: Required request parameters are missing or invalid.
   rpc ListOffers(ListOffersRequest) returns (ListOffersResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=accounts/*}/offers"
     };
   }
 
-  // Lists the Purchasable SKUs for following cases:
+  // Lists the following:
   //
-  // * SKUs that can be newly purchased for a customer
-  // * SKUs that can be upgraded/downgraded to, for an entitlement.
+  // * SKUs that you can purchase for a customer
+  // * SKUs that you can upgrade or downgrade for an entitlement.
   //
-  // Possible Error Codes:
+  // Possible error codes:
   //
-  // * PERMISSION_DENIED: If the customer doesn't belong to the reseller
-  // * INVALID_ARGUMENT: Missing or invalid required parameters in the
-  // request.
+  // * PERMISSION_DENIED: The customer doesn't belong to the reseller.
+  // * INVALID_ARGUMENT: Required request parameters are missing or invalid.
   rpc ListPurchasableSkus(ListPurchasableSkusRequest) returns (ListPurchasableSkusResponse) {
     option (google.api.http) = {
       get: "/v1/{customer=accounts/*/customers/*}:listPurchasableSkus"
     };
   }
 
-  // Lists the Purchasable Offers for the following cases:
+  // Lists the following:
   //
-  // * Offers that can be newly purchased for a customer
-  // * Offers that can be changed to, for an entitlement.
+  // * Offers that you can purchase for a customer.
+  // * Offers that you can change for an entitlement.
   //
-  // Possible Error Codes:
+  // Possible error codes:
   //
-  // * PERMISSION_DENIED: If the customer doesn't belong to the reseller
-  // * INVALID_ARGUMENT: Missing or invalid required parameters in the
-  // request.
+  // * PERMISSION_DENIED: The customer doesn't belong to the reseller
+  // * INVALID_ARGUMENT: Required request parameters are missing or invalid.
   rpc ListPurchasableOffers(ListPurchasableOffersRequest) returns (ListPurchasableOffersResponse) {
     option (google.api.http) = {
       get: "/v1/{customer=accounts/*/customers/*}:listPurchasableOffers"
@@ -853,24 +810,22 @@ service CloudChannelService {
   }
 
   // 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 [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent]
+  // topic for this Channel Services account. After you create a
+  // subscriber, you get the events through [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent]
   //
-  // Possible Error Codes:
+  // 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.
   rpc RegisterSubscriber(RegisterSubscriberRequest) returns (RegisterSubscriberResponse) {
     option (google.api.http) = {
       post: "/v1/{account=accounts/*}:register"
@@ -880,26 +835,25 @@ service CloudChannelService {
 
   // 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.
-  //
-  // 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.
+  // backend. Contact Cloud Channel support.
+  // * UNKNOWN: Any non-user error related to a technical issue in the backend.
+  // Contact Cloud Channel support.
+  //
+  // Return value:
+  // The topic name that unregistered the service email address.
+  // Returns a success response if the service email address wasn't registered
+  // with the topic.
   rpc UnregisterSubscriber(UnregisterSubscriberRequest) returns (UnregisterSubscriberResponse) {
     option (google.api.http) = {
       post: "/v1/{account=accounts/*}:unregister"
@@ -910,22 +864,20 @@ service CloudChannelService {
   // 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.
   rpc ListSubscribers(ListSubscribersRequest) returns (ListSubscribersResponse) {
     option (google.api.http) = {
       get: "/v1/{account=accounts/*}:listSubscribers"
@@ -935,32 +887,31 @@ service CloudChannelService {
 
 // Request message for [CloudChannelService.CheckCloudIdentityAccountsExist][google.cloud.channel.v1.CloudChannelService.CheckCloudIdentityAccountsExist].
 message CheckCloudIdentityAccountsExistRequest {
-  // 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}
   string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. Domain for which the Cloud Identity account customer is fetched.
+  // Required. Domain to fetch for Cloud Identity account customer.
   string domain = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
-// Entity representing a Cloud Identity account which may or may not be
+// Entity representing a Cloud Identity account that may be
 // associated with a Channel Services API partner.
 message CloudIdentityCustomerAccount {
-  // True if a Cloud Identity account exists for a specific domain.
+  // Returns true if a Cloud Identity account exists for a specific domain.
   bool existing = 1;
 
-  // True if the Cloud Identity account is associated with a customer
-  // belonging to the Channel Services partner making the API call.
+  // Returns true if the Cloud Identity account is associated with a customer
+  // of the Channel Services partner.
   bool owned = 2;
 
-  // Name of the customer that owns the Cloud Identity account. This field is
-  // populated ONLY if owned = true.
-  // The customer_name takes the format:
+  // If owned = true, the name of the customer that owns the Cloud Identity
+  // account.
+  // Customer_name uses the format:
   // accounts/{account_id}/customers/{customer_id}
   string customer_name = 3;
 
-  // Cloud Identity ID of the customer. This field is populated ONLY if
-  // existing = true.
+  // If existing = true, the Cloud Identity ID of the customer.
   string customer_cloud_identity_id = 4;
 }
 
@@ -973,17 +924,17 @@ message CheckCloudIdentityAccountsExistResponse {
 
 // Request message for [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers]
 message ListCustomersRequest {
-  // 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}.
   string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
   // 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.
   int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // 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
   // [ListCustomersResponse.next_page_token][google.cloud.channel.v1.ListCustomersResponse.next_page_token] of the previous
   // [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers] call.
   string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
@@ -991,7 +942,7 @@ message ListCustomersRequest {
 
 // Response message for [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers].
 message ListCustomersResponse {
-  // The customers belonging to the reseller or distributor.
+  // The customers belonging to a reseller or distributor.
   repeated Customer customers = 1;
 
   // A token to retrieve the next page of results.
@@ -1002,7 +953,7 @@ message ListCustomersResponse {
 // Request message for [CloudChannelService.GetCustomer][google.cloud.channel.v1.CloudChannelService.GetCustomer].
 message GetCustomerRequest {
   // 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}
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -1014,7 +965,7 @@ message GetCustomerRequest {
 // Request message for [CloudChannelService.CreateCustomer][google.cloud.channel.v1.CloudChannelService.CreateCustomer]
 message CreateCustomerRequest {
   // 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}
   string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The customer to create.
@@ -1059,16 +1010,15 @@ message ProvisionCloudIdentityRequest {
   // Admin user information.
   AdminUser user = 3;
 
-  // 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.
   bool validate_only = 4;
 }
 
 // Request message for [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements]
 message ListEntitlementsRequest {
-  // 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}
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -1077,12 +1027,12 @@ message ListEntitlementsRequest {
   ];
 
   // 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.
   int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // 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
   // [ListEntitlementsResponse.next_page_token][google.cloud.channel.v1.ListEntitlementsResponse.next_page_token] of the previous
   // [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements] call.
   string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
@@ -1090,10 +1040,10 @@ message ListEntitlementsRequest {
 
 // Response message for [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements].
 message ListEntitlementsResponse {
-  // The entitlements belonging to the reseller's customer.
+  // The reseller customer's entitlements.
   repeated Entitlement entitlements = 1;
 
-  // A token to List next page of results.
+  // A token to list the next page of results.
   // Pass to [ListEntitlementsRequest.page_token][google.cloud.channel.v1.ListEntitlementsRequest.page_token] to obtain that page.
   string next_page_token = 2;
 }
@@ -1101,7 +1051,7 @@ message ListEntitlementsResponse {
 // Request message for [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus]
 message ListTransferableSkusRequest {
   // Specifies the identity of transferred customer.
-  // Either a cloud_identity_id of the customer OR the customer name is
+  // Either a cloud_identity_id of the customer or the customer name is
   // required to look up transferable SKUs.
   oneof transferred_customer_identity {
     // Customer's Cloud Identity ID
@@ -1109,46 +1059,44 @@ message ListTransferableSkusRequest {
 
     // 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}
     string customer_name = 7;
   }
 
-  // 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}
   string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // 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.
   int32 page_size = 2;
 
-  // 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
   // [ListTransferableSkusResponse.next_page_token][google.cloud.channel.v1.ListTransferableSkusResponse.next_page_token] of the previous
   // [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus] call.
   // Optional.
   string page_token = 3;
 
-  // 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.
   string auth_token = 5;
 
-  // 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.
   string language_code = 6;
 }
 
 // Response message for [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus].
 message ListTransferableSkusResponse {
-  // Information about existing SKUs for a customer that would need to be
-  // transferred.
+  // Information about existing SKUs for a customer that needs a transfer.
   repeated TransferableSku transferable_skus = 1;
 
   // A token to retrieve the next page of results.
@@ -1160,14 +1108,14 @@ message ListTransferableSkusResponse {
 // Request message for [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers]
 message ListTransferableOffersRequest {
   // Specifies the identity of transferred customer.
-  // Either a cloud_identity_id of the customer OR the customer name is
+  // Either a cloud_identity_id of the customer or the customer name is
   // required to look up transferrable Offers.
   oneof transferred_customer_identity {
     // Customer's Cloud Identity ID
     string cloud_identity_id = 4;
 
     // A reseller should create a customer and use the resource name of
-    // the created customer here.
+    // that customer here.
     string customer_name = 5;
   }
 
@@ -1175,22 +1123,22 @@ message ListTransferableOffersRequest {
   string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
   // 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.
   int32 page_size = 2;
 
-  // 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
   // [ListTransferableOffersResponse.next_page_token][google.cloud.channel.v1.ListTransferableOffersResponse.next_page_token] of the previous
   // [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers] call.
   string page_token = 3;
 
-  // Required. SKU for which the Offers are being looked up.
+  // Required. The SKU to look up Offers for.
   string sku = 6 [(google.api.field_behavior) = REQUIRED];
 
-  // 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".
   string language_code = 7;
 }
 
@@ -1216,8 +1164,8 @@ message TransferableOffer {
 // Request message for [CloudChannelService.GetEntitlement][google.cloud.channel.v1.CloudChannelService.GetEntitlement].
 message GetEntitlementRequest {
   // 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}
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -1230,16 +1178,16 @@ message GetEntitlementRequest {
 message ListChannelPartnerLinksRequest {
   // 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}
   string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
   // 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.
   int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // 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
   // [ListChannelPartnerLinksResponse.next_page_token][google.cloud.channel.v1.ListChannelPartnerLinksResponse.next_page_token] of the previous
   // [CloudChannelService.ListChannelPartnerLinks][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerLinks] call.
   string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
@@ -1261,7 +1209,7 @@ message ListChannelPartnerLinksResponse {
 // Request message for [CloudChannelService.GetChannelPartnerLink][google.cloud.channel.v1.CloudChannelService.GetChannelPartnerLink].
 message GetChannelPartnerLinkRequest {
   // 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.
   string name = 1 [(google.api.field_behavior) = REQUIRED];
 
@@ -1271,9 +1219,9 @@ message GetChannelPartnerLinkRequest {
 
 // Request message for [CloudChannelService.CreateChannelPartnerLink][google.cloud.channel.v1.CloudChannelService.CreateChannelPartnerLink]
 message CreateChannelPartnerLinkRequest {
-  // 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}
   string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The channel partner link to create.
@@ -1285,25 +1233,25 @@ message CreateChannelPartnerLinkRequest {
 // Request message for [CloudChannelService.UpdateChannelPartnerLink][google.cloud.channel.v1.CloudChannelService.UpdateChannelPartnerLink]
 message UpdateChannelPartnerLinkRequest {
   // 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.
   string name = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // 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.
   ChannelPartnerLink channel_partner_link = 2 [(google.api.field_behavior) = REQUIRED];
 
   // 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.
   google.protobuf.FieldMask update_mask = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for [CloudChannelService.CreateEntitlement][google.cloud.channel.v1.CloudChannelService.CreateEntitlement]
 message CreateEntitlementRequest {
-  // 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}
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -1314,14 +1262,13 @@ message CreateEntitlementRequest {
   // Required. The entitlement to create.
   Entitlement entitlement = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // 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
@@ -1331,29 +1278,27 @@ message CreateEntitlementRequest {
 
 // Request message for [CloudChannelService.TransferEntitlements][google.cloud.channel.v1.CloudChannelService.TransferEntitlements].
 message TransferEntitlementsRequest {
-  // 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}
   string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. The new entitlements to be created or transferred.
+  // Required. The new entitlements to create or transfer.
   repeated Entitlement entitlements = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // 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.
   string auth_token = 4;
 
-  // 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
@@ -1362,30 +1307,29 @@ message TransferEntitlementsRequest {
 }
 
 // Response message for [CloudChannelService.TransferEntitlements][google.cloud.channel.v1.CloudChannelService.TransferEntitlements].
-// This will be put into the response field of google.longrunning.Operation.
+// This is put in the response field of google.longrunning.Operation.
 message TransferEntitlementsResponse {
-  // The entitlements that have been transferred.
+  // The transferred entitlements.
   repeated Entitlement entitlements = 1;
 }
 
 // Request message for [CloudChannelService.TransferEntitlementsToGoogle][google.cloud.channel.v1.CloudChannelService.TransferEntitlementsToGoogle].
 message TransferEntitlementsToGoogleRequest {
-  // 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}
   string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. The entitlements to be transferred to Google.
+  // Required. The entitlements to transfer to Google.
   repeated Entitlement entitlements = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // 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
@@ -1396,26 +1340,23 @@ message TransferEntitlementsToGoogleRequest {
 // Request message for [CloudChannelService.ChangeParametersRequest][].
 message ChangeParametersRequest {
   // 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}
   string name = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. Entitlement parameters to update. Only editable parameters are allowed to
-  // be changed.
+  // Required. Entitlement parameters to update. You can only change editable parameters.
   repeated Parameter parameters = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // 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
+  // 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`).
   string request_id = 4 [(google.api.field_behavior) = OPTIONAL];
 
@@ -1426,21 +1367,20 @@ message ChangeParametersRequest {
 // Request message for [CloudChannelService.ChangeRenewalSettings][google.cloud.channel.v1.CloudChannelService.ChangeRenewalSettings].
 message ChangeRenewalSettingsRequest {
   // 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}
   string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. New renewal settings.
   RenewalSettings renewal_settings = 4 [(google.api.field_behavior) = REQUIRED];
 
-  // 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
@@ -1450,8 +1390,8 @@ message ChangeRenewalSettingsRequest {
 
 // Request message for [CloudChannelService.ChangeOffer][google.cloud.channel.v1.CloudChannelService.ChangeOffer].
 message ChangeOfferRequest {
-  // 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}
   string name = 1 [(google.api.field_behavior) = REQUIRED];
 
@@ -1470,14 +1410,13 @@ message ChangeOfferRequest {
   // Optional. Purchase order id provided by the reseller.
   string purchase_order_id = 5 [(google.api.field_behavior) = OPTIONAL];
 
-  // 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
@@ -1487,19 +1426,18 @@ message ChangeOfferRequest {
 
 // Request message for [CloudChannelService.StartPaidService][google.cloud.channel.v1.CloudChannelService.StartPaidService].
 message StartPaidServiceRequest {
-  // 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}
   string name = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // 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
@@ -1510,18 +1448,17 @@ message StartPaidServiceRequest {
 // Request message for [CloudChannelService.CancelEntitlement][google.cloud.channel.v1.CloudChannelService.CancelEntitlement].
 message CancelEntitlementRequest {
   // 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}
   string name = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // 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
@@ -1532,18 +1469,17 @@ message CancelEntitlementRequest {
 // Request message for [CloudChannelService.SuspendEntitlement][google.cloud.channel.v1.CloudChannelService.SuspendEntitlement].
 message SuspendEntitlementRequest {
   // 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}
   string name = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // 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
@@ -1554,18 +1490,17 @@ message SuspendEntitlementRequest {
 // Request message for [CloudChannelService.ActivateEntitlement][google.cloud.channel.v1.CloudChannelService.ActivateEntitlement].
 message ActivateEntitlementRequest {
   // 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}
   string name = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // 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
@@ -1580,16 +1515,16 @@ message ListProductsRequest {
   string account = 1 [(google.api.field_behavior) = REQUIRED];
 
   // 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.
   int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // 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.
   string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // 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".
   string language_code = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -1604,8 +1539,8 @@ message ListProductsResponse {
 
 // Request message for ListSkus.
 message ListSkusRequest {
-  // 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.
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
@@ -1619,17 +1554,17 @@ message ListSkusRequest {
   string account = 2 [(google.api.field_behavior) = REQUIRED];
 
   // 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.
   int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // 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.
   string page_token = 4 [(google.api.field_behavior) = OPTIONAL];
 
-  // 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".
   string language_code = 5 [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -1645,27 +1580,27 @@ message ListSkusResponse {
 // Request message for ListOffers.
 message ListOffersRequest {
   // 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}.
   string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
   // 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.
   int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // 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.
   string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // 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
   string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 
-  // 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".
   string language_code = 5 [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -1713,8 +1648,7 @@ message ListPurchasableSkusRequest {
     ChangeType change_type = 2 [(google.api.field_behavior) = REQUIRED];
   }
 
-  // Purchase option for the request. Defines the purchase for which the SKUs
-  // are being listed.
+  // Defines the intended purchase.
   oneof purchase_option {
     // List SKUs for CreateEntitlement purchase.
     CreateEntitlementPurchase create_entitlement_purchase = 2;
@@ -1723,7 +1657,7 @@ message ListPurchasableSkusRequest {
     ChangeOfferPurchase change_offer_purchase = 3;
   }
 
-  // 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}.
   string customer = 1 [
     (google.api.field_behavior) = REQUIRED,
@@ -1733,16 +1667,16 @@ message ListPurchasableSkusRequest {
   ];
 
   // 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.
   int32 page_size = 4 [(google.api.field_behavior) = OPTIONAL];
 
-  // 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.
   string page_token = 5 [(google.api.field_behavior) = OPTIONAL];
 
-  // 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".
   string language_code = 6 [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -1755,7 +1689,7 @@ message ListPurchasableSkusResponse {
   string next_page_token = 2;
 }
 
-// SKU that can be used for a puchase. This is used in ListPurchasableSku API
+// SKU that you can purchase. This is used in ListPurchasableSku API
 // response.
 message PurchasableSku {
   // SKU
@@ -1778,14 +1712,13 @@ message ListPurchasableOffersRequest {
     // accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id}
     string entitlement = 1 [(google.api.field_behavior) = REQUIRED];
 
-    // Optional. Resource name of the SKU that is being changed to. Should be provided if
+    // Optional. Resource name of the new target SKU. Provide this SKU when
     // upgrading or downgrading an entitlement. Format:
     // products/{product_id}/skus/{sku_id}
     string new_sku = 2 [(google.api.field_behavior) = OPTIONAL];
   }
 
-  // Purchase option for the request. Defines the purchase for which the Offers
-  // are being listed.
+  // Defines the intended purchase.
   oneof purchase_option {
     // List Offers for CreateEntitlement purchase.
     CreateEntitlementPurchase create_entitlement_purchase = 2;
@@ -1794,7 +1727,7 @@ message ListPurchasableOffersRequest {
     ChangeOfferPurchase change_offer_purchase = 3;
   }
 
-  // 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}.
   string customer = 1 [
     (google.api.field_behavior) = REQUIRED,
@@ -1804,16 +1737,16 @@ message ListPurchasableOffersRequest {
   ];
 
   // 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.
   int32 page_size = 4 [(google.api.field_behavior) = OPTIONAL];
 
-  // 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.
   string page_token = 5 [(google.api.field_behavior) = OPTIONAL];
 
-  // 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".
   string language_code = 6 [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -1826,7 +1759,7 @@ message ListPurchasableOffersResponse {
   string next_page_token = 2;
 }
 
-// Offer that can be puchased for a customer. This is used in
+// Offer that you can purchase for a customer. This is used in the
 // ListPurchasableOffer API response.
 message PurchasableOffer {
   // Offer.
@@ -1838,14 +1771,13 @@ message RegisterSubscriberRequest {
   // Required. Resource name of the account.
   string account = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. Service account which will provide subscriber access to the
-  // registered topic.
+  // Required. Service account that provides subscriber access to the registered topic.
   string service_account = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response Message for RegisterSubscriber.
 message RegisterSubscriberResponse {
-  // Name of the topic to which the subscriber will listen to.
+  // Name of the topic the subscriber will listen to.
   string topic = 1;
 }
 
@@ -1854,15 +1786,13 @@ message UnregisterSubscriberRequest {
   // Required. Resource name of the account.
   string account = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // 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.
   string service_account = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response Message for UnregisterSubscriber.
 message UnregisterSubscriberResponse {
-  // Name of the topic from which the service account subscriber access has been
-  // removed.
+  // Name of the topic the service account subscriber access was removed from.
   string topic = 1;
 }
 
@@ -1873,15 +1803,15 @@ message ListSubscribersRequest {
 
   // 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.
   int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // 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.
   string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
diff --git a/proto-google-cloud-channel-v1/src/main/proto/google/cloud/channel/v1/subscriber_event.proto b/proto-google-cloud-channel-v1/src/main/proto/google/cloud/channel/v1/subscriber_event.proto
index d2ae2f0c..a45c47e7 100644
--- a/proto-google-cloud-channel-v1/src/main/proto/google/cloud/channel/v1/subscriber_event.proto
+++ b/proto-google-cloud-channel-v1/src/main/proto/google/cloud/channel/v1/subscriber_event.proto
@@ -30,6 +30,12 @@ message CustomerEvent {
   enum Type {
     // Default value. This state doesn't show unless an error occurs.
     TYPE_UNSPECIFIED = 0;
+
+    // Primary domain for customer was changed.
+    PRIMARY_DOMAIN_CHANGED = 1;
+
+    // Primary domain of the customer has been verified.
+    PRIMARY_DOMAIN_VERIFIED = 2;
   }
 
   // Resource name of the customer.
diff --git a/synth.metadata b/synth.metadata
index 6b4c6127..f1e16265 100644
--- a/synth.metadata
+++ b/synth.metadata
@@ -4,15 +4,15 @@
       "git": {
         "name": ".",
         "remote": "https://github.com/googleapis/java-channel.git",
-        "sha": "3ab128114d0b2708f89b857320720c3b830a2c01"
+        "sha": "a34fad14e9cc86d014c3e543536519db06807614"
       }
     },
     {
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "1305ca41d554eb0725237561e34129373bb8cbc1",
-        "internalRef": "362856902"
+        "sha": "ddb4f289890694d97902b0558f192a796e02728f",
+        "internalRef": "367097700"
       }
     },
     {