google-apis-content_v2_1 0.18.0 → 0.22.0

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

@@ -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
@@ -1137,6 +1146,11 @@ module Google
         # @return [String]
         attr_accessor :action
       
+        # Additional information required for E_COMMERCE_PLATFORM link type.
+        # Corresponds to the JSON property `eCommercePlatformLinkInfo`
+        # @return [Google::Apis::ContentV2_1::ECommercePlatformLinkInfo]
+        attr_accessor :e_commerce_platform_link_info
+      
         # Type of the link between the two accounts. Acceptable values are: - "`
         # channelPartner`" - "`eCommercePlatform`" - "`paymentServiceProvider`"
         # Corresponds to the JSON property `linkType`
@@ -1167,6 +1181,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @action = args[:action] if args.key?(:action)
+          @e_commerce_platform_link_info = args[:e_commerce_platform_link_info] if args.key?(:e_commerce_platform_link_info)
           @link_type = args[:link_type] if args.key?(:link_type)
           @linked_account_id = args[:linked_account_id] if args.key?(:linked_account_id)
           @payment_service_provider_link_info = args[:payment_service_provider_link_info] if args.key?(:payment_service_provider_link_info)
@@ -1651,7 +1666,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 +1685,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 +1748,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
@@ -3148,6 +3244,25 @@ module Google
         end
       end
       
+      # Additional information required for E_COMMERCE_PLATFORM link type.
+      class ECommercePlatformLinkInfo
+        include Google::Apis::Core::Hashable
+      
+        # The id used by the third party service provider to identify the merchant.
+        # Corresponds to the JSON property `externalAccountId`
+        # @return [String]
+        attr_accessor :external_account_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @external_account_id = args[:external_account_id] if args.key?(:external_account_id)
+        end
+      end
+      
       # An error returned by the API.
       class Error
         include Google::Apis::Core::Hashable
@@ -3210,6 +3325,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
@@ -5375,7 +5578,7 @@ module Google
         # "`noInventory`" - "`orderTimeout`" - "`other`" - "`paymentAbuse`" - "`
         # paymentDeclined`" - "`priceError`" - "`returnRefundAbuse`" - "`
         # shippingPriceError`" - "`taxError`" - "`undeliverableShippingAddress`" - "`
-        # unsupportedPoBoxAddress`"
+        # unsupportedPoBoxAddress`" - "`failedToCaptureFunds`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -7663,7 +7866,8 @@ module Google
         # The reason for the cancellation. Acceptable values are: - "`
         # customerInitiatedCancel`" - "`invalidCoupon`" - "`malformedShippingAddress`" -
         # "`noInventory`" - "`other`" - "`priceError`" - "`shippingPriceError`" - "`
-        # taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`"
+        # taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "
+        # `failedToCaptureFunds`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -7727,7 +7931,8 @@ module Google
         # The reason for the cancellation. Acceptable values are: - "`
         # customerInitiatedCancel`" - "`invalidCoupon`" - "`malformedShippingAddress`" -
         # "`noInventory`" - "`other`" - "`priceError`" - "`shippingPriceError`" - "`
-        # taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`"
+        # taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "
+        # `failedToCaptureFunds`"
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -10203,16 +10408,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 +10633,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 +10696,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 +11212,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
@@ -11006,8 +11292,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
@@ -11304,6 +11590,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
@@ -12355,6 +12852,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
@@ -12368,6 +12926,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
@@ -13308,7 +13906,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
@@ -13365,27 +13965,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
@@ -13439,27 +14049,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
@@ -14331,6 +14951,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
@@ -15016,6 +15718,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