google-apis-retail_v2beta 0.32.0 → 0.35.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
@@ -1310,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
@@ -1398,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
@@ -1467,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]
@@ -1485,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
@@ -1603,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
@@ -1645,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
@@ -1685,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
@@ -1862,14 +2106,6 @@ 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
@@ -1889,7 +2125,6 @@ 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
@@ -2290,8 +2525,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
@@ -2351,11 +2585,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
@@ -2606,6 +2836,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
@@ -3337,13 +3702,13 @@ module Google
         # The type of Products allowed to be ingested into the catalog. Acceptable
         # values are: * `primary` (default): You can ingest Products of all types. When
         # ingesting a Product, its type will default to Product.Type.PRIMARY if unset. *
-        # `variant`: You can only ingest Product.Type.VARIANT Products. This means
-        # Product.primary_product_id cannot be empty. If this field is set to an invalid
-        # value other than these, an INVALID_ARGUMENT error is returned. If this field
-        # is `variant` and merchant_center_product_id_field is `itemGroupId`, an
-        # INVALID_ARGUMENT error is returned. See [Using product levels](https://cloud.
-        # google.com/retail/recommendations-ai/docs/catalog#product-levels) for more
-        # details.
+        # `variant` (incompatible with Retail Search): You can only ingest Product.Type.
+        # VARIANT Products. This means Product.primary_product_id cannot be empty. If
+        # this field is set to an invalid value other than these, an INVALID_ARGUMENT
+        # error is returned. If this field is `variant` and
+        # merchant_center_product_id_field is `itemGroupId`, an INVALID_ARGUMENT error
+        # is returned. See [Product levels](https://cloud.google.com/retail/docs/catalog#
+        # product-levels) for more details.
         # Corresponds to the JSON property `ingestionProductType`
         # @return [String]
         attr_accessor :ingestion_product_type
@@ -3356,8 +3721,8 @@ module Google
         # the item group. If this field is set to an invalid value other than these, an
         # INVALID_ARGUMENT error is returned. If this field is `itemGroupId` and
         # ingestion_product_type is `variant`, an INVALID_ARGUMENT error is returned.
-        # See [Using product levels](https://cloud.google.com/retail/recommendations-ai/
-        # docs/catalog#product-levels) for more details.
+        # See [Product levels](https://cloud.google.com/retail/docs/catalog#product-
+        # levels) for more details.
         # Corresponds to the JSON property `merchantCenterProductIdField`
         # @return [String]
         attr_accessor :merchant_center_product_id_field
@@ -3730,6 +4095,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
@@ -4182,7 +4614,8 @@ module Google
         # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaSearchRequestPersonalizationSpec]
         attr_accessor :personalization_spec
       
-        # Raw search query.
+        # Raw search query. If this field is empty, the request is considered a category
+        # browsing request and returned results are based on filter and page_categories.
         # Corresponds to the JSON property `query`
         # @return [String]
         attr_accessor :query
@@ -5279,10 +5712,12 @@ module Google
         # Required. A unique identifier for tracking visitors. For example, this could
         # be implemented with an HTTP cookie, which should be able to uniquely identify
         # a visitor on a single device. This unique identifier should not change if the
-        # visitor log in/out of the website. The field must be a UTF-8 encoded string
-        # with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is
-        # returned. The field should not contain PII or user-data. We recommend to use
-        # Google Analystics [Client ID](https://developers.google.com/analytics/
+        # visitor log in/out of the website. Don't set the field to the same fixed ID
+        # for different users. This mixes the event history of those users together,
+        # which results in degraded model quality. The field must be a UTF-8 encoded
+        # string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT
+        # error is returned. The field should not contain PII or user-data. We recommend
+        # to use Google Analystics [Client ID](https://developers.google.com/analytics/
         # devguides/collection/analyticsjs/field-reference#clientId) for this field.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
@@ -5409,13 +5844,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
@@ -5431,7 +5865,10 @@ 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
+        # such as a user name. Don't set for anonymous users. Always use a hashed value
+        # for this ID. Don't set the field to the same fixed ID for different users.
+        # This mixes the event history of those users together, which results in
+        # degraded model quality. 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]
@@ -5540,8 +5977,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