google-cloud-channel-v1 0.3.0 → 0.7.1

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

@@ -13,6 +13,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_enum "google.cloud.channel.v1.CustomerEvent.Type" do
       value :TYPE_UNSPECIFIED, 0
+      value :PRIMARY_DOMAIN_CHANGED, 1
+      value :PRIMARY_DOMAIN_VERIFIED, 2
     end
     add_message "google.cloud.channel.v1.EntitlementEvent" do
       optional :entitlement, :string, 1
@@ -31,6 +33,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :RENEWAL_SETTING_CHANGED, 10
       value :PAID_SERVICE_STARTED, 11
       value :LICENSE_ASSIGNMENT_CHANGED, 12
+      value :LICENSE_CAP_CHANGED, 13
     end
     add_message "google.cloud.channel.v1.SubscriberEvent" do
       oneof :event do

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Channel
       module V1
-        VERSION = "0.3.0"
+        VERSION = "0.7.1"
       end
     end
   end

data/proto_docs/google/api/field_behavior.rb

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

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

@@ -82,9 +82,13 @@ module Google
         # @!attribute [r] primary_domain
         #   @return [::String]
         #     Output only. The primary domain name.
-        # @!attribute [rw] is_domain_verified
+        # @!attribute [r] is_domain_verified
         #   @return [::Boolean]
-        #     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.
         # @!attribute [rw] alternate_email
         #   @return [::String]
         #     The alternate email.
@@ -130,6 +134,9 @@ module Google
         # @!attribute [rw] proto_value
         #   @return [::Google::Protobuf::Any]
         #     Represents an 'Any' proto value.
+        # @!attribute [rw] bool_value
+        #   @return [::Boolean]
+        #     Represents a boolean value.
         class Value
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

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

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

@@ -203,18 +203,15 @@ module Google
         # TransferableSku represents information a reseller needs to view existing
         # provisioned services for a customer that they do not own.
         # Read-only.
-        # @!attribute [rw] is_commitment
-        #   @return [::Google::Protobuf::BoolValue]
-        #     Whether a transferable SKU is commitment-based or not.
-        # @!attribute [rw] commitment_end_timestamp
-        #   @return [::Google::Protobuf::Timestamp]
-        #     Commitment end timestamp.
         # @!attribute [rw] transfer_eligibility
         #   @return [::Google::Cloud::Channel::V1::TransferEligibility]
         #     Describes the transfer eligibility of a SKU.
         # @!attribute [rw] sku
         #   @return [::Google::Cloud::Channel::V1::Sku]
         #     The SKU pertaining to the provisioning resource as specified in the Offer.
+        # @!attribute [rw] legacy_sku
+        #   @return [::Google::Cloud::Channel::V1::Sku]
+        #     Optional. The customer to transfer has an entitlement with the populated legacy SKU.
         class TransferableSku
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -147,6 +147,10 @@ module Google
         #     For Regular Offers with a trial period, the regular pricing goes into
         #     effect when trial period ends, or if paid service is started before the end
         #     of the trial period.
+        # @!attribute [rw] billing_account
+        #   @return [::String]
+        #     Reseller Billing account to charge after an offer transaction.
+        #     Only present for Google Cloud Platform offers.
         class Plan
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -24,35 +24,34 @@ module Google
         # Request message for {::Google::Cloud::Channel::V1::CloudChannelService::Client#check_cloud_identity_accounts_exist CloudChannelService.CheckCloudIdentityAccountsExist}.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The resource name of the reseller account.
-        #     The parent takes the format: accounts/\\{account_id}
+        #     Required. The reseller account's resource name.
+        #     Parent uses the format: accounts/\\{account_id}
         # @!attribute [rw] domain
         #   @return [::String]
-        #     Required. Domain for which the Cloud Identity account customer is fetched.
+        #     Required. Domain to fetch for Cloud Identity account customer.
         class CheckCloudIdentityAccountsExistRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # 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.
         # @!attribute [rw] existing
         #   @return [::Boolean]
-        #     True if a Cloud Identity account exists for a specific domain.
+        #     Returns true if a Cloud Identity account exists for a specific domain.
         # @!attribute [rw] owned
         #   @return [::Boolean]
-        #     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.
         # @!attribute [rw] customer_name
         #   @return [::String]
-        #     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}
         # @!attribute [rw] customer_cloud_identity_id
         #   @return [::String]
-        #     Cloud Identity ID of the customer. This field is populated ONLY if
-        #     existing = true.
+        #     If existing = true, the Cloud Identity ID of the customer.
         class CloudIdentityCustomerAccount
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -71,17 +70,17 @@ module Google
         # Request message for {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_customers CloudChannelService.ListCustomers}
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The resource name of the reseller account from which to list customers.
-        #     The parent takes the format: accounts/\\{account_id}.
+        #     Required. The resource name of the reseller account to list customers from.
+        #     Parent uses the format: accounts/\\{account_id}.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. The maximum number of customers to return. The service may return fewer
-        #     than this value. If unspecified, at most 10 customers will be returned. The
-        #     maximum value is 50; values about 50 will be coerced to 50.
+        #     than this value. If unspecified, returns at most 10 customers. The
+        #     maximum value is 50.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. A token identifying a page of results, if other than the first one.
-        #     Typically obtained via
+        #     Optional. A token identifying a page of results other than the first page.
+        #     Obtained through
         #     {::Google::Cloud::Channel::V1::ListCustomersResponse#next_page_token ListCustomersResponse.next_page_token} of the previous
         #     {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_customers CloudChannelService.ListCustomers} call.
         class ListCustomersRequest
@@ -92,7 +91,7 @@ module Google
         # Response message for {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_customers CloudChannelService.ListCustomers}.
         # @!attribute [rw] customers
         #   @return [::Array<::Google::Cloud::Channel::V1::Customer>]
-        #     The customers belonging to the reseller or distributor.
+        #     The customers belonging to a reseller or distributor.
         # @!attribute [rw] next_page_token
         #   @return [::String]
         #     A token to retrieve the next page of results.
@@ -106,7 +105,7 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the customer to retrieve.
-        #     The name takes the format: accounts/\\{account_id}/customers/\\{customer_id}
+        #     Name uses the format: accounts/\\{account_id}/customers/\\{customer_id}
         class GetCustomerRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -116,7 +115,7 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The resource name of reseller account in which to create the customer.
-        #     The parent takes the format: accounts/\\{account_id}
+        #     Parent uses the format: accounts/\\{account_id}
         # @!attribute [rw] customer
         #   @return [::Google::Cloud::Channel::V1::Customer]
         #     Required. The customer to create.
@@ -160,8 +159,7 @@ module Google
         #     Admin user information.
         # @!attribute [rw] validate_only
         #   @return [::Boolean]
-        #     If set, validate the request and preview the review, but do not actually
-        #     post it.
+        #     Validate the request and preview the review, but do not post it.
         class ProvisionCloudIdentityRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -170,18 +168,18 @@ module Google
         # Request message for {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_entitlements CloudChannelService.ListEntitlements}
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The resource name of the reseller's customer account for which to list
-        #     entitlements.
-        #     The parent takes the format: accounts/\\{account_id}/customers/\\{customer_id}
+        #     Required. The resource name of the reseller's customer account to list
+        #     entitlements for.
+        #     Parent uses the format: accounts/\\{account_id}/customers/\\{customer_id}
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Requested page size. Server might return fewer results than requested.
-        #     If unspecified, at most 50 entitlements will be returned.
-        #     The maximum value is 100; values above 100 will be coerced to 100.
+        #     If unspecified, return at most 50 entitlements.
+        #     The maximum value is 100; the server will coerce values above 100.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. A token identifying a page of results, if other than the first one.
-        #     Typically obtained via
+        #     Optional. A token for a page of results other than the first page.
+        #     Obtained using
         #     {::Google::Cloud::Channel::V1::ListEntitlementsResponse#next_page_token ListEntitlementsResponse.next_page_token} of the previous
         #     {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_entitlements CloudChannelService.ListEntitlements} call.
         class ListEntitlementsRequest
@@ -192,10 +190,10 @@ module Google
         # Response message for {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_entitlements CloudChannelService.ListEntitlements}.
         # @!attribute [rw] entitlements
         #   @return [::Array<::Google::Cloud::Channel::V1::Entitlement>]
-        #     The entitlements belonging to the reseller's customer.
+        #     The reseller customer's entitlements.
         # @!attribute [rw] next_page_token
         #   @return [::String]
-        #     A token to List next page of results.
+        #     A token to list the next page of results.
         #     Pass to {::Google::Cloud::Channel::V1::ListEntitlementsRequest#page_token ListEntitlementsRequest.page_token} to obtain that page.
         class ListEntitlementsResponse
           include ::Google::Protobuf::MessageExts
@@ -210,37 +208,36 @@ module Google
         #   @return [::String]
         #     A reseller is required to create a customer and use the resource name of
         #     the created customer here.
-        #     The customer_name takes the format:
+        #     Customer_name uses the format:
         #     accounts/\\{account_id}/customers/\\{customer_id}
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The resource name of the reseller's account.
-        #     The parent takes the format: accounts/\\{account_id}
+        #     Required. The reseller account's resource name.
+        #     Parent uses the format: accounts/\\{account_id}
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     Requested page size. Server might return fewer results than requested.
-        #     If unspecified, at most 100 SKUs will be returned.
-        #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+        #     The requested page size. Server might return fewer results than requested.
+        #     If unspecified, returns at most 100 SKUs.
+        #     The maximum value is 1000; the server will coerce values above 1000.
         #     Optional.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     A token identifying a page of results, if other than the first one.
-        #     Typically obtained via
+        #     A token for a page of results other than the first page.
+        #     Obtained using
         #     {::Google::Cloud::Channel::V1::ListTransferableSkusResponse#next_page_token ListTransferableSkusResponse.next_page_token} of the previous
         #     {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_transferable_skus CloudChannelService.ListTransferableSkus} call.
         #     Optional.
         # @!attribute [rw] auth_token
         #   @return [::String]
-        #     This token is generated by the Super Admin of the resold customer to
+        #     The super admin of the resold customer generates this token to
         #     authorize a reseller to access their Cloud Identity and purchase
-        #     entitlements on their behalf. This token can be omitted once the
-        #     authorization is generated. See https://support.google.com/a/answer/7643790
-        #     for more details.
+        #     entitlements on their behalf. You can omit this token after authorization.
+        #     See https://support.google.com/a/answer/7643790 for more details.
         # @!attribute [rw] language_code
         #   @return [::String]
-        #     The BCP-47 language code, such as "en-US".  If specified, the
-        #     response will be localized to the corresponding language code. Default is
-        #     "en-US".
+        #     The BCP-47 language code. For example, "en-US". The
+        #     response will localize in the corresponding language code, if specified.
+        #     The default value is "en-US".
         #     Optional.
         class ListTransferableSkusRequest
           include ::Google::Protobuf::MessageExts
@@ -250,8 +247,7 @@ module Google
         # Response message for {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_transferable_skus CloudChannelService.ListTransferableSkus}.
         # @!attribute [rw] transferable_skus
         #   @return [::Array<::Google::Cloud::Channel::V1::TransferableSku>]
-        #     Information about existing SKUs for a customer that would need to be
-        #     transferred.
+        #     Information about existing SKUs for a customer that needs a transfer.
         # @!attribute [rw] next_page_token
         #   @return [::String]
         #     A token to retrieve the next page of results.
@@ -269,29 +265,29 @@ module Google
         # @!attribute [rw] customer_name
         #   @return [::String]
         #     A reseller should create a customer and use the resource name of
-        #     the created customer here.
+        #     that customer here.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The resource name of the reseller's account.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Requested page size. Server might return fewer results than requested.
-        #     If unspecified, at most 100 Offers will be returned.
-        #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+        #     If unspecified, returns at most 100 offers.
+        #     The maximum value is 1000; the server will coerce values above 1000.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     A token identifying a page of results, if other than the first one.
-        #     Typically obtained via
+        #     A token for a page of results other than the first page.
+        #     Obtained using
         #     {::Google::Cloud::Channel::V1::ListTransferableOffersResponse#next_page_token ListTransferableOffersResponse.next_page_token} of the previous
         #     {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_transferable_offers CloudChannelService.ListTransferableOffers} call.
         # @!attribute [rw] sku
         #   @return [::String]
-        #     Required. SKU for which the Offers are being looked up.
+        #     Required. The SKU to look up Offers for.
         # @!attribute [rw] language_code
         #   @return [::String]
-        #     The BCP-47 language code, such as "en-US".  If specified, the
-        #     response will be localized to the corresponding language code. Default is
-        #     "en-US".
+        #     The BCP-47 language code. For example, "en-US". The
+        #     response will localize in the corresponding language code, if specified.
+        #     The default value is "en-US".
         class ListTransferableOffersRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -326,8 +322,8 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the entitlement to retrieve.
-        #     The name takes the format:
-        #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{id}
+        #     Name uses the format:
+        #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
         class GetEntitlementRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -338,16 +334,16 @@ module Google
         #   @return [::String]
         #     Required. The resource name of the reseller account for listing channel partner
         #     links.
-        #     The parent takes the format: accounts/\\{account_id}
+        #     Parent uses the format: accounts/\\{account_id}
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Requested page size. Server might return fewer results than requested.
         #     If unspecified, server will pick a default size (25).
-        #     The maximum value is 200, values above 200 will be coerced to 200.
+        #     The maximum value is 200; the server will coerce values above 200.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. A token identifying a page of results, if other than the first one.
-        #     Typically obtained via
+        #     Optional. A token for a page of results other than the first page.
+        #     Obtained using
         #     {::Google::Cloud::Channel::V1::ListChannelPartnerLinksResponse#next_page_token ListChannelPartnerLinksResponse.next_page_token} of the previous
         #     {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_channel_partner_links CloudChannelService.ListChannelPartnerLinks} call.
         # @!attribute [rw] view
@@ -375,7 +371,7 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the channel partner link to retrieve.
-        #     The name takes the format: accounts/\\{account_id}/channelPartnerLinks/\\{id}
+        #     Name uses the format: accounts/\\{account_id}/channelPartnerLinks/\\{id}
         #     where \\{id} is the Cloud Identity ID of the partner.
         # @!attribute [rw] view
         #   @return [::Google::Cloud::Channel::V1::ChannelPartnerLinkView]
@@ -388,19 +384,14 @@ module Google
         # Request message for {::Google::Cloud::Channel::V1::CloudChannelService::Client#create_channel_partner_link CloudChannelService.CreateChannelPartnerLink}
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The resource name of reseller's account for which to create a channel
-        #     partner link.
-        #     The parent takes the format: accounts/\\{account_id}
+        #     Required. Create a channel partner link for the provided reseller account's
+        #     resource name.
+        #     Parent uses the format: accounts/\\{account_id}
         # @!attribute [rw] channel_partner_link
         #   @return [::Google::Cloud::Channel::V1::ChannelPartnerLink]
         #     Required. The channel partner link to create.
         #     Either channel_partner_link.reseller_cloud_identity_id or domain can be
         #     used to create a link.
-        # @!attribute [rw] domain
-        #   @return [::String]
-        #     Optional. The invited partner's domain. Either domain or
-        #     channel_partner_link.reseller_cloud_identity_id can be used to create a
-        #     link.
         class CreateChannelPartnerLinkRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -410,16 +401,16 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the channel partner link to cancel.
-        #     The name takes the format: accounts/\\{account_id}/channelPartnerLinks/\\{id}
+        #     Name uses the format: accounts/\\{account_id}/channelPartnerLinks/\\{id}
         #     where \\{id} is the Cloud Identity ID of the partner.
         # @!attribute [rw] channel_partner_link
         #   @return [::Google::Cloud::Channel::V1::ChannelPartnerLink]
-        #     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.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
         #     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.
         class UpdateChannelPartnerLinkRequest
           include ::Google::Protobuf::MessageExts
@@ -429,22 +420,21 @@ module Google
         # Request message for {::Google::Cloud::Channel::V1::CloudChannelService::Client#create_entitlement CloudChannelService.CreateEntitlement}
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The resource name of reseller's customer account in which to create the
+        #     Required. The resource name of the reseller's customer account in which to create the
         #     entitlement.
-        #     The parent takes the format: accounts/\\{account_id}/customers/\\{customer_id}
+        #     Parent uses the format: accounts/\\{account_id}/customers/\\{customer_id}
         # @!attribute [rw] entitlement
         #   @return [::Google::Cloud::Channel::V1::Entitlement]
         #     Required. The entitlement to create.
         # @!attribute [rw] request_id
         #   @return [::String]
-        #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-        #     that if you must retry your request, the server will know to ignore the
-        #     request if it has already been completed.
+        #     Optional. You can specify an optional unique request ID, and if you need to retry
+        #     your request, the server will know to ignore the request if it's complete.
         #
-        #     For example, consider a situation where you make an initial request and
-        #     the request times out. If you make the request again with the same
-        #     request ID, the server can check if the original operation with the same
-        #     request ID was received, and if so, will ignore the second request.
+        #     For example, you make an initial request and the request times out. If you
+        #     make the request again with the same request ID, the server can check if
+        #     it received the original operation with the same request ID. If it did, it
+        #     will ignore the second request.
         #
         #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
         #     with the exception that zero UUID is not supported
@@ -457,29 +447,27 @@ module Google
         # Request message for {::Google::Cloud::Channel::V1::CloudChannelService::Client#transfer_entitlements CloudChannelService.TransferEntitlements}.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The resource name of reseller's customer account where the entitlements
-        #     transfer to.
-        #     The parent takes the format: accounts/\\{account_id}/customers/\\{customer_id}
+        #     Required. The resource name of the reseller's customer account that will receive
+        #     transferred entitlements.
+        #     Parent uses the format: accounts/\\{account_id}/customers/\\{customer_id}
         # @!attribute [rw] entitlements
         #   @return [::Array<::Google::Cloud::Channel::V1::Entitlement>]
-        #     Required. The new entitlements to be created or transferred.
+        #     Required. The new entitlements to create or transfer.
         # @!attribute [rw] auth_token
         #   @return [::String]
-        #     This token is generated by the Super Admin of the resold customer to
+        #     The super admin of the resold customer generates this token to
         #     authorize a reseller to access their Cloud Identity and purchase
-        #     entitlements on their behalf. This token can be omitted once the
-        #     authorization is generated. See https://support.google.com/a/answer/7643790
-        #     for more details.
+        #     entitlements on their behalf. You can omit this token after authorization.
+        #     See https://support.google.com/a/answer/7643790 for more details.
         # @!attribute [rw] request_id
         #   @return [::String]
-        #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-        #     that if you must retry your request, the server will know to ignore the
-        #     request if it has already been completed.
+        #     Optional. You can specify an optional unique request ID, and if you need to retry
+        #     your request, the server will know to ignore the request if it's complete.
         #
-        #     For example, consider a situation where you make an initial request and
-        #     the request times out. If you make the request again with the same
-        #     request ID, the server can check if the original operation with the same
-        #     request ID was received, and if so, will ignore the second request.
+        #     For example, you make an initial request and the request times out. If you
+        #     make the request again with the same request ID, the server can check if
+        #     it received the original operation with the same request ID. If it did, it
+        #     will ignore the second request.
         #
         #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
         #     with the exception that zero UUID is not supported
@@ -490,10 +478,10 @@ module Google
         end
 
         # Response message for {::Google::Cloud::Channel::V1::CloudChannelService::Client#transfer_entitlements 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.
         # @!attribute [rw] entitlements
         #   @return [::Array<::Google::Cloud::Channel::V1::Entitlement>]
-        #     The entitlements that have been transferred.
+        #     The transferred entitlements.
         class TransferEntitlementsResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -502,22 +490,21 @@ module Google
         # Request message for {::Google::Cloud::Channel::V1::CloudChannelService::Client#transfer_entitlements_to_google CloudChannelService.TransferEntitlementsToGoogle}.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The resource name of reseller's customer account where the entitlements
+        #     Required. The resource name of the reseller's customer account where the entitlements
         #     transfer from.
-        #     The parent takes the format: accounts/\\{account_id}/customers/\\{customer_id}
+        #     Parent uses the format: accounts/\\{account_id}/customers/\\{customer_id}
         # @!attribute [rw] entitlements
         #   @return [::Array<::Google::Cloud::Channel::V1::Entitlement>]
-        #     Required. The entitlements to be transferred to Google.
+        #     Required. The entitlements to transfer to Google.
         # @!attribute [rw] request_id
         #   @return [::String]
-        #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-        #     that if you must retry your request, the server will know to ignore the
-        #     request if it has already been completed.
+        #     Optional. You can specify an optional unique request ID, and if you need to retry
+        #     your request, the server will know to ignore the request if it's complete.
         #
-        #     For example, consider a situation where you make an initial request and
-        #     the request times out. If you make the request again with the same
-        #     request ID, the server can check if the original operation with the same
-        #     request ID was received, and if so, will ignore the second request.
+        #     For example, you make an initial request and the request times out. If you
+        #     make the request again with the same request ID, the server can check if
+        #     it received the original operation with the same request ID. If it did, it
+        #     will ignore the second request.
         #
         #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
         #     with the exception that zero UUID is not supported
@@ -531,26 +518,23 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The name of the entitlement to update.
-        #     The name takes the format:
+        #     Name uses the format:
         #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
         # @!attribute [rw] parameters
         #   @return [::Array<::Google::Cloud::Channel::V1::Parameter>]
-        #     Required. Entitlement parameters to update. Only editable parameters are allowed to
-        #     be changed.
+        #     Required. Entitlement parameters to update. You can only change editable parameters.
         # @!attribute [rw] request_id
         #   @return [::String]
-        #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-        #     that if you must retry your request, the server will know to ignore the
-        #     request if it has already been completed.
+        #     Optional. You can specify an optional unique request ID, and if you need to retry
+        #     your request, the server will know to ignore the request if it's complete.
         #
-        #     For example, consider a situation where you make an initial request and
-        #     the request times out. If you make the request again with the same
-        #     request ID, the server can check if the original operation with the same
-        #     request ID was received, and if so, will ignore the second request.
+        #     For example, you make an initial request and the request times out. If you
+        #     make the request again with the same request ID, the server can check if
+        #     it received the original operation with the same request ID. If it did, it
+        #     will ignore the second request.
         #
-        #     The request ID must be
-        #     a valid [UUID](https://tools.ietf.org/html/rfc4122) with the exception that
-        #     zero UUID is not supported
+        #     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`).
         # @!attribute [rw] purchase_order_id
         #   @return [::String]
@@ -564,21 +548,20 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The name of the entitlement to update.
-        #     The name takes the format:
+        #     Name uses the format:
         #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
         # @!attribute [rw] renewal_settings
         #   @return [::Google::Cloud::Channel::V1::RenewalSettings]
         #     Required. New renewal settings.
         # @!attribute [rw] request_id
         #   @return [::String]
-        #     Optional. A request ID to identify requests. Specify a unique request ID so
-        #     that if you must retry your request, the server will know to ignore the
-        #     request if it has already been completed.
+        #     Optional. You can specify an optional unique request ID, and if you need to retry
+        #     your request, the server will know to ignore the request if it's complete.
         #
-        #     For example, consider a situation where you make an initial request and
-        #     the request times out. If you make the request again with the same
-        #     request ID, the server can check if the original operation with the same
-        #     request ID was received, and if so, will ignore the second request.
+        #     For example, you make an initial request and the request times out. If you
+        #     make the request again with the same request ID, the server can check if
+        #     it received the original operation with the same request ID. If it did, it
+        #     will ignore the second request.
         #
         #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
         #     with the exception that zero UUID is not supported
@@ -591,8 +574,8 @@ module Google
         # Request message for {::Google::Cloud::Channel::V1::CloudChannelService::Client#change_offer CloudChannelService.ChangeOffer}.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. The name of the entitlement to update.
-        #     Format:
+        #     Required. The resource name of the entitlement to update.
+        #     Name uses the format:
         #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
         # @!attribute [rw] offer
         #   @return [::String]
@@ -606,14 +589,13 @@ module Google
         #     Optional. Purchase order id provided by the reseller.
         # @!attribute [rw] request_id
         #   @return [::String]
-        #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-        #     that if you must retry your request, the server will know to ignore the
-        #     request if it has already been completed.
+        #     Optional. You can specify an optional unique request ID, and if you need to retry
+        #     your request, the server will know to ignore the request if it's complete.
         #
-        #     For example, consider a situation where you make an initial request and
-        #     the request times out. If you make the request again with the same
-        #     request ID, the server can check if the original operation with the same
-        #     request ID was received, and if so, will ignore the second request.
+        #     For example, you make an initial request and the request times out. If you
+        #     make the request again with the same request ID, the server can check if
+        #     it received the original operation with the same request ID. If it did, it
+        #     will ignore the second request.
         #
         #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
         #     with the exception that zero UUID is not supported
@@ -626,19 +608,18 @@ module Google
         # Request message for {::Google::Cloud::Channel::V1::CloudChannelService::Client#start_paid_service CloudChannelService.StartPaidService}.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. The name of the entitlement for which paid service is being started.
-        #     The name takes the format:
+        #     Required. The name of the entitlement to start a paid service for.
+        #     Name uses the format:
         #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
         # @!attribute [rw] request_id
         #   @return [::String]
-        #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-        #     that if you must retry your request, the server will know to ignore the
-        #     request if it has already been completed.
+        #     Optional. You can specify an optional unique request ID, and if you need to retry
+        #     your request, the server will know to ignore the request if it's complete.
         #
-        #     For example, consider a situation where you make an initial request and
-        #     the request times out. If you make the request again with the same
-        #     request ID, the server can check if the original operation with the same
-        #     request ID was received, and if so, will ignore the second request.
+        #     For example, you make an initial request and the request times out. If you
+        #     make the request again with the same request ID, the server can check if
+        #     it received the original operation with the same request ID. If it did, it
+        #     will ignore the second request.
         #
         #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
         #     with the exception that zero UUID is not supported
@@ -652,18 +633,17 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the entitlement to cancel.
-        #     The name takes the format:
+        #     Name uses the format:
         #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
         # @!attribute [rw] request_id
         #   @return [::String]
-        #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-        #     that if you must retry your request, the server will know to ignore the
-        #     request if it has already been completed.
+        #     Optional. You can specify an optional unique request ID, and if you need to retry
+        #     your request, the server will know to ignore the request if it's complete.
         #
-        #     For example, consider a situation where you make an initial request and
-        #     the request times out. If you make the request again with the same
-        #     request ID, the server can check if the original operation with the same
-        #     request ID was received, and if so, will ignore the second request.
+        #     For example, you make an initial request and the request times out. If you
+        #     make the request again with the same request ID, the server can check if
+        #     it received the original operation with the same request ID. If it did, it
+        #     will ignore the second request.
         #
         #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
         #     with the exception that zero UUID is not supported
@@ -677,18 +657,17 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the entitlement to suspend.
-        #     The name takes the format:
+        #     Name uses the format:
         #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
         # @!attribute [rw] request_id
         #   @return [::String]
-        #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-        #     that if you must retry your request, the server will know to ignore the
-        #     request if it has already been completed.
+        #     Optional. You can specify an optional unique request ID, and if you need to retry
+        #     your request, the server will know to ignore the request if it's complete.
         #
-        #     For example, consider a situation where you make an initial request and
-        #     the request times out. If you make the request again with the same
-        #     request ID, the server can check if the original operation with the same
-        #     request ID was received, and if so, will ignore the second request.
+        #     For example, you make an initial request and the request times out. If you
+        #     make the request again with the same request ID, the server can check if
+        #     it received the original operation with the same request ID. If it did, it
+        #     will ignore the second request.
         #
         #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
         #     with the exception that zero UUID is not supported
@@ -702,18 +681,17 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the entitlement to activate.
-        #     The name takes the format:
+        #     Name uses the format:
         #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
         # @!attribute [rw] request_id
         #   @return [::String]
-        #     Optional. An optional request ID to identify requests. Specify a unique request ID so
-        #     that if you must retry your request, the server will know to ignore the
-        #     request if it has already been completed.
+        #     Optional. You can specify an optional unique request ID, and if you need to retry
+        #     your request, the server will know to ignore the request if it's complete.
         #
-        #     For example, consider a situation where you make an initial request and
-        #     the request times out. If you make the request again with the same
-        #     request ID, the server can check if the original operation with the same
-        #     request ID was received, and if so, will ignore the second request.
+        #     For example, you make an initial request and the request times out. If you
+        #     make the request again with the same request ID, the server can check if
+        #     it received the original operation with the same request ID. If it did, it
+        #     will ignore the second request.
         #
         #     The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
         #     with the exception that zero UUID is not supported
@@ -723,6 +701,17 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for LookupOffer.
+        # @!attribute [rw] entitlement
+        #   @return [::String]
+        #     Required. The resource name of the entitlement to retrieve the Offer.
+        #     Entitlement uses the format:
+        #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
+        class LookupOfferRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for ListProducts.
         # @!attribute [rw] account
         #   @return [::String]
@@ -731,16 +720,16 @@ module Google
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Requested page size. Server might return fewer results than requested.
-        #     If unspecified, at most 100 Products will be returned.
-        #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+        #     If unspecified, returns at most 100 Products.
+        #     The maximum value is 1000; the server will coerce values above 1000.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. A token identifying a page of results, if other than the first one.
+        #     Optional. A token for a page of results other than the first page.
         # @!attribute [rw] language_code
         #   @return [::String]
-        #     Optional. The BCP-47 language code, such as "en-US".  If specified, the
-        #     response will be localized to the corresponding language code. Default is
-        #     "en-US".
+        #     Optional. The BCP-47 language code. For example, "en-US". The
+        #     response will localize in the corresponding language code, if specified.
+        #     The default value is "en-US".
         class ListProductsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -761,8 +750,8 @@ module Google
         # Request message for ListSkus.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The resource name of the Product for which to list SKUs.
-        #     The parent takes the format: products/\\{product_id}.
+        #     Required. The resource name of the Product to list SKUs for.
+        #     Parent uses the format: products/\\{product_id}.
         #     Supports products/- to retrieve SKUs for all products.
         # @!attribute [rw] account
         #   @return [::String]
@@ -771,17 +760,17 @@ module Google
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Requested page size. Server might return fewer results than requested.
-        #     If unspecified, at most 100 SKUs will be returned.
-        #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+        #     If unspecified, returns at most 100 SKUs.
+        #     The maximum value is 1000; the server will coerce values above 1000.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. A token identifying a page of results, if other than the first one.
+        #     Optional. A token for a page of results other than the first page.
         #     Optional.
         # @!attribute [rw] language_code
         #   @return [::String]
-        #     Optional. The BCP-47 language code, such as "en-US".  If specified, the
-        #     response will be localized to the corresponding language code. Default is
-        #     "en-US".
+        #     Optional. The BCP-47 language code. For example, "en-US". The
+        #     response will localize in the corresponding language code, if specified.
+        #     The default value is "en-US".
         class ListSkusRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -803,27 +792,27 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The resource name of the reseller account from which to list Offers.
-        #     The parent takes the format: accounts/\\{account_id}.
+        #     Parent uses the format: accounts/\\{account_id}.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Requested page size. Server might return fewer results than requested.
-        #     If unspecified, at most 500 Offers will be returned.
-        #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+        #     If unspecified, returns at most 500 Offers.
+        #     The maximum value is 1000; the server will coerce values above 1000.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. A token identifying a page of results, if other than the first one.
+        #     Optional. A token for a page of results other than the first page.
         # @!attribute [rw] filter
         #   @return [::String]
         #     Optional. The expression to filter results by name (name of
-        #     the Offer), sku.name (name of the SKU) or sku.product.name (name of the
+        #     the Offer), sku.name (name of the SKU), or sku.product.name (name of the
         #     Product).
         #     Example 1: sku.product.name=products/p1 AND sku.name!=products/p1/skus/s1
         #     Example 2: name=accounts/a1/offers/o1
         # @!attribute [rw] language_code
         #   @return [::String]
-        #     Optional. The BCP-47 language code, such as "en-US".  If specified, the
-        #     response will be localized to the corresponding language code. Default is
-        #     "en-US".
+        #     Optional. The BCP-47 language code. For example, "en-US". The
+        #     response will localize in the corresponding language code, if specified.
+        #     The default value is "en-US".
         class ListOffersRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -850,21 +839,21 @@ module Google
         #     List SKUs for ChangeOffer purchase with a new SKU.
         # @!attribute [rw] customer
         #   @return [::String]
-        #     Required. The resource name of the customer for which to list SKUs.
+        #     Required. The resource name of the customer to list SKUs for.
         #     Format: accounts/\\{account_id}/customers/\\{customer_id}.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Requested page size. Server might return fewer results than requested.
-        #     If unspecified, at most 100 SKUs will be returned.
-        #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+        #     If unspecified, returns at most 100 SKUs.
+        #     The maximum value is 1000; the server will coerce values above 1000.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. A token identifying a page of results, if other than the first one.
+        #     Optional. A token for a page of results other than the first page.
         # @!attribute [rw] language_code
         #   @return [::String]
-        #     Optional. The BCP-47 language code, such as "en-US".  If specified, the
-        #     response will be localized to the corresponding language code. Default is
-        #     "en-US".
+        #     Optional. The BCP-47 language code. For example, "en-US". The
+        #     response will localize in the corresponding language code, if specified.
+        #     The default value is "en-US".
         class ListPurchasableSkusRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -921,7 +910,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # 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.
         # @!attribute [rw] sku
         #   @return [::Google::Cloud::Channel::V1::Sku]
@@ -940,21 +929,21 @@ module Google
         #     List Offers for ChangeOffer purchase.
         # @!attribute [rw] customer
         #   @return [::String]
-        #     Required. The resource name of the customer for which to list Offers.
+        #     Required. The resource name of the customer to list Offers for.
         #     Format: accounts/\\{account_id}/customers/\\{customer_id}.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Requested page size. Server might return fewer results than requested.
-        #     If unspecified, at most 100 Offers will be returned.
-        #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+        #     If unspecified, returns at most 100 Offers.
+        #     The maximum value is 1000; the server will coerce values above 1000.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. A token identifying a page of results, if other than the first one.
+        #     Optional. A token for a page of results other than the first page.
         # @!attribute [rw] language_code
         #   @return [::String]
-        #     Optional. The BCP-47 language code, such as "en-US".  If specified, the
-        #     response will be localized to the corresponding language code. Default is
-        #     "en-US".
+        #     Optional. The BCP-47 language code. For example, "en-US". The
+        #     response will localize in the corresponding language code, if specified.
+        #     The default value is "en-US".
         class ListPurchasableOffersRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -977,7 +966,7 @@ module Google
           #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
           # @!attribute [rw] new_sku
           #   @return [::String]
-          #     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}
           class ChangeOfferPurchase
@@ -998,7 +987,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # 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.
         # @!attribute [rw] offer
         #   @return [::Google::Cloud::Channel::V1::Offer]
@@ -1014,8 +1003,7 @@ module Google
         #     Required. Resource name of the account.
         # @!attribute [rw] service_account
         #   @return [::String]
-        #     Required. Service account which will provide subscriber access to the
-        #     registered topic.
+        #     Required. Service account that provides subscriber access to the registered topic.
         class RegisterSubscriberRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1024,7 +1012,7 @@ module Google
         # Response Message for RegisterSubscriber.
         # @!attribute [rw] topic
         #   @return [::String]
-        #     Name of the topic to which the subscriber will listen to.
+        #     Name of the topic the subscriber will listen to.
         class RegisterSubscriberResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1036,8 +1024,7 @@ module Google
         #     Required. Resource name of the account.
         # @!attribute [rw] service_account
         #   @return [::String]
-        #     Required. Service account which will be unregistered from getting subscriber access
-        #     to the topic.
+        #     Required. Service account to unregister from subscriber access to the topic.
         class UnregisterSubscriberRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1046,8 +1033,7 @@ module Google
         # Response Message for UnregisterSubscriber.
         # @!attribute [rw] topic
         #   @return [::String]
-        #     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.
         class UnregisterSubscriberResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1061,15 +1047,15 @@ module Google
         #   @return [::Integer]
         #     Optional. The maximum number of service accounts to return. The service may return
         #     fewer than this value.
-        #     If unspecified, at most 100 service accounts will be returned.
-        #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+        #     If unspecified, returns at most 100 service accounts.
+        #     The maximum value is 1000; the server will coerce values above 1000.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Optional. A page token, received from a previous `ListSubscribers` call.
         #     Provide this to retrieve the subsequent page.
         #
         #     When paginating, all other parameters provided to `ListSubscribers` must
-        #      match the call that provided the page token.
+        #     match the call that provided the page token.
         class ListSubscribersRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods