google-api-client 0.32.1 → 0.40.0

data/generated/google/apis/content_v2/classes.rb

@@ -23,8 +23,8 @@ module Google
     module ContentV2
       
       # Account data. After the creation of a new account it may take a few minutes
-      # before it is fully operational. The methods delete, insert, patch, and update
-      # require the admin role.
+      # before it is fully operational. The methods delete, insert, and update require
+      # the admin role.
       class Account
         include Google::Apis::Core::Hashable
       
@@ -35,8 +35,8 @@ module Google
         alias_method :adult_content?, :adult_content
       
         # List of linked AdWords accounts that are active or pending approval. To create
-        # a new link request, add a new link with status active to the list. It will
-        # remain in a pending state until approved or rejected either in the AdWords
+        # a new link request, add a new link with status `active` to the list. It will
+        # remain in a `pending` state until approved or rejected either in the AdWords
         # interface or through the  AdWords API. To delete an active link, or to cancel
         # a link request, remove it from the list.
         # Corresponds to the JSON property `adwordsLinks`
@@ -54,18 +54,18 @@ module Google
         # @return [Google::Apis::ContentV2::AccountGoogleMyBusinessLink]
         attr_accessor :google_my_business_link
       
-        # Merchant Center account ID.
+        # Required for update. Merchant Center account ID.
         # Corresponds to the JSON property `id`
         # @return [Fixnum]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # account".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # account`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # Display name for the account.
+        # Required. Display name for the account.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -92,10 +92,10 @@ module Google
         attr_accessor :website_url
       
         # List of linked YouTube channels that are active or pending approval. To create
-        # a new link request, add a new link with status active to the list. It will
-        # remain in a pending state until approved or rejected in the YT Creator Studio
-        # interface. To delete an active link, or to cancel a link request, remove it
-        # from the list.
+        # a new link request, add a new link with status `active` to the list. It will
+        # remain in a `pending` state until approved or rejected in the YT Creator
+        # Studio interface. To delete an active link, or to cancel a link request,
+        # remove it from the list.
         # Corresponds to the JSON property `youtubeChannelLinks`
         # @return [Array<Google::Apis::ContentV2::AccountYouTubeChannelLink>]
         attr_accessor :youtube_channel_links
@@ -177,13 +177,16 @@ module Google
       
         # Status of the link between this Merchant Center account and the AdWords
         # account. Upon retrieval, it represents the actual status of the link and can
-        # be either active if it was approved in Google AdWords or pending if it's
+        # be either `active` if it was approved in Google AdWords or `pending` if it's
         # pending approval. Upon insertion, it represents the intended status of the
-        # link. Re-uploading a link with status active when it's still pending or with
-        # status pending when it's already active will have no effect: the status will
-        # remain unchanged. Re-uploading a link with deprecated status inactive is
+        # link. Re-uploading a link with status `active` when it's still pending or with
+        # status `pending` when it's already active will have no effect: the status will
+        # remain unchanged. Re-uploading a link with deprecated status `inactive` is
         # equivalent to not submitting the link at all and will delete the link if it
         # was active or cancel the link request if it was pending.
+        # Acceptable values are:
+        # - "`active`"
+        # - "`pending`"
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -273,6 +276,9 @@ module Google
         attr_accessor :gmb_email
       
         # Status of the link between this Merchant Center account and the GMB account.
+        # Acceptable values are:
+        # - "`active`"
+        # - "`pending`"
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -334,8 +340,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2::AccountStatusDataQualityIssue>]
         attr_accessor :data_quality_issues
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # accountStatus".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # accountStatus`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -397,6 +403,10 @@ module Google
         attr_accessor :id
       
         # Severity of the issue.
+        # Acceptable values are:
+        # - "`critical`"
+        # - "`error`"
+        # - "`suggestion`"
         # Corresponds to the JSON property `severity`
         # @return [String]
         attr_accessor :severity
@@ -471,7 +481,10 @@ module Google
         # @return [Fixnum]
         attr_accessor :num_items
       
-        # 
+        # Acceptable values are:
+        # - "`critical`"
+        # - "`error`"
+        # - "`suggestion`"
         # Corresponds to the JSON property `severity`
         # @return [String]
         attr_accessor :severity
@@ -610,6 +623,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The channel the data applies to.
+        # Acceptable values are:
+        # - "`local`"
+        # - "`online`"
         # Corresponds to the JSON property `channel`
         # @return [String]
         attr_accessor :channel
@@ -689,7 +705,7 @@ module Google
       class AccountTax
         include Google::Apis::Core::Hashable
       
-        # The ID of the account to which these account tax settings belong.
+        # Required. The ID of the account to which these account tax settings belong.
         # Corresponds to the JSON property `accountId`
         # @return [Fixnum]
         attr_accessor :account_id
@@ -727,8 +743,8 @@ module Google
         # @return [String]
         attr_accessor :country
       
-        # State (or province) is which the tax is applicable, described by its location
-        # ID (also called criteria ID).
+        # Required. State (or province) is which the tax is applicable, described by its
+        # location ID (also called criteria ID).
         # Corresponds to the JSON property `locationId`
         # @return [Fixnum]
         attr_accessor :location_id
@@ -823,11 +839,11 @@ module Google
       
         # Status of the link between this Merchant Center account and the YouTube
         # channel. Upon retrieval, it represents the actual status of the link and can
-        # be either active if it was approved in YT Creator Studio or pending if it's
-        # pending approval. Upon insertion, it represents the intended status of the
-        # link. Re-uploading a link with status active when it's still pending or with
-        # status pending when it's already active will have no effect: the status will
-        # remain unchanged. Re-uploading a link with deprecated status inactive is
+        # be either `active` if it was approved in YT Creator Studio or `pending` if it'
+        # s pending approval. Upon insertion, it represents the intended status of the
+        # link. Re-uploading a link with status `active` when it's still pending or with
+        # status `pending` when it's already active will have no effect: the status will
+        # remain unchanged. Re-uploading a link with deprecated status `inactive` is
         # equivalent to not submitting the link at all and will delete the link if it
         # was active or cancel the link request if it was pending.
         # Corresponds to the JSON property `status`
@@ -919,13 +935,13 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Account data. After the creation of a new account it may take a few minutes
-        # before it is fully operational. The methods delete, insert, patch, and update
-        # require the admin role.
+        # before it is fully operational. The methods delete, insert, and update require
+        # the admin role.
         # Corresponds to the JSON property `account`
         # @return [Google::Apis::ContentV2::Account]
         attr_accessor :account
       
-        # The ID of the targeted account. Only defined if the method is not insert.
+        # The ID of the targeted account. Only defined if the method is not `insert`.
         # Corresponds to the JSON property `accountId`
         # @return [Fixnum]
         attr_accessor :account_id
@@ -936,13 +952,13 @@ module Google
         attr_accessor :batch_id
       
         # Whether the account should be deleted if the account has offers. Only
-        # applicable if the method is delete.
+        # applicable if the method is `delete`.
         # Corresponds to the JSON property `force`
         # @return [Boolean]
         attr_accessor :force
         alias_method :force?, :force
       
-        # Details about the link request.
+        # Details about the `link` request.
         # Corresponds to the JSON property `linkRequest`
         # @return [Google::Apis::ContentV2::AccountsCustomBatchRequestEntryLinkRequest]
         attr_accessor :link_request
@@ -953,11 +969,18 @@ module Google
         attr_accessor :merchant_id
       
         # The method of the batch entry.
+        # Acceptable values are:
+        # - "`claimWebsite`"
+        # - "`delete`"
+        # - "`get`"
+        # - "`insert`"
+        # - "`link`"
+        # - "`update`"
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :request_method
       
-        # Only applicable if the method is claimwebsite. Indicates whether or not to
+        # Only applicable if the method is `claimwebsite`. Indicates whether or not to
         # take the claim from another account in case there is a conflict.
         # Corresponds to the JSON property `overwrite`
         # @return [Boolean]
@@ -985,13 +1008,20 @@ module Google
       class AccountsCustomBatchRequestEntryLinkRequest
         include Google::Apis::Core::Hashable
       
-        # Action to perform for this link. The "request" action is only available to
+        # Action to perform for this link. The `"request"` action is only available to
         # select merchants.
+        # Acceptable values are:
+        # - "`approve`"
+        # - "`remove`"
+        # - "`request`"
         # Corresponds to the JSON property `action`
         # @return [String]
         attr_accessor :action
       
         # Type of the link between the two accounts.
+        # Acceptable values are:
+        # - "`channelPartner`"
+        # - "`eCommercePlatform`"
         # Corresponds to the JSON property `linkType`
         # @return [String]
         attr_accessor :link_type
@@ -1044,8 +1074,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Account data. After the creation of a new account it may take a few minutes
-        # before it is fully operational. The methods delete, insert, patch, and update
-        # require the admin role.
+        # before it is fully operational. The methods delete, insert, and update require
+        # the admin role.
         # Corresponds to the JSON property `account`
         # @return [Google::Apis::ContentV2::Account]
         attr_accessor :account
@@ -1060,13 +1090,17 @@ module Google
         # @return [Google::Apis::ContentV2::Errors]
         attr_accessor :errors
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # accountsCustomBatchResponseEntry".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # accountsCustomBatchResponseEntry`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
         # Deprecated. This field is never set.
+        # Acceptable values are:
+        # - "`active`"
+        # - "`inactive`"
+        # - "`pending`"
         # Corresponds to the JSON property `linkStatus`
         # @return [String]
         attr_accessor :link_status
@@ -1089,13 +1123,20 @@ module Google
       class AccountsLinkRequest
         include Google::Apis::Core::Hashable
       
-        # Action to perform for this link. The "request" action is only available to
+        # Action to perform for this link. The `"request"` action is only available to
         # select merchants.
+        # Acceptable values are:
+        # - "`approve`"
+        # - "`remove`"
+        # - "`request`"
         # Corresponds to the JSON property `action`
         # @return [String]
         attr_accessor :action
       
         # Type of the link between the two accounts.
+        # Acceptable values are:
+        # - "`channelPartner`"
+        # - "`eCommercePlatform`"
         # Corresponds to the JSON property `linkType`
         # @return [String]
         attr_accessor :link_type
@@ -1213,7 +1254,9 @@ module Google
         # @return [Fixnum]
         attr_accessor :merchant_id
       
-        # The method (get).
+        # The method of the batch entry.
+        # Acceptable values are:
+        # - "`get`"
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :request_method
@@ -1365,7 +1408,10 @@ module Google
         # @return [Fixnum]
         attr_accessor :merchant_id
       
-        # 
+        # The method of the batch entry.
+        # Acceptable values are:
+        # - "`get`"
+        # - "`update`"
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :request_method
@@ -1429,8 +1475,8 @@ module Google
         # @return [Google::Apis::ContentV2::Errors]
         attr_accessor :errors
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # accounttaxCustomBatchResponseEntry".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # accounttaxCustomBatchResponseEntry`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1528,21 +1574,22 @@ module Google
       class CarrierRate
         include Google::Apis::Core::Hashable
       
-        # Carrier service, such as "UPS" or "Fedex". The list of supported carriers can
-        # be retrieved via the getSupportedCarriers method. Required.
+        # Carrier service, such as `"UPS"` or `"Fedex"`. The list of supported carriers
+        # can be retrieved via the `getSupportedCarriers` method. Required.
         # Corresponds to the JSON property `carrierName`
         # @return [String]
         attr_accessor :carrier_name
       
-        # Carrier service, such as "ground" or "2 days". The list of supported services
-        # for a carrier can be retrieved via the getSupportedCarriers method. Required.
+        # Carrier service, such as `"ground"` or `"2 days"`. The list of supported
+        # services for a carrier can be retrieved via the `getSupportedCarriers` method.
+        # Required.
         # Corresponds to the JSON property `carrierService`
         # @return [String]
         attr_accessor :carrier_service
       
-        # Additive shipping rate modifier. Can be negative. For example ` "value": "1", "
-        # currency" : "USD" ` adds $1 to the rate, ` "value": "-3", "currency" : "USD" `
-        # removes $3 from the rate. Optional.
+        # Additive shipping rate modifier. Can be negative. For example `` "value": "1",
+        # "currency" : "USD" `` adds $1 to the rate, `` "value": "-3", "currency" : "USD"
+        # `` removes $3 from the rate. Optional.
         # Corresponds to the JSON property `flatAdjustment`
         # @return [Google::Apis::ContentV2::Price]
         attr_accessor :flat_adjustment
@@ -1558,7 +1605,7 @@ module Google
         attr_accessor :origin_postal_code
       
         # Multiplicative shipping rate modifier as a number in decimal notation. Can be
-        # negative. For example "5.4" increases the rate by 5.4%, "-3" decreases the
+        # negative. For example `"5.4"` increases the rate by 5.4%, `"-3"` decreases the
         # rate by 3%. Optional.
         # Corresponds to the JSON property `percentageAdjustment`
         # @return [String]
@@ -1588,12 +1635,12 @@ module Google
         # @return [String]
         attr_accessor :country
       
-        # The name of the carrier (e.g., "UPS"). Always present.
+        # The name of the carrier (e.g., `"UPS"`). Always present.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # A list of supported services (e.g., "ground") for that carrier. Contains at
+        # A list of supported services (e.g., `"ground"`) for that carrier. Contains at
         # least one service.
         # Corresponds to the JSON property `services`
         # @return [Array<String>]
@@ -1622,6 +1669,16 @@ module Google
         attr_accessor :name
       
         # The type of the attribute.
+        # Acceptable values are:
+        # - "`boolean`"
+        # - "`datetimerange`"
+        # - "`float`"
+        # - "`group`"
+        # - "`int`"
+        # - "`price`"
+        # - "`text`"
+        # - "`time`"
+        # - "`url`"
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -1679,12 +1736,27 @@ module Google
       class CustomerReturnReason
         include Google::Apis::Core::Hashable
       
-        # 
+        # Description of the reason.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # 
+        # Code of the return reason.
+        # Acceptable values are:
+        # - "`betterPriceFound`"
+        # - "`changedMind`"
+        # - "`damagedOrDefectiveItem`"
+        # - "`didNotMatchDescription`"
+        # - "`doesNotFit`"
+        # - "`expiredItem`"
+        # - "`incorrectItemReceived`"
+        # - "`noLongerNeeded`"
+        # - "`notSpecified`"
+        # - "`orderedWrongItem`"
+        # - "`other`"
+        # - "`qualityNotExpected`"
+        # - "`receivedTooLate`"
+        # - "`undeliverable`"
         # Corresponds to the JSON property `reasonCode`
         # @return [String]
         attr_accessor :reason_code
@@ -1745,13 +1817,18 @@ module Google
         attr_accessor :attribute_language
       
         # [DEPRECATED] Please use targets[].language instead. The two-letter ISO 639-1
-        # language of the items in the feed. Must be a valid language for targetCountry.
+        # language of the items in the feed. Must be a valid language for `targetCountry`
+        # .
         # Corresponds to the JSON property `contentLanguage`
         # @return [String]
         attr_accessor :content_language
       
-        # The type of data feed. For product inventory feeds, only feeds for local
-        # stores, not online stores, are supported.
+        # Required. The type of data feed. For product inventory feeds, only feeds for
+        # local stores, not online stores, are supported.
+        # Acceptable values are:
+        # - "`local products`"
+        # - "`product inventory`"
+        # - "`products`"
         # Corresponds to the JSON property `contentType`
         # @return [String]
         attr_accessor :content_type
@@ -1764,7 +1841,7 @@ module Google
         # @return [Google::Apis::ContentV2::DatafeedFetchSchedule]
         attr_accessor :fetch_schedule
       
-        # The filename of the feed. All feeds must have a unique file name.
+        # Required. The filename of the feed. All feeds must have a unique file name.
         # Corresponds to the JSON property `fileName`
         # @return [String]
         attr_accessor :file_name
@@ -1774,24 +1851,24 @@ module Google
         # @return [Google::Apis::ContentV2::DatafeedFormat]
         attr_accessor :format
       
-        # The ID of the data feed.
+        # Required for update. The ID of the data feed.
         # Corresponds to the JSON property `id`
         # @return [Fixnum]
         attr_accessor :id
       
-        # [DEPRECATED] Please use targets[].includedDestinations instead. The list of
+        # [DEPRECATED] Please use  targets[].includedDestinations instead. The list of
         # intended destinations (corresponds to checked check boxes in Merchant Center).
         # Corresponds to the JSON property `intendedDestinations`
         # @return [Array<String>]
         attr_accessor :intended_destinations
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # datafeed".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # datafeed`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # A descriptive name of the data feed.
+        # Required for insert. A descriptive name of the data feed.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1881,6 +1958,14 @@ module Google
         attr_accessor :username
       
         # The day of the week the feed file should be fetched.
+        # Acceptable values are:
+        # - "`monday`"
+        # - "`tuesday`"
+        # - "`wednesday`"
+        # - "`thursday`"
+        # - "`friday`"
+        # - "`saturday`"
+        # - "`sunday`"
         # Corresponds to the JSON property `weekday`
         # @return [String]
         attr_accessor :weekday
@@ -1910,18 +1995,31 @@ module Google
         # Delimiter for the separation of values in a delimiter-separated values feed.
         # If not specified, the delimiter will be auto-detected. Ignored for non-DSV
         # data feeds.
+        # Acceptable values are:
+        # - "`pipe`"
+        # - "`tab`"
+        # - "`tilde`"
         # Corresponds to the JSON property `columnDelimiter`
         # @return [String]
         attr_accessor :column_delimiter
       
         # Character encoding scheme of the data feed. If not specified, the encoding
         # will be auto-detected.
+        # Acceptable values are:
+        # - "`latin-1`"
+        # - "`utf-16be`"
+        # - "`utf-16le`"
+        # - "`utf-8`"
+        # - "`windows-1252`"
         # Corresponds to the JSON property `fileEncoding`
         # @return [String]
         attr_accessor :file_encoding
       
         # Specifies how double quotes are interpreted. If not specified, the mode will
         # be auto-detected. Ignored for non-DSV data feeds.
+        # Acceptable values are:
+        # - "`normal character`"
+        # - "`value quoting`"
         # Corresponds to the JSON property `quotingMode`
         # @return [String]
         attr_accessor :quoting_mode
@@ -1969,8 +2067,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :items_valid
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # datafeedStatus".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # datafeedStatus`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1986,6 +2084,13 @@ module Google
         attr_accessor :last_upload_date
       
         # The processing status of the feed.
+        # Acceptable values are:
+        # - "`"`failure`": The feed could not be processed or all items had errors.`"
+        # - "`in progress`": The feed is being processed.
+        # - "`none`": The feed has not yet been processed. For example, a feed that has
+        # never been uploaded will have this processing status.
+        # - "`success`": The feed was processed successfully, though some items might
+        # have had errors.
         # Corresponds to the JSON property `processingStatus`
         # @return [String]
         attr_accessor :processing_status
@@ -2100,13 +2205,18 @@ module Google
       
         # The list of destinations to include for this target (corresponds to checked
         # check boxes in Merchant Center). Default destinations are always included
-        # unless provided in excludedDestinations.
+        # unless provided in `excludedDestinations`.
+        # List of supported destinations (if available to the account):
+        # - DisplayAds
+        # - Shopping
+        # - ShoppingActions
+        # - SurfacesAcrossGoogle
         # Corresponds to the JSON property `includedDestinations`
         # @return [Array<String>]
         attr_accessor :included_destinations
       
         # The two-letter ISO 639-1 language of the items in the feed. Must be a valid
-        # language for targets[].country.
+        # language for `targets[].country`.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
@@ -2167,7 +2277,13 @@ module Google
         # @return [Fixnum]
         attr_accessor :merchant_id
       
-        # 
+        # The method of the batch entry.
+        # Acceptable values are:
+        # - "`delete`"
+        # - "`fetchNow`"
+        # - "`get`"
+        # - "`insert`"
+        # - "`update`"
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :request_method
@@ -2347,7 +2463,9 @@ module Google
         # @return [Fixnum]
         attr_accessor :merchant_id
       
-        # 
+        # The method of the batch entry.
+        # Acceptable values are:
+        # - "`get`"
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :request_method
@@ -2480,15 +2598,15 @@ module Google
         attr_accessor :holiday_cutoffs
       
         # Maximum number of business days spent before an order is shipped. 0 means same
-        # day shipped, 1 means next day shipped. Must be greater than or equal to
-        # minHandlingTimeInDays.
+        # day shipped, 1 means next day shipped. Must be greater than or equal to `
+        # minHandlingTimeInDays`.
         # Corresponds to the JSON property `maxHandlingTimeInDays`
         # @return [Fixnum]
         attr_accessor :max_handling_time_in_days
       
         # Maximum number of business days that is spent in transit. 0 means same day
-        # delivery, 1 means next day delivery. Must be greater than or equal to
-        # minTransitTimeInDays.
+        # delivery, 1 means next day delivery. Must be greater than or equal to `
+        # minTransitTimeInDays`.
         # Corresponds to the JSON property `maxTransitTimeInDays`
         # @return [Fixnum]
         attr_accessor :max_transit_time_in_days
@@ -2500,8 +2618,8 @@ module Google
         attr_accessor :min_handling_time_in_days
       
         # Minimum number of business days that is spent in transit. 0 means same day
-        # delivery, 1 means next day delivery. Either `min,max`TransitTimeInDays or
-        # transitTimeTable must be set, but not both.
+        # delivery, 1 means next day delivery. Either ``min,max`TransitTimeInDays` or `
+        # transitTimeTable` must be set, but not both.
         # Corresponds to the JSON property `minTransitTimeInDays`
         # @return [Fixnum]
         attr_accessor :min_transit_time_in_days
@@ -2513,8 +2631,8 @@ module Google
         attr_accessor :transit_business_day_config
       
         # Transit time table, number of business days spent in transit based on row and
-        # column dimensions. Either `min,max`TransitTimeInDays or transitTimeTable can
-        # be set, but not both.
+        # column dimensions. Either ``min,max`TransitTimeInDays` or `transitTimeTable`
+        # can be set, but not both.
         # Corresponds to the JSON property `transitTimeTable`
         # @return [Google::Apis::ContentV2::TransitTable]
         attr_accessor :transit_time_table
@@ -2572,7 +2690,7 @@ module Google
       class Errors
         include Google::Apis::Core::Hashable
       
-        # The HTTP status of the first error in errors.
+        # The HTTP status of the first error in `errors`.
         # Corresponds to the JSON property `code`
         # @return [Fixnum]
         attr_accessor :code
@@ -2582,7 +2700,7 @@ module Google
         # @return [Array<Google::Apis::ContentV2::Error>]
         attr_accessor :errors
       
-        # The message of the first error in errors.
+        # The message of the first error in `errors`.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
@@ -2603,7 +2721,7 @@ module Google
       class GmbAccounts
         include Google::Apis::Core::Hashable
       
-        # The ID of the account.
+        # The ID of the Merchant Center account.
         # Corresponds to the JSON property `accountId`
         # @return [Fixnum]
         attr_accessor :account_id
@@ -2661,8 +2779,8 @@ module Google
         end
       end
       
-      # A non-empty list of row or column headers for a table. Exactly one of prices,
-      # weights, numItems, postalCodeGroupNames, or location must be set.
+      # A non-empty list of row or column headers for a table. Exactly one of `prices`,
+      # `weights`, `numItems`, `postalCodeGroupNames`, or `location` must be set.
       class Headers
         include Google::Apis::Core::Hashable
       
@@ -2672,36 +2790,36 @@ module Google
         # @return [Array<Google::Apis::ContentV2::LocationIdSet>]
         attr_accessor :locations
       
-        # A list of inclusive number of items upper bounds. The last value can be "
-        # infinity". For example ["10", "50", "infinity"] represents the headers "<= 10
-        # items", " 50 items". Must be non-empty. Can only be set if all other fields
+        # A list of inclusive number of items upper bounds. The last value can be `"
+        # infinity"`. For example `["10", "50", "infinity"]` represents the headers "<=
+        # 10 items", " 50 items". Must be non-empty. Can only be set if all other fields
         # are not set.
         # Corresponds to the JSON property `numberOfItems`
         # @return [Array<String>]
         attr_accessor :number_of_items
       
-        # A list of postal group names. The last value can be "all other locations".
-        # Example: ["zone 1", "zone 2", "all other locations"]. The referred postal code
-        # groups must match the delivery country of the service. Must be non-empty. Can
-        # only be set if all other fields are not set.
+        # A list of postal group names. The last value can be `"all other locations"`.
+        # Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal
+        # code groups must match the delivery country of the service. Must be non-empty.
+        # Can only be set if all other fields are not set.
         # Corresponds to the JSON property `postalCodeGroupNames`
         # @return [Array<String>]
         attr_accessor :postal_code_group_names
       
-        # A list of inclusive order price upper bounds. The last price's value can be "
-        # infinity". For example [`"value": "10", "currency": "USD"`, `"value": "500", "
-        # currency": "USD"`, `"value": "infinity", "currency": "USD"`] represents the
+        # A list of inclusive order price upper bounds. The last price's value can be `"
+        # infinity"`. For example `[`"value": "10", "currency": "USD"`, `"value": "500",
+        # "currency": "USD"`, `"value": "infinity", "currency": "USD"`]` represents the
         # headers "<= $10", " $500". All prices within a service must have the same
         # currency. Must be non-empty. Can only be set if all other fields are not set.
         # Corresponds to the JSON property `prices`
         # @return [Array<Google::Apis::ContentV2::Price>]
         attr_accessor :prices
       
-        # A list of inclusive order weight upper bounds. The last weight's value can be "
-        # infinity". For example [`"value": "10", "unit": "kg"`, `"value": "50", "unit":
-        # "kg"`, `"value": "infinity", "unit": "kg"`] represents the headers "<= 10kg", "
-        # 50kg". All weights within a service must have the same unit. Must be non-
-        # empty. Can only be set if all other fields are not set.
+        # A list of inclusive order weight upper bounds. The last weight's value can be `
+        # "infinity"`. For example `[`"value": "10", "unit": "kg"`, `"value": "50", "
+        # unit": "kg"`, `"value": "infinity", "unit": "kg"`]` represents the headers "<=
+        # 10kg", " 50kg". All weights within a service must have the same unit. Must be
+        # non-empty. Can only be set if all other fields are not set.
         # Corresponds to the JSON property `weights`
         # @return [Array<Google::Apis::ContentV2::Weight>]
         attr_accessor :weights
@@ -2805,6 +2923,15 @@ module Google
         attr_accessor :id
       
         # The holiday type. Always present.
+        # Acceptable values are:
+        # - "`Christmas`"
+        # - "`Easter`"
+        # - "`Father's Day`"
+        # - "`Halloween`"
+        # - "`Independence Day (USA)`"
+        # - "`Mother's Day`"
+        # - "`Thanksgiving`"
+        # - "`Valentine's Day`"
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -2849,11 +2976,15 @@ module Google
         end
       end
       
-      # 
+      # (== resource_for v2.inventory ==)
       class Inventory
         include Google::Apis::Core::Hashable
       
         # The availability of the product.
+        # Acceptable values are:
+        # - "`in stock`"
+        # - "`out of stock`"
+        # - "`preorder`"
         # Corresponds to the JSON property `availability`
         # @return [String]
         attr_accessor :availability
@@ -2898,8 +3029,8 @@ module Google
         # @return [String]
         attr_accessor :instore_product_location
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # inventory".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # inventory`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2909,10 +3040,10 @@ module Google
         # @return [Google::Apis::ContentV2::LoyaltyPoints]
         attr_accessor :loyalty_points
       
-        # Store pickup information. Only supported for local inventory. Not setting
-        # pickup means "don't update" while setting it to the empty value (`` in JSON)
-        # means "delete". Otherwise, pickupMethod and pickupSla must be set together,
-        # unless pickupMethod is "not supported".
+        # Store pickup information. Only supported for local inventory. Not setting `
+        # pickup` means "don't update" while setting it to the empty value (```` in JSON)
+        # means "delete". Otherwise, `pickupMethod` and `pickupSla` must be set
+        # together, unless `pickupMethod` is "not supported".
         # Corresponds to the JSON property `pickup`
         # @return [Google::Apis::ContentV2::InventoryPickup]
         attr_accessor :pickup
@@ -2928,7 +3059,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :quantity
       
-        # The sale price of the product. Mandatory if sale_price_effective_date is
+        # The sale price of the product. Mandatory if `sale_price_effective_date` is
         # defined.
         # Corresponds to the JSON property `salePrice`
         # @return [Google::Apis::ContentV2::Price]
@@ -2999,7 +3130,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :batch_id
       
-        # Price and availability of the product.
+        # (== resource_for v2.inventory ==)
         # Corresponds to the JSON property `inventory`
         # @return [Google::Apis::ContentV2::Inventory]
         attr_accessor :inventory
@@ -3014,7 +3145,7 @@ module Google
         # @return [String]
         attr_accessor :product_id
       
-        # The code of the store for which to update price and availability. Use online
+        # The code of the store for which to update price and availability. Use `online`
         # to update price and availability of an online product.
         # Corresponds to the JSON property `storeCode`
         # @return [String]
@@ -3074,8 +3205,8 @@ module Google
         # @return [Google::Apis::ContentV2::Errors]
         attr_accessor :errors
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # inventoryCustomBatchResponseEntry".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # inventoryCustomBatchResponseEntry`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3099,14 +3230,30 @@ module Google
         # Whether store pickup is available for this offer and whether the pickup option
         # should be shown as buy, reserve, or not supported. Only supported for local
         # inventory. Unless the value is "not supported", must be submitted together
-        # with pickupSla.
+        # with `pickupSla`.
+        # Acceptable values are:
+        # - "`buy`"
+        # - "`not supported`"
+        # - "`reserve`"
+        # - "`ship to store`"
         # Corresponds to the JSON property `pickupMethod`
         # @return [String]
         attr_accessor :pickup_method
       
         # The expected date that an order will be ready for pickup, relative to when the
         # order is placed. Only supported for local inventory. Must be submitted
-        # together with pickupMethod.
+        # together with `pickupMethod`.
+        # Acceptable values are:
+        # - "`five day`"
+        # - "`four day`"
+        # - "`multi day`"
+        # - "`multi week`"
+        # - "`next day`"
+        # - "`same day`"
+        # - "`seven day`"
+        # - "`six day`"
+        # - "`three day`"
+        # - "`two day`"
         # Corresponds to the JSON property `pickupSla`
         # @return [String]
         attr_accessor :pickup_sla
@@ -3127,6 +3274,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The availability of the product.
+        # Acceptable values are:
+        # - "`in stock`"
+        # - "`out of stock`"
+        # - "`preorder`"
         # Corresponds to the JSON property `availability`
         # @return [String]
         attr_accessor :availability
@@ -3176,10 +3327,10 @@ module Google
         # @return [Google::Apis::ContentV2::LoyaltyPoints]
         attr_accessor :loyalty_points
       
-        # Store pickup information. Only supported for local inventory. Not setting
-        # pickup means "don't update" while setting it to the empty value (`` in JSON)
-        # means "delete". Otherwise, pickupMethod and pickupSla must be set together,
-        # unless pickupMethod is "not supported".
+        # Store pickup information. Only supported for local inventory. Not setting `
+        # pickup` means "don't update" while setting it to the empty value (```` in JSON)
+        # means "delete". Otherwise, `pickupMethod` and `pickupSla` must be set
+        # together, unless `pickupMethod` is "not supported".
         # Corresponds to the JSON property `pickup`
         # @return [Google::Apis::ContentV2::InventoryPickup]
         attr_accessor :pickup
@@ -3195,7 +3346,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :quantity
       
-        # The sale price of the product. Mandatory if sale_price_effective_date is
+        # The sale price of the product. Mandatory if `sale_price_effective_date` is
         # defined.
         # Corresponds to the JSON property `salePrice`
         # @return [Google::Apis::ContentV2::Price]
@@ -3316,6 +3467,8 @@ module Google
         attr_accessor :total_amount
       
         # [required] Type of the additional charge.
+        # Acceptable values are:
+        # - "`shipping`"
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -3336,6 +3489,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The status of the verification process for the About page.
+        # Acceptable values are:
+        # - "`active`"
+        # - "`inactive`"
+        # - "`pending`"
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -3365,7 +3522,7 @@ module Google
         # @return [Google::Apis::ContentV2::LiaAboutPageSettings]
         attr_accessor :about
       
-        # CLDR country code (e.g. "US").
+        # Required. CLDR country code (e.g. "US").
         # Corresponds to the JSON property `country`
         # @return [String]
         attr_accessor :country
@@ -3428,11 +3585,19 @@ module Google
         attr_accessor :inventory_verification_contact_name
       
         # The status of the verification contact.
+        # Acceptable values are:
+        # - "`active`"
+        # - "`inactive`"
+        # - "`pending`"
         # Corresponds to the JSON property `inventoryVerificationContactStatus`
         # @return [String]
         attr_accessor :inventory_verification_contact_status
       
         # The status of the inventory verification process.
+        # Acceptable values are:
+        # - "`active`"
+        # - "`inactive`"
+        # - "`pending`"
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -3460,6 +3625,10 @@ module Google
         attr_accessor :shipping_cost_policy_url
       
         # The status of the ?On display to order? feature.
+        # Acceptable values are:
+        # - "`active`"
+        # - "`inactive`"
+        # - "`pending`"
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -3516,8 +3685,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2::LiaCountrySettings>]
         attr_accessor :country_settings
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # liaSettings".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # liaSettings`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3557,7 +3726,7 @@ module Google
       class LiasettingsCustomBatchRequestEntry
         include Google::Apis::Core::Hashable
       
-        # The ID of the account for which to get/update account shipping settings.
+        # The ID of the account for which to get/update account LIA settings.
         # Corresponds to the JSON property `accountId`
         # @return [Fixnum]
         attr_accessor :account_id
@@ -3600,7 +3769,14 @@ module Google
         # @return [Fixnum]
         attr_accessor :merchant_id
       
-        # 
+        # The method of the batch entry.
+        # Acceptable values are:
+        # - "`get`"
+        # - "`getAccessibleGmbAccounts`"
+        # - "`requestGmbAccess`"
+        # - "`requestInventoryVerification`"
+        # - "`setInventoryVerificationContact`"
+        # - "`update`"
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :method_prop
@@ -3680,8 +3856,8 @@ module Google
         # @return [Google::Apis::ContentV2::GmbAccounts]
         attr_accessor :gmb_accounts
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # liasettingsCustomBatchResponseEntry".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # liasettingsCustomBatchResponseEntry`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3716,7 +3892,7 @@ module Google
       class LiasettingsGetAccessibleGmbAccountsResponse
         include Google::Apis::Core::Hashable
       
-        # The ID of the account.
+        # The ID of the Merchant Center account.
         # Corresponds to the JSON property `accountId`
         # @return [Fixnum]
         attr_accessor :account_id
@@ -3935,36 +4111,37 @@ module Google
         end
       end
       
-      # 
+      # Order return. Production access (all methods) requires the order manager role.
+      # Sandbox access does not.
       class MerchantOrderReturn
         include Google::Apis::Core::Hashable
       
-        # 
+        # The date of creation of the return, in ISO 8601 format.
         # Corresponds to the JSON property `creationDate`
         # @return [String]
         attr_accessor :creation_date
       
-        # 
+        # Merchant defined order ID.
         # Corresponds to the JSON property `merchantOrderId`
         # @return [String]
         attr_accessor :merchant_order_id
       
-        # 
+        # Google order ID.
         # Corresponds to the JSON property `orderId`
         # @return [String]
         attr_accessor :order_id
       
-        # 
+        # Order return ID generated by Google.
         # Corresponds to the JSON property `orderReturnId`
         # @return [String]
         attr_accessor :order_return_id
       
-        # 
+        # Items of the return.
         # Corresponds to the JSON property `returnItems`
         # @return [Array<Google::Apis::ContentV2::MerchantOrderReturnItem>]
         attr_accessor :return_items
       
-        # 
+        # Shipments of the return.
         # Corresponds to the JSON property `returnShipments`
         # @return [Array<Google::Apis::ContentV2::ReturnShipment>]
         attr_accessor :return_shipments
@@ -3988,32 +4165,39 @@ module Google
       class MerchantOrderReturnItem
         include Google::Apis::Core::Hashable
       
-        # 
+        # The reason that the customer chooses to return an item.
         # Corresponds to the JSON property `customerReturnReason`
         # @return [Google::Apis::ContentV2::CustomerReturnReason]
         attr_accessor :customer_return_reason
       
-        # 
+        # Product level item ID. If the returned items are of the same product, they
+        # will have the same ID.
         # Corresponds to the JSON property `itemId`
         # @return [String]
         attr_accessor :item_id
       
-        # 
+        # The reason that merchant chooses to accept a return item.
         # Corresponds to the JSON property `merchantReturnReason`
         # @return [Google::Apis::ContentV2::RefundReason]
         attr_accessor :merchant_return_reason
       
-        # 
+        # Product data from the time of the order placement.
         # Corresponds to the JSON property `product`
         # @return [Google::Apis::ContentV2::OrderLineItemProduct]
         attr_accessor :product
       
-        # 
+        # IDs of the return shipments that this return item belongs to.
         # Corresponds to the JSON property `returnShipmentIds`
         # @return [Array<String>]
         attr_accessor :return_shipment_ids
       
-        # 
+        # State of the item.
+        # Acceptable values are:
+        # - "`canceled`"
+        # - "`new`"
+        # - "`received`"
+        # - "`refunded`"
+        # - "`rejected`"
         # Corresponds to the JSON property `state`
         # @return [String]
         attr_accessor :state
@@ -4033,7 +4217,56 @@ module Google
         end
       end
       
-      # Order. All methods require the order manager role.
+      # 
+      class MinimumOrderValueTable
+        include Google::Apis::Core::Hashable
+      
+        # 
+        # Corresponds to the JSON property `storeCodeSetWithMovs`
+        # @return [Array<Google::Apis::ContentV2::MinimumOrderValueTableStoreCodeSetWithMov>]
+        attr_accessor :store_code_set_with_movs
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @store_code_set_with_movs = args[:store_code_set_with_movs] if args.key?(:store_code_set_with_movs)
+        end
+      end
+      
+      # A list of store code sets sharing the same minimum order value. At least two
+      # sets are required and the last one must be empty, which signifies 'MOV for all
+      # other stores'. Each store code can only appear once across all the sets. All
+      # prices within a service must have the same currency.
+      class MinimumOrderValueTableStoreCodeSetWithMov
+        include Google::Apis::Core::Hashable
+      
+        # A list of unique store codes or empty for the catch all.
+        # Corresponds to the JSON property `storeCodes`
+        # @return [Array<String>]
+        attr_accessor :store_codes
+      
+        # The minimum order value for the given stores.
+        # Corresponds to the JSON property `value`
+        # @return [Google::Apis::ContentV2::Price]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @store_codes = args[:store_codes] if args.key?(:store_codes)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
+      # Order. Production access (all methods) requires the order manager role.
+      # Sandbox access does not. (== resource_for v2.orders ==) (== resource_for v2.1.
+      # orders ==)
       class Order
         include Google::Apis::Core::Hashable
       
@@ -4044,6 +4277,9 @@ module Google
         alias_method :acknowledged?, :acknowledged
       
         # Deprecated.
+        # Acceptable values are:
+        # - "`googleExpress`"
+        # - "`purchasesOnGoogle`"
         # Corresponds to the JSON property `channelType`
         # @return [String]
         attr_accessor :channel_type
@@ -4053,7 +4289,7 @@ module Google
         # @return [Google::Apis::ContentV2::OrderCustomer]
         attr_accessor :customer
       
-        # Delivery details for shipments of type delivery.
+        # Delivery details for shipments of type `delivery`.
         # Corresponds to the JSON property `deliveryDetails`
         # @return [Google::Apis::ContentV2::OrderDeliveryDetails]
         attr_accessor :delivery_details
@@ -4063,8 +4299,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # order".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # order`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -4097,11 +4333,16 @@ module Google
         attr_accessor :payment_method
       
         # The status of the payment.
+        # Acceptable values are:
+        # - "`paymentCaptured`"
+        # - "`paymentRejected`"
+        # - "`paymentSecured`"
+        # - "`pendingAuthorization`"
         # Corresponds to the JSON property `paymentStatus`
         # @return [String]
         attr_accessor :payment_status
       
-        # Pickup details for shipments of type pickup.
+        # Pickup details for shipments of type `pickup`.
         # Corresponds to the JSON property `pickupDetails`
         # @return [Google::Apis::ContentV2::OrderPickupDetails]
         attr_accessor :pickup_details
@@ -4111,8 +4352,24 @@ module Google
         # @return [String]
         attr_accessor :placed_date
       
-        # The details of the merchant provided promotions applied to the order. More
-        # details about the program are here.
+        # The details of the merchant provided promotions applied to the order.
+        # To determine which promotions apply to which products, check the `Promotions[].
+        # Benefits[].OfferIds` field against the `LineItems[].Product.OfferId` field for
+        # each promotion. If a promotion is applied to more than 1 `offerId`, divide the
+        # discount value by the number of affected offers to determine how much discount
+        # to apply to each `offerId`.
+        # Examples:
+        # - To calculate the line item level discount for a single specific item: For
+        # each promotion, subtract the `Promotions[].Benefits[].Discount.value` amount
+        # from the `LineItems[].Price.value`.
+        # - To calculate the line item level discount for multiple quantity of a
+        # specific item: For each promotion, divide the `Promotions[].Benefits[].
+        # Discount.value` by the quantity of products and substract it from `LineItems[].
+        # Product.Price.value` for each quantity item.
+        # Only 1 promotion can be applied to an offerId in a given order. To refund an
+        # item which had a promotion applied to it, make sure to refund the amount after
+        # first subtracting the promotion discount from the item price.
+        # More details about the program are here.
         # Corresponds to the JSON property `promotions`
         # @return [Array<Google::Apis::ContentV2::OrderLegacyPromotion>]
         attr_accessor :promotions
@@ -4138,16 +4395,36 @@ module Google
         attr_accessor :shipping_cost_tax
       
         # Deprecated. Shipping details are provided with line items instead.
+        # Acceptable values are:
+        # - "`economy`"
+        # - "`expedited`"
+        # - "`oneDay`"
+        # - "`sameDay`"
+        # - "`standard`"
+        # - "`twoDay`"
         # Corresponds to the JSON property `shippingOption`
         # @return [String]
         attr_accessor :shipping_option
       
         # The status of the order.
+        # Acceptable values are:
+        # - "`canceled`"
+        # - "`delivered`"
+        # - "`inProgress`"
+        # - "`partiallyDelivered`"
+        # - "`partiallyReturned`"
+        # - "`partiallyShipped`"
+        # - "`pendingShipment`"
+        # - "`returned`"
+        # - "`shipped`"
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
       
         # The party responsible for collecting and remitting taxes.
+        # Acceptable values are:
+        # - "`marketplaceFacilitator`"
+        # - "`merchant`"
         # Corresponds to the JSON property `taxCollector`
         # @return [String]
         attr_accessor :tax_collector
@@ -4257,6 +4534,13 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The actor that created the cancellation.
+        # Acceptable values are:
+        # - "`customer`"
+        # - "`googleBot`"
+        # - "`googleCustomerService`"
+        # - "`googlePayments`"
+        # - "`googleSabre`"
+        # - "`merchant`"
         # Corresponds to the JSON property `actor`
         # @return [String]
         attr_accessor :actor
@@ -4271,9 +4555,38 @@ module Google
         # @return [Fixnum]
         attr_accessor :quantity
       
-        # The reason for the cancellation. Orders that are cancelled with a noInventory
+        # The reason for the cancellation. Orders that are canceled with a noInventory
         # reason will lead to the removal of the product from Shopping Actions until you
         # make an update to that product. This will not affect your Shopping ads.
+        # Acceptable values are:
+        # - "`autoPostInternal`"
+        # - "`autoPostInvalidBillingAddress`"
+        # - "`autoPostNoInventory`"
+        # - "`autoPostPriceError`"
+        # - "`autoPostUndeliverableShippingAddress`"
+        # - "`couponAbuse`"
+        # - "`customerCanceled`"
+        # - "`customerInitiatedCancel`"
+        # - "`customerSupportRequested`"
+        # - "`failToPushOrderGoogleError`"
+        # - "`failToPushOrderMerchantError`"
+        # - "`failToPushOrderMerchantFulfillmentError`"
+        # - "`failToPushOrderToMerchant`"
+        # - "`failToPushOrderToMerchantOutOfStock`"
+        # - "`invalidCoupon`"
+        # - "`malformedShippingAddress`"
+        # - "`merchantDidNotShipOnTime`"
+        # - "`noInventory`"
+        # - "`orderTimeout`"
+        # - "`other`"
+        # - "`paymentAbuse`"
+        # - "`paymentDeclined`"
+        # - "`priceError`"
+        # - "`returnRefundAbuse`"
+        # - "`shippingPriceError`"
+        # - "`taxError`"
+        # - "`undeliverableShippingAddress`"
+        # - "`unsupportedPoBoxAddress`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -4317,8 +4630,10 @@ module Google
         # @return [String]
         attr_accessor :full_name
       
-        # Email address for receiving merchant issued value-added tax or invoice
-        # documentation of this order.
+        # Email address for the merchant to send value-added tax or invoice
+        # documentation of the order. Only the last document sent is made available to
+        # the customer. For more information, see  About automated VAT invoicing for
+        # Shopping Actions.
         # Corresponds to the JSON property `invoiceReceivingEmail`
         # @return [String]
         attr_accessor :invoice_receiving_email
@@ -4351,9 +4666,12 @@ module Google
       
         # Last known customer selection regarding marketing preferences. In certain
         # cases this selection might not be known, so this field would be empty. If a
-        # customer selected granted in their most recent order, they can be subscribed
-        # to marketing emails. Customers who have chosen denied must not be subscribed,
+        # customer selected `granted` in their most recent order, they can be subscribed
+        # to marketing emails. Customers who have chosen `denied` must not be subscribed,
         # or must be unsubscribed if already opted-in.
+        # Acceptable values are:
+        # - "`denied`"
+        # - "`granted`"
         # Corresponds to the JSON property `explicitMarketingPreference`
         # @return [String]
         attr_accessor :explicit_marketing_preference
@@ -4365,8 +4683,8 @@ module Google
         attr_accessor :last_updated_timestamp
       
         # Email address that can be used for marketing purposes. The field may be empty
-        # even if explicitMarketingPreference is 'granted'. This happens when retrieving
-        # an old order from the customer who deleted their account.
+        # even if `explicitMarketingPreference` is 'granted'. This happens when
+        # retrieving an old order from the customer who deleted their account.
         # Corresponds to the JSON property `marketingEmailAddress`
         # @return [String]
         attr_accessor :marketing_email_address
@@ -4445,11 +4763,16 @@ module Google
         attr_accessor :long_title
       
         # Whether the promotion is applicable to all products or only specific products.
+        # Acceptable values are:
+        # - "`allProducts`"
+        # - "`specificProducts`"
         # Corresponds to the JSON property `productApplicability`
         # @return [String]
         attr_accessor :product_applicability
       
         # Indicates that the promotion is valid online.
+        # Acceptable values are:
+        # - "`online`"
         # Corresponds to the JSON property `redemptionChannel`
         # @return [String]
         attr_accessor :redemption_channel
@@ -4487,6 +4810,21 @@ module Google
       
         # Further describes the benefit of the promotion. Note that we will expand on
         # this enumeration as we support new promotion sub-types.
+        # Acceptable values are:
+        # - "`buyMGetMoneyOff`"
+        # - "`buyMGetNMoneyOff`"
+        # - "`buyMGetNPercentOff`"
+        # - "`buyMGetPercentOff`"
+        # - "`freeGift`"
+        # - "`freeGiftWithItemId`"
+        # - "`freeGiftWithValue`"
+        # - "`freeOvernightShipping`"
+        # - "`freeShipping`"
+        # - "`freeTwoDayShipping`"
+        # - "`moneyOff`"
+        # - "`percentageOff`"
+        # - "`rewardPoints`"
+        # - "`salePrice`"
         # Corresponds to the JSON property `subType`
         # @return [String]
         attr_accessor :sub_type
@@ -4498,6 +4836,9 @@ module Google
       
         # Describes whether the promotion applies to products (e.g. 20% off) or to
         # shipping (e.g. Free Shipping).
+        # Acceptable values are:
+        # - "`product`"
+        # - "`shipping`"
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -4639,11 +4980,18 @@ module Google
         attr_accessor :brand
       
         # The item's channel (online or local).
+        # Acceptable values are:
+        # - "`local`"
+        # - "`online`"
         # Corresponds to the JSON property `channel`
         # @return [String]
         attr_accessor :channel
       
         # Condition or state of the item.
+        # Acceptable values are:
+        # - "`new`"
+        # - "`refurbished`"
+        # - "`used`"
         # Corresponds to the JSON property `condition`
         # @return [String]
         attr_accessor :condition
@@ -4794,18 +5142,18 @@ module Google
       class OrderLineItemReturnInfo
         include Google::Apis::Core::Hashable
       
-        # How many days later the item can be returned.
+        # Required. How many days later the item can be returned.
         # Corresponds to the JSON property `daysToReturn`
         # @return [Fixnum]
         attr_accessor :days_to_return
       
-        # Whether the item is returnable.
+        # Required. Whether the item is returnable.
         # Corresponds to the JSON property `isReturnable`
         # @return [Boolean]
         attr_accessor :is_returnable
         alias_method :is_returnable?, :is_returnable
       
-        # URL of the item return policy.
+        # Required. URL of the item return policy.
         # Corresponds to the JSON property `policyUrl`
         # @return [String]
         attr_accessor :policy_url
@@ -4826,23 +5174,26 @@ module Google
       class OrderLineItemShippingDetails
         include Google::Apis::Core::Hashable
       
-        # The delivery by date, in ISO 8601 format.
+        # Required. The delivery by date, in ISO 8601 format.
         # Corresponds to the JSON property `deliverByDate`
         # @return [String]
         attr_accessor :deliver_by_date
       
-        # Details of the shipping method.
+        # Required. Details of the shipping method.
         # Corresponds to the JSON property `method`
         # @return [Google::Apis::ContentV2::OrderLineItemShippingDetailsMethod]
         attr_accessor :method_prop
       
-        # The ship by date, in ISO 8601 format.
+        # Required. The ship by date, in ISO 8601 format.
         # Corresponds to the JSON property `shipByDate`
         # @return [String]
         attr_accessor :ship_by_date
       
-        # Type of shipment. Indicates whether deliveryDetails or pickupDetails is
+        # Type of shipment. Indicates whether `deliveryDetails` or `pickupDetails` is
         # applicable for this shipment.
+        # Acceptable values are:
+        # - "`delivery`"
+        # - "`pickup`"
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -4864,23 +5215,23 @@ module Google
       class OrderLineItemShippingDetailsMethod
         include Google::Apis::Core::Hashable
       
-        # The carrier for the shipping. Optional. See shipments[].carrier for a list of
-        # acceptable values.
+        # The carrier for the shipping. Optional. See `shipments[].carrier` for a list
+        # of acceptable values.
         # Corresponds to the JSON property `carrier`
         # @return [String]
         attr_accessor :carrier
       
-        # Maximum transit time.
+        # Required. Maximum transit time.
         # Corresponds to the JSON property `maxDaysInTransit`
         # @return [Fixnum]
         attr_accessor :max_days_in_transit
       
-        # The name of the shipping method.
+        # Required. The name of the shipping method.
         # Corresponds to the JSON property `methodName`
         # @return [String]
         attr_accessor :method_name
       
-        # Minimum transit time.
+        # Required. Minimum transit time.
         # Corresponds to the JSON property `minDaysInTransit`
         # @return [Fixnum]
         attr_accessor :min_days_in_transit
@@ -4956,13 +5307,13 @@ module Google
       
         # The type of instrument.
         # Acceptable values are:
-        # - "AMEX"
-        # - "DISCOVER"
-        # - "JCB"
-        # - "MASTERCARD"
-        # - "UNIONPAY"
-        # - "VISA"
-        # - ""
+        # - "`AMEX`"
+        # - "`DISCOVER`"
+        # - "`JCB`"
+        # - "`MASTERCARD`"
+        # - "`UNIONPAY`"
+        # - "`VISA`"
+        # - "``"
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -4986,8 +5337,8 @@ module Google
       class OrderPickupDetails
         include Google::Apis::Core::Hashable
       
-        # Address of the pickup location where the shipment should be sent. Note that
-        # recipientName in the address is the name of the business at the pickup
+        # Address of the pickup location where the shipment should be sent. Note that `
+        # recipientName` in the address is the name of the business at the pickup
         # location.
         # Corresponds to the JSON property `address`
         # @return [Google::Apis::ContentV2::OrderAddress]
@@ -5045,6 +5396,13 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The actor that created the refund.
+        # Acceptable values are:
+        # - "`customer`"
+        # - "`googleBot`"
+        # - "`googleCustomerService`"
+        # - "`googlePayments`"
+        # - "`googleSabre`"
+        # - "`merchant`"
         # Corresponds to the JSON property `actor`
         # @return [String]
         attr_accessor :actor
@@ -5060,6 +5418,51 @@ module Google
         attr_accessor :creation_date
       
         # The reason for the refund.
+        # Acceptable values are:
+        # - "`adjustment`"
+        # - "`autoPostInternal`"
+        # - "`autoPostInvalidBillingAddress`"
+        # - "`autoPostNoInventory`"
+        # - "`autoPostPriceError`"
+        # - "`autoPostUndeliverableShippingAddress`"
+        # - "`couponAbuse`"
+        # - "`courtesyAdjustment`"
+        # - "`customerCanceled`"
+        # - "`customerDiscretionaryReturn`"
+        # - "`customerInitiatedMerchantCancel`"
+        # - "`customerSupportRequested`"
+        # - "`deliveredLateByCarrier`"
+        # - "`deliveredTooLate`"
+        # - "`expiredItem`"
+        # - "`failToPushOrderGoogleError`"
+        # - "`failToPushOrderMerchantError`"
+        # - "`failToPushOrderMerchantFulfillmentError`"
+        # - "`failToPushOrderToMerchant`"
+        # - "`failToPushOrderToMerchantOutOfStock`"
+        # - "`feeAdjustment`"
+        # - "`invalidCoupon`"
+        # - "`lateShipmentCredit`"
+        # - "`malformedShippingAddress`"
+        # - "`merchantDidNotShipOnTime`"
+        # - "`noInventory`"
+        # - "`orderTimeout`"
+        # - "`other`"
+        # - "`paymentAbuse`"
+        # - "`paymentDeclined`"
+        # - "`priceAdjustment`"
+        # - "`priceError`"
+        # - "`productArrivedDamaged`"
+        # - "`productNotAsDescribed`"
+        # - "`promoReallocation`"
+        # - "`qualityNotAsExpected`"
+        # - "`returnRefundAbuse`"
+        # - "`shippingCostAdjustment`"
+        # - "`shippingPriceError`"
+        # - "`taxAdjustment`"
+        # - "`taxError`"
+        # - "`undeliverableShippingAddress`"
+        # - "`unsupportedPoBoxAddress`"
+        # - "`wrongProductShipped`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -5083,7 +5486,8 @@ module Google
         end
       end
       
-      # Order disbursement. All methods require the payment analyst role.
+      # Order disbursement. All methods require the payment analyst role. (==
+      # resource_for v2.orderreports ==) (== resource_for v2.1.orderreports ==)
       class OrderReportDisbursement
         include Google::Apis::Core::Hashable
       
@@ -5204,6 +5608,13 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The actor that created the refund.
+        # Acceptable values are:
+        # - "`customer`"
+        # - "`googleBot`"
+        # - "`googleCustomerService`"
+        # - "`googlePayments`"
+        # - "`googleSabre`"
+        # - "`merchant`"
         # Corresponds to the JSON property `actor`
         # @return [String]
         attr_accessor :actor
@@ -5219,6 +5630,20 @@ module Google
         attr_accessor :quantity
       
         # The reason for the return.
+        # Acceptable values are:
+        # - "`customerDiscretionaryReturn`"
+        # - "`customerInitiatedMerchantCancel`"
+        # - "`deliveredTooLate`"
+        # - "`expiredItem`"
+        # - "`invalidCoupon`"
+        # - "`malformedShippingAddress`"
+        # - "`other`"
+        # - "`productArrivedDamaged`"
+        # - "`productNotAsDescribed`"
+        # - "`qualityNotAsExpected`"
+        # - "`undeliverableShippingAddress`"
+        # - "`unsupportedPoBoxAddress`"
+        # - "`wrongProductShipped`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -5247,33 +5672,49 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The carrier handling the shipment.
-        # Acceptable values for US are:
-        # - "gsx"
-        # - "ups"
-        # - "usps"
-        # - "fedex"
-        # - "dhl"
-        # - "ecourier"
-        # - "cxt"
-        # - "google"
-        # - "ontrac"
-        # - "emsy"
-        # - "ont"
-        # - "deliv"
-        # - "dynamex"
-        # - "lasership"
-        # - "mpx"
-        # - "uds"
-        # - "efw"
-        # Acceptable values for FR are:
-        # - "colissimo"
-        # - "chronopost"
-        # - "gls"
-        # - "dpd"
-        # - "bpost"
-        # - "colis prive"
-        # - "boxtal"
-        # - "geodis"
+        # For supported carriers, Google includes the carrier name and tracking URL in
+        # emails to customers. For select supported carriers, Google also automatically
+        # updates the shipment status based on the provided shipment ID. Note: You can
+        # also use unsupported carriers, but emails to customers will not include the
+        # carrier name or tracking URL, and there will be no automatic order status
+        # updates.
+        # Supported carriers for US are:
+        # - "`ups`" (United Parcel Service) automatic status updates
+        # - "`usps`" (United States Postal Service) automatic status updates
+        # - "`fedex`" (FedEx) automatic status updates
+        # - "`dhl`" (DHL eCommerce) automatic status updates (US only)
+        # - "`ontrac`" (OnTrac) automatic status updates
+        # - "`dhl express`" (DHL Express)
+        # - "`deliv`" (Deliv)
+        # - "`dynamex`" (TForce)
+        # - "`lasership`" (LaserShip)
+        # - "`mpx`" (Military Parcel Xpress)
+        # - "`uds`" (United Delivery Service)
+        # - "`efw`" (Estes Forwarding Worldwide)
+        # - "`jd logistics`" (JD Logistics)
+        # - "`yunexpress`" (YunExpress)
+        # - "`china post`" (China Post)
+        # - "`china ems`" (China Post Express Mail Service)
+        # - "`singapore post`" (Singapore Post)
+        # - "`pos malaysia`" (Pos Malaysia)
+        # - "`postnl`" (PostNL)
+        # - "`ptt`" (PTT Turkish Post)
+        # - "`eub`" (ePacket)
+        # - "`chukou1`" (Chukou1 Logistics)
+        # Supported carriers for FR are:
+        # - "`la poste`" (La Poste) automatic status updates
+        # - "`colissimo`" (Colissimo by La Poste) automatic status updates
+        # - "`ups`" (United Parcel Service) automatic status updates
+        # - "`chronopost`" (Chronopost by La Poste)
+        # - "`gls`" (General Logistics Systems France)
+        # - "`dpd`" (DPD Group by GeoPost)
+        # - "`bpost`" (Belgian Post Group)
+        # - "`colis prive`" (Colis Privé)
+        # - "`boxtal`" (Boxtal)
+        # - "`geodis`" (GEODIS)
+        # - "`tnt`" (TNT)
+        # - "`db schenker`" (DB Schenker)
+        # - "`aramex`" (Aramex)
         # Corresponds to the JSON property `carrier`
         # @return [String]
         attr_accessor :carrier
@@ -5284,7 +5725,7 @@ module Google
         attr_accessor :creation_date
       
         # Date on which the shipment has been delivered, in ISO 8601 format. Present
-        # only if status is delivered
+        # only if `status` is `delivered`
         # Corresponds to the JSON property `deliveryDate`
         # @return [String]
         attr_accessor :delivery_date
@@ -5300,6 +5741,11 @@ module Google
         attr_accessor :line_items
       
         # The status of the shipment.
+        # Acceptable values are:
+        # - "`delivered`"
+        # - "`readyForPickup`"
+        # - "`shipped`"
+        # - "`undeliverable`"
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -5329,8 +5775,8 @@ module Google
       class OrderShipmentLineItemShipment
         include Google::Apis::Core::Hashable
       
-        # The ID of the line item that is shipped. Either lineItemId or productId is
-        # required.
+        # The ID of the line item that is shipped. This value is assigned by Google when
+        # an order is created. Either lineItemId or productId is required.
         # Corresponds to the JSON property `lineItemId`
         # @return [String]
         attr_accessor :line_item_id
@@ -5383,8 +5829,8 @@ module Google
         # @return [String]
         attr_accessor :operation_id
       
-        # [required] ID of the shipment group. It is assigned by the merchant in the
-        # shipLineItems method and is used to group multiple line items that have the
+        # [required] ID of the shipment group. It is assigned by the merchant in the `
+        # shipLineItems` method and is used to group multiple line items that have the
         # same kind of shipping charges.
         # Corresponds to the JSON property `shipmentGroupId`
         # @return [String]
@@ -5409,6 +5855,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The status of the execution.
+        # Acceptable values are:
+        # - "`duplicate`"
+        # - "`executed`"
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
@@ -5445,14 +5894,15 @@ module Google
         # @return [String]
         attr_accessor :operation_id
       
-        # Option to create a refund-only invoice. Exactly one of refundOnlyOption or
-        # returnOption must be provided.
+        # Option to create a refund-only invoice. Exactly one of `refundOnlyOption` or `
+        # returnOption` must be provided.
         # Corresponds to the JSON property `refundOnlyOption`
         # @return [Google::Apis::ContentV2::OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceRefundOption]
         attr_accessor :refund_only_option
       
         # Option to create an invoice for a refund and mark all items within the invoice
-        # as returned. Exactly one of refundOnlyOption or returnOption must be provided.
+        # as returned. Exactly one of `refundOnlyOption` or `returnOption` must be
+        # provided.
         # Corresponds to the JSON property `returnOption`
         # @return [Google::Apis::ContentV2::OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceReturnOption]
         attr_accessor :return_option
@@ -5481,6 +5931,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The status of the execution.
+        # Acceptable values are:
+        # - "`duplicate`"
+        # - "`executed`"
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
@@ -5512,6 +5965,51 @@ module Google
         attr_accessor :description
       
         # [required] Reason for the refund.
+        # Acceptable values are:
+        # - "`adjustment`"
+        # - "`autoPostInternal`"
+        # - "`autoPostInvalidBillingAddress`"
+        # - "`autoPostNoInventory`"
+        # - "`autoPostPriceError`"
+        # - "`autoPostUndeliverableShippingAddress`"
+        # - "`couponAbuse`"
+        # - "`courtesyAdjustment`"
+        # - "`customerCanceled`"
+        # - "`customerDiscretionaryReturn`"
+        # - "`customerInitiatedMerchantCancel`"
+        # - "`customerSupportRequested`"
+        # - "`deliveredLateByCarrier`"
+        # - "`deliveredTooLate`"
+        # - "`expiredItem`"
+        # - "`failToPushOrderGoogleError`"
+        # - "`failToPushOrderMerchantError`"
+        # - "`failToPushOrderMerchantFulfillmentError`"
+        # - "`failToPushOrderToMerchant`"
+        # - "`failToPushOrderToMerchantOutOfStock`"
+        # - "`feeAdjustment`"
+        # - "`invalidCoupon`"
+        # - "`lateShipmentCredit`"
+        # - "`malformedShippingAddress`"
+        # - "`merchantDidNotShipOnTime`"
+        # - "`noInventory`"
+        # - "`orderTimeout`"
+        # - "`other`"
+        # - "`paymentAbuse`"
+        # - "`paymentDeclined`"
+        # - "`priceAdjustment`"
+        # - "`priceError`"
+        # - "`productArrivedDamaged`"
+        # - "`productNotAsDescribed`"
+        # - "`promoReallocation`"
+        # - "`qualityNotAsExpected`"
+        # - "`returnRefundAbuse`"
+        # - "`shippingCostAdjustment`"
+        # - "`shippingPriceError`"
+        # - "`taxAdjustment`"
+        # - "`taxError`"
+        # - "`undeliverableShippingAddress`"
+        # - "`unsupportedPoBoxAddress`"
+        # - "`wrongProductShipped`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -5537,6 +6035,20 @@ module Google
         attr_accessor :description
       
         # [required] Reason for the return.
+        # Acceptable values are:
+        # - "`customerDiscretionaryReturn`"
+        # - "`customerInitiatedMerchantCancel`"
+        # - "`deliveredTooLate`"
+        # - "`expiredItem`"
+        # - "`invalidCoupon`"
+        # - "`malformedShippingAddress`"
+        # - "`other`"
+        # - "`productArrivedDamaged`"
+        # - "`productNotAsDescribed`"
+        # - "`qualityNotAsExpected`"
+        # - "`undeliverableShippingAddress`"
+        # - "`unsupportedPoBoxAddress`"
+        # - "`wrongProductShipped`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -5552,216 +6064,6 @@ module Google
         end
       end
       
-      # 
-      class OrderpaymentsNotifyAuthApprovedRequest
-        include Google::Apis::Core::Hashable
-      
-        # Authorized amount for pre-tax charge on user's credit card.
-        # Corresponds to the JSON property `authAmountPretax`
-        # @return [Google::Apis::ContentV2::Price]
-        attr_accessor :auth_amount_pretax
-      
-        # Authorized amount for tax charge on user's credit card.
-        # Corresponds to the JSON property `authAmountTax`
-        # @return [Google::Apis::ContentV2::Price]
-        attr_accessor :auth_amount_tax
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @auth_amount_pretax = args[:auth_amount_pretax] if args.key?(:auth_amount_pretax)
-          @auth_amount_tax = args[:auth_amount_tax] if args.key?(:auth_amount_tax)
-        end
-      end
-      
-      # 
-      class OrderpaymentsNotifyAuthApprovedResponse
-        include Google::Apis::Core::Hashable
-      
-        # The status of the execution.
-        # Corresponds to the JSON property `executionStatus`
-        # @return [String]
-        attr_accessor :execution_status
-      
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # orderpaymentsNotifyAuthApprovedResponse".
-        # Corresponds to the JSON property `kind`
-        # @return [String]
-        attr_accessor :kind
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @execution_status = args[:execution_status] if args.key?(:execution_status)
-          @kind = args[:kind] if args.key?(:kind)
-        end
-      end
-      
-      # 
-      class OrderpaymentsNotifyAuthDeclinedRequest
-        include Google::Apis::Core::Hashable
-      
-        # Reason why payment authorization was declined.
-        # Corresponds to the JSON property `declineReason`
-        # @return [String]
-        attr_accessor :decline_reason
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @decline_reason = args[:decline_reason] if args.key?(:decline_reason)
-        end
-      end
-      
-      # 
-      class OrderpaymentsNotifyAuthDeclinedResponse
-        include Google::Apis::Core::Hashable
-      
-        # The status of the execution.
-        # Corresponds to the JSON property `executionStatus`
-        # @return [String]
-        attr_accessor :execution_status
-      
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # orderpaymentsNotifyAuthDeclinedResponse".
-        # Corresponds to the JSON property `kind`
-        # @return [String]
-        attr_accessor :kind
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @execution_status = args[:execution_status] if args.key?(:execution_status)
-          @kind = args[:kind] if args.key?(:kind)
-        end
-      end
-      
-      # 
-      class OrderpaymentsNotifyChargeRequest
-        include Google::Apis::Core::Hashable
-      
-        # Whether charge was successful.
-        # Corresponds to the JSON property `chargeState`
-        # @return [String]
-        attr_accessor :charge_state
-      
-        # Deprecated. Please use invoiceIds instead.
-        # Corresponds to the JSON property `invoiceId`
-        # @return [String]
-        attr_accessor :invoice_id
-      
-        # Invoice IDs from the orderinvoices service that correspond to the charge.
-        # Corresponds to the JSON property `invoiceIds`
-        # @return [Array<String>]
-        attr_accessor :invoice_ids
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @charge_state = args[:charge_state] if args.key?(:charge_state)
-          @invoice_id = args[:invoice_id] if args.key?(:invoice_id)
-          @invoice_ids = args[:invoice_ids] if args.key?(:invoice_ids)
-        end
-      end
-      
-      # 
-      class OrderpaymentsNotifyChargeResponse
-        include Google::Apis::Core::Hashable
-      
-        # The status of the execution.
-        # Corresponds to the JSON property `executionStatus`
-        # @return [String]
-        attr_accessor :execution_status
-      
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # orderpaymentsNotifyChargeResponse".
-        # Corresponds to the JSON property `kind`
-        # @return [String]
-        attr_accessor :kind
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @execution_status = args[:execution_status] if args.key?(:execution_status)
-          @kind = args[:kind] if args.key?(:kind)
-        end
-      end
-      
-      # 
-      class OrderpaymentsNotifyRefundRequest
-        include Google::Apis::Core::Hashable
-      
-        # Deprecated. Please use invoiceIds instead.
-        # Corresponds to the JSON property `invoiceId`
-        # @return [String]
-        attr_accessor :invoice_id
-      
-        # Invoice IDs from the orderinvoices service that correspond to the refund.
-        # Corresponds to the JSON property `invoiceIds`
-        # @return [Array<String>]
-        attr_accessor :invoice_ids
-      
-        # Whether refund was successful.
-        # Corresponds to the JSON property `refundState`
-        # @return [String]
-        attr_accessor :refund_state
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @invoice_id = args[:invoice_id] if args.key?(:invoice_id)
-          @invoice_ids = args[:invoice_ids] if args.key?(:invoice_ids)
-          @refund_state = args[:refund_state] if args.key?(:refund_state)
-        end
-      end
-      
-      # 
-      class OrderpaymentsNotifyRefundResponse
-        include Google::Apis::Core::Hashable
-      
-        # The status of the execution.
-        # Corresponds to the JSON property `executionStatus`
-        # @return [String]
-        attr_accessor :execution_status
-      
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # orderpaymentsNotifyRefundResponse".
-        # Corresponds to the JSON property `kind`
-        # @return [String]
-        attr_accessor :kind
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @execution_status = args[:execution_status] if args.key?(:execution_status)
-          @kind = args[:kind] if args.key?(:kind)
-        end
-      end
-      
       # 
       class OrderreportsListDisbursementsResponse
         include Google::Apis::Core::Hashable
@@ -5882,6 +6184,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The status of the execution.
+        # Acceptable values are:
+        # - "`duplicate`"
+        # - "`executed`"
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
@@ -5968,6 +6273,17 @@ module Google
         attr_accessor :quantity
       
         # The reason for the cancellation.
+        # Acceptable values are:
+        # - "`customerInitiatedCancel`"
+        # - "`invalidCoupon`"
+        # - "`malformedShippingAddress`"
+        # - "`noInventory`"
+        # - "`other`"
+        # - "`priceError`"
+        # - "`shippingPriceError`"
+        # - "`taxError`"
+        # - "`undeliverableShippingAddress`"
+        # - "`unsupportedPoBoxAddress`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -6000,6 +6316,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The status of the execution.
+        # Acceptable values are:
+        # - "`duplicate`"
+        # - "`executed`"
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
@@ -6031,6 +6350,17 @@ module Google
         attr_accessor :operation_id
       
         # The reason for the cancellation.
+        # Acceptable values are:
+        # - "`customerInitiatedCancel`"
+        # - "`invalidCoupon`"
+        # - "`malformedShippingAddress`"
+        # - "`noInventory`"
+        # - "`other`"
+        # - "`priceError`"
+        # - "`shippingPriceError`"
+        # - "`taxError`"
+        # - "`undeliverableShippingAddress`"
+        # - "`unsupportedPoBoxAddress`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -6057,6 +6387,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The status of the execution.
+        # Acceptable values are:
+        # - "`duplicate`"
+        # - "`executed`"
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
@@ -6083,6 +6416,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The reason for the cancellation.
+        # Acceptable values are:
+        # - "`changedMind`"
+        # - "`orderedWrongItem`"
+        # - "`other`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -6122,18 +6459,24 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The  CLDR territory code of the country of the test order to create. Affects
-        # the currency and addresses of orders created via template_name, or the
-        # addresses of orders created via test_order.
+        # the currency and addresses of orders created via `template_name`, or the
+        # addresses of orders created via `test_order`.
         # Acceptable values are:
-        # - "US"
-        # - "FR"  Defaults to US.
+        # - "`US`"
+        # - "`FR`"  Defaults to `US`.
         # Corresponds to the JSON property `country`
         # @return [String]
         attr_accessor :country
       
-        # The test order template to use. Specify as an alternative to testOrder as a
+        # The test order template to use. Specify as an alternative to `testOrder` as a
         # shortcut for retrieving a template and then creating an order using that
         # template.
+        # Acceptable values are:
+        # - "`template1`"
+        # - "`template1a`"
+        # - "`template1b`"
+        # - "`template2`"
+        # - "`template3`"
         # Corresponds to the JSON property `templateName`
         # @return [String]
         attr_accessor :template_name
@@ -6254,17 +6597,17 @@ module Google
         # @return [Fixnum]
         attr_accessor :batch_id
       
-        # Required for cancel method.
+        # Required for `cancel` method.
         # Corresponds to the JSON property `cancel`
         # @return [Google::Apis::ContentV2::OrdersCustomBatchRequestEntryCancel]
         attr_accessor :cancel
       
-        # Required for cancelLineItem method.
+        # Required for `cancelLineItem` method.
         # Corresponds to the JSON property `cancelLineItem`
         # @return [Google::Apis::ContentV2::OrdersCustomBatchRequestEntryCancelLineItem]
         attr_accessor :cancel_line_item
       
-        # Required for inStoreReturnLineItem method.
+        # Required for `inStoreReturnLineItem` method.
         # Corresponds to the JSON property `inStoreRefundLineItem`
         # @return [Google::Apis::ContentV2::OrdersCustomBatchRequestEntryInStoreRefundLineItem]
         attr_accessor :in_store_refund_line_item
@@ -6274,64 +6617,80 @@ module Google
         # @return [Fixnum]
         attr_accessor :merchant_id
       
-        # The merchant order ID. Required for updateMerchantOrderId and
-        # getByMerchantOrderId methods.
+        # The merchant order ID. Required for `updateMerchantOrderId` and `
+        # getByMerchantOrderId` methods.
         # Corresponds to the JSON property `merchantOrderId`
         # @return [String]
         attr_accessor :merchant_order_id
       
-        # The method to apply.
+        # The method of the batch entry.
+        # Acceptable values are:
+        # - "`acknowledge`"
+        # - "`cancel`"
+        # - "`cancelLineItem`"
+        # - "`get`"
+        # - "`getByMerchantOrderId`"
+        # - "`inStoreRefundLineItem`"
+        # - "`refund`"
+        # - "`rejectReturnLineItem`"
+        # - "`returnLineItem`"
+        # - "`returnRefundLineItem`"
+        # - "`setLineItemMetadata`"
+        # - "`shipLineItems`"
+        # - "`updateLineItemShippingDetails`"
+        # - "`updateMerchantOrderId`"
+        # - "`updateShipment`"
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :method_prop
       
         # The ID of the operation. Unique across all operations for a given order.
-        # Required for all methods beside get and getByMerchantOrderId.
+        # Required for all methods beside `get` and `getByMerchantOrderId`.
         # Corresponds to the JSON property `operationId`
         # @return [String]
         attr_accessor :operation_id
       
-        # The ID of the order. Required for all methods beside getByMerchantOrderId.
+        # The ID of the order. Required for all methods beside `getByMerchantOrderId`.
         # Corresponds to the JSON property `orderId`
         # @return [String]
         attr_accessor :order_id
       
-        # Required for refund method.
+        # Required for `refund` method.
         # Corresponds to the JSON property `refund`
         # @return [Google::Apis::ContentV2::OrdersCustomBatchRequestEntryRefund]
         attr_accessor :refund
       
-        # Required for rejectReturnLineItem method.
+        # Required for `rejectReturnLineItem` method.
         # Corresponds to the JSON property `rejectReturnLineItem`
         # @return [Google::Apis::ContentV2::OrdersCustomBatchRequestEntryRejectReturnLineItem]
         attr_accessor :reject_return_line_item
       
-        # Required for returnLineItem method.
+        # Required for `returnLineItem` method.
         # Corresponds to the JSON property `returnLineItem`
         # @return [Google::Apis::ContentV2::OrdersCustomBatchRequestEntryReturnLineItem]
         attr_accessor :return_line_item
       
-        # Required for returnRefundLineItem method.
+        # Required for `returnRefundLineItem` method.
         # Corresponds to the JSON property `returnRefundLineItem`
         # @return [Google::Apis::ContentV2::OrdersCustomBatchRequestEntryReturnRefundLineItem]
         attr_accessor :return_refund_line_item
       
-        # Required for setLineItemMetadata method.
+        # Required for `setLineItemMetadata` method.
         # Corresponds to the JSON property `setLineItemMetadata`
         # @return [Google::Apis::ContentV2::OrdersCustomBatchRequestEntrySetLineItemMetadata]
         attr_accessor :set_line_item_metadata
       
-        # Required for shipLineItems method.
+        # Required for `shipLineItems` method.
         # Corresponds to the JSON property `shipLineItems`
         # @return [Google::Apis::ContentV2::OrdersCustomBatchRequestEntryShipLineItems]
         attr_accessor :ship_line_items
       
-        # Required for updateLineItemShippingDate method.
+        # Required for `updateLineItemShippingDate` method.
         # Corresponds to the JSON property `updateLineItemShippingDetails`
         # @return [Google::Apis::ContentV2::OrdersCustomBatchRequestEntryUpdateLineItemShippingDetails]
         attr_accessor :update_line_item_shipping_details
       
-        # Required for updateShipment method.
+        # Required for `updateShipment` method.
         # Corresponds to the JSON property `updateShipment`
         # @return [Google::Apis::ContentV2::OrdersCustomBatchRequestEntryUpdateShipment]
         attr_accessor :update_shipment
@@ -6367,6 +6726,17 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The reason for the cancellation.
+        # Acceptable values are:
+        # - "`customerInitiatedCancel`"
+        # - "`invalidCoupon`"
+        # - "`malformedShippingAddress`"
+        # - "`noInventory`"
+        # - "`other`"
+        # - "`priceError`"
+        # - "`shippingPriceError`"
+        # - "`taxError`"
+        # - "`undeliverableShippingAddress`"
+        # - "`unsupportedPoBoxAddress`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -6427,6 +6797,17 @@ module Google
         attr_accessor :quantity
       
         # The reason for the cancellation.
+        # Acceptable values are:
+        # - "`customerInitiatedCancel`"
+        # - "`invalidCoupon`"
+        # - "`malformedShippingAddress`"
+        # - "`noInventory`"
+        # - "`other`"
+        # - "`priceError`"
+        # - "`shippingPriceError`"
+        # - "`taxError`"
+        # - "`undeliverableShippingAddress`"
+        # - "`unsupportedPoBoxAddress`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -6509,6 +6890,20 @@ module Google
         attr_accessor :quantity
       
         # The reason for the return.
+        # Acceptable values are:
+        # - "`customerDiscretionaryReturn`"
+        # - "`customerInitiatedMerchantCancel`"
+        # - "`deliveredTooLate`"
+        # - "`expiredItem`"
+        # - "`invalidCoupon`"
+        # - "`malformedShippingAddress`"
+        # - "`other`"
+        # - "`productArrivedDamaged`"
+        # - "`productNotAsDescribed`"
+        # - "`qualityNotAsExpected`"
+        # - "`undeliverableShippingAddress`"
+        # - "`unsupportedPoBoxAddress`"
+        # - "`wrongProductShipped`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -6555,6 +6950,23 @@ module Google
         attr_accessor :amount_tax
       
         # The reason for the refund.
+        # Acceptable values are:
+        # - "`adjustment`"
+        # - "`courtesyAdjustment`"
+        # - "`customerCanceled`"
+        # - "`customerDiscretionaryReturn`"
+        # - "`deliveredLateByCarrier`"
+        # - "`feeAdjustment`"
+        # - "`lateShipmentCredit`"
+        # - "`noInventory`"
+        # - "`other`"
+        # - "`priceError`"
+        # - "`productArrivedDamaged`"
+        # - "`productNotAsDescribed`"
+        # - "`shippingCostAdjustment`"
+        # - "`taxAdjustment`"
+        # - "`undeliverableShippingAddress`"
+        # - "`wrongProductShipped`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -6599,6 +7011,12 @@ module Google
         attr_accessor :quantity
       
         # The reason for the return.
+        # Acceptable values are:
+        # - "`damagedOrUsed`"
+        # - "`missingComponent`"
+        # - "`notEligible`"
+        # - "`other`"
+        # - "`outOfReturnWindow`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -6643,6 +7061,20 @@ module Google
         attr_accessor :quantity
       
         # The reason for the return.
+        # Acceptable values are:
+        # - "`customerDiscretionaryReturn`"
+        # - "`customerInitiatedMerchantCancel`"
+        # - "`deliveredTooLate`"
+        # - "`expiredItem`"
+        # - "`invalidCoupon`"
+        # - "`malformedShippingAddress`"
+        # - "`other`"
+        # - "`productArrivedDamaged`"
+        # - "`productNotAsDescribed`"
+        # - "`qualityNotAsExpected`"
+        # - "`undeliverableShippingAddress`"
+        # - "`unsupportedPoBoxAddress`"
+        # - "`wrongProductShipped`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -6700,6 +7132,20 @@ module Google
         attr_accessor :quantity
       
         # The reason for the return.
+        # Acceptable values are:
+        # - "`customerDiscretionaryReturn`"
+        # - "`customerInitiatedMerchantCancel`"
+        # - "`deliveredTooLate`"
+        # - "`expiredItem`"
+        # - "`invalidCoupon`"
+        # - "`malformedShippingAddress`"
+        # - "`other`"
+        # - "`productArrivedDamaged`"
+        # - "`productNotAsDescribed`"
+        # - "`qualityNotAsExpected`"
+        # - "`undeliverableShippingAddress`"
+        # - "`unsupportedPoBoxAddress`"
+        # - "`wrongProductShipped`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -6763,8 +7209,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Deprecated. Please use shipmentInfo instead. The carrier handling the shipment.
-        # See shipments[].carrier in the  Orders resource representation for a list of
-        # acceptable values.
+        # See `shipments[].carrier` in the  Orders resource representation for a list
+        # of acceptable values.
         # Corresponds to the JSON property `carrier`
         # @return [String]
         attr_accessor :carrier
@@ -6815,14 +7261,14 @@ module Google
       class OrdersCustomBatchRequestEntryShipLineItemsShipmentInfo
         include Google::Apis::Core::Hashable
       
-        # The carrier handling the shipment. See shipments[].carrier in the  Orders
+        # The carrier handling the shipment. See `shipments[].carrier` in the  Orders
         # resource representation for a list of acceptable values.
         # Corresponds to the JSON property `carrier`
         # @return [String]
         attr_accessor :carrier
       
-        # The ID of the shipment. This is assigned by the merchant and is unique to each
-        # shipment.
+        # Required. The ID of the shipment. This is assigned by the merchant and is
+        # unique to each shipment.
         # Corresponds to the JSON property `shipmentId`
         # @return [String]
         attr_accessor :shipment_id
@@ -6893,14 +7339,15 @@ module Google
       class OrdersCustomBatchRequestEntryUpdateShipment
         include Google::Apis::Core::Hashable
       
-        # The carrier handling the shipment. Not updated if missing. See shipments[].
-        # carrier in the  Orders resource representation for a list of acceptable values.
+        # The carrier handling the shipment. Not updated if missing. See `shipments[].
+        # carrier` in the  Orders resource representation for a list of acceptable
+        # values.
         # Corresponds to the JSON property `carrier`
         # @return [String]
         attr_accessor :carrier
       
         # Date on which the shipment has been delivered, in ISO 8601 format. Optional
-        # and can be provided only if status is delivered.
+        # and can be provided only if `status` is `delivered`.
         # Corresponds to the JSON property `deliveryDate`
         # @return [String]
         attr_accessor :delivery_date
@@ -6911,6 +7358,9 @@ module Google
         attr_accessor :shipment_id
       
         # New status for the shipment. Not updated if missing.
+        # Acceptable values are:
+        # - "`delivered`"
+        # - "`undeliverable`"
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -6976,18 +7426,24 @@ module Google
       
         # The status of the execution. Only defined if
         # - the request was successful; and
-        # - the method is not get, getByMerchantOrderId, or one of the test methods.
+        # - the method is not `get`, `getByMerchantOrderId`, or one of the test methods.
+        # 
+        # Acceptable values are:
+        # - "`duplicate`"
+        # - "`executed`"
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersCustomBatchResponseEntry".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersCustomBatchResponseEntry`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # Order. All methods require the order manager role.
+        # Order. Production access (all methods) requires the order manager role.
+        # Sandbox access does not. (== resource_for v2.orders ==) (== resource_for v2.1.
+        # orders ==)
         # Corresponds to the JSON property `order`
         # @return [Google::Apis::ContentV2::Order]
         attr_accessor :order
@@ -7016,7 +7472,9 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Order. All methods require the order manager role.
+        # Order. Production access (all methods) requires the order manager role.
+        # Sandbox access does not. (== resource_for v2.orders ==) (== resource_for v2.1.
+        # orders ==)
         # Corresponds to the JSON property `order`
         # @return [Google::Apis::ContentV2::Order]
         attr_accessor :order
@@ -7094,6 +7552,20 @@ module Google
         attr_accessor :quantity
       
         # The reason for the return.
+        # Acceptable values are:
+        # - "`customerDiscretionaryReturn`"
+        # - "`customerInitiatedMerchantCancel`"
+        # - "`deliveredTooLate`"
+        # - "`expiredItem`"
+        # - "`invalidCoupon`"
+        # - "`malformedShippingAddress`"
+        # - "`other`"
+        # - "`productArrivedDamaged`"
+        # - "`productNotAsDescribed`"
+        # - "`qualityNotAsExpected`"
+        # - "`undeliverableShippingAddress`"
+        # - "`unsupportedPoBoxAddress`"
+        # - "`wrongProductShipped`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -7125,6 +7597,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The status of the execution.
+        # Acceptable values are:
+        # - "`duplicate`"
+        # - "`executed`"
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
@@ -7204,6 +7679,23 @@ module Google
         attr_accessor :operation_id
       
         # The reason for the refund.
+        # Acceptable values are:
+        # - "`adjustment`"
+        # - "`courtesyAdjustment`"
+        # - "`customerCanceled`"
+        # - "`customerDiscretionaryReturn`"
+        # - "`deliveredLateByCarrier`"
+        # - "`feeAdjustment`"
+        # - "`lateShipmentCredit`"
+        # - "`noInventory`"
+        # - "`other`"
+        # - "`priceError`"
+        # - "`productArrivedDamaged`"
+        # - "`productNotAsDescribed`"
+        # - "`shippingCostAdjustment`"
+        # - "`taxAdjustment`"
+        # - "`undeliverableShippingAddress`"
+        # - "`wrongProductShipped`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -7233,6 +7725,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The status of the execution.
+        # Acceptable values are:
+        # - "`duplicate`"
+        # - "`executed`"
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
@@ -7280,6 +7775,12 @@ module Google
         attr_accessor :quantity
       
         # The reason for the return.
+        # Acceptable values are:
+        # - "`damagedOrUsed`"
+        # - "`missingComponent`"
+        # - "`notEligible`"
+        # - "`other`"
+        # - "`outOfReturnWindow`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -7309,6 +7810,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The status of the execution.
+        # Acceptable values are:
+        # - "`duplicate`"
+        # - "`executed`"
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
@@ -7356,6 +7860,20 @@ module Google
         attr_accessor :quantity
       
         # The reason for the return.
+        # Acceptable values are:
+        # - "`customerDiscretionaryReturn`"
+        # - "`customerInitiatedMerchantCancel`"
+        # - "`deliveredTooLate`"
+        # - "`expiredItem`"
+        # - "`invalidCoupon`"
+        # - "`malformedShippingAddress`"
+        # - "`other`"
+        # - "`productArrivedDamaged`"
+        # - "`productNotAsDescribed`"
+        # - "`qualityNotAsExpected`"
+        # - "`undeliverableShippingAddress`"
+        # - "`unsupportedPoBoxAddress`"
+        # - "`wrongProductShipped`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -7385,6 +7903,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The status of the execution.
+        # Acceptable values are:
+        # - "`duplicate`"
+        # - "`executed`"
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
@@ -7445,6 +7966,20 @@ module Google
         attr_accessor :quantity
       
         # The reason for the return.
+        # Acceptable values are:
+        # - "`customerDiscretionaryReturn`"
+        # - "`customerInitiatedMerchantCancel`"
+        # - "`deliveredTooLate`"
+        # - "`expiredItem`"
+        # - "`invalidCoupon`"
+        # - "`malformedShippingAddress`"
+        # - "`other`"
+        # - "`productArrivedDamaged`"
+        # - "`productNotAsDescribed`"
+        # - "`qualityNotAsExpected`"
+        # - "`undeliverableShippingAddress`"
+        # - "`unsupportedPoBoxAddress`"
+        # - "`wrongProductShipped`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -7476,6 +8011,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The status of the execution.
+        # Acceptable values are:
+        # - "`duplicate`"
+        # - "`executed`"
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
@@ -7541,6 +8079,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The status of the execution.
+        # Acceptable values are:
+        # - "`duplicate`"
+        # - "`executed`"
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
@@ -7567,8 +8108,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Deprecated. Please use shipmentInfo instead. The carrier handling the shipment.
-        # See shipments[].carrier in the  Orders resource representation for a list of
-        # acceptable values.
+        # See `shipments[].carrier` in the  Orders resource representation for a list
+        # of acceptable values.
         # Corresponds to the JSON property `carrier`
         # @return [String]
         attr_accessor :carrier
@@ -7626,6 +8167,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The status of the execution.
+        # Acceptable values are:
+        # - "`duplicate`"
+        # - "`executed`"
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
@@ -7703,6 +8247,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The status of the execution.
+        # Acceptable values are:
+        # - "`duplicate`"
+        # - "`executed`"
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
@@ -7754,6 +8301,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The status of the execution.
+        # Acceptable values are:
+        # - "`duplicate`"
+        # - "`executed`"
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
@@ -7779,14 +8329,15 @@ module Google
       class OrdersUpdateShipmentRequest
         include Google::Apis::Core::Hashable
       
-        # The carrier handling the shipment. Not updated if missing. See shipments[].
-        # carrier in the  Orders resource representation for a list of acceptable values.
+        # The carrier handling the shipment. Not updated if missing. See `shipments[].
+        # carrier` in the  Orders resource representation for a list of acceptable
+        # values.
         # Corresponds to the JSON property `carrier`
         # @return [String]
         attr_accessor :carrier
       
         # Date on which the shipment has been delivered, in ISO 8601 format. Optional
-        # and can be provided only if status is delivered.
+        # and can be provided only if `status` is `delivered`.
         # Corresponds to the JSON property `deliveryDate`
         # @return [String]
         attr_accessor :delivery_date
@@ -7802,6 +8353,9 @@ module Google
         attr_accessor :shipment_id
       
         # New status for the shipment. Not updated if missing.
+        # Acceptable values are:
+        # - "`delivered`"
+        # - "`undeliverable`"
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -7831,6 +8385,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The status of the execution.
+        # Acceptable values are:
+        # - "`duplicate`"
+        # - "`executed`"
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
@@ -7852,6 +8409,62 @@ module Google
         end
       end
       
+      # 
+      class PickupCarrierService
+        include Google::Apis::Core::Hashable
+      
+        # The name of the pickup carrier (e.g., `"UPS"`). Required.
+        # Corresponds to the JSON property `carrierName`
+        # @return [String]
+        attr_accessor :carrier_name
+      
+        # The name of the pickup service (e.g., `"Access point"`). Required.
+        # Corresponds to the JSON property `serviceName`
+        # @return [String]
+        attr_accessor :service_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @carrier_name = args[:carrier_name] if args.key?(:carrier_name)
+          @service_name = args[:service_name] if args.key?(:service_name)
+        end
+      end
+      
+      # 
+      class PickupServicesPickupService
+        include Google::Apis::Core::Hashable
+      
+        # The name of the carrier (e.g., `"UPS"`). Always present.
+        # Corresponds to the JSON property `carrierName`
+        # @return [String]
+        attr_accessor :carrier_name
+      
+        # The CLDR country code of the carrier (e.g., "US"). Always present.
+        # Corresponds to the JSON property `country`
+        # @return [String]
+        attr_accessor :country
+      
+        # The name of the pickup service (e.g., `"Access point"`). Always present.
+        # Corresponds to the JSON property `serviceName`
+        # @return [String]
+        attr_accessor :service_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @carrier_name = args[:carrier_name] if args.key?(:carrier_name)
+          @country = args[:country] if args.key?(:country)
+          @service_name = args[:service_name] if args.key?(:service_name)
+        end
+      end
+      
       # 
       class PosCustomBatchRequest
         include Google::Apis::Core::Hashable
@@ -7890,7 +8503,13 @@ module Google
         # @return [Fixnum]
         attr_accessor :merchant_id
       
-        # 
+        # The method of the batch entry.
+        # Acceptable values are:
+        # - "`delete`"
+        # - "`get`"
+        # - "`insert`"
+        # - "`inventory`"
+        # - "`sale`"
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :method_prop
@@ -7905,7 +8524,7 @@ module Google
         # @return [Google::Apis::ContentV2::PosStore]
         attr_accessor :store
       
-        # The store code. Set this only if the method is delete or get.
+        # The store code. Set this only if the method is `delete` or `get`.
         # Corresponds to the JSON property `storeCode`
         # @return [String]
         attr_accessor :store_code
@@ -7977,8 +8596,8 @@ module Google
         # @return [Google::Apis::ContentV2::PosInventory]
         attr_accessor :inventory
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # posCustomBatchResponseEntry".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # posCustomBatchResponseEntry`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -8068,7 +8687,7 @@ module Google
       class PosInventory
         include Google::Apis::Core::Hashable
       
-        # The two-letter ISO 639-1 language code for the item.
+        # Required. The two-letter ISO 639-1 language code for the item.
         # Corresponds to the JSON property `contentLanguage`
         # @return [String]
         attr_accessor :content_language
@@ -8078,39 +8697,39 @@ module Google
         # @return [String]
         attr_accessor :gtin
       
-        # A unique identifier for the item.
+        # Required. A unique identifier for the item.
         # Corresponds to the JSON property `itemId`
         # @return [String]
         attr_accessor :item_id
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # posInventory".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # posInventory`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The current price of the item.
+        # Required. The current price of the item.
         # Corresponds to the JSON property `price`
         # @return [Google::Apis::ContentV2::Price]
         attr_accessor :price
       
-        # The available quantity of the item.
+        # Required. The available quantity of the item.
         # Corresponds to the JSON property `quantity`
         # @return [Fixnum]
         attr_accessor :quantity
       
-        # The identifier of the merchant's store. Either a storeCode inserted via the
-        # API or the code of the store in Google My Business.
+        # Required. The identifier of the merchant's store. Either a `storeCode`
+        # inserted via the API or the code of the store in Google My Business.
         # Corresponds to the JSON property `storeCode`
         # @return [String]
         attr_accessor :store_code
       
-        # The CLDR territory code for the item.
+        # Required. The CLDR territory code for the item.
         # Corresponds to the JSON property `targetCountry`
         # @return [String]
         attr_accessor :target_country
       
-        # The inventory timestamp, in ISO 8601 format.
+        # Required. The inventory timestamp, in ISO 8601 format.
         # Corresponds to the JSON property `timestamp`
         # @return [String]
         attr_accessor :timestamp
@@ -8137,7 +8756,7 @@ module Google
       class PosInventoryRequest
         include Google::Apis::Core::Hashable
       
-        # The two-letter ISO 639-1 language code for the item.
+        # Required. The two-letter ISO 639-1 language code for the item.
         # Corresponds to the JSON property `contentLanguage`
         # @return [String]
         attr_accessor :content_language
@@ -8147,33 +8766,33 @@ module Google
         # @return [String]
         attr_accessor :gtin
       
-        # A unique identifier for the item.
+        # Required. A unique identifier for the item.
         # Corresponds to the JSON property `itemId`
         # @return [String]
         attr_accessor :item_id
       
-        # The current price of the item.
+        # Required. The current price of the item.
         # Corresponds to the JSON property `price`
         # @return [Google::Apis::ContentV2::Price]
         attr_accessor :price
       
-        # The available quantity of the item.
+        # Required. The available quantity of the item.
         # Corresponds to the JSON property `quantity`
         # @return [Fixnum]
         attr_accessor :quantity
       
-        # The identifier of the merchant's store. Either a storeCode inserted via the
-        # API or the code of the store in Google My Business.
+        # Required. The identifier of the merchant's store. Either a `storeCode`
+        # inserted via the API or the code of the store in Google My Business.
         # Corresponds to the JSON property `storeCode`
         # @return [String]
         attr_accessor :store_code
       
-        # The CLDR territory code for the item.
+        # Required. The CLDR territory code for the item.
         # Corresponds to the JSON property `targetCountry`
         # @return [String]
         attr_accessor :target_country
       
-        # The inventory timestamp, in ISO 8601 format.
+        # Required. The inventory timestamp, in ISO 8601 format.
         # Corresponds to the JSON property `timestamp`
         # @return [String]
         attr_accessor :timestamp
@@ -8199,7 +8818,7 @@ module Google
       class PosInventoryResponse
         include Google::Apis::Core::Hashable
       
-        # The two-letter ISO 639-1 language code for the item.
+        # Required. The two-letter ISO 639-1 language code for the item.
         # Corresponds to the JSON property `contentLanguage`
         # @return [String]
         attr_accessor :content_language
@@ -8209,7 +8828,7 @@ module Google
         # @return [String]
         attr_accessor :gtin
       
-        # A unique identifier for the item.
+        # Required. A unique identifier for the item.
         # Corresponds to the JSON property `itemId`
         # @return [String]
         attr_accessor :item_id
@@ -8220,28 +8839,28 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The current price of the item.
+        # Required. The current price of the item.
         # Corresponds to the JSON property `price`
         # @return [Google::Apis::ContentV2::Price]
         attr_accessor :price
       
-        # The available quantity of the item.
+        # Required. The available quantity of the item.
         # Corresponds to the JSON property `quantity`
         # @return [Fixnum]
         attr_accessor :quantity
       
-        # The identifier of the merchant's store. Either a storeCode inserted via the
-        # API or the code of the store in Google My Business.
+        # Required. The identifier of the merchant's store. Either a `storeCode`
+        # inserted via the API or the code of the store in Google My Business.
         # Corresponds to the JSON property `storeCode`
         # @return [String]
         attr_accessor :store_code
       
-        # The CLDR territory code for the item.
+        # Required. The CLDR territory code for the item.
         # Corresponds to the JSON property `targetCountry`
         # @return [String]
         attr_accessor :target_country
       
-        # The inventory timestamp, in ISO 8601 format.
+        # Required. The inventory timestamp, in ISO 8601 format.
         # Corresponds to the JSON property `timestamp`
         # @return [String]
         attr_accessor :timestamp
@@ -8294,7 +8913,7 @@ module Google
       class PosSale
         include Google::Apis::Core::Hashable
       
-        # The two-letter ISO 639-1 language code for the item.
+        # Required. The two-letter ISO 639-1 language code for the item.
         # Corresponds to the JSON property `contentLanguage`
         # @return [String]
         attr_accessor :content_language
@@ -8304,23 +8923,24 @@ module Google
         # @return [String]
         attr_accessor :gtin
       
-        # A unique identifier for the item.
+        # Required. A unique identifier for the item.
         # Corresponds to the JSON property `itemId`
         # @return [String]
         attr_accessor :item_id
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # posSale".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # posSale`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The price of the item.
+        # Required. The price of the item.
         # Corresponds to the JSON property `price`
         # @return [Google::Apis::ContentV2::Price]
         attr_accessor :price
       
-        # The relative change of the available quantity. Negative for items returned.
+        # Required. The relative change of the available quantity. Negative for items
+        # returned.
         # Corresponds to the JSON property `quantity`
         # @return [Fixnum]
         attr_accessor :quantity
@@ -8330,18 +8950,18 @@ module Google
         # @return [String]
         attr_accessor :sale_id
       
-        # The identifier of the merchant's store. Either a storeCode inserted via the
-        # API or the code of the store in Google My Business.
+        # Required. The identifier of the merchant's store. Either a `storeCode`
+        # inserted via the API or the code of the store in Google My Business.
         # Corresponds to the JSON property `storeCode`
         # @return [String]
         attr_accessor :store_code
       
-        # The CLDR territory code for the item.
+        # Required. The CLDR territory code for the item.
         # Corresponds to the JSON property `targetCountry`
         # @return [String]
         attr_accessor :target_country
       
-        # The inventory timestamp, in ISO 8601 format.
+        # Required. The inventory timestamp, in ISO 8601 format.
         # Corresponds to the JSON property `timestamp`
         # @return [String]
         attr_accessor :timestamp
@@ -8369,7 +8989,7 @@ module Google
       class PosSaleRequest
         include Google::Apis::Core::Hashable
       
-        # The two-letter ISO 639-1 language code for the item.
+        # Required. The two-letter ISO 639-1 language code for the item.
         # Corresponds to the JSON property `contentLanguage`
         # @return [String]
         attr_accessor :content_language
@@ -8379,17 +8999,18 @@ module Google
         # @return [String]
         attr_accessor :gtin
       
-        # A unique identifier for the item.
+        # Required. A unique identifier for the item.
         # Corresponds to the JSON property `itemId`
         # @return [String]
         attr_accessor :item_id
       
-        # The price of the item.
+        # Required. The price of the item.
         # Corresponds to the JSON property `price`
         # @return [Google::Apis::ContentV2::Price]
         attr_accessor :price
       
-        # The relative change of the available quantity. Negative for items returned.
+        # Required. The relative change of the available quantity. Negative for items
+        # returned.
         # Corresponds to the JSON property `quantity`
         # @return [Fixnum]
         attr_accessor :quantity
@@ -8399,18 +9020,18 @@ module Google
         # @return [String]
         attr_accessor :sale_id
       
-        # The identifier of the merchant's store. Either a storeCode inserted via the
-        # API or the code of the store in Google My Business.
+        # Required. The identifier of the merchant's store. Either a `storeCode`
+        # inserted via the API or the code of the store in Google My Business.
         # Corresponds to the JSON property `storeCode`
         # @return [String]
         attr_accessor :store_code
       
-        # The CLDR territory code for the item.
+        # Required. The CLDR territory code for the item.
         # Corresponds to the JSON property `targetCountry`
         # @return [String]
         attr_accessor :target_country
       
-        # The inventory timestamp, in ISO 8601 format.
+        # Required. The inventory timestamp, in ISO 8601 format.
         # Corresponds to the JSON property `timestamp`
         # @return [String]
         attr_accessor :timestamp
@@ -8437,7 +9058,7 @@ module Google
       class PosSaleResponse
         include Google::Apis::Core::Hashable
       
-        # The two-letter ISO 639-1 language code for the item.
+        # Required. The two-letter ISO 639-1 language code for the item.
         # Corresponds to the JSON property `contentLanguage`
         # @return [String]
         attr_accessor :content_language
@@ -8447,7 +9068,7 @@ module Google
         # @return [String]
         attr_accessor :gtin
       
-        # A unique identifier for the item.
+        # Required. A unique identifier for the item.
         # Corresponds to the JSON property `itemId`
         # @return [String]
         attr_accessor :item_id
@@ -8458,12 +9079,13 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The price of the item.
+        # Required. The price of the item.
         # Corresponds to the JSON property `price`
         # @return [Google::Apis::ContentV2::Price]
         attr_accessor :price
       
-        # The relative change of the available quantity. Negative for items returned.
+        # Required. The relative change of the available quantity. Negative for items
+        # returned.
         # Corresponds to the JSON property `quantity`
         # @return [Fixnum]
         attr_accessor :quantity
@@ -8473,18 +9095,18 @@ module Google
         # @return [String]
         attr_accessor :sale_id
       
-        # The identifier of the merchant's store. Either a storeCode inserted via the
-        # API or the code of the store in Google My Business.
+        # Required. The identifier of the merchant's store. Either a `storeCode`
+        # inserted via the API or the code of the store in Google My Business.
         # Corresponds to the JSON property `storeCode`
         # @return [String]
         attr_accessor :store_code
       
-        # The CLDR territory code for the item.
+        # Required. The CLDR territory code for the item.
         # Corresponds to the JSON property `targetCountry`
         # @return [String]
         attr_accessor :target_country
       
-        # The inventory timestamp, in ISO 8601 format.
+        # Required. The inventory timestamp, in ISO 8601 format.
         # Corresponds to the JSON property `timestamp`
         # @return [String]
         attr_accessor :timestamp
@@ -8512,18 +9134,18 @@ module Google
       class PosStore
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # posStore".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # posStore`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The street address of the store.
+        # Required. The street address of the store.
         # Corresponds to the JSON property `storeAddress`
         # @return [String]
         attr_accessor :store_address
       
-        # A store identifier that is unique for the given merchant.
+        # Required. A store identifier that is unique for the given merchant.
         # Corresponds to the JSON property `storeCode`
         # @return [String]
         attr_accessor :store_code
@@ -8576,20 +9198,20 @@ module Google
       class PostalCodeRange
         include Google::Apis::Core::Hashable
       
-        # A postal code or a pattern of the form prefix* denoting the inclusive lower
-        # bound of the range defining the area. Examples values: "94108", "9410*", "9*".
-        # Required.
+        # A postal code or a pattern of the form `prefix*` denoting the inclusive lower
+        # bound of the range defining the area. Examples values: `"94108"`, `"9410*"`, `"
+        # 9*"`. Required.
         # Corresponds to the JSON property `postalCodeRangeBegin`
         # @return [String]
         attr_accessor :postal_code_range_begin
       
-        # A postal code or a pattern of the form prefix* denoting the inclusive upper
-        # bound of the range defining the area. It must have the same length as
-        # postalCodeRangeBegin: if postalCodeRangeBegin is a postal code then
-        # postalCodeRangeEnd must be a postal code too; if postalCodeRangeBegin is a
-        # pattern then postalCodeRangeEnd must be a pattern with the same prefix length.
-        # Optional: if not set, then the area is defined as being all the postal codes
-        # matching postalCodeRangeBegin.
+        # A postal code or a pattern of the form `prefix*` denoting the inclusive upper
+        # bound of the range defining the area. It must have the same length as `
+        # postalCodeRangeBegin`: if `postalCodeRangeBegin` is a postal code then `
+        # postalCodeRangeEnd` must be a postal code too; if `postalCodeRangeBegin` is a
+        # pattern then `postalCodeRangeEnd` must be a pattern with the same prefix
+        # length. Optional: if not set, then the area is defined as being all the postal
+        # codes matching `postalCodeRangeBegin`.
         # Corresponds to the JSON property `postalCodeRangeEnd`
         # @return [String]
         attr_accessor :postal_code_range_end
@@ -8630,6 +9252,11 @@ module Google
         end
       end
       
+      # Required product attributes are primarily defined by the products data
+      # specification. See the  Products Data Specification Help Center article for
+      # information.
+      # Some attributes are country-specific, so make sure you select the appropriate
+      # country in the drop-down selector at the top of the page.
       # Product data. After inserting, updating, or deleting a product, it may take
       # several minutes before changes take effect.
       class Product
@@ -8669,6 +9296,13 @@ module Google
         attr_accessor :adwords_redirect
       
         # Target age group of the item.
+        # Acceptable values are:
+        # - "`adult`"
+        # - "`infant`"
+        # - "`kids`"
+        # - "`newborn`"
+        # - "`toddler`"
+        # - "`youngAdult`"
         # Corresponds to the JSON property `ageGroup`
         # @return [String]
         attr_accessor :age_group
@@ -8679,6 +9313,10 @@ module Google
         attr_accessor :aspects
       
         # Availability status of the item.
+        # Acceptable values are:
+        # - "`in stock`"
+        # - "`out of stock`"
+        # - "`preorder`"
         # Corresponds to the JSON property `availability`
         # @return [String]
         attr_accessor :availability
@@ -8694,7 +9332,10 @@ module Google
         # @return [String]
         attr_accessor :brand
       
-        # The item's channel (online or local).
+        # Required. The item's channel (online or local).
+        # Acceptable values are:
+        # - "`local`"
+        # - "`online`"
         # Corresponds to the JSON property `channel`
         # @return [String]
         attr_accessor :channel
@@ -8705,11 +9346,14 @@ module Google
         attr_accessor :color
       
         # Condition or state of the item.
+        # Acceptable values are:
+        # - "`local`"
+        # - "`online`"
         # Corresponds to the JSON property `condition`
         # @return [String]
         attr_accessor :condition
       
-        # The two-letter ISO 639-1 language code for the item.
+        # Required. The two-letter ISO 639-1 language code for the item.
         # Corresponds to the JSON property `contentLanguage`
         # @return [String]
         attr_accessor :content_language
@@ -8721,8 +9365,9 @@ module Google
       
         # A list of custom (merchant-provided) attributes. It can also be used for
         # submitting any attribute of the feed specification in its generic form (e.g., `
-        # "name": "size type", "value": "regular" `). This is useful for submitting
-        # attributes not explicitly exposed by the API.
+        # ` "name": "size type", "value": "regular" ``). This is useful for submitting
+        # attributes not explicitly exposed by the API, such as additional attributes
+        # used for Shopping Actions.
         # Corresponds to the JSON property `customAttributes`
         # @return [Array<Google::Apis::ContentV2::CustomAttribute>]
         attr_accessor :custom_attributes
@@ -8793,19 +9438,34 @@ module Google
         attr_accessor :display_ads_value
       
         # The energy efficiency class as defined in EU directive 2010/30/EU.
+        # Acceptable values are:
+        # - "`A`"
+        # - "`A+`"
+        # - "`A++`"
+        # - "`A+++`"
+        # - "`B`"
+        # - "`C`"
+        # - "`D`"
+        # - "`E`"
+        # - "`F`"
+        # - "`G`"
         # Corresponds to the JSON property `energyEfficiencyClass`
         # @return [String]
         attr_accessor :energy_efficiency_class
       
         # Date on which the item should expire, as specified upon insertion, in ISO 8601
-        # format. The actual expiration date in Google Shopping is exposed in
-        # productstatuses as googleExpirationDate and might be earlier if expirationDate
-        # is too far in the future.
+        # format. The actual expiration date in Google Shopping is exposed in `
+        # productstatuses` as `googleExpirationDate` and might be earlier if `
+        # expirationDate` is too far in the future.
         # Corresponds to the JSON property `expirationDate`
         # @return [String]
         attr_accessor :expiration_date
       
         # Target gender of the item.
+        # Acceptable values are:
+        # - "`female`"
+        # - "`male`"
+        # - "`unisex`"
         # Corresponds to the JSON property `gender`
         # @return [String]
         attr_accessor :gender
@@ -8821,7 +9481,7 @@ module Google
         attr_accessor :gtin
       
         # The REST ID of the product. Content API methods that operate on products take
-        # this as their productId parameter.
+        # this as their `productId` parameter.
         # The REST ID for a product is of the form channel:contentLanguage:targetCountry:
         # offerId.
         # Corresponds to the JSON property `id`
@@ -8858,8 +9518,8 @@ module Google
         # @return [String]
         attr_accessor :item_group_id
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # product".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # product`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -8880,6 +9540,17 @@ module Google
         attr_accessor :material
       
         # The energy efficiency class as defined in EU directive 2010/30/EU.
+        # Acceptable values are:
+        # - "`A`"
+        # - "`A+`"
+        # - "`A++`"
+        # - "`A+++`"
+        # - "`B`"
+        # - "`C`"
+        # - "`D`"
+        # - "`E`"
+        # - "`F`"
+        # - "`G`"
         # Corresponds to the JSON property `maxEnergyEfficiencyClass`
         # @return [String]
         attr_accessor :max_energy_efficiency_class
@@ -8890,6 +9561,17 @@ module Google
         attr_accessor :max_handling_time
       
         # The energy efficiency class as defined in EU directive 2010/30/EU.
+        # Acceptable values are:
+        # - "`A`"
+        # - "`A+`"
+        # - "`A++`"
+        # - "`A+++`"
+        # - "`B`"
+        # - "`C`"
+        # - "`D`"
+        # - "`E`"
+        # - "`F`"
+        # - "`G`"
         # Corresponds to the JSON property `minEnergyEfficiencyClass`
         # @return [String]
         attr_accessor :min_energy_efficiency_class
@@ -8914,8 +9596,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :multipack
       
-        # A unique identifier for the item. Leading and trailing whitespaces are
-        # stripped and multiple whitespaces are replaced by a single whitespace upon
+        # Required. A unique identifier for the item. Leading and trailing whitespaces
+        # are stripped and multiple whitespaces are replaced by a single whitespace upon
         # submission. Only valid unicode characters are accepted. See the products feed
         # specification for details.
         # Note: Content API methods that operate on products take the REST ID of the
@@ -8924,7 +9606,7 @@ module Google
         # @return [String]
         attr_accessor :offer_id
       
-        # Deprecated. Whether an item is available for purchase only online.
+        # Deprecated.
         # Corresponds to the JSON property `onlineOnly`
         # @return [Boolean]
         attr_accessor :online_only
@@ -8998,26 +9680,51 @@ module Google
         attr_accessor :shipping_width
       
         # System in which the size is specified. Recommended for apparel items.
+        # Acceptable values are:
+        # - "`AU`"
+        # - "`BR`"
+        # - "`CN`"
+        # - "`DE`"
+        # - "`EU`"
+        # - "`FR`"
+        # - "`IT`"
+        # - "`JP`"
+        # - "`MEX`"
+        # - "`UK`"
+        # - "`US`"
         # Corresponds to the JSON property `sizeSystem`
         # @return [String]
         attr_accessor :size_system
       
         # The cut of the item. Recommended for apparel items.
+        # Acceptable values are:
+        # - "`big and tall`"
+        # - "`maternity`"
+        # - "`oversize`"
+        # - "`petite`"
+        # - "`plus`"
+        # - "`regular`"
         # Corresponds to the JSON property `sizeType`
         # @return [String]
         attr_accessor :size_type
       
-        # Size of the item.
+        # Size of the item. Only one value is allowed. For variants with different sizes,
+        # insert a separate product for each size with the same `itemGroupId` value (
+        # see size definition).
         # Corresponds to the JSON property `sizes`
         # @return [Array<String>]
         attr_accessor :sizes
       
         # The source of the offer, i.e., how the offer was created.
+        # Acceptable values are:
+        # - "`api`"
+        # - "`crawl`"
+        # - "`feed`"
         # Corresponds to the JSON property `source`
         # @return [String]
         attr_accessor :source
       
-        # The CLDR territory code for the item.
+        # Required. The CLDR territory code for the item.
         # Corresponds to the JSON property `targetCountry`
         # @return [String]
         attr_accessor :target_country
@@ -9175,17 +9882,17 @@ module Google
       class ProductAspect
         include Google::Apis::Core::Hashable
       
-        # The name of the aspect.
+        # Deprecated.
         # Corresponds to the JSON property `aspectName`
         # @return [String]
         attr_accessor :aspect_name
       
-        # The name of the destination. Leave out to apply to all destinations.
+        # Deprecated.
         # Corresponds to the JSON property `destinationName`
         # @return [String]
         attr_accessor :destination_name
       
-        # Whether the aspect is required, excluded or should be validated.
+        # Deprecated.
         # Corresponds to the JSON property `intention`
         # @return [String]
         attr_accessor :intention
@@ -9212,6 +9919,11 @@ module Google
         attr_accessor :destination_name
       
         # Whether the destination is required, excluded or should be validated.
+        # Acceptable values are:
+        # - "`default`"
+        # - "`excluded`"
+        # - "`optional`"
+        # - "`required`"
         # Corresponds to the JSON property `intention`
         # @return [String]
         attr_accessor :intention
@@ -9366,8 +10078,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2::ProductStatusItemLevelIssue>]
         attr_accessor :item_level_issues
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # productStatus".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # productStatus`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -9382,6 +10094,11 @@ module Google
         # @return [String]
         attr_accessor :link
       
+        # Required product attributes are primarily defined by the products data
+        # specification. See the  Products Data Specification Help Center article for
+        # information.
+        # Some attributes are country-specific, so make sure you select the appropriate
+        # country in the drop-down selector at the top of the page.
         # Product data. After inserting, updating, or deleting a product, it may take
         # several minutes before changes take effect.
         # Corresponds to the JSON property `product`
@@ -9496,6 +10213,9 @@ module Google
         alias_method :approval_pending?, :approval_pending
       
         # The destination's approval status.
+        # Acceptable values are:
+        # - "`approved`"
+        # - "`disapproved`"
         # Corresponds to the JSON property `approvalStatus`
         # @return [String]
         attr_accessor :approval_status
@@ -9506,6 +10226,11 @@ module Google
         attr_accessor :destination
       
         # Provided for backward compatibility only. Always set to "required".
+        # Acceptable values are:
+        # - "`default`"
+        # - "`excluded`"
+        # - "`optional`"
+        # - "`required`"
         # Corresponds to the JSON property `intention`
         # @return [String]
         attr_accessor :intention
@@ -9720,19 +10445,28 @@ module Google
         # @return [Fixnum]
         attr_accessor :merchant_id
       
-        # 
+        # The method of the batch entry.
+        # Acceptable values are:
+        # - "`delete`"
+        # - "`get`"
+        # - "`insert`"
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :request_method
       
+        # Required product attributes are primarily defined by the products data
+        # specification. See the  Products Data Specification Help Center article for
+        # information.
+        # Some attributes are country-specific, so make sure you select the appropriate
+        # country in the drop-down selector at the top of the page.
         # Product data. After inserting, updating, or deleting a product, it may take
         # several minutes before changes take effect.
         # Corresponds to the JSON property `product`
         # @return [Google::Apis::ContentV2::Product]
         attr_accessor :product
       
-        # The ID of the product to get or delete. Only defined if the method is get or
-        # delete.
+        # The ID of the product to get or delete. Only defined if the method is `get` or
+        # `delete`.
         # Corresponds to the JSON property `productId`
         # @return [String]
         attr_accessor :product_id
@@ -9791,12 +10525,17 @@ module Google
         # @return [Google::Apis::ContentV2::Errors]
         attr_accessor :errors
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # productsCustomBatchResponseEntry".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # productsCustomBatchResponseEntry`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
+        # Required product attributes are primarily defined by the products data
+        # specification. See the  Products Data Specification Help Center article for
+        # information.
+        # Some attributes are country-specific, so make sure you select the appropriate
+        # country in the drop-down selector at the top of the page.
         # Product data. After inserting, updating, or deleting a product, it may take
         # several minutes before changes take effect.
         # Corresponds to the JSON property `product`
@@ -9893,7 +10632,9 @@ module Google
         # @return [Fixnum]
         attr_accessor :merchant_id
       
-        # 
+        # The method of the batch entry.
+        # Acceptable values are:
+        # - "`get`"
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :request_method
@@ -9958,8 +10699,8 @@ module Google
         # @return [Google::Apis::ContentV2::Errors]
         attr_accessor :errors
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # productstatusesCustomBatchResponseEntry".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # productstatusesCustomBatchResponseEntry`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -10053,13 +10794,14 @@ module Google
         # @return [Array<String>]
         attr_accessor :applicable_shipping_labels
       
-        # A list of carrier rates that can be referred to by mainTable or singleValue.
+        # A list of carrier rates that can be referred to by `mainTable` or `singleValue`
+        # .
         # Corresponds to the JSON property `carrierRates`
         # @return [Array<Google::Apis::ContentV2::CarrierRate>]
         attr_accessor :carrier_rates
       
-        # A table defining the rate group, when singleValue is not expressive enough.
-        # Can only be set if singleValue is not set.
+        # A table defining the rate group, when `singleValue` is not expressive enough.
+        # Can only be set if `singleValue` is not set.
         # Corresponds to the JSON property `mainTable`
         # @return [Google::Apis::ContentV2::Table]
         attr_accessor :main_table
@@ -10071,14 +10813,14 @@ module Google
         attr_accessor :name
       
         # The single value of a rate group or the value of a rate group table's cell.
-        # Exactly one of noShipping, flatRate, pricePercentage, carrierRateName,
-        # subtableName must be set.
+        # Exactly one of `noShipping`, `flatRate`, `pricePercentage`, `carrierRateName`,
+        # `subtableName` must be set.
         # Corresponds to the JSON property `singleValue`
         # @return [Google::Apis::ContentV2::Value]
         attr_accessor :single_value
       
-        # A list of subtables referred to by mainTable. Can only be set if mainTable is
-        # set.
+        # A list of subtables referred to by `mainTable`. Can only be set if `mainTable`
+        # is set.
         # Corresponds to the JSON property `subtables`
         # @return [Array<Google::Apis::ContentV2::Table>]
         attr_accessor :subtables
@@ -10102,12 +10844,57 @@ module Google
       class RefundReason
         include Google::Apis::Core::Hashable
       
-        # 
+        # Description of the reason.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # 
+        # Code of the refund reason.
+        # Acceptable values are:
+        # - "`adjustment`"
+        # - "`autoPostInternal`"
+        # - "`autoPostInvalidBillingAddress`"
+        # - "`autoPostNoInventory`"
+        # - "`autoPostPriceError`"
+        # - "`autoPostUndeliverableShippingAddress`"
+        # - "`couponAbuse`"
+        # - "`courtesyAdjustment`"
+        # - "`customerCanceled`"
+        # - "`customerDiscretionaryReturn`"
+        # - "`customerInitiatedMerchantCancel`"
+        # - "`customerSupportRequested`"
+        # - "`deliveredLateByCarrier`"
+        # - "`deliveredTooLate`"
+        # - "`expiredItem`"
+        # - "`failToPushOrderGoogleError`"
+        # - "`failToPushOrderMerchantError`"
+        # - "`failToPushOrderMerchantFulfillmentError`"
+        # - "`failToPushOrderToMerchant`"
+        # - "`failToPushOrderToMerchantOutOfStock`"
+        # - "`feeAdjustment`"
+        # - "`invalidCoupon`"
+        # - "`lateShipmentCredit`"
+        # - "`malformedShippingAddress`"
+        # - "`merchantDidNotShipOnTime`"
+        # - "`noInventory`"
+        # - "`orderTimeout`"
+        # - "`other`"
+        # - "`paymentAbuse`"
+        # - "`paymentDeclined`"
+        # - "`priceAdjustment`"
+        # - "`priceError`"
+        # - "`productArrivedDamaged`"
+        # - "`productNotAsDescribed`"
+        # - "`promoReallocation`"
+        # - "`qualityNotAsExpected`"
+        # - "`returnRefundAbuse`"
+        # - "`shippingCostAdjustment`"
+        # - "`shippingPriceError`"
+        # - "`taxAdjustment`"
+        # - "`taxError`"
+        # - "`undeliverableShippingAddress`"
+        # - "`unsupportedPoBoxAddress`"
+        # - "`wrongProductShipped`"
         # Corresponds to the JSON property `reasonCode`
         # @return [String]
         attr_accessor :reason_code
@@ -10127,37 +10914,47 @@ module Google
       class ReturnShipment
         include Google::Apis::Core::Hashable
       
-        # 
+        # The date of creation of the shipment, in ISO 8601 format.
         # Corresponds to the JSON property `creationDate`
         # @return [String]
         attr_accessor :creation_date
       
-        # 
+        # The date of delivery of the shipment, in ISO 8601 format.
         # Corresponds to the JSON property `deliveryDate`
         # @return [String]
         attr_accessor :delivery_date
       
-        # 
+        # Type of the return method.
+        # Acceptable values are:
+        # - "`byMail`"
+        # - "`contactCustomerSupport`"
+        # - "`returnless`"
         # Corresponds to the JSON property `returnMethodType`
         # @return [String]
         attr_accessor :return_method_type
       
-        # 
+        # Shipment ID generated by Google.
         # Corresponds to the JSON property `shipmentId`
         # @return [String]
         attr_accessor :shipment_id
       
-        # 
+        # Tracking information of the shipment. One return shipment might be handled by
+        # several shipping carriers sequentially.
         # Corresponds to the JSON property `shipmentTrackingInfos`
         # @return [Array<Google::Apis::ContentV2::ShipmentTrackingInfo>]
         attr_accessor :shipment_tracking_infos
       
-        # 
+        # The date of shipping of the shipment, in ISO 8601 format.
         # Corresponds to the JSON property `shippingDate`
         # @return [String]
         attr_accessor :shipping_date
       
-        # 
+        # State of the shipment.
+        # Acceptable values are:
+        # - "`completed`"
+        # - "`new`"
+        # - "`shipped`"
+        # - "`undeliverable`"
         # Corresponds to the JSON property `state`
         # @return [String]
         attr_accessor :state
@@ -10182,8 +10979,8 @@ module Google
       class Row
         include Google::Apis::Core::Hashable
       
-        # The list of cells that constitute the row. Must have the same length as
-        # columnHeaders for two-dimensional tables, a length of 1 for one-dimensional
+        # The list of cells that constitute the row. Must have the same length as `
+        # columnHeaders` for two-dimensional tables, a length of 1 for one-dimensional
         # tables. Required.
         # Corresponds to the JSON property `cells`
         # @return [Array<Google::Apis::ContentV2::Value>]
@@ -10227,29 +11024,54 @@ module Google
         attr_accessor :delivery_time
       
         # Eligibility for this service.
+        # Acceptable values are:
+        # - "`All scenarios`"
+        # - "`All scenarios except Shopping Actions`"
+        # - "`Shopping Actions`"
         # Corresponds to the JSON property `eligibility`
         # @return [String]
         attr_accessor :eligibility
       
         # Minimum order value for this service. If set, indicates that customers will
         # have to spend at least this amount. All prices within a service must have the
-        # same currency.
+        # same currency. Cannot be set together with minimum_order_value_table.
         # Corresponds to the JSON property `minimumOrderValue`
         # @return [Google::Apis::ContentV2::Price]
         attr_accessor :minimum_order_value
       
+        # Table of per store minimum order values for the pickup fulfillment type.
+        # Cannot be set together with minimum_order_value.
+        # Corresponds to the JSON property `minimumOrderValueTable`
+        # @return [Google::Apis::ContentV2::MinimumOrderValueTable]
+        attr_accessor :minimum_order_value_table
+      
         # Free-form name of the service. Must be unique within target account. Required.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
+        # The carrier-service pair delivering items to collection points. The list of
+        # supported pickup services can be retrieved via the `getSupportedPickupServices`
+        # method. Required if and only if the service delivery type is `pickup`.
+        # Corresponds to the JSON property `pickupService`
+        # @return [Google::Apis::ContentV2::PickupCarrierService]
+        attr_accessor :pickup_service
+      
         # Shipping rate group definitions. Only the last one is allowed to have an empty
-        # applicableShippingLabels, which means "everything else". The other
-        # applicableShippingLabels must not overlap.
+        # `applicableShippingLabels`, which means "everything else". The other `
+        # applicableShippingLabels` must not overlap.
         # Corresponds to the JSON property `rateGroups`
         # @return [Array<Google::Apis::ContentV2::RateGroup>]
         attr_accessor :rate_groups
       
+        # Type of locations this service ships orders to.
+        # Acceptable values are:
+        # - "`delivery`"
+        # - "`pickup`"
+        # Corresponds to the JSON property `shipmentType`
+        # @return [String]
+        attr_accessor :shipment_type
+      
         def initialize(**args)
            update!(**args)
         end
@@ -10262,8 +11084,11 @@ module Google
           @delivery_time = args[:delivery_time] if args.key?(:delivery_time)
           @eligibility = args[:eligibility] if args.key?(:eligibility)
           @minimum_order_value = args[:minimum_order_value] if args.key?(:minimum_order_value)
+          @minimum_order_value_table = args[:minimum_order_value_table] if args.key?(:minimum_order_value_table)
           @name = args[:name] if args.key?(:name)
+          @pickup_service = args[:pickup_service] if args.key?(:pickup_service)
           @rate_groups = args[:rate_groups] if args.key?(:rate_groups)
+          @shipment_type = args[:shipment_type] if args.key?(:shipment_type)
         end
       end
       
@@ -10281,8 +11106,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2::ShipmentInvoiceLineItemInvoice>]
         attr_accessor :line_item_invoices
       
-        # [required] ID of the shipment group. It is assigned by the merchant in the
-        # shipLineItems method and is used to group multiple line items that have the
+        # [required] ID of the shipment group. It is assigned by the merchant in the `
+        # shipLineItems` method and is used to group multiple line items that have the
         # same kind of shipping charges.
         # Corresponds to the JSON property `shipmentGroupId`
         # @return [String]
@@ -10345,12 +11170,43 @@ module Google
       class ShipmentTrackingInfo
         include Google::Apis::Core::Hashable
       
-        # 
+        # The shipping carrier that handles the package.
+        # Acceptable values are:
+        # - "`boxtal`"
+        # - "`bpost`"
+        # - "`chronopost`"
+        # - "`colisPrive`"
+        # - "`colissimo`"
+        # - "`cxt`"
+        # - "`deliv`"
+        # - "`dhl`"
+        # - "`dpd`"
+        # - "`dynamex`"
+        # - "`eCourier`"
+        # - "`easypost`"
+        # - "`efw`"
+        # - "`fedex`"
+        # - "`fedexSmartpost`"
+        # - "`geodis`"
+        # - "`gls`"
+        # - "`googleCourier`"
+        # - "`gsx`"
+        # - "`jdLogistics`"
+        # - "`laPoste`"
+        # - "`lasership`"
+        # - "`manual`"
+        # - "`mpx`"
+        # - "`onTrac`"
+        # - "`other`"
+        # - "`tnt`"
+        # - "`uds`"
+        # - "`ups`"
+        # - "`usps`"
         # Corresponds to the JSON property `carrier`
         # @return [String]
         attr_accessor :carrier
       
-        # 
+        # The tracking number for the package.
         # Corresponds to the JSON property `trackingNumber`
         # @return [String]
         attr_accessor :tracking_number
@@ -10377,7 +11233,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :account_id
       
-        # A list of postal code groups that can be referred to in services. Optional.
+        # A list of postal code groups that can be referred to in `services`. Optional.
         # Corresponds to the JSON property `postalCodeGroups`
         # @return [Array<Google::Apis::ContentV2::PostalCodeGroup>]
         attr_accessor :postal_code_groups
@@ -10437,7 +11293,10 @@ module Google
         # @return [Fixnum]
         attr_accessor :merchant_id
       
-        # 
+        # The method of the batch entry.
+        # Acceptable values are:
+        # - "`get`"
+        # - "`update`"
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :method_prop
@@ -10502,8 +11361,8 @@ module Google
         # @return [Google::Apis::ContentV2::Errors]
         attr_accessor :errors
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # shippingsettingsCustomBatchResponseEntry".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # shippingsettingsCustomBatchResponseEntry`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -10579,6 +11438,32 @@ module Google
         end
       end
       
+      # 
+      class ShippingsettingsGetSupportedPickupServicesResponse
+        include Google::Apis::Core::Hashable
+      
+        # Identifies what kind of resource this is. Value: the fixed string "content#
+        # shippingsettingsGetSupportedPickupServicesResponse".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # A list of supported pickup services. May be empty.
+        # Corresponds to the JSON property `pickupServices`
+        # @return [Array<Google::Apis::ContentV2::PickupServicesPickupService>]
+        attr_accessor :pickup_services
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
+          @pickup_services = args[:pickup_services] if args.key?(:pickup_services)
+        end
+      end
+      
       # 
       class ShippingsettingsListResponse
         include Google::Apis::Core::Hashable
@@ -10615,8 +11500,8 @@ module Google
       class Table
         include Google::Apis::Core::Hashable
       
-        # A non-empty list of row or column headers for a table. Exactly one of prices,
-        # weights, numItems, postalCodeGroupNames, or location must be set.
+        # A non-empty list of row or column headers for a table. Exactly one of `prices`,
+        # `weights`, `numItems`, `postalCodeGroupNames`, or `location` must be set.
         # Corresponds to the JSON property `columnHeaders`
         # @return [Google::Apis::ContentV2::Headers]
         attr_accessor :column_headers
@@ -10626,14 +11511,14 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # A non-empty list of row or column headers for a table. Exactly one of prices,
-        # weights, numItems, postalCodeGroupNames, or location must be set.
+        # A non-empty list of row or column headers for a table. Exactly one of `prices`,
+        # `weights`, `numItems`, `postalCodeGroupNames`, or `location` must be set.
         # Corresponds to the JSON property `rowHeaders`
         # @return [Google::Apis::ContentV2::Headers]
         attr_accessor :row_headers
       
-        # The list of rows that constitute the table. Must have the same length as
-        # rowHeaders. Required.
+        # The list of rows that constitute the table. Must have the same length as `
+        # rowHeaders`. Required.
         # Corresponds to the JSON property `rows`
         # @return [Array<Google::Apis::ContentV2::Row>]
         attr_accessor :rows
@@ -10655,7 +11540,7 @@ module Google
       class TestOrder
         include Google::Apis::Core::Hashable
       
-        # The details of the customer who placed the order.
+        # Required. The details of the customer who placed the order.
         # Corresponds to the JSON property `customer`
         # @return [Google::Apis::ContentV2::TestOrderCustomer]
         attr_accessor :customer
@@ -10666,19 +11551,18 @@ module Google
         attr_accessor :enable_orderinvoices
         alias_method :enable_orderinvoices?, :enable_orderinvoices
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # testOrder".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # testOrder`"
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # Line items that are ordered. At least one line item must be provided.
+        # Required. Line items that are ordered. At least one line item must be provided.
         # Corresponds to the JSON property `lineItems`
         # @return [Array<Google::Apis::ContentV2::TestOrderLineItem>]
         attr_accessor :line_items
       
-        # Determines if test order must be pulled by merchant or pushed to merchant via
-        # push integration.
+        # Restricted. Do not use.
         # Corresponds to the JSON property `notificationMode`
         # @return [String]
         attr_accessor :notification_mode
@@ -10688,13 +11572,22 @@ module Google
         # @return [Google::Apis::ContentV2::TestOrderPaymentMethod]
         attr_accessor :payment_method
       
-        # Identifier of one of the predefined delivery addresses for the delivery.
+        # Required. Identifier of one of the predefined delivery addresses for the
+        # delivery.
+        # Acceptable values are:
+        # - "`dwight`"
+        # - "`jim`"
+        # - "`pam`"
         # Corresponds to the JSON property `predefinedDeliveryAddress`
         # @return [String]
         attr_accessor :predefined_delivery_address
       
         # Identifier of one of the predefined pickup details. Required for orders
-        # containing line items with shipping type pickup.
+        # containing line items with shipping type `pickup`.
+        # Acceptable values are:
+        # - "`dwight`"
+        # - "`jim`"
+        # - "`pam`"
         # Corresponds to the JSON property `predefinedPickupDetails`
         # @return [String]
         attr_accessor :predefined_pickup_details
@@ -10704,10 +11597,10 @@ module Google
         # @return [Array<Google::Apis::ContentV2::OrderLegacyPromotion>]
         attr_accessor :promotions
       
-        # The price of shipping for all items. Shipping tax is automatically calculated
-        # for orders where marketplace facilitator tax laws are applicable. Otherwise,
-        # tax settings from Merchant Center are applied. Note that shipping is not taxed
-        # in certain states.
+        # Required. The price of shipping for all items. Shipping tax is automatically
+        # calculated for orders where marketplace facilitator tax laws are applicable.
+        # Otherwise, tax settings from Merchant Center are applied. Note that shipping
+        # is not taxed in certain states.
         # Corresponds to the JSON property `shippingCost`
         # @return [Google::Apis::ContentV2::Price]
         attr_accessor :shipping_cost
@@ -10717,7 +11610,14 @@ module Google
         # @return [Google::Apis::ContentV2::Price]
         attr_accessor :shipping_cost_tax
       
-        # The requested shipping option.
+        # Required. The requested shipping option.
+        # Acceptable values are:
+        # - "`economy`"
+        # - "`expedited`"
+        # - "`oneDay`"
+        # - "`sameDay`"
+        # - "`standard`"
+        # - "`twoDay`"
         # Corresponds to the JSON property `shippingOption`
         # @return [String]
         attr_accessor :shipping_option
@@ -10747,7 +11647,11 @@ module Google
       class TestOrderCustomer
         include Google::Apis::Core::Hashable
       
-        # Email address of the customer.
+        # Required. Email address of the customer.
+        # Acceptable values are:
+        # - "`pog.dwight.schrute@gmail.com`"
+        # - "`pog.jim.halpert@gmail.com`"
+        # - "`penpog.pam.beesly@gmail.comding`"
         # Corresponds to the JSON property `email`
         # @return [String]
         attr_accessor :email
@@ -10787,6 +11691,9 @@ module Google
       
         # Last know user use selection regards marketing preferences. In certain cases
         # selection might not be known, so this field would be empty.
+        # Acceptable values are:
+        # - "`denied`"
+        # - "`granted`"
         # Corresponds to the JSON property `explicitMarketingPreference`
         # @return [String]
         attr_accessor :explicit_marketing_preference
@@ -10812,22 +11719,22 @@ module Google
       class TestOrderLineItem
         include Google::Apis::Core::Hashable
       
-        # Product data from the time of the order placement.
+        # Required. Product data from the time of the order placement.
         # Corresponds to the JSON property `product`
         # @return [Google::Apis::ContentV2::TestOrderLineItemProduct]
         attr_accessor :product
       
-        # Number of items ordered.
+        # Required. Number of items ordered.
         # Corresponds to the JSON property `quantityOrdered`
         # @return [Fixnum]
         attr_accessor :quantity_ordered
       
-        # Details of the return policy for the line item.
+        # Required. Details of the return policy for the line item.
         # Corresponds to the JSON property `returnInfo`
         # @return [Google::Apis::ContentV2::OrderLineItemReturnInfo]
         attr_accessor :return_info
       
-        # Details of the requested shipping for the line item.
+        # Required. Details of the requested shipping for the line item.
         # Corresponds to the JSON property `shippingDetails`
         # @return [Google::Apis::ContentV2::OrderLineItemShippingDetails]
         attr_accessor :shipping_details
@@ -10855,22 +11762,29 @@ module Google
       class TestOrderLineItemProduct
         include Google::Apis::Core::Hashable
       
-        # Brand of the item.
+        # Required. Brand of the item.
         # Corresponds to the JSON property `brand`
         # @return [String]
         attr_accessor :brand
       
         # Deprecated.
+        # Acceptable values are:
+        # - "`online`"
         # Corresponds to the JSON property `channel`
         # @return [String]
         attr_accessor :channel
       
-        # Condition or state of the item.
+        # Required. Condition or state of the item.
+        # Acceptable values are:
+        # - "`new`"
         # Corresponds to the JSON property `condition`
         # @return [String]
         attr_accessor :condition
       
-        # The two-letter ISO 639-1 language code for the item.
+        # Required. The two-letter ISO 639-1 language code for the item.
+        # Acceptable values are:
+        # - "`en`"
+        # - "`fr`"
         # Corresponds to the JSON property `contentLanguage`
         # @return [String]
         attr_accessor :content_language
@@ -10885,7 +11799,7 @@ module Google
         # @return [String]
         attr_accessor :gtin
       
-        # URL of an image of the item.
+        # Required. URL of an image of the item.
         # Corresponds to the JSON property `imageLink`
         # @return [String]
         attr_accessor :image_link
@@ -10900,24 +11814,24 @@ module Google
         # @return [String]
         attr_accessor :mpn
       
-        # An identifier of the item.
+        # Required. An identifier of the item.
         # Corresponds to the JSON property `offerId`
         # @return [String]
         attr_accessor :offer_id
       
-        # The price for the product. Tax is automatically calculated for orders where
-        # marketplace facilitator tax laws are applicable. Otherwise, tax settings from
-        # Merchant Center are applied.
+        # Required. The price for the product. Tax is automatically calculated for
+        # orders where marketplace facilitator tax laws are applicable. Otherwise, tax
+        # settings from Merchant Center are applied.
         # Corresponds to the JSON property `price`
         # @return [Google::Apis::ContentV2::Price]
         attr_accessor :price
       
-        # The CLDR territory code of the target country of the product.
+        # Required. The CLDR territory code of the target country of the product.
         # Corresponds to the JSON property `targetCountry`
         # @return [String]
         attr_accessor :target_country
       
-        # The title of the product.
+        # Required. The title of the product.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
@@ -10970,12 +11884,21 @@ module Google
         attr_accessor :last_four_digits
       
         # The billing address.
+        # Acceptable values are:
+        # - "`dwight`"
+        # - "`jim`"
+        # - "`pam`"
         # Corresponds to the JSON property `predefinedBillingAddress`
         # @return [String]
         attr_accessor :predefined_billing_address
       
         # The type of instrument. Note that real orders might have different values than
-        # the four values accepted by createTestOrder.
+        # the four values accepted by `createTestOrder`.
+        # Acceptable values are:
+        # - "`AMEX`"
+        # - "`DISCOVER`"
+        # - "`MASTERCARD`"
+        # - "`VISA`"
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -10998,9 +11921,9 @@ module Google
       class TransitTable
         include Google::Apis::Core::Hashable
       
-        # A list of postal group names. The last value can be "all other locations".
-        # Example: ["zone 1", "zone 2", "all other locations"]. The referred postal code
-        # groups must match the delivery country of the service.
+        # A list of postal group names. The last value can be `"all other locations"`.
+        # Example: `["zone 1", "zone 2", "all other locations"]`. The referred postal
+        # code groups must match the delivery country of the service.
         # Corresponds to the JSON property `postalCodeGroupNames`
         # @return [Array<String>]
         attr_accessor :postal_code_group_names
@@ -11010,8 +11933,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2::TransitTableTransitTimeRow>]
         attr_accessor :rows
       
-        # A list of transit time labels. The last value can be "all other labels".
-        # Example: ["food", "electronics", "all other labels"].
+        # A list of transit time labels. The last value can be `"all other labels"`.
+        # Example: `["food", "electronics", "all other labels"]`.
         # Corresponds to the JSON property `transitTimeLabels`
         # @return [Array<String>]
         attr_accessor :transit_time_labels
@@ -11051,7 +11974,7 @@ module Google
       class TransitTableTransitTimeRowTransitTimeValue
         include Google::Apis::Core::Hashable
       
-        # Must be greater than or equal to minTransitTimeInDays.
+        # Must be greater than or equal to `minTransitTimeInDays`.
         # Corresponds to the JSON property `maxTransitTimeInDays`
         # @return [Fixnum]
         attr_accessor :max_transit_time_in_days
@@ -11125,6 +12048,8 @@ module Google
         attr_accessor :additional_charge_promotions
       
         # [required] Type of the additional charge.
+        # Acceptable values are:
+        # - "`shipping`"
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -11150,13 +12075,17 @@ module Google
         # @return [Google::Apis::ContentV2::Price]
         attr_accessor :tax_amount
       
-        # Optional name of the tax type. This should only be provided if taxType is
-        # otherFeeTax.
+        # Optional name of the tax type. This should only be provided if `taxType` is `
+        # otherFeeTax`.
         # Corresponds to the JSON property `taxName`
         # @return [String]
         attr_accessor :tax_name
       
         # [required] Type of the tax.
+        # Acceptable values are:
+        # - "`otherFee`"
+        # - "`otherFeeTax`"
+        # - "`sales`"
         # Corresponds to the JSON property `taxType`
         # @return [String]
         attr_accessor :tax_type
@@ -11174,8 +12103,8 @@ module Google
       end
       
       # The single value of a rate group or the value of a rate group table's cell.
-      # Exactly one of noShipping, flatRate, pricePercentage, carrierRateName,
-      # subtableName must be set.
+      # Exactly one of `noShipping`, `flatRate`, `pricePercentage`, `carrierRateName`,
+      # `subtableName` must be set.
       class Value
         include Google::Apis::Core::Hashable
       
@@ -11197,8 +12126,8 @@ module Google
         attr_accessor :no_shipping
         alias_method :no_shipping?, :no_shipping
       
-        # A percentage of the price represented as a number in decimal notation (e.g., "
-        # 5.4"). Can only be set if all other fields are not set.
+        # A percentage of the price represented as a number in decimal notation (e.g., `"
+        # 5.4"`). Can only be set if all other fields are not set.
         # Corresponds to the JSON property `pricePercentage`
         # @return [String]
         attr_accessor :price_percentage
@@ -11227,12 +12156,15 @@ module Google
       class Weight
         include Google::Apis::Core::Hashable
       
-        # The weight unit.
+        # Required. The weight unit.
+        # Acceptable values are:
+        # - "`kg`"
+        # - "`lb`"
         # Corresponds to the JSON property `unit`
         # @return [String]
         attr_accessor :unit
       
-        # The weight represented as a number.
+        # Required. The weight represented as a number.
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value