google-apis-content_v2_1 0.17.0 → 0.21.0

data/lib/google/apis/content_v2_1/classes.rb

@@ -28,8 +28,8 @@ module Google
       class Account
         include Google::Apis::Core::Hashable
       
-        # How the account is managed. Acceptable values are: - "`manual`" - "`automatic`"
-        # 
+        # Output only. How the account is managed. Acceptable values are: - "`manual`" -
+        # "`automatic`"
         # Corresponds to the JSON property `accountManagement`
         # @return [String]
         attr_accessor :account_management
@@ -76,7 +76,7 @@ module Google
         attr_accessor :id
       
         # Identifies what kind of resource this is. Value: the fixed string "`content#
-        # account`"
+        # account`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -144,8 +144,9 @@ module Google
       class AccountAddress
         include Google::Apis::Core::Hashable
       
-        # CLDR country code (e.g. "US"). This value cannot be set for a sub-account of
-        # an MCA. All MCA sub-accounts inherit the country of their parent MCA.
+        # CLDR country code (e.g. "US"). All MCA sub-accounts inherit the country of
+        # their parent MCA by default, however the country can be updated for individual
+        # sub-accounts.
         # Corresponds to the JSON property `country`
         # @return [String]
         attr_accessor :country
@@ -234,6 +235,13 @@ module Google
         # @return [Google::Apis::ContentV2_1::AccountCustomerService]
         attr_accessor :customer_service
       
+        # The 10-digit [Korean business registration number](https://support.google.com/
+        # merchants/answer/9037766) separated with dashes in the format: XXX-XX-XXXXX.
+        # This field will only be updated if explicitly set.
+        # Corresponds to the JSON property `koreanBusinessRegistrationNumber`
+        # @return [String]
+        attr_accessor :korean_business_registration_number
+      
         # The phone number of the business.
         # Corresponds to the JSON property `phoneNumber`
         # @return [String]
@@ -247,6 +255,7 @@ module Google
         def update!(**args)
           @address = args[:address] if args.key?(:address)
           @customer_service = args[:customer_service] if args.key?(:customer_service)
+          @korean_business_registration_number = args[:korean_business_registration_number] if args.key?(:korean_business_registration_number)
           @phone_number = args[:phone_number] if args.key?(:phone_number)
         end
       end
@@ -719,8 +728,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :account_id
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # accountTax".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # accountTax`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -882,8 +891,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::AccountIdentifier>]
         attr_accessor :account_identifiers
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # accountsAuthInfoResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # accountsAuthInfoResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -903,8 +912,8 @@ module Google
       class AccountsClaimWebsiteResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # accountsClaimWebsiteResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # accountsClaimWebsiteResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1069,8 +1078,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::AccountsCustomBatchResponseEntry>]
         attr_accessor :entries
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # accountsCustomBatchResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # accountsCustomBatchResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1178,8 +1187,8 @@ module Google
       class AccountsLinkResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # accountsLinkResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # accountsLinkResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1198,8 +1207,8 @@ module Google
       class AccountsListLinksResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # accountsListLinksResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # accountsListLinksResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1230,8 +1239,8 @@ module Google
       class AccountsListResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # accountsListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # accountsListResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1281,8 +1290,8 @@ module Google
       class AccountsUpdateLabelsResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # accountsUpdateLabelsResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # accountsUpdateLabelsResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1369,8 +1378,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::AccountstatusesCustomBatchResponseEntry>]
         attr_accessor :entries
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # accountstatusesCustomBatchResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # accountstatusesCustomBatchResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1422,8 +1431,8 @@ module Google
       class AccountstatusesListResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # accountstatusesListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # accountstatusesListResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1521,8 +1530,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::AccounttaxCustomBatchResponseEntry>]
         attr_accessor :entries
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # accounttaxCustomBatchResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # accounttaxCustomBatchResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1580,8 +1589,8 @@ module Google
       class AccounttaxListResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # accounttaxListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # accounttaxListResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1651,7 +1660,7 @@ module Google
       class BusinessDayConfig
         include Google::Apis::Core::Hashable
       
-        # Regular business days. May not be empty.
+        # Regular business days, such as '"monday"'. May not be empty.
         # Corresponds to the JSON property `businessDays`
         # @return [Array<String>]
         attr_accessor :business_days
@@ -1670,17 +1679,59 @@ module Google
       class BuyOnGoogleProgramStatus
         include Google::Apis::Core::Hashable
       
-        # The customer service pending email.
+        # The business models in which merchant participates.
+        # Corresponds to the JSON property `businessModel`
+        # @return [Array<String>]
+        attr_accessor :business_model
+      
+        # The customer service pending email. After verification this field becomes
+        # empty.
         # Corresponds to the JSON property `customerServicePendingEmail`
         # @return [String]
         attr_accessor :customer_service_pending_email
       
-        # The customer service verified email.
+        # The pending phone number specified for BuyOnGoogle program. It might be
+        # different than account level phone number. In order to update this field the
+        # customer_service_pending_phone_region_code must also be set. After
+        # verification this field becomes empty.
+        # Corresponds to the JSON property `customerServicePendingPhoneNumber`
+        # @return [String]
+        attr_accessor :customer_service_pending_phone_number
+      
+        # Two letter country code for the pending phone number, for example `CA` for
+        # Canadian numbers. See the [ISO 3166-1 alpha-2](https://wikipedia.org/wiki/
+        # ISO_3166-1_alpha-2#Officially_assigned_code_elements) officially assigned
+        # codes. In order to update this field the customer_service_pending_phone_number
+        # must also be set. After verification this field becomes empty.
+        # Corresponds to the JSON property `customerServicePendingPhoneRegionCode`
+        # @return [String]
+        attr_accessor :customer_service_pending_phone_region_code
+      
+        # Output only. The customer service verified email.
         # Corresponds to the JSON property `customerServiceVerifiedEmail`
         # @return [String]
         attr_accessor :customer_service_verified_email
       
-        # The current participation stage for the program.
+        # Output only. The verified phone number specified for BuyOnGoogle program. It
+        # might be different than account level phone number.
+        # Corresponds to the JSON property `customerServiceVerifiedPhoneNumber`
+        # @return [String]
+        attr_accessor :customer_service_verified_phone_number
+      
+        # Output only. Two letter country code for the verified phone number, for
+        # example `CA` for Canadian numbers. See the [ISO 3166-1 alpha-2](https://
+        # wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)
+        # officially assigned codes.
+        # Corresponds to the JSON property `customerServiceVerifiedPhoneRegionCode`
+        # @return [String]
+        attr_accessor :customer_service_verified_phone_region_code
+      
+        # The channels through which the merchant is selling.
+        # Corresponds to the JSON property `onlineSalesChannel`
+        # @return [String]
+        attr_accessor :online_sales_channel
+      
+        # Output only. The current participation stage for the program.
         # Corresponds to the JSON property `participationStage`
         # @return [String]
         attr_accessor :participation_stage
@@ -1691,12 +1742,51 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @business_model = args[:business_model] if args.key?(:business_model)
           @customer_service_pending_email = args[:customer_service_pending_email] if args.key?(:customer_service_pending_email)
+          @customer_service_pending_phone_number = args[:customer_service_pending_phone_number] if args.key?(:customer_service_pending_phone_number)
+          @customer_service_pending_phone_region_code = args[:customer_service_pending_phone_region_code] if args.key?(:customer_service_pending_phone_region_code)
           @customer_service_verified_email = args[:customer_service_verified_email] if args.key?(:customer_service_verified_email)
+          @customer_service_verified_phone_number = args[:customer_service_verified_phone_number] if args.key?(:customer_service_verified_phone_number)
+          @customer_service_verified_phone_region_code = args[:customer_service_verified_phone_region_code] if args.key?(:customer_service_verified_phone_region_code)
+          @online_sales_channel = args[:online_sales_channel] if args.key?(:online_sales_channel)
           @participation_stage = args[:participation_stage] if args.key?(:participation_stage)
         end
       end
       
+      # Request message for the CaptureOrder method.
+      class CaptureOrderRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Response message for the CaptureOrder method.
+      class CaptureOrderResponse
+        include Google::Apis::Core::Hashable
+      
+        # The status of the execution. Only defined if the request was successful.
+        # Acceptable values are: * "duplicate" * "executed"
+        # Corresponds to the JSON property `executionStatus`
+        # @return [String]
+        attr_accessor :execution_status
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @execution_status = args[:execution_status] if args.key?(:execution_status)
+        end
+      end
+      
       # 
       class CarrierRate
         include Google::Apis::Core::Hashable
@@ -2672,8 +2762,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::DatafeedsCustomBatchResponseEntry>]
         attr_accessor :entries
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # datafeedsCustomBatchResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # datafeedsCustomBatchResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2724,8 +2814,8 @@ module Google
       class DatafeedsFetchNowResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # datafeedsFetchNowResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # datafeedsFetchNowResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2744,8 +2834,8 @@ module Google
       class DatafeedsListResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # datafeedsListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # datafeedsListResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2853,8 +2943,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::DatafeedstatusesCustomBatchResponseEntry>]
         attr_accessor :entries
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # datafeedstatusesCustomBatchResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # datafeedstatusesCustomBatchResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2906,8 +2996,8 @@ module Google
       class DatafeedstatusesListResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # datafeedstatusesListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # datafeedstatusesListResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3210,6 +3300,94 @@ module Google
         end
       end
       
+      # Response message for GetFreeListingsProgramStatus.
+      class FreeListingsProgramStatus
+        include Google::Apis::Core::Hashable
+      
+        # Status of the program in each region. Regions with the same status and review
+        # eligibility are grouped together in `regionCodes`.
+        # Corresponds to the JSON property `regionStatuses`
+        # @return [Array<Google::Apis::ContentV2_1::FreeListingsProgramStatusRegionStatus>]
+        attr_accessor :region_statuses
+      
+        # If program is successfully onboarded for at least one region.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @region_statuses = args[:region_statuses] if args.key?(:region_statuses)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
+      # Status of program and region.
+      class FreeListingsProgramStatusRegionStatus
+        include Google::Apis::Core::Hashable
+      
+        # Date by which `eligibility_status` will go from `WARNING` to `DISAPPROVED`. It
+        # will be present when `eligibility_status` is `WARNING`. Date will be provided
+        # in ISO 8601 format i.e. YYYY-MM-DD
+        # Corresponds to the JSON property `disapprovalDate`
+        # @return [String]
+        attr_accessor :disapproval_date
+      
+        # Eligibility status of the standard free listing program.
+        # Corresponds to the JSON property `eligibilityStatus`
+        # @return [String]
+        attr_accessor :eligibility_status
+      
+        # Eligibility status of the enhanced free listing program.
+        # Corresponds to the JSON property `enhancedEligibilityStatus`
+        # @return [String]
+        attr_accessor :enhanced_eligibility_status
+      
+        # Reason if a program in a given country is not eligible for review. Populated
+        # only if `review_eligibility_status` is `INELIGIBLE`.
+        # Corresponds to the JSON property `ineligibilityReason`
+        # @return [String]
+        attr_accessor :ineligibility_reason
+      
+        # The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-
+        # 1_alpha-2) codes for all the regions with the same `eligibilityStatus` and `
+        # reviewEligibility`.
+        # Corresponds to the JSON property `regionCodes`
+        # @return [Array<String>]
+        attr_accessor :region_codes
+      
+        # If a program in a given country is eligible for review. It will be present
+        # only if eligibility status is `DISAPPROVED`.
+        # Corresponds to the JSON property `reviewEligibilityStatus`
+        # @return [String]
+        attr_accessor :review_eligibility_status
+      
+        # These issues will be evaluated in review process. Fix all the issues before
+        # requesting the review.
+        # Corresponds to the JSON property `reviewIssues`
+        # @return [Array<String>]
+        attr_accessor :review_issues
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @disapproval_date = args[:disapproval_date] if args.key?(:disapproval_date)
+          @eligibility_status = args[:eligibility_status] if args.key?(:eligibility_status)
+          @enhanced_eligibility_status = args[:enhanced_eligibility_status] if args.key?(:enhanced_eligibility_status)
+          @ineligibility_reason = args[:ineligibility_reason] if args.key?(:ineligibility_reason)
+          @region_codes = args[:region_codes] if args.key?(:region_codes)
+          @review_eligibility_status = args[:review_eligibility_status] if args.key?(:review_eligibility_status)
+          @review_issues = args[:review_issues] if args.key?(:review_issues)
+        end
+      end
+      
       # 
       class GmbAccounts
         include Google::Apis::Core::Hashable
@@ -3878,8 +4056,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::LiasettingsCustomBatchResponseEntry>]
         attr_accessor :entries
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # liasettingsCustomBatchResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # liasettingsCustomBatchResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3960,8 +4138,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::GmbAccountsGmbAccount>]
         attr_accessor :gmb_accounts
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # liasettingsGetAccessibleGmbAccountsResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # liasettingsGetAccessibleGmbAccountsResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3982,8 +4160,8 @@ module Google
       class LiasettingsListPosDataProvidersResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # liasettingsListPosDataProvidersResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # liasettingsListPosDataProvidersResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -4008,8 +4186,8 @@ module Google
       class LiasettingsListResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # liasettingsListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # liasettingsListResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -4040,8 +4218,8 @@ module Google
       class LiasettingsRequestGmbAccessResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # liasettingsRequestGmbAccessResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # liasettingsRequestGmbAccessResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -4060,8 +4238,8 @@ module Google
       class LiasettingsRequestInventoryVerificationResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # liasettingsRequestInventoryVerificationResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # liasettingsRequestInventoryVerificationResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -4080,8 +4258,8 @@ module Google
       class LiasettingsSetInventoryVerificationContactResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # liasettingsSetInventoryVerificationContactResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # liasettingsSetInventoryVerificationContactResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -4100,8 +4278,8 @@ module Google
       class LiasettingsSetPosDataProviderResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # liasettingsSetPosDataProviderResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # liasettingsSetPosDataProviderResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -4568,8 +4746,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::LocalinventoryCustomBatchResponseEntry>]
         attr_accessor :entries
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # localinventoryCustomBatchResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # localinventoryCustomBatchResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -6961,8 +7139,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # orderinvoicesCreateChargeInvoiceResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # orderinvoicesCreateChargeInvoiceResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7035,8 +7213,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # orderinvoicesCreateRefundInvoiceResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # orderinvoicesCreateRefundInvoiceResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7133,8 +7311,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::OrderReportDisbursement>]
         attr_accessor :disbursements
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # orderreportsListDisbursementsResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # orderreportsListDisbursementsResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7160,8 +7338,8 @@ module Google
       class OrderreportsListTransactionsResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # orderreportsListTransactionsResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # orderreportsListTransactionsResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7218,8 +7396,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # orderreturnsAcknowledgeResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # orderreturnsAcknowledgeResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7282,8 +7460,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # orderreturnsCreateOrderReturnResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # orderreturnsCreateOrderReturnResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7343,8 +7521,8 @@ module Google
       class OrderreturnsListResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # orderreturnsListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # orderreturnsListResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7447,8 +7625,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # orderreturnsProcessResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # orderreturnsProcessResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7598,8 +7776,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersAcknowledgeResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersAcknowledgeResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7619,8 +7797,8 @@ module Google
       class OrdersAdvanceTestOrderResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersAdvanceTestOrderResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersAdvanceTestOrderResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7698,8 +7876,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersCancelLineItemResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersCancelLineItemResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7759,8 +7937,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersCancelResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersCancelResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7800,8 +7978,8 @@ module Google
       class OrdersCancelTestOrderByCustomerResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersCancelTestOrderByCustomerResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersCancelTestOrderByCustomerResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7857,8 +8035,8 @@ module Google
       class OrdersCreateTestOrderResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersCreateTestOrderResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersCreateTestOrderResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -7902,8 +8080,8 @@ module Google
       class OrdersCreateTestReturnResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersCreateTestReturnResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersCreateTestReturnResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -8091,8 +8269,8 @@ module Google
       class OrdersGetByMerchantOrderIdResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersGetByMerchantOrderIdResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersGetByMerchantOrderIdResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -8118,8 +8296,8 @@ module Google
       class OrdersGetTestOrderTemplateResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersGetTestOrderTemplateResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersGetTestOrderTemplateResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -8219,8 +8397,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersInStoreRefundLineItemResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersInStoreRefundLineItemResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -8240,8 +8418,8 @@ module Google
       class OrdersListResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersListResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -8328,8 +8506,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersRefundItemResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersRefundItemResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -8402,8 +8580,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersRefundOrderResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersRefundOrderResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -8480,8 +8658,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersRejectReturnLineItemResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersRejectReturnLineItemResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -8577,8 +8755,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersReturnRefundLineItemResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersReturnRefundLineItemResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -8643,8 +8821,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersSetLineItemMetadataResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersSetLineItemMetadataResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -8709,8 +8887,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersShipLineItemsResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersShipLineItemsResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -8785,8 +8963,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersUpdateLineItemShippingDetailsResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersUpdateLineItemShippingDetailsResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -8837,8 +9015,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersUpdateMerchantOrderIdResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersUpdateMerchantOrderIdResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -8944,8 +9122,8 @@ module Google
         # @return [String]
         attr_accessor :execution_status
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # ordersUpdateShipmentResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # ordersUpdateShipmentResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -9146,8 +9324,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::PosCustomBatchResponseEntry>]
         attr_accessor :entries
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # posCustomBatchResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # posCustomBatchResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -9419,8 +9597,8 @@ module Google
         # @return [String]
         attr_accessor :item_id
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # posInventoryResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # posInventoryResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -9473,8 +9651,8 @@ module Google
       class PosListResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # posListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # posListResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -9659,8 +9837,8 @@ module Google
         # @return [String]
         attr_accessor :item_id
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # posSaleResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # posSaleResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -10203,16 +10381,40 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::ProductProductDetail>]
         attr_accessor :product_details
       
+        # The height of the product in the units provided. The value must be between 0 (
+        # exclusive) and 3000 (inclusive).
+        # Corresponds to the JSON property `productHeight`
+        # @return [Google::Apis::ContentV2_1::ProductDimension]
+        attr_accessor :product_height
+      
         # Bullet points describing the most relevant highlights of a product.
         # Corresponds to the JSON property `productHighlights`
         # @return [Array<String>]
         attr_accessor :product_highlights
       
+        # The length of the product in the units provided. The value must be between 0 (
+        # exclusive) and 3000 (inclusive).
+        # Corresponds to the JSON property `productLength`
+        # @return [Google::Apis::ContentV2_1::ProductDimension]
+        attr_accessor :product_length
+      
         # Categories of the item (formatted as in products data specification).
         # Corresponds to the JSON property `productTypes`
         # @return [Array<String>]
         attr_accessor :product_types
       
+        # The weight of the product in the units provided. The value must be between 0 (
+        # exclusive) and 2000 (inclusive).
+        # Corresponds to the JSON property `productWeight`
+        # @return [Google::Apis::ContentV2_1::ProductWeight]
+        attr_accessor :product_weight
+      
+        # The width of the product in the units provided. The value must be between 0 (
+        # exclusive) and 3000 (inclusive).
+        # Corresponds to the JSON property `productWidth`
+        # @return [Google::Apis::ContentV2_1::ProductDimension]
+        attr_accessor :product_width
+      
         # The unique ID of a promotion.
         # Corresponds to the JSON property `promotionIds`
         # @return [Array<String>]
@@ -10404,8 +10606,12 @@ module Google
           @pickup_sla = args[:pickup_sla] if args.key?(:pickup_sla)
           @price = args[:price] if args.key?(:price)
           @product_details = args[:product_details] if args.key?(:product_details)
+          @product_height = args[:product_height] if args.key?(:product_height)
           @product_highlights = args[:product_highlights] if args.key?(:product_highlights)
+          @product_length = args[:product_length] if args.key?(:product_length)
           @product_types = args[:product_types] if args.key?(:product_types)
+          @product_weight = args[:product_weight] if args.key?(:product_weight)
+          @product_width = args[:product_width] if args.key?(:product_width)
           @promotion_ids = args[:promotion_ids] if args.key?(:promotion_ids)
           @sale_price = args[:sale_price] if args.key?(:sale_price)
           @sale_price_effective_date = args[:sale_price_effective_date] if args.key?(:sale_price_effective_date)
@@ -10463,6 +10669,32 @@ module Google
         end
       end
       
+      # 
+      class ProductDimension
+        include Google::Apis::Core::Hashable
+      
+        # Required. The length units. Acceptable values are: - "`in`" - "`cm`"
+        # Corresponds to the JSON property `unit`
+        # @return [String]
+        attr_accessor :unit
+      
+        # Required. The length value represented as a number. The value can have a
+        # maximum precision of four decimal places.
+        # Corresponds to the JSON property `value`
+        # @return [Float]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @unit = args[:unit] if args.key?(:unit)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
       # 
       class ProductProductDetail
         include Google::Apis::Core::Hashable
@@ -10953,6 +11185,33 @@ module Google
         end
       end
       
+      # 
+      class ProductWeight
+        include Google::Apis::Core::Hashable
+      
+        # Required. The weight unit. Acceptable values are: - "`g`" - "`kg`" - "`oz`" - "
+        # `lb`"
+        # Corresponds to the JSON property `unit`
+        # @return [String]
+        attr_accessor :unit
+      
+        # Required. The weight represented as a number. The weight can have a maximum
+        # precision of four decimal places.
+        # Corresponds to the JSON property `value`
+        # @return [Float]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @unit = args[:unit] if args.key?(:unit)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
       # 
       class ProductsCustomBatchRequest
         include Google::Apis::Core::Hashable
@@ -10981,7 +11240,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :batch_id
       
-        # The Content API feed id.
+        # The Content API Supplemental Feed ID. If present then product insertion or
+        # deletion applies to a supplemental feed instead of primary Content API feed.
         # Corresponds to the JSON property `feedId`
         # @return [Fixnum]
         attr_accessor :feed_id
@@ -11005,8 +11265,8 @@ module Google
         # @return [Google::Apis::ContentV2_1::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 mutate. Only defined if the method is `get`, `
+        # delete`, or `update`.
         # Corresponds to the JSON property `productId`
         # @return [String]
         attr_accessor :product_id
@@ -11046,8 +11306,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::ProductsCustomBatchResponseEntry>]
         attr_accessor :entries
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # productsCustomBatchResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # productsCustomBatchResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -11108,8 +11368,8 @@ module Google
       class ProductsListResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # productsListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # productsListResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -11215,8 +11475,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::ProductstatusesCustomBatchResponseEntry>]
         attr_accessor :entries
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # productstatusesCustomBatchResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # productstatusesCustomBatchResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -11275,8 +11535,8 @@ module Google
       class ProductstatusesListResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # productstatusesListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # productstatusesListResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -11303,6 +11563,217 @@ module Google
         end
       end
       
+      # Represents a promotion. (1) https://support.google.com/merchants/answer/
+      # 2906014 (2) https://support.google.com/merchants/answer/10146130 (3) https://
+      # support.google.com/merchants/answer/9173673
+      class Promotion
+        include Google::Apis::Core::Hashable
+      
+        # Product filter by brand for the promotion.
+        # Corresponds to the JSON property `brand`
+        # @return [Array<String>]
+        attr_accessor :brand
+      
+        # Product filter by brand exclusion for the promotion.
+        # Corresponds to the JSON property `brandExclusion`
+        # @return [Array<String>]
+        attr_accessor :brand_exclusion
+      
+        # Required. The content language used as part of the unique identifier.
+        # Corresponds to the JSON property `contentLanguage`
+        # @return [String]
+        attr_accessor :content_language
+      
+        # Required. Coupon value type for the promotion.
+        # Corresponds to the JSON property `couponValueType`
+        # @return [String]
+        attr_accessor :coupon_value_type
+      
+        # Free gift description for the promotion.
+        # Corresponds to the JSON property `freeGiftDescription`
+        # @return [String]
+        attr_accessor :free_gift_description
+      
+        # Free gift item id for the promotion.
+        # Corresponds to the JSON property `freeGiftItemId`
+        # @return [String]
+        attr_accessor :free_gift_item_id
+      
+        # The price represented as a number and currency.
+        # Corresponds to the JSON property `freeGiftValue`
+        # @return [Google::Apis::ContentV2_1::PriceAmount]
+        attr_accessor :free_gift_value
+      
+        # Generic redemption code for the promotion. To be used with the above field.
+        # Corresponds to the JSON property `genericRedemptionCode`
+        # @return [String]
+        attr_accessor :generic_redemption_code
+      
+        # The number of items discounted in the promotion.
+        # Corresponds to the JSON property `getThisQuantityDiscounted`
+        # @return [Fixnum]
+        attr_accessor :get_this_quantity_discounted
+      
+        # Required. Output only. The REST promotion id to uniquely identify the
+        # promotion. Content API methods that operate on promotions take this as their
+        # promotionId parameter.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # Product filter by item group id for the promotion.
+        # Corresponds to the JSON property `itemGroupId`
+        # @return [Array<String>]
+        attr_accessor :item_group_id
+      
+        # Product filter by item group id exclusion for the promotion.
+        # Corresponds to the JSON property `itemGroupIdExclusion`
+        # @return [Array<String>]
+        attr_accessor :item_group_id_exclusion
+      
+        # Product filter by item id for the promotion.
+        # Corresponds to the JSON property `itemId`
+        # @return [Array<String>]
+        attr_accessor :item_id
+      
+        # Product filter by item id exclusion for the promotion.
+        # Corresponds to the JSON property `itemIdExclusion`
+        # @return [Array<String>]
+        attr_accessor :item_id_exclusion
+      
+        # Maximum purchase quantity for the promotion.
+        # Corresponds to the JSON property `limitQuantity`
+        # @return [Fixnum]
+        attr_accessor :limit_quantity
+      
+        # The price represented as a number and currency.
+        # Corresponds to the JSON property `limitValue`
+        # @return [Google::Apis::ContentV2_1::PriceAmount]
+        attr_accessor :limit_value
+      
+        # Long title for the promotion.
+        # Corresponds to the JSON property `longTitle`
+        # @return [String]
+        attr_accessor :long_title
+      
+        # The price represented as a number and currency.
+        # Corresponds to the JSON property `minimumPurchaseAmount`
+        # @return [Google::Apis::ContentV2_1::PriceAmount]
+        attr_accessor :minimum_purchase_amount
+      
+        # Minimum purchase quantity for the promotion.
+        # Corresponds to the JSON property `minimumPurchaseQuantity`
+        # @return [Fixnum]
+        attr_accessor :minimum_purchase_quantity
+      
+        # The price represented as a number and currency.
+        # Corresponds to the JSON property `moneyBudget`
+        # @return [Google::Apis::ContentV2_1::PriceAmount]
+        attr_accessor :money_budget
+      
+        # The price represented as a number and currency.
+        # Corresponds to the JSON property `moneyOffAmount`
+        # @return [Google::Apis::ContentV2_1::PriceAmount]
+        attr_accessor :money_off_amount
+      
+        # Required. Type of the promotion.
+        # Corresponds to the JSON property `offerType`
+        # @return [String]
+        attr_accessor :offer_type
+      
+        # Order limit for the promotion.
+        # Corresponds to the JSON property `orderLimit`
+        # @return [Fixnum]
+        attr_accessor :order_limit
+      
+        # The percentage discount offered in the promotion.
+        # Corresponds to the JSON property `percentOff`
+        # @return [Fixnum]
+        attr_accessor :percent_off
+      
+        # Required. Applicability of the promotion to either all products or only
+        # specific products.
+        # Corresponds to the JSON property `productApplicability`
+        # @return [String]
+        attr_accessor :product_applicability
+      
+        # Destination ID for the promotion.
+        # Corresponds to the JSON property `promotionDestinationIds`
+        # @return [Array<String>]
+        attr_accessor :promotion_destination_ids
+      
+        # String representation of the promotion display dates.
+        # Corresponds to the JSON property `promotionDisplayDates`
+        # @return [String]
+        attr_accessor :promotion_display_dates
+      
+        # Required. String representation of the promotion effective dates.
+        # Corresponds to the JSON property `promotionEffectiveDates`
+        # @return [String]
+        attr_accessor :promotion_effective_dates
+      
+        # Required. The user provided promotion id to uniquely identify the promotion.
+        # Corresponds to the JSON property `promotionId`
+        # @return [String]
+        attr_accessor :promotion_id
+      
+        # Required. Redemption channel for the promotion. At least one channel is
+        # required.
+        # Corresponds to the JSON property `redemptionChannel`
+        # @return [Array<String>]
+        attr_accessor :redemption_channel
+      
+        # Shipping service names for thse promotion.
+        # Corresponds to the JSON property `shippingServiceNames`
+        # @return [Array<String>]
+        attr_accessor :shipping_service_names
+      
+        # Required. The target country used as part of the unique identifier.
+        # Corresponds to the JSON property `targetCountry`
+        # @return [String]
+        attr_accessor :target_country
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @brand = args[:brand] if args.key?(:brand)
+          @brand_exclusion = args[:brand_exclusion] if args.key?(:brand_exclusion)
+          @content_language = args[:content_language] if args.key?(:content_language)
+          @coupon_value_type = args[:coupon_value_type] if args.key?(:coupon_value_type)
+          @free_gift_description = args[:free_gift_description] if args.key?(:free_gift_description)
+          @free_gift_item_id = args[:free_gift_item_id] if args.key?(:free_gift_item_id)
+          @free_gift_value = args[:free_gift_value] if args.key?(:free_gift_value)
+          @generic_redemption_code = args[:generic_redemption_code] if args.key?(:generic_redemption_code)
+          @get_this_quantity_discounted = args[:get_this_quantity_discounted] if args.key?(:get_this_quantity_discounted)
+          @id = args[:id] if args.key?(:id)
+          @item_group_id = args[:item_group_id] if args.key?(:item_group_id)
+          @item_group_id_exclusion = args[:item_group_id_exclusion] if args.key?(:item_group_id_exclusion)
+          @item_id = args[:item_id] if args.key?(:item_id)
+          @item_id_exclusion = args[:item_id_exclusion] if args.key?(:item_id_exclusion)
+          @limit_quantity = args[:limit_quantity] if args.key?(:limit_quantity)
+          @limit_value = args[:limit_value] if args.key?(:limit_value)
+          @long_title = args[:long_title] if args.key?(:long_title)
+          @minimum_purchase_amount = args[:minimum_purchase_amount] if args.key?(:minimum_purchase_amount)
+          @minimum_purchase_quantity = args[:minimum_purchase_quantity] if args.key?(:minimum_purchase_quantity)
+          @money_budget = args[:money_budget] if args.key?(:money_budget)
+          @money_off_amount = args[:money_off_amount] if args.key?(:money_off_amount)
+          @offer_type = args[:offer_type] if args.key?(:offer_type)
+          @order_limit = args[:order_limit] if args.key?(:order_limit)
+          @percent_off = args[:percent_off] if args.key?(:percent_off)
+          @product_applicability = args[:product_applicability] if args.key?(:product_applicability)
+          @promotion_destination_ids = args[:promotion_destination_ids] if args.key?(:promotion_destination_ids)
+          @promotion_display_dates = args[:promotion_display_dates] if args.key?(:promotion_display_dates)
+          @promotion_effective_dates = args[:promotion_effective_dates] if args.key?(:promotion_effective_dates)
+          @promotion_id = args[:promotion_id] if args.key?(:promotion_id)
+          @redemption_channel = args[:redemption_channel] if args.key?(:redemption_channel)
+          @shipping_service_names = args[:shipping_service_names] if args.key?(:shipping_service_names)
+          @target_country = args[:target_country] if args.key?(:target_country)
+        end
+      end
+      
       # Settings for Pub/Sub notifications, all methods require that the caller is a
       # direct user of the merchant center account.
       class PubsubNotificationSettings
@@ -11596,8 +12067,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::CustomAttribute>]
         attr_accessor :custom_attributes
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # regionalInventory".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # regionalInventory`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -11712,8 +12183,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::RegionalinventoryCustomBatchResponseEntry>]
         attr_accessor :entries
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # regionalinventoryCustomBatchResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # regionalinventoryCustomBatchResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -11743,8 +12214,8 @@ module Google
         # @return [Google::Apis::ContentV2_1::Errors]
         attr_accessor :errors
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # regionalinventoryCustomBatchResponseEntry".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # regionalinventoryCustomBatchResponseEntry`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -12354,6 +12825,67 @@ module Google
         end
       end
       
+      # Request message for the RequestPhoneVerification method.
+      class RequestPhoneVerificationRequest
+        include Google::Apis::Core::Hashable
+      
+        # Language code [IETF BCP 47 syntax](https://tools.ietf.org/html/bcp47) (for
+        # example, en-US). Language code is used to provide localized `SMS` and `
+        # PHONE_CALL`. Default language used is en-US if not provided.
+        # Corresponds to the JSON property `languageCode`
+        # @return [String]
+        attr_accessor :language_code
+      
+        # Phone number to be verified.
+        # Corresponds to the JSON property `phoneNumber`
+        # @return [String]
+        attr_accessor :phone_number
+      
+        # Required. Two letter country code for the phone number, for example `CA` for
+        # Canadian numbers. See the [ISO 3166-1 alpha-2](https://wikipedia.org/wiki/
+        # ISO_3166-1_alpha-2#Officially_assigned_code_elements) officially assigned
+        # codes.
+        # Corresponds to the JSON property `phoneRegionCode`
+        # @return [String]
+        attr_accessor :phone_region_code
+      
+        # Verification method to receive verification code.
+        # Corresponds to the JSON property `phoneVerificationMethod`
+        # @return [String]
+        attr_accessor :phone_verification_method
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @language_code = args[:language_code] if args.key?(:language_code)
+          @phone_number = args[:phone_number] if args.key?(:phone_number)
+          @phone_region_code = args[:phone_region_code] if args.key?(:phone_region_code)
+          @phone_verification_method = args[:phone_verification_method] if args.key?(:phone_verification_method)
+        end
+      end
+      
+      # Response message for the RequestPhoneVerification method.
+      class RequestPhoneVerificationResponse
+        include Google::Apis::Core::Hashable
+      
+        # The verification ID to use in subsequent calls to `verifyphonenumber`.
+        # Corresponds to the JSON property `verificationId`
+        # @return [String]
+        attr_accessor :verification_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @verification_id = args[:verification_id] if args.key?(:verification_id)
+        end
+      end
+      
       # Request message for the RequestReviewProgram method.
       class RequestReviewBuyOnGoogleProgramRequest
         include Google::Apis::Core::Hashable
@@ -12367,6 +12899,46 @@ module Google
         end
       end
       
+      # Request message for the RequestReviewFreeListings Program method.
+      class RequestReviewFreeListingsRequest
+        include Google::Apis::Core::Hashable
+      
+        # The code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
+        # of the country for which review is to be requested.
+        # Corresponds to the JSON property `regionCode`
+        # @return [String]
+        attr_accessor :region_code
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @region_code = args[:region_code] if args.key?(:region_code)
+        end
+      end
+      
+      # Request message for the RequestReviewShoppingAds program method.
+      class RequestReviewShoppingAdsRequest
+        include Google::Apis::Core::Hashable
+      
+        # The code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
+        # of the country for which review is to be requested.
+        # Corresponds to the JSON property `regionCode`
+        # @return [String]
+        attr_accessor :region_code
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @region_code = args[:region_code] if args.key?(:region_code)
+        end
+      end
+      
       # Return address resource.
       class ReturnAddress
         include Google::Apis::Core::Hashable
@@ -13027,8 +13599,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::ReturnaddressCustomBatchResponseEntry>]
         attr_accessor :entries
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # returnaddressCustomBatchResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # returnaddressCustomBatchResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -13086,8 +13658,8 @@ module Google
       class ReturnaddressListResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # returnaddressListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # returnaddressListResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -13187,8 +13759,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::ReturnpolicyCustomBatchResponseEntry>]
         attr_accessor :entries
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # returnpolicyCustomBatchResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # returnpolicyCustomBatchResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -13246,8 +13818,8 @@ module Google
       class ReturnpolicyListResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # returnpolicyListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # returnpolicyListResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -13307,7 +13879,9 @@ module Google
         attr_accessor :page_token
       
         # Required. Query that defines performance metrics to retrieve and dimensions
-        # according to which the metrics are to be segmented.
+        # according to which the metrics are to be segmented. For details on how to
+        # construct your query, see the [Query Language guide](https://developers.google.
+        # com/shopping-content/guides/reports/query-language/overview).
         # Corresponds to the JSON property `query`
         # @return [String]
         attr_accessor :query
@@ -13364,27 +13938,37 @@ module Google
         # @return [String]
         attr_accessor :brand
       
-        # Product category (1st level) in Google's product taxonomy.
+        # [Product category (1st level)](https://developers.google.com/shopping-content/
+        # guides/reports/segmentation#category_and_product_type) in Google's product
+        # taxonomy.
         # Corresponds to the JSON property `categoryL1`
         # @return [String]
         attr_accessor :category_l1
       
-        # Product category (2nd level) in Google's product taxonomy.
+        # [Product category (2nd level)](https://developers.google.com/shopping-content/
+        # guides/reports/segmentation#category_and_product_type) in Google's product
+        # taxonomy.
         # Corresponds to the JSON property `categoryL2`
         # @return [String]
         attr_accessor :category_l2
       
-        # Product category (3rd level) in Google's product taxonomy.
+        # [Product category (3rd level)](https://developers.google.com/shopping-content/
+        # guides/reports/segmentation#category_and_product_type) in Google's product
+        # taxonomy.
         # Corresponds to the JSON property `categoryL3`
         # @return [String]
         attr_accessor :category_l3
       
-        # Product category (4th level) in Google's product taxonomy.
+        # [Product category (4th level)](https://developers.google.com/shopping-content/
+        # guides/reports/segmentation#category_and_product_type) in Google's product
+        # taxonomy.
         # Corresponds to the JSON property `categoryL4`
         # @return [String]
         attr_accessor :category_l4
       
-        # Product category (5th level) in Google's product taxonomy.
+        # [Product category (5th level)](https://developers.google.com/shopping-content/
+        # guides/reports/segmentation#category_and_product_type) in Google's product
+        # taxonomy.
         # Corresponds to the JSON property `categoryL5`
         # @return [String]
         attr_accessor :category_l5
@@ -13438,27 +14022,37 @@ module Google
         # @return [String]
         attr_accessor :offer_id
       
-        # Product category (1st level) in merchant's own product taxonomy.
+        # [Product type (1st level)](https://developers.google.com/shopping-content/
+        # guides/reports/segmentation#category_and_product_type) in merchant's own
+        # product taxonomy.
         # Corresponds to the JSON property `productTypeL1`
         # @return [String]
         attr_accessor :product_type_l1
       
-        # Product category (2nd level) in merchant's own product taxonomy.
+        # [Product type (2nd level)](https://developers.google.com/shopping-content/
+        # guides/reports/segmentation#category_and_product_type) in merchant's own
+        # product taxonomy.
         # Corresponds to the JSON property `productTypeL2`
         # @return [String]
         attr_accessor :product_type_l2
       
-        # Product category (3rd level) in merchant's own product taxonomy.
+        # [Product type (3rd level)](https://developers.google.com/shopping-content/
+        # guides/reports/segmentation#category_and_product_type) in merchant's own
+        # product taxonomy.
         # Corresponds to the JSON property `productTypeL3`
         # @return [String]
         attr_accessor :product_type_l3
       
-        # Product category (4th level) in merchant's own product taxonomy.
+        # [Product type (4th level)](https://developers.google.com/shopping-content/
+        # guides/reports/segmentation#category_and_product_type) in merchant's own
+        # product taxonomy.
         # Corresponds to the JSON property `productTypeL4`
         # @return [String]
         attr_accessor :product_type_l4
       
-        # Product category (5th level) in merchant's own product taxonomy.
+        # [Product type (5th level)](https://developers.google.com/shopping-content/
+        # guides/reports/segmentation#category_and_product_type) in merchant's own
+        # product taxonomy.
         # Corresponds to the JSON property `productTypeL5`
         # @return [String]
         attr_accessor :product_type_l5
@@ -13894,8 +14488,8 @@ module Google
       class SettlementreportsListResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # settlementreportsListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # settlementreportsListResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -13926,8 +14520,8 @@ module Google
       class SettlementtransactionsListResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # settlementtransactionsListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # settlementtransactionsListResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -14164,8 +14758,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::ShippingsettingsCustomBatchResponseEntry>]
         attr_accessor :entries
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # shippingsettingsCustomBatchResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # shippingsettingsCustomBatchResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -14229,8 +14823,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::CarriersCarrier>]
         attr_accessor :carriers
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # shippingsettingsGetSupportedCarriersResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # shippingsettingsGetSupportedCarriersResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -14255,8 +14849,8 @@ module Google
         # @return [Array<Google::Apis::ContentV2_1::HolidaysHoliday>]
         attr_accessor :holidays
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # shippingsettingsGetSupportedHolidaysResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # shippingsettingsGetSupportedHolidaysResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -14276,8 +14870,8 @@ module Google
       class ShippingsettingsGetSupportedPickupServicesResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # shippingsettingsGetSupportedPickupServicesResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # shippingsettingsGetSupportedPickupServicesResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -14302,8 +14896,8 @@ module Google
       class ShippingsettingsListResponse
         include Google::Apis::Core::Hashable
       
-        # Identifies what kind of resource this is. Value: the fixed string "content#
-        # shippingsettingsListResponse".
+        # Identifies what kind of resource this is. Value: the fixed string "`content#
+        # shippingsettingsListResponse`".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -14330,6 +14924,88 @@ module Google
         end
       end
       
+      # Response message for GetShoppingAdsProgramStatus.
+      class ShoppingAdsProgramStatus
+        include Google::Apis::Core::Hashable
+      
+        # Status of the program in each region. Regions with the same status and review
+        # eligibility are grouped together in `regionCodes`.
+        # Corresponds to the JSON property `regionStatuses`
+        # @return [Array<Google::Apis::ContentV2_1::ShoppingAdsProgramStatusRegionStatus>]
+        attr_accessor :region_statuses
+      
+        # If program is successfully onboarded for at least one region.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @region_statuses = args[:region_statuses] if args.key?(:region_statuses)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
+      # Status of program and region.
+      class ShoppingAdsProgramStatusRegionStatus
+        include Google::Apis::Core::Hashable
+      
+        # Date by which `eligibility_status` will go from `WARNING` to `DISAPPROVED`. It
+        # will be present when `eligibility_status` is `WARNING`. Date will be provided
+        # in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format i.e. YYYY-MM-DD
+        # Corresponds to the JSON property `disapprovalDate`
+        # @return [String]
+        attr_accessor :disapproval_date
+      
+        # Eligibility status of the Shopping Ads program.
+        # Corresponds to the JSON property `eligibilityStatus`
+        # @return [String]
+        attr_accessor :eligibility_status
+      
+        # Reason if a program in a given country is not eligible for review. Populated
+        # only if `review_eligibility_status` is `INELIGIBLE`.
+        # Corresponds to the JSON property `ineligibilityReason`
+        # @return [String]
+        attr_accessor :ineligibility_reason
+      
+        # The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-
+        # 1_alpha-2) codes for all the regions with the same `eligibilityStatus` and `
+        # reviewEligibility`.
+        # Corresponds to the JSON property `regionCodes`
+        # @return [Array<String>]
+        attr_accessor :region_codes
+      
+        # If a program in a given country is eligible for review. It will be present
+        # only if eligibility status is `DISAPPROVED`.
+        # Corresponds to the JSON property `reviewEligibilityStatus`
+        # @return [String]
+        attr_accessor :review_eligibility_status
+      
+        # These issues will be evaluated in review process. Fix all the issues before
+        # requesting the review.
+        # Corresponds to the JSON property `reviewIssues`
+        # @return [Array<String>]
+        attr_accessor :review_issues
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @disapproval_date = args[:disapproval_date] if args.key?(:disapproval_date)
+          @eligibility_status = args[:eligibility_status] if args.key?(:eligibility_status)
+          @ineligibility_reason = args[:ineligibility_reason] if args.key?(:ineligibility_reason)
+          @region_codes = args[:region_codes] if args.key?(:region_codes)
+          @review_eligibility_status = args[:review_eligibility_status] if args.key?(:review_eligibility_status)
+          @review_issues = args[:review_issues] if args.key?(:review_issues)
+        end
+      end
+      
       # 
       class Table
         include Google::Apis::Core::Hashable
@@ -15015,6 +15691,57 @@ module Google
         end
       end
       
+      # Request message for the VerifyPhoneNumber method.
+      class VerifyPhoneNumberRequest
+        include Google::Apis::Core::Hashable
+      
+        # Verification method used to receive verification code.
+        # Corresponds to the JSON property `phoneVerificationMethod`
+        # @return [String]
+        attr_accessor :phone_verification_method
+      
+        # The verification code that was sent to the phone number for validation.
+        # Corresponds to the JSON property `verificationCode`
+        # @return [String]
+        attr_accessor :verification_code
+      
+        # The verification ID returned by `requestphoneverification`.
+        # Corresponds to the JSON property `verificationId`
+        # @return [String]
+        attr_accessor :verification_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @phone_verification_method = args[:phone_verification_method] if args.key?(:phone_verification_method)
+          @verification_code = args[:verification_code] if args.key?(:verification_code)
+          @verification_id = args[:verification_id] if args.key?(:verification_id)
+        end
+      end
+      
+      # Response message for the VerifyPhoneNumber method.
+      class VerifyPhoneNumberResponse
+        include Google::Apis::Core::Hashable
+      
+        # Verified phone number if verification is successful. This phone number can
+        # only be replaced by another verified phone number.
+        # Corresponds to the JSON property `verifiedPhoneNumber`
+        # @return [String]
+        attr_accessor :verified_phone_number
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @verified_phone_number = args[:verified_phone_number] if args.key?(:verified_phone_number)
+        end
+      end
+      
       # 
       class WarehouseBasedDeliveryTime
         include Google::Apis::Core::Hashable