google-apis-retail_v2beta 0.31.0 → 0.34.0

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

@@ -308,6 +308,35 @@ module Google
         end
       end
       
+      # Metadata related to the progress of the AddLocalInventories operation.
+      # Currently empty because there is no meaningful metadata populated from the
+      # AddLocalInventories method.
+      class GoogleCloudRetailV2AddLocalInventoriesMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Response of the AddLocalInventories API. Currently empty because there is no
+      # meaningful response populated from the AddLocalInventories method.
+      class GoogleCloudRetailV2AddLocalInventoriesResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Response of the ImportCompletionDataRequest. If the long running operation is
       # done, this message is returned by the google.longrunning.Operations.response
       # field if the operation is successful.
@@ -373,8 +402,7 @@ module Google
         # @return [String]
         attr_accessor :notification_pubsub_topic
       
-        # Id of the request / operation. This is parroting back the requestId that was
-        # passed in the request.
+        # Deprecated. This field is never set.
         # Corresponds to the JSON property `requestId`
         # @return [String]
         attr_accessor :request_id
@@ -562,6 +590,35 @@ module Google
         end
       end
       
+      # Metadata related to the progress of the RemoveLocalInventories operation.
+      # Currently empty because there is no meaningful metadata populated from the
+      # RemoveLocalInventories method.
+      class GoogleCloudRetailV2RemoveLocalInventoriesMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Response of the RemoveLocalInventories API. Currently empty because there is
+      # no meaningful response populated from the RemoveLocalInventories method.
+      class GoogleCloudRetailV2RemoveLocalInventoriesResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Metadata related to the progress of the SetInventory operation. Currently
       # empty because there is no meaningful metadata populated from the SetInventory
       # method.
@@ -843,8 +900,7 @@ module Google
         # @return [String]
         attr_accessor :notification_pubsub_topic
       
-        # Id of the request / operation. This is parroting back the requestId that was
-        # passed in the request.
+        # Deprecated. This field is never set.
         # Corresponds to the JSON property `requestId`
         # @return [String]
         attr_accessor :request_id
@@ -950,6 +1006,74 @@ module Google
         end
       end
       
+      # Metadata related to the progress of the PurgeProducts operation. This will be
+      # returned by the google.longrunning.Operation.metadata field.
+      class GoogleCloudRetailV2alphaPurgeProductsMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Operation create time.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Count of entries that encountered errors while processing.
+        # Corresponds to the JSON property `failureCount`
+        # @return [Fixnum]
+        attr_accessor :failure_count
+      
+        # Count of entries that were deleted successfully.
+        # Corresponds to the JSON property `successCount`
+        # @return [Fixnum]
+        attr_accessor :success_count
+      
+        # Operation last update time. If the operation is done, this is also the finish
+        # time.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @failure_count = args[:failure_count] if args.key?(:failure_count)
+          @success_count = args[:success_count] if args.key?(:success_count)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
+      # Response of the PurgeProductsRequest. If the long running operation is
+      # successfully done, then this message is returned by the google.longrunning.
+      # Operations.response field.
+      class GoogleCloudRetailV2alphaPurgeProductsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The total count of products purged as a result of the operation.
+        # Corresponds to the JSON property `purgeCount`
+        # @return [Fixnum]
+        attr_accessor :purge_count
+      
+        # A sample of the product names that will be deleted. Only populated if `force`
+        # is set to false. A max of 100 names will be returned and the names are chosen
+        # at random.
+        # Corresponds to the JSON property `purgeSample`
+        # @return [Array<String>]
+        attr_accessor :purge_sample
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @purge_count = args[:purge_count] if args.key?(:purge_count)
+          @purge_sample = args[:purge_sample] if args.key?(:purge_sample)
+        end
+      end
+      
       # Response of the PurgeUserEventsRequest. If the long running operation is
       # successfully done, then this message is returned by the google.longrunning.
       # Operations.response field.
@@ -1242,6 +1366,86 @@ module Google
         end
       end
       
+      # Metadata related to the progress of the AddLocalInventories operation.
+      # Currently empty because there is no meaningful metadata populated from the
+      # AddLocalInventories method.
+      class GoogleCloudRetailV2betaAddLocalInventoriesMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Request message for AddLocalInventories method.
+      class GoogleCloudRetailV2betaAddLocalInventoriesRequest
+        include Google::Apis::Core::Hashable
+      
+        # Indicates which inventory fields in the provided list of LocalInventory to
+        # update. The field is updated to the provided value. If a field is set while
+        # the place does not have a previous local inventory, the local inventory at
+        # that store is created. If a field is set while the value of that field is not
+        # provided, the original field value, if it exists, is deleted. If the mask is
+        # not set or set with empty paths, all inventory fields will be updated. If an
+        # unsupported or unknown field is provided, an INVALID_ARGUMENT error is
+        # returned and the entire update will be ignored.
+        # Corresponds to the JSON property `addMask`
+        # @return [String]
+        attr_accessor :add_mask
+      
+        # The time when the inventory updates are issued. Used to prevent out-of-order
+        # updates on local inventory fields. If not provided, the internal system time
+        # will be used.
+        # Corresponds to the JSON property `addTime`
+        # @return [String]
+        attr_accessor :add_time
+      
+        # If set to true, and the Product is not found, the local inventory will still
+        # be processed and retained for at most 1 day and processed once the Product is
+        # created. If set to false, a NOT_FOUND error is returned if the Product is not
+        # found.
+        # Corresponds to the JSON property `allowMissing`
+        # @return [Boolean]
+        attr_accessor :allow_missing
+        alias_method :allow_missing?, :allow_missing
+      
+        # Required. A list of inventory information at difference places. Each place is
+        # identified by its place ID. At most 3000 inventories are allowed per request.
+        # Corresponds to the JSON property `localInventories`
+        # @return [Array<Google::Apis::RetailV2beta::GoogleCloudRetailV2betaLocalInventory>]
+        attr_accessor :local_inventories
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @add_mask = args[:add_mask] if args.key?(:add_mask)
+          @add_time = args[:add_time] if args.key?(:add_time)
+          @allow_missing = args[:allow_missing] if args.key?(:allow_missing)
+          @local_inventories = args[:local_inventories] if args.key?(:local_inventories)
+        end
+      end
+      
+      # Response of the AddLocalInventories API. Currently empty because there is no
+      # meaningful response populated from the AddLocalInventories method.
+      class GoogleCloudRetailV2betaAddLocalInventoriesResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Catalog level attribute config.
       class GoogleCloudRetailV2betaAttributesConfig
         include Google::Apis::Core::Hashable
@@ -1330,7 +1534,9 @@ module Google
         # analytics/answer/3437719. * `user_event_ga4`: This feature is in private
         # preview. Please contact the support team for importing Google Analytics 4
         # events. The schema is available here: https://support.google.com/analytics/
-        # answer/7029846.
+        # answer/7029846. Supported values for auto-completion imports: * `suggestions` (
+        # default): One JSON completion suggestion per line. * `denylist`: One JSON deny
+        # suggestion per line. * `allowlist`: One JSON allow suggestion per line.
         # Corresponds to the JSON property `dataSchema`
         # @return [String]
         attr_accessor :data_schema
@@ -1399,6 +1605,12 @@ module Google
         # @return [String]
         attr_accessor :display_name
       
+        # Configures Merchant Center linking. Links contained in the config will be used
+        # to sync data from a Merchant Center account to a Cloud Retail branch.
+        # Corresponds to the JSON property `merchantCenterLinkingConfig`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaMerchantCenterLinkingConfig]
+        attr_accessor :merchant_center_linking_config
+      
         # Required. Immutable. The fully qualified resource name of the catalog.
         # Corresponds to the JSON property `name`
         # @return [String]
@@ -1417,6 +1629,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @display_name = args[:display_name] if args.key?(:display_name)
+          @merchant_center_linking_config = args[:merchant_center_linking_config] if args.key?(:merchant_center_linking_config)
           @name = args[:name] if args.key?(:name)
           @product_level_config = args[:product_level_config] if args.key?(:product_level_config)
         end
@@ -1535,9 +1748,9 @@ module Google
       class GoogleCloudRetailV2betaCompleteQueryResponse
         include Google::Apis::Core::Hashable
       
-        # A unique complete token. This should be included in the SearchRequest
-        # resulting from this completion, which enables accurate attribution of complete
-        # model performance.
+        # A unique complete token. This should be included in the UserEvent.
+        # completion_detail for search events resulting from this completion, which
+        # enables accurate attribution of complete model performance.
         # Corresponds to the JSON property `attributionToken`
         # @return [String]
         attr_accessor :attribution_token
@@ -1577,7 +1790,9 @@ module Google
       class GoogleCloudRetailV2betaCompleteQueryResponseCompletionResult
         include Google::Apis::Core::Hashable
       
-        # Additional custom attributes ingested through BigQuery.
+        # Custom attributes for the suggestion term. * For "user-data", the attributes
+        # are additional custom attributes ingested through BigQuery. * For "cloud-
+        # retail", the attributes are product attributes generated by Cloud Retail.
         # Corresponds to the JSON property `attributes`
         # @return [Hash<String,Google::Apis::RetailV2beta::GoogleCloudRetailV2betaCustomAttribute>]
         attr_accessor :attributes
@@ -1617,6 +1832,103 @@ module Google
         end
       end
       
+      # Catalog level autocomplete config for customers to customize autocomplete
+      # feature's settings.
+      class GoogleCloudRetailV2betaCompletionConfig
+        include Google::Apis::Core::Hashable
+      
+        # The input config source for completion data.
+        # Corresponds to the JSON property `allowlistInputConfig`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaCompletionDataInputConfig]
+        attr_accessor :allowlist_input_config
+      
+        # If set to true, the auto learning function is enabled. Auto learning uses user
+        # data to generate suggestions using ML techniques. Default value is false. Only
+        # after enabling auto learning can users use `cloud-retail` data in
+        # CompleteQueryRequest.
+        # Corresponds to the JSON property `autoLearning`
+        # @return [Boolean]
+        attr_accessor :auto_learning
+        alias_method :auto_learning?, :auto_learning
+      
+        # The input config source for completion data.
+        # Corresponds to the JSON property `denylistInputConfig`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaCompletionDataInputConfig]
+        attr_accessor :denylist_input_config
+      
+        # Output only. LRO corresponding to the latest allowlist import. Can use
+        # GetOperation API to retrieve the latest state of the Long Running Operation.
+        # Corresponds to the JSON property `lastAllowlistImportOperation`
+        # @return [String]
+        attr_accessor :last_allowlist_import_operation
+      
+        # Output only. LRO corresponding to the latest denylist import. Can use
+        # GetOperation API to retrieve the latest state of the Long Running Operation.
+        # Corresponds to the JSON property `lastDenylistImportOperation`
+        # @return [String]
+        attr_accessor :last_denylist_import_operation
+      
+        # Output only. Name of the LRO corresponding to the latest suggestion terms list
+        # import. Can use GetOperation API to retrieve the latest state of the Long
+        # Running Operation.
+        # Corresponds to the JSON property `lastSuggestionsImportOperation`
+        # @return [String]
+        attr_accessor :last_suggestions_import_operation
+      
+        # Specifies the matching order for autocomplete suggestions, e.g., a query
+        # consisting of 'sh' with 'out-of-order' specified would suggest "women's shoes",
+        # whereas a query of 'red s' with 'exact-prefix' specified would suggest "red
+        # shoes". Currently supported values: * 'out-of-order' * 'exact-prefix' Default
+        # value: 'exact-prefix'.
+        # Corresponds to the JSON property `matchingOrder`
+        # @return [String]
+        attr_accessor :matching_order
+      
+        # The maximum number of autocomplete suggestions returned per term. The maximum
+        # allowed max suggestions is 20. Default value is 20. If left unset or set to 0,
+        # then will fallback to default value.
+        # Corresponds to the JSON property `maxSuggestions`
+        # @return [Fixnum]
+        attr_accessor :max_suggestions
+      
+        # The minimum number of characters needed to be typed in order to get
+        # suggestions. Default value is 2. If left unset or set to 0, then will fallback
+        # to default value.
+        # Corresponds to the JSON property `minPrefixLength`
+        # @return [Fixnum]
+        attr_accessor :min_prefix_length
+      
+        # Required. Immutable. Fully qualified name projects/*/locations/*/catalogs/*/
+        # completionConfig
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The input config source for completion data.
+        # Corresponds to the JSON property `suggestionsInputConfig`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaCompletionDataInputConfig]
+        attr_accessor :suggestions_input_config
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @allowlist_input_config = args[:allowlist_input_config] if args.key?(:allowlist_input_config)
+          @auto_learning = args[:auto_learning] if args.key?(:auto_learning)
+          @denylist_input_config = args[:denylist_input_config] if args.key?(:denylist_input_config)
+          @last_allowlist_import_operation = args[:last_allowlist_import_operation] if args.key?(:last_allowlist_import_operation)
+          @last_denylist_import_operation = args[:last_denylist_import_operation] if args.key?(:last_denylist_import_operation)
+          @last_suggestions_import_operation = args[:last_suggestions_import_operation] if args.key?(:last_suggestions_import_operation)
+          @matching_order = args[:matching_order] if args.key?(:matching_order)
+          @max_suggestions = args[:max_suggestions] if args.key?(:max_suggestions)
+          @min_prefix_length = args[:min_prefix_length] if args.key?(:min_prefix_length)
+          @name = args[:name] if args.key?(:name)
+          @suggestions_input_config = args[:suggestions_input_config] if args.key?(:suggestions_input_config)
+        end
+      end
+      
       # The input config source for completion data.
       class GoogleCloudRetailV2betaCompletionDataInputConfig
         include Google::Apis::Core::Hashable
@@ -1794,6 +2106,14 @@ module Google
         # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaRule]
         attr_accessor :rule
       
+        # Required. Specifies the use case for the control. Affects what condition
+        # fields can be set. Only settable by search controls. Will default to
+        # SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one
+        # search_solution_use_case per control.
+        # Corresponds to the JSON property `searchSolutionUseCase`
+        # @return [Array<String>]
+        attr_accessor :search_solution_use_case
+      
         # Required. Immutable. The solution types that the serving config is used for.
         # Currently we support setting only one type of solution at creation time. Only `
         # SOLUTION_TYPE_SEARCH` value is supported at the moment. If no solution type is
@@ -1813,6 +2133,7 @@ module Google
           @facet_spec = args[:facet_spec] if args.key?(:facet_spec)
           @name = args[:name] if args.key?(:name)
           @rule = args[:rule] if args.key?(:rule)
+          @search_solution_use_case = args[:search_solution_use_case] if args.key?(:search_solution_use_case)
           @solution_types = args[:solution_types] if args.key?(:solution_types)
         end
       end
@@ -2080,7 +2401,10 @@ module Google
         end
       end
       
-      # Product thumbnail/detail image.
+      # Product image. Recommendations AI and Retail Search do not use product images
+      # to improve prediction and search results. However, product images can be
+      # returned in results, and are shown in prediction or search previews in the
+      # console.
       class GoogleCloudRetailV2betaImage
         include Google::Apis::Core::Hashable
       
@@ -2210,8 +2534,7 @@ module Google
         # @return [String]
         attr_accessor :notification_pubsub_topic
       
-        # Id of the request / operation. This is parroting back the requestId that was
-        # passed in the request.
+        # Deprecated. This field is never set.
         # Corresponds to the JSON property `requestId`
         # @return [String]
         attr_accessor :request_id
@@ -2271,11 +2594,7 @@ module Google
         # @return [String]
         attr_accessor :reconciliation_mode
       
-        # Unique identifier provided by client, within the ancestor dataset scope.
-        # Ensures idempotency and used for request deduplication. Server-generated if
-        # unspecified. Up to 128 characters long and must match the pattern: `[a-zA-Z0-
-        # 9_]+`. This is returned as Operation.name in ImportMetadata. Only supported
-        # when ImportProductsRequest.reconciliation_mode is set to `FULL`.
+        # Deprecated. This field has no effect.
         # Corresponds to the JSON property `requestId`
         # @return [String]
         attr_accessor :request_id
@@ -2526,6 +2845,141 @@ module Google
         end
       end
       
+      # The inventory information at a place (e.g. a store) identified by a place ID.
+      class GoogleCloudRetailV2betaLocalInventory
+        include Google::Apis::Core::Hashable
+      
+        # Additional local inventory attributes, for example, store name, promotion tags,
+        # etc. This field needs to pass all below criteria, otherwise an
+        # INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The
+        # key must be a UTF-8 encoded string with a length limit of 32 characters. * The
+        # key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or
+        # KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or
+        # number). * Only 1 value is allowed for each attribute. * For text values, the
+        # length limit is 256 UTF-8 characters. * The attribute does not support search.
+        # The `searchable` field should be unset or set to false. * The max summed total
+        # bytes of custom attribute keys and values per product is 5MiB.
+        # Corresponds to the JSON property `attributes`
+        # @return [Hash<String,Google::Apis::RetailV2beta::GoogleCloudRetailV2betaCustomAttribute>]
+        attr_accessor :attributes
+      
+        # Input only. Supported fulfillment types. Valid fulfillment type values include
+        # commonly used types (such as pickup in store and same day delivery), and
+        # custom types. Customers have to map custom types to their display names before
+        # rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-
+        # day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "
+        # custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an
+        # invalid value other than these, an INVALID_ARGUMENT error is returned. All the
+        # elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+        # Corresponds to the JSON property `fulfillmentTypes`
+        # @return [Array<String>]
+        attr_accessor :fulfillment_types
+      
+        # The place ID for the current set of inventory information.
+        # Corresponds to the JSON property `placeId`
+        # @return [String]
+        attr_accessor :place_id
+      
+        # The price information of a Product.
+        # Corresponds to the JSON property `priceInfo`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaPriceInfo]
+        attr_accessor :price_info
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @attributes = args[:attributes] if args.key?(:attributes)
+          @fulfillment_types = args[:fulfillment_types] if args.key?(:fulfillment_types)
+          @place_id = args[:place_id] if args.key?(:place_id)
+          @price_info = args[:price_info] if args.key?(:price_info)
+        end
+      end
+      
+      # Represents a link between a Merchant Center account and a branch. Once a link
+      # is established, products from the linked merchant center account will be
+      # streamed to the linked branch.
+      class GoogleCloudRetailV2betaMerchantCenterLink
+        include Google::Apis::Core::Hashable
+      
+        # The branch id (e.g. 0/1/2) within this catalog that products from
+        # merchant_center_account_id are streamed to. When updating this field, an empty
+        # value will use the currently configured default branch. However, changing the
+        # default branch later on won't change the linked branch here. A single branch
+        # id can only have one linked merchant center account id.
+        # Corresponds to the JSON property `branchId`
+        # @return [String]
+        attr_accessor :branch_id
+      
+        # String representing the destination to import for, all if left empty. List of
+        # possible values can be found here. [https://support.google.com/merchants/
+        # answer/7501026] List of allowed string values: "Shopping_ads", "
+        # Buy_on_google_listings", "Display_ads", "Local_inventory _ads", "Free_listings"
+        # , "Free_local_listings" NOTE: The string values are case sensitive.
+        # Corresponds to the JSON property `destinations`
+        # @return [Array<String>]
+        attr_accessor :destinations
+      
+        # Language of the title/description and other string attributes. Use language
+        # tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). ISO
+        # 639-1. This specifies the language of offers in Merchant Center that will be
+        # accepted. If empty no language filtering will be performed. Example value: `en`
+        # .
+        # Corresponds to the JSON property `languageCode`
+        # @return [String]
+        attr_accessor :language_code
+      
+        # Required. The linked [Merchant center account id](https://developers.google.
+        # com/shopping-content/guides/accountstatuses). The account must be a standalone
+        # account or a sub-account of a MCA.
+        # Corresponds to the JSON property `merchantCenterAccountId`
+        # @return [Fixnum]
+        attr_accessor :merchant_center_account_id
+      
+        # Region code of offers to accept. 2-letter Uppercase ISO 3166-1 alpha-2 code.
+        # List of values can be found [here](https://www.iana.org/assignments/language-
+        # subtag-registry/language-subtag-registry) under the `region` tag. If left
+        # blank no region filtering will be performed. Example value: `US`.
+        # 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)
+          @branch_id = args[:branch_id] if args.key?(:branch_id)
+          @destinations = args[:destinations] if args.key?(:destinations)
+          @language_code = args[:language_code] if args.key?(:language_code)
+          @merchant_center_account_id = args[:merchant_center_account_id] if args.key?(:merchant_center_account_id)
+          @region_code = args[:region_code] if args.key?(:region_code)
+        end
+      end
+      
+      # Configures Merchant Center linking. Links contained in the config will be used
+      # to sync data from a Merchant Center account to a Cloud Retail branch.
+      class GoogleCloudRetailV2betaMerchantCenterLinkingConfig
+        include Google::Apis::Core::Hashable
+      
+        # Links between Merchant Center accounts and branches.
+        # Corresponds to the JSON property `links`
+        # @return [Array<Google::Apis::RetailV2beta::GoogleCloudRetailV2betaMerchantCenterLink>]
+        attr_accessor :links
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @links = args[:links] if args.key?(:links)
+        end
+      end
+      
       # Request message for Predict method.
       class GoogleCloudRetailV2betaPredictRequest
         include Google::Apis::Core::Hashable
@@ -2542,9 +2996,11 @@ module Google
         # do not have a stockState value of OUT_OF_STOCK. Examples: * tag=("Red" OR "
         # Blue") tag="New-Arrival" tag=(NOT "promotional") * filterOutOfStockItems tag=(-
         # "promotional") * filterOutOfStockItems If your filter blocks all prediction
-        # results, nothing will be returned. If you want generic (unfiltered) popular
-        # products to be returned instead, set `strictFiltering` to false in `
-        # PredictRequest.params`.
+        # results, the API will return generic (unfiltered) popular products. If you
+        # only want results strictly matching the filters, set `strictFiltering` to True
+        # in `PredictRequest.params` to receive empty results instead. Note that the API
+        # will never return items with storageStatus of "EXPIRED" or "DELETED"
+        # regardless of filter choices.
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
@@ -2951,7 +3407,7 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Product images for the product.Highly recommended to put the main image to the
+        # Product images for the product. We highly recommend putting the main image
         # first. A maximum of 300 images are allowed. Corresponding properties: Google
         # Merchant Center property [image_link](https://support.google.com/merchants/
         # answer/6324350). Schema.org property [Product.image](https://schema.org/image).
@@ -3648,6 +4104,73 @@ module Google
         end
       end
       
+      # Metadata related to the progress of the RemoveLocalInventories operation.
+      # Currently empty because there is no meaningful metadata populated from the
+      # RemoveLocalInventories method.
+      class GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Request message for RemoveLocalInventories method.
+      class GoogleCloudRetailV2betaRemoveLocalInventoriesRequest
+        include Google::Apis::Core::Hashable
+      
+        # If set to true, and the Product is not found, the local inventory removal
+        # request will still be processed and retained for at most 1 day and processed
+        # once the Product is created. If set to false, a NOT_FOUND error is returned if
+        # the Product is not found.
+        # Corresponds to the JSON property `allowMissing`
+        # @return [Boolean]
+        attr_accessor :allow_missing
+        alias_method :allow_missing?, :allow_missing
+      
+        # Required. A list of place IDs to have their inventory deleted. At most 3000
+        # place IDs are allowed per request.
+        # Corresponds to the JSON property `placeIds`
+        # @return [Array<String>]
+        attr_accessor :place_ids
+      
+        # The time when the inventory deletions are issued. Used to prevent out-of-order
+        # updates and deletions on local inventory fields. If not provided, the internal
+        # system time will be used.
+        # Corresponds to the JSON property `removeTime`
+        # @return [String]
+        attr_accessor :remove_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @allow_missing = args[:allow_missing] if args.key?(:allow_missing)
+          @place_ids = args[:place_ids] if args.key?(:place_ids)
+          @remove_time = args[:remove_time] if args.key?(:remove_time)
+        end
+      end
+      
+      # Response of the RemoveLocalInventories API. Currently empty because there is
+      # no meaningful response populated from the RemoveLocalInventories method.
+      class GoogleCloudRetailV2betaRemoveLocalInventoriesResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Request for CatalogService.ReplaceCatalogAttribute method.
       class GoogleCloudRetailV2betaReplaceCatalogAttributeRequest
         include Google::Apis::Core::Hashable
@@ -4019,12 +4542,13 @@ module Google
         # @return [String]
         attr_accessor :branch
       
-        # The filter applied to every search request when quality improvement such as
-        # query expansion is needed. For example, if a query does not have enough
-        # results, an expanded query with SearchRequest.canonical_filter will be
-        # returned as a supplement of the original query. This field is strongly
-        # recommended to achieve high search quality. See SearchRequest.filter for more
-        # details about filter syntax.
+        # The default filter that is applied when a user performs a search without
+        # checking any filters on the search page. The filter applied to every search
+        # request when quality improvement such as query expansion is needed. For
+        # example, if a query does not have enough results, an expanded query with
+        # SearchRequest.canonical_filter will be returned as a supplement of the
+        # original query. This field is strongly recommended to achieve high search
+        # quality. See SearchRequest.filter for more details about filter syntax.
         # Corresponds to the JSON property `canonicalFilter`
         # @return [String]
         attr_accessor :canonical_filter
@@ -5014,15 +5538,21 @@ module Google
       class GoogleCloudRetailV2betaUserEvent
         include Google::Apis::Core::Hashable
       
-        # Extra user event features to include in the recommendation model. This field
-        # needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is
-        # returned: * The key must be a UTF-8 encoded string with a length limit of 5,
-        # 000 characters. * For text attributes, at most 400 values are allowed. Empty
-        # values are not allowed. Each value must be a UTF-8 encoded string with a
-        # length limit of 256 characters. * For number attributes, at most 400 values
-        # are allowed. For product recommendation, an example of extra user information
-        # is traffic_channel, i.e. how user arrives at the site. Users can arrive at the
-        # site by coming to the site directly, or coming through Google search, and etc.
+        # Extra user event features to include in the recommendation model. If you
+        # provide custom attributes for ingested user events, also include them in the
+        # user events that you associate with prediction requests. Custom attribute
+        # formatting must be consistent between imported events and events provided with
+        # prediction requests. This lets the Retail API use those custom attributes when
+        # training models and serving predictions, which helps improve recommendation
+        # quality. This field needs to pass all below criteria, otherwise an
+        # INVALID_ARGUMENT error is returned: * The key must be a UTF-8 encoded string
+        # with a length limit of 5,000 characters. * For text attributes, at most 400
+        # values are allowed. Empty values are not allowed. Each value must be a UTF-8
+        # encoded string with a length limit of 256 characters. * For number attributes,
+        # at most 400 values are allowed. For product recommendations, an example of
+        # extra user information is traffic_channel, which is how a user arrives at the
+        # site. Users can arrive at the site by coming to the site directly, coming
+        # through Google search, or in other ways.
         # Corresponds to the JSON property `attributes`
         # @return [Hash<String,Google::Apis::RetailV2beta::GoogleCloudRetailV2betaCustomAttribute>]
         attr_accessor :attributes
@@ -5320,13 +5850,12 @@ module Google
         attr_accessor :direct_user_request
         alias_method :direct_user_request?, :direct_user_request
       
-        # The end user's IP address. Required for getting SearchResponse.
-        # sponsored_results. This field is used to extract location information for
-        # personalization. This field must be either an IPv4 address (e.g. "104.133.9.80"
-        # ) or an IPv6 address (e.g. "2001:0db8:85a3:0000:0000:8a2e:0370:7334").
-        # Otherwise, an INVALID_ARGUMENT error is returned. This should not be set when
-        # using the JavaScript tag in UserEventService.CollectUserEvent or if
-        # direct_user_request is set.
+        # The end user's IP address. This field is used to extract location information
+        # for personalization. This field must be either an IPv4 address (e.g. "104.133.
+        # 9.80") or an IPv6 address (e.g. "2001:0db8:85a3:0000:0000:8a2e:0370:7334").
+        # Otherwise, an INVALID_ARGUMENT error is returned. This should not be set when:
+        # * setting SearchRequest.user_info. * using the JavaScript tag in
+        # UserEventService.CollectUserEvent or if direct_user_request is set.
         # Corresponds to the JSON property `ipAddress`
         # @return [String]
         attr_accessor :ip_address
@@ -5342,8 +5871,9 @@ module Google
         attr_accessor :user_agent
       
         # Highly recommended for logged-in users. Unique identifier for logged-in user,
-        # such as a user name. The field must be a UTF-8 encoded string with a length
-        # limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.
+        # such as a user name. Always use a hashed value for this ID. The field must be
+        # a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an
+        # INVALID_ARGUMENT error is returned.
         # Corresponds to the JSON property `userId`
         # @return [String]
         attr_accessor :user_id
@@ -5451,8 +5981,7 @@ module Google
       # A generic empty message that you can re-use to avoid defining duplicated empty
       # messages in your APIs. A typical example is to use it as the request or the
       # response type of an API method. For instance: service Foo ` rpc Bar(google.
-      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
-      # `Empty` is empty JSON object ````.
+      # protobuf.Empty) returns (google.protobuf.Empty); `
       class GoogleProtobufEmpty
         include Google::Apis::Core::Hashable