google-apis-retail_v2beta 0.22.0 → 0.26.0

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

@@ -1117,6 +1117,26 @@ module Google
         end
       end
       
+      # Request for AddControl method.
+      class GoogleCloudRetailV2betaAddControlRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The id of the control to apply. Assumed to be in the same catalog as
+        # the serving config - if id is not found a NOT_FOUND error is returned.
+        # Corresponds to the JSON property `controlId`
+        # @return [String]
+        attr_accessor :control_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @control_id = args[:control_id] if args.key?(:control_id)
+        end
+      end
+      
       # Metadata related to the progress of the AddFulfillmentPlaces operation.
       # Currently empty because there is no meaningful metadata populated from the
       # AddFulfillmentPlaces method.
@@ -1520,6 +1540,153 @@ module Google
         end
       end
       
+      # Metadata that is used to define a condition that triggers an action. A valid
+      # condition must specify at least one of 'query_terms' or 'products_filter'. If
+      # multiple fields are specified, the condition is met if all the fields are
+      # satisfied e.g. if a set of query terms and product_filter are set, then only
+      # items matching the product_filter for requests with a query matching the query
+      # terms wil get boosted.
+      class GoogleCloudRetailV2betaCondition
+        include Google::Apis::Core::Hashable
+      
+        # Range of time(s) specifying when Condition is active. Condition true if any
+        # time range matches.
+        # Corresponds to the JSON property `activeTimeRange`
+        # @return [Array<Google::Apis::RetailV2beta::GoogleCloudRetailV2betaConditionTimeRange>]
+        attr_accessor :active_time_range
+      
+        # A list (up to 10 entries) of terms to match the query on. If not specified,
+        # match all queries. If many query terms are specified, the condition is matched
+        # if any of the terms is a match (i.e. using the OR operator).
+        # Corresponds to the JSON property `queryTerms`
+        # @return [Array<Google::Apis::RetailV2beta::GoogleCloudRetailV2betaConditionQueryTerm>]
+        attr_accessor :query_terms
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @active_time_range = args[:active_time_range] if args.key?(:active_time_range)
+          @query_terms = args[:query_terms] if args.key?(:query_terms)
+        end
+      end
+      
+      # Query terms that we want to match on.
+      class GoogleCloudRetailV2betaConditionQueryTerm
+        include Google::Apis::Core::Hashable
+      
+        # Whether this is supposed to be a full or partial match.
+        # Corresponds to the JSON property `fullMatch`
+        # @return [Boolean]
+        attr_accessor :full_match
+        alias_method :full_match?, :full_match
+      
+        # The value of the term to match on. Value cannot be empty. Value can have at
+        # most 3 terms if specified as a partial match. Each space separated string is
+        # considered as one term. Example) "a b c" is 3 terms and allowed, " a b c d" is
+        # 4 terms and not allowed for partial match.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @full_match = args[:full_match] if args.key?(:full_match)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
+      # Used for time-dependent conditions. Example: Want to have rule applied for
+      # week long sale.
+      class GoogleCloudRetailV2betaConditionTimeRange
+        include Google::Apis::Core::Hashable
+      
+        # End of time range. Range is inclusive.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # Start of time range. Range is inclusive.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @start_time = args[:start_time] if args.key?(:start_time)
+        end
+      end
+      
+      # Configures dynamic serving time metadata that is used to pre and post process
+      # search/recommendation model results.
+      class GoogleCloudRetailV2betaControl
+        include Google::Apis::Core::Hashable
+      
+        # Output only. List of serving configuration ids that that are associated with
+        # this control. Note the association is managed via the ServingConfig, this is
+        # an output only denormalizeed view. Assumed to be in the same catalog.
+        # Corresponds to the JSON property `associatedServingConfigIds`
+        # @return [Array<String>]
+        attr_accessor :associated_serving_config_ids
+      
+        # Required. The human readable control display name. Used in Retail UI. This
+        # field must be a UTF-8 encoded string with a length limit of 128 characters.
+        # Otherwise, an INVALID_ARGUMENT error is thrown.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # A facet specification to perform faceted search.
+        # Corresponds to the JSON property `facetSpec`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaSearchRequestFacetSpec]
+        attr_accessor :facet_spec
+      
+        # Immutable. Fully qualified name projects/*/locations/global/catalogs/*/
+        # controls/*
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # A rule is a condition-action pair * A condition defines when a rule is to be
+        # triggered. * An action specifies what occurs on that trigger. Currently only
+        # boost rules are supported. Currently only supported by the search endpoint.
+        # Corresponds to the JSON property `rule`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaRule]
+        attr_accessor :rule
+      
+        # 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.
+        # Corresponds to the JSON property `solutionTypes`
+        # @return [Array<String>]
+        attr_accessor :solution_types
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @associated_serving_config_ids = args[:associated_serving_config_ids] if args.key?(:associated_serving_config_ids)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @facet_spec = args[:facet_spec] if args.key?(:facet_spec)
+          @name = args[:name] if args.key?(:name)
+          @rule = args[:rule] if args.key?(:rule)
+          @solution_types = args[:solution_types] if args.key?(:solution_types)
+        end
+      end
+      
       # A custom attribute that is not explicitly modeled in Product.
       class GoogleCloudRetailV2betaCustomAttribute
         include Google::Apis::Core::Hashable
@@ -1534,9 +1701,8 @@ module Google
         alias_method :indexable?, :indexable
       
         # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when
-        # the key is "lengths_cm". At most 400 values are allowed.Otherwise, an
-        # INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be
-        # set. Otherwise, an INVALID_ARGUMENT error is returned.
+        # the key is "lengths_cm". Exactly one of text or numbers should be set.
+        # Otherwise, an INVALID_ARGUMENT error is returned.
         # Corresponds to the JSON property `numbers`
         # @return [Array<Float>]
         attr_accessor :numbers
@@ -1550,11 +1716,8 @@ module Google
         alias_method :searchable?, :searchable
       
         # The textual values of this custom attribute. For example, `["yellow", "green"]`
-        # when the key is "color". 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. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of
-        # text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is
-        # returned.
+        # when the key is "color". Exactly one of text or numbers should be set.
+        # Otherwise, an INVALID_ARGUMENT error is returned.
         # Corresponds to the JSON property `text`
         # @return [Array<String>]
         attr_accessor :text
@@ -1721,6 +1884,9 @@ module Google
         # recommendations-ai/docs/upload-catalog#mc). Supported values for user events
         # imports: * `user_event` (default): One JSON UserEvent per line. * `
         # user_event_ga360`: Using https://support.google.com/analytics/answer/3437719.
+        # Supported values for control imports: * 'control' (default): One JSON Control
+        # per line. Supported values for catalog attribute imports: * 'catalog_attribute'
+        # (default): One CSV CatalogAttribute per line.
         # Corresponds to the JSON property `dataSchema`
         # @return [String]
         attr_accessor :data_schema
@@ -2149,6 +2315,31 @@ module Google
         end
       end
       
+      # Response for ListControls method.
+      class GoogleCloudRetailV2betaListControlsResponse
+        include Google::Apis::Core::Hashable
+      
+        # All the Controls for a given catalog.
+        # Corresponds to the JSON property `controls`
+        # @return [Array<Google::Apis::RetailV2beta::GoogleCloudRetailV2betaControl>]
+        attr_accessor :controls
+      
+        # Pagination token, if not returned indicates the last page.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @controls = args[:controls] if args.key?(:controls)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # Response message for ProductService.ListProducts method.
       class GoogleCloudRetailV2betaListProductsResponse
         include Google::Apis::Core::Hashable
@@ -2175,6 +2366,31 @@ module Google
         end
       end
       
+      # Response for ListServingConfigs method.
+      class GoogleCloudRetailV2betaListServingConfigsResponse
+        include Google::Apis::Core::Hashable
+      
+        # Pagination token, if not returned indicates the last page.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # All the ServingConfigs for a given catalog.
+        # Corresponds to the JSON property `servingConfigs`
+        # @return [Array<Google::Apis::RetailV2beta::GoogleCloudRetailV2betaServingConfig>]
+        attr_accessor :serving_configs
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @serving_configs = args[:serving_configs] if args.key?(:serving_configs)
+        end
+      end
+      
       # Request message for Predict method.
       class GoogleCloudRetailV2betaPredictRequest
         include Google::Apis::Core::Hashable
@@ -2374,8 +2590,8 @@ module Google
         attr_accessor :original_price
       
         # Price of the product. Google Merchant Center property [price](https://support.
-        # google.com/merchants/answer/6324371). Schema.org property [Offer.
-        # priceSpecification](https://schema.org/priceSpecification).
+        # google.com/merchants/answer/6324371). Schema.org property [Offer.price](https:/
+        # /schema.org/price).
         # Corresponds to the JSON property `price`
         # @return [Float]
         attr_accessor :price
@@ -2463,7 +2679,10 @@ module Google
         # INVALID_ARGUMENT error is returned: * Max entries count: 200. * The key must
         # be a UTF-8 encoded string with a length limit of 128 characters. * For
         # indexable attribute, the key must match the pattern: `a-zA-Z0-9*`. For example,
-        # key0LikeThis or KEY_1_LIKE_THIS.
+        # `key0LikeThis` or `KEY_1_LIKE_THIS`. * 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.
         # Corresponds to the JSON property `attributes`
         # @return [Hash<String,Google::Apis::RetailV2beta::GoogleCloudRetailV2betaCustomAttribute>]
         attr_accessor :attributes
@@ -2474,9 +2693,9 @@ module Google
         attr_accessor :audience
       
         # The online availability of the Product. Default to Availability.IN_STOCK.
-        # Google Merchant Center Property [availability](https://support.google.com/
-        # merchants/answer/6324448). Schema.org Property [Offer.availability](https://
-        # schema.org/availability).
+        # Corresponding properties: Google Merchant Center property [availability](https:
+        # //support.google.com/merchants/answer/6324448). Schema.org property [Offer.
+        # availability](https://schema.org/availability).
         # Corresponds to the JSON property `availability`
         # @return [String]
         attr_accessor :availability
@@ -2493,9 +2712,9 @@ module Google
       
         # The brands of the product. A maximum of 30 brands are allowed. Each brand must
         # be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise,
-        # an INVALID_ARGUMENT error is returned. Google Merchant Center property [brand](
-        # https://support.google.com/merchants/answer/6324351). Schema.org property [
-        # Product.brand](https://schema.org/brand).
+        # an INVALID_ARGUMENT error is returned. Corresponding properties: Google
+        # Merchant Center property [brand](https://support.google.com/merchants/answer/
+        # 6324351). Schema.org property [Product.brand](https://schema.org/brand).
         # Corresponds to the JSON property `brands`
         # @return [Array<String>]
         attr_accessor :brands
@@ -2512,15 +2731,17 @@ module Google
         # INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product.
         # Empty values are not allowed. Each value must be a UTF-8 encoded string with
         # a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is
-        # returned. Google Merchant Center property google_product_category. Schema.org
-        # property [Product.category] (https://schema.org/category). [
-        # mc_google_product_category]: https://support.google.com/merchants/answer/
-        # 6324436
+        # returned. Corresponding properties: Google Merchant Center property
+        # google_product_category. Schema.org property [Product.category] (https://
+        # schema.org/category). [mc_google_product_category]: https://support.google.com/
+        # merchants/answer/6324436
         # Corresponds to the JSON property `categories`
         # @return [Array<String>]
         attr_accessor :categories
       
-        # The id of the collection members when type is Type.COLLECTION. Should not set
+        # The id of the collection members when type is Type.COLLECTION. Non-existent
+        # product ids are allowed. The type of the members must be either Type.PRIMARY
+        # or Type.VARIANT otherwise and INVALID_ARGUMENT error is thrown. Should not set
         # it for other types. A maximum of 1000 values are allowed. Otherwise, an
         # INVALID_ARGUMENT error is return.
         # Corresponds to the JSON property `collectionMemberIds`
@@ -2533,21 +2754,21 @@ module Google
         attr_accessor :color_info
       
         # The condition of the product. Strongly encouraged to use the standard values: "
-        # new", "refurbished", "used". A maximum of 5 values are allowed per Product.
-        # Each value must be a UTF-8 encoded string with a length limit of 128
-        # characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant
-        # Center property [condition](https://support.google.com/merchants/answer/
-        # 6324469). Schema.org property [Offer.itemCondition](https://schema.org/
-        # itemCondition).
+        # new", "refurbished", "used". A maximum of 1 value is allowed per Product. Each
+        # value must be a UTF-8 encoded string with a length limit of 128 characters.
+        # Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties:
+        # Google Merchant Center property [condition](https://support.google.com/
+        # merchants/answer/6324469). Schema.org property [Offer.itemCondition](https://
+        # schema.org/itemCondition).
         # Corresponds to the JSON property `conditions`
         # @return [Array<String>]
         attr_accessor :conditions
       
         # Product description. This field must be a UTF-8 encoded string with a length
         # limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.
-        # Google Merchant Center property [description](https://support.google.com/
-        # merchants/answer/6324468). schema.org property [Product.description](https://
-        # schema.org/description).
+        # Corresponding properties: Google Merchant Center property [description](https:/
+        # /support.google.com/merchants/answer/6324468). Schema.org property [Product.
+        # description](https://schema.org/description).
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
@@ -2557,8 +2778,8 @@ module Google
         # expire_time. However, the product can still be retrieved by ProductService.
         # GetProduct and ProductService.ListProducts. expire_time must be later than
         # available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown.
-        # Google Merchant Center property [expiration_date](https://support.google.com/
-        # merchants/answer/6324499).
+        # Corresponding properties: Google Merchant Center property [expiration_date](
+        # https://support.google.com/merchants/answer/6324499).
         # Corresponds to the JSON property `expireTime`
         # @return [String]
         attr_accessor :expire_time
@@ -2573,12 +2794,13 @@ module Google
         # The Global Trade Item Number (GTIN) of the product. This field must be a UTF-8
         # encoded string with a length limit of 128 characters. Otherwise, an
         # INVALID_ARGUMENT error is returned. This field must be a Unigram. Otherwise,
-        # an INVALID_ARGUMENT error is returned. Google Merchant Center property [gtin](
-        # https://support.google.com/merchants/answer/6324461). Schema.org property [
-        # Product.isbn](https://schema.org/isbn) or [Product.gtin8](https://schema.org/
-        # gtin8) or [Product.gtin12](https://schema.org/gtin12) or [Product.gtin13](
-        # https://schema.org/gtin13) or [Product.gtin14](https://schema.org/gtin14). If
-        # the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.
+        # an INVALID_ARGUMENT error is returned. Corresponding properties: Google
+        # Merchant Center property [gtin](https://support.google.com/merchants/answer/
+        # 6324461). Schema.org property [Product.isbn](https://schema.org/isbn), [
+        # Product.gtin8](https://schema.org/gtin8), [Product.gtin12](https://schema.org/
+        # gtin12), [Product.gtin13](https://schema.org/gtin13), or [Product.gtin14](
+        # https://schema.org/gtin14). If the value is not a valid GTIN, an
+        # INVALID_ARGUMENT error is returned.
         # Corresponds to the JSON property `gtin`
         # @return [String]
         attr_accessor :gtin
@@ -2587,27 +2809,28 @@ module Google
         # example, this field is "id_1", if name is `projects/*/locations/global/
         # catalogs/default_catalog/branches/default_branch/products/id_1`. This field
         # must be a UTF-8 encoded string with a length limit of 128 characters.
-        # Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center
-        # property [id](https://support.google.com/merchants/answer/6324405). Schema.org
-        # Property [Product.sku](https://schema.org/sku).
+        # Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties:
+        # Google Merchant Center property [id](https://support.google.com/merchants/
+        # answer/6324405). Schema.org property [Product.sku](https://schema.org/sku).
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
         # Product images for the product.Highly recommended to put the main image to the
-        # first. A maximum of 300 images are allowed. Google Merchant Center property [
-        # image_link](https://support.google.com/merchants/answer/6324350). Schema.org
-        # property [Product.image](https://schema.org/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).
         # Corresponds to the JSON property `images`
         # @return [Array<Google::Apis::RetailV2beta::GoogleCloudRetailV2betaImage>]
         attr_accessor :images
       
         # Language of the title/description and other string attributes. Use language
-        # tags defined by BCP 47. For product prediction, this field is ignored and the
-        # model automatically detects the text language. The Product can include text in
-        # different languages, but duplicating Products to provide text in multiple
-        # languages can result in degraded model performance. For product search this
-        # field is in use. It defaults to "en-US" if unset.
+        # tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). For
+        # product prediction, this field is ignored and the model automatically detects
+        # the text language. The Product can include text in different languages, but
+        # duplicating Products to provide text in multiple languages can result in
+        # degraded model performance. For product search this field is in use. It
+        # defaults to "en-US" if unset.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -2615,9 +2838,9 @@ module Google
         # The material of the product. For example, "leather", "wooden". A maximum of 20
         # values are allowed. Each value must be a UTF-8 encoded string with a length
         # limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.
-        # Google Merchant Center property [material](https://support.google.com/
-        # merchants/answer/6324410). Schema.org property [Product.material](https://
-        # schema.org/material).
+        # Corresponding properties: Google Merchant Center property [material](https://
+        # support.google.com/merchants/answer/6324410). Schema.org property [Product.
+        # material](https://schema.org/material).
         # Corresponds to the JSON property `materials`
         # @return [Array<String>]
         attr_accessor :materials
@@ -2631,9 +2854,10 @@ module Google
         # The pattern or graphic print of the product. For example, "striped", "polka
         # dot", "paisley". A maximum of 20 values are allowed per Product. Each value
         # must be a UTF-8 encoded string with a length limit of 128 characters.
-        # Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center
-        # property [pattern](https://support.google.com/merchants/answer/6324483).
-        # Schema.org property [Product.pattern](https://schema.org/pattern).
+        # Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties:
+        # Google Merchant Center property [pattern](https://support.google.com/merchants/
+        # answer/6324483). Schema.org property [Product.pattern](https://schema.org/
+        # pattern).
         # Corresponds to the JSON property `patterns`
         # @return [Array<String>]
         attr_accessor :patterns
@@ -2648,10 +2872,9 @@ module Google
         # can only be empty or set to the same value as id. For VARIANT Products, this
         # field cannot be empty. A maximum of 2,000 products are allowed to share the
         # same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned.
-        # Google Merchant Center Property [item_group_id](https://support.google.com/
-        # merchants/answer/6324507). Schema.org Property [Product.inProductGroupWithID](
-        # https://schema.org/inProductGroupWithID). This field must be enabled before it
-        # can be used. [Learn more](/recommendations-ai/docs/catalog#item-group-id).
+        # Corresponding properties: Google Merchant Center property [item_group_id](
+        # https://support.google.com/merchants/answer/6324507). Schema.org property [
+        # Product.inProductGroupWithID](https://schema.org/inProductGroupWithID).
         # Corresponds to the JSON property `primaryProductId`
         # @return [String]
         attr_accessor :primary_product_id
@@ -2700,10 +2923,11 @@ module Google
         # system and size type are empty, while size value is "32 inches". A maximum of
         # 20 values are allowed per Product. Each value must be a UTF-8 encoded string
         # with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is
-        # returned. Google Merchant Center property [size](https://support.google.com/
-        # merchants/answer/6324492), [size_type](https://support.google.com/merchants/
-        # answer/6324497) and [size_system](https://support.google.com/merchants/answer/
-        # 6324502). Schema.org property [Product.size](https://schema.org/size).
+        # returned. Corresponding properties: Google Merchant Center property [size](
+        # https://support.google.com/merchants/answer/6324492), [size_type](https://
+        # support.google.com/merchants/answer/6324497), and [size_system](https://
+        # support.google.com/merchants/answer/6324502). Schema.org property [Product.
+        # size](https://schema.org/size).
         # Corresponds to the JSON property `sizes`
         # @return [Array<String>]
         attr_accessor :sizes
@@ -2712,17 +2936,18 @@ module Google
         # Product. This value must be a UTF-8 encoded string with a length limit of 1,
         # 000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This tag can
         # be used for filtering recommendation results by passing the tag as part of the
-        # PredictRequest.filter. Google Merchant Center property [custom_label_0–4](
-        # https://support.google.com/merchants/answer/6324473).
+        # PredictRequest.filter. Corresponding properties: Google Merchant Center
+        # property [custom_label_0–4](https://support.google.com/merchants/answer/
+        # 6324473).
         # Corresponds to the JSON property `tags`
         # @return [Array<String>]
         attr_accessor :tags
       
         # Required. Product title. This field must be a UTF-8 encoded string with a
         # length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is
-        # returned. Google Merchant Center property [title](https://support.google.com/
-        # merchants/answer/6324415). Schema.org property [Product.name](https://schema.
-        # org/name).
+        # returned. Corresponding properties: Google Merchant Center property [title](
+        # https://support.google.com/merchants/answer/6324415). Schema.org property [
+        # Product.name](https://schema.org/name).
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
@@ -2748,9 +2973,9 @@ module Google
         # recommended to provide a valid uri for the product, otherwise the service
         # performance could be significantly degraded. This field must be a UTF-8
         # encoded string with a length limit of 5,000 characters. Otherwise, an
-        # INVALID_ARGUMENT error is returned. Google Merchant Center property [link](
-        # https://support.google.com/merchants/answer/6324416). Schema.org property [
-        # Offer.url](https://schema.org/url).
+        # INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant
+        # Center property [link](https://support.google.com/merchants/answer/6324416).
+        # Schema.org property [Offer.url](https://schema.org/url).
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -3165,6 +3390,26 @@ module Google
         end
       end
       
+      # Request for RemoveControl method.
+      class GoogleCloudRetailV2betaRemoveControlRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The id of the control to apply. Assumed to be in the same catalog as
+        # the serving config.
+        # Corresponds to the JSON property `controlId`
+        # @return [String]
+        attr_accessor :control_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @control_id = args[:control_id] if args.key?(:control_id)
+        end
+      end
+      
       # Metadata related to the progress of the RemoveFulfillmentPlaces operation.
       # Currently empty because there is no meaningful metadata populated from the
       # RemoveFulfillmentPlaces method.
@@ -3248,6 +3493,333 @@ module Google
         end
       end
       
+      # A rule is a condition-action pair * A condition defines when a rule is to be
+      # triggered. * An action specifies what occurs on that trigger. Currently only
+      # boost rules are supported. Currently only supported by the search endpoint.
+      class GoogleCloudRetailV2betaRule
+        include Google::Apis::Core::Hashable
+      
+        # A boost action to apply to results matching condition specified above.
+        # Corresponds to the JSON property `boostAction`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaRuleBoostAction]
+        attr_accessor :boost_action
+      
+        # Metadata that is used to define a condition that triggers an action. A valid
+        # condition must specify at least one of 'query_terms' or 'products_filter'. If
+        # multiple fields are specified, the condition is met if all the fields are
+        # satisfied e.g. if a set of query terms and product_filter are set, then only
+        # items matching the product_filter for requests with a query matching the query
+        # terms wil get boosted.
+        # Corresponds to the JSON property `condition`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaCondition]
+        attr_accessor :condition
+      
+        # Prevents `query_term` from being associated with specified terms during search.
+        # Example: Don't associate "gShoe" and "cheap".
+        # Corresponds to the JSON property `doNotAssociateAction`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaRuleDoNotAssociateAction]
+        attr_accessor :do_not_associate_action
+      
+        # * Rule Condition: - No Condition provided is a global match. - 1 or more
+        # Condition provided is combined with OR operator. * Action Input: The request
+        # query and filter that will be applied to the retrieved products, in addition
+        # to any filters already provided with the SearchRequest. The AND operator is
+        # used to combine the query's existing filters with the filter rule(s). NOTE:
+        # May result in 0 results when filters conflict. * Action Result: Filters the
+        # returned objects to be ONLY those that passed the filter.
+        # Corresponds to the JSON property `filterAction`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaRuleFilterAction]
+        attr_accessor :filter_action
+      
+        # Prevents a term in the query from being used in search. Example: Don't search
+        # for "shoddy".
+        # Corresponds to the JSON property `ignoreAction`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaRuleIgnoreAction]
+        attr_accessor :ignore_action
+      
+        # Maps a set of terms to a set of synonyms. Set of synonyms will be treated as
+        # synonyms of each query term only. `query_terms` will not be treated as
+        # synonyms of each other. Example: "sneakers" will use a synonym of "shoes". "
+        # shoes" will not use a synonym of "sneakers".
+        # Corresponds to the JSON property `onewaySynonymsAction`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaRuleOnewaySynonymsAction]
+        attr_accessor :oneway_synonyms_action
+      
+        # Redirects a shopper to a specific page. * Rule Condition: - Must specify
+        # Condition. * Action Input: Request Query * Action Result: Redirects shopper to
+        # provided uri.
+        # Corresponds to the JSON property `redirectAction`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaRuleRedirectAction]
+        attr_accessor :redirect_action
+      
+        # Replaces a term in the query. Multiple replacement candidates can be specified.
+        # All `query_terms` will be replaced with the replacement term. Example:
+        # Replace "gShoe" with "google shoe".
+        # Corresponds to the JSON property `replacementAction`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaRuleReplacementAction]
+        attr_accessor :replacement_action
+      
+        # Creates a set of terms that will be treated as synonyms of each other. Example:
+        # synonyms of "sneakers" and "shoes". * "sneakers" will use a synonym of "shoes"
+        # . * "shoes" will use a synonym of "sneakers".
+        # Corresponds to the JSON property `twowaySynonymsAction`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaRuleTwowaySynonymsAction]
+        attr_accessor :twoway_synonyms_action
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @boost_action = args[:boost_action] if args.key?(:boost_action)
+          @condition = args[:condition] if args.key?(:condition)
+          @do_not_associate_action = args[:do_not_associate_action] if args.key?(:do_not_associate_action)
+          @filter_action = args[:filter_action] if args.key?(:filter_action)
+          @ignore_action = args[:ignore_action] if args.key?(:ignore_action)
+          @oneway_synonyms_action = args[:oneway_synonyms_action] if args.key?(:oneway_synonyms_action)
+          @redirect_action = args[:redirect_action] if args.key?(:redirect_action)
+          @replacement_action = args[:replacement_action] if args.key?(:replacement_action)
+          @twoway_synonyms_action = args[:twoway_synonyms_action] if args.key?(:twoway_synonyms_action)
+        end
+      end
+      
+      # A boost action to apply to results matching condition specified above.
+      class GoogleCloudRetailV2betaRuleBoostAction
+        include Google::Apis::Core::Hashable
+      
+        # Strength of the condition boost, which must be in [-1, 1]. Negative boost
+        # means demotion. Default is 0.0. Setting to 1.0 gives the item a big promotion.
+        # However, it does not necessarily mean that the boosted item will be the top
+        # result at all times, nor that other items will be excluded. Results could
+        # still be shown even when none of them matches the condition. And results that
+        # are significantly more relevant to the search query can still trump your
+        # heavily favored but irrelevant items. Setting to -1.0 gives the item a big
+        # demotion. However, results that are deeply relevant might still be shown. The
+        # item will have an upstream battle to get a fairly high ranking, but it is not
+        # blocked out completely. Setting to 0.0 means no boost applied. The boosting
+        # condition is ignored.
+        # Corresponds to the JSON property `boost`
+        # @return [Float]
+        attr_accessor :boost
+      
+        # The filter can have a max size of 5000 characters. An expression which
+        # specifies which products to apply an action to. The syntax and supported
+        # fields are the same as a filter expression. See SearchRequest.filter for
+        # detail syntax and limitations. Examples: * To boost products with product ID "
+        # product_1" or "product_2", and color "Red" or "Blue": *(id: ANY("product_1", "
+        # product_2")) * *AND * *(colorFamilies: ANY("Red", "Blue")) *
+        # Corresponds to the JSON property `productsFilter`
+        # @return [String]
+        attr_accessor :products_filter
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @boost = args[:boost] if args.key?(:boost)
+          @products_filter = args[:products_filter] if args.key?(:products_filter)
+        end
+      end
+      
+      # Prevents `query_term` from being associated with specified terms during search.
+      # Example: Don't associate "gShoe" and "cheap".
+      class GoogleCloudRetailV2betaRuleDoNotAssociateAction
+        include Google::Apis::Core::Hashable
+      
+        # Cannot contain duplicates or the query term. Can specify up to 100 terms.
+        # Corresponds to the JSON property `doNotAssociateTerms`
+        # @return [Array<String>]
+        attr_accessor :do_not_associate_terms
+      
+        # Terms from the search query. Will not consider do_not_associate_terms for
+        # search if in search query. Can specify up to 100 terms.
+        # Corresponds to the JSON property `queryTerms`
+        # @return [Array<String>]
+        attr_accessor :query_terms
+      
+        # Will be [deprecated = true] post migration;
+        # Corresponds to the JSON property `terms`
+        # @return [Array<String>]
+        attr_accessor :terms
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @do_not_associate_terms = args[:do_not_associate_terms] if args.key?(:do_not_associate_terms)
+          @query_terms = args[:query_terms] if args.key?(:query_terms)
+          @terms = args[:terms] if args.key?(:terms)
+        end
+      end
+      
+      # * Rule Condition: - No Condition provided is a global match. - 1 or more
+      # Condition provided is combined with OR operator. * Action Input: The request
+      # query and filter that will be applied to the retrieved products, in addition
+      # to any filters already provided with the SearchRequest. The AND operator is
+      # used to combine the query's existing filters with the filter rule(s). NOTE:
+      # May result in 0 results when filters conflict. * Action Result: Filters the
+      # returned objects to be ONLY those that passed the filter.
+      class GoogleCloudRetailV2betaRuleFilterAction
+        include Google::Apis::Core::Hashable
+      
+        # A filter to apply on the matching condition results. Supported features: *
+        # filter must be set. * Filter syntax is identical to SearchRequest.filter. See
+        # more details at the Retail Search [user guide](/retail/search/docs/filter-and-
+        # order#filter). * To filter products with product ID "product_1" or "product_2",
+        # and color "Red" or "Blue": *(id: ANY("product_1", "product_2")) * *AND * *(
+        # colorFamilies: ANY("Red", "Blue")) *
+        # Corresponds to the JSON property `filter`
+        # @return [String]
+        attr_accessor :filter
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @filter = args[:filter] if args.key?(:filter)
+        end
+      end
+      
+      # Prevents a term in the query from being used in search. Example: Don't search
+      # for "shoddy".
+      class GoogleCloudRetailV2betaRuleIgnoreAction
+        include Google::Apis::Core::Hashable
+      
+        # Terms to ignore in the search query.
+        # Corresponds to the JSON property `ignoreTerms`
+        # @return [Array<String>]
+        attr_accessor :ignore_terms
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @ignore_terms = args[:ignore_terms] if args.key?(:ignore_terms)
+        end
+      end
+      
+      # Maps a set of terms to a set of synonyms. Set of synonyms will be treated as
+      # synonyms of each query term only. `query_terms` will not be treated as
+      # synonyms of each other. Example: "sneakers" will use a synonym of "shoes". "
+      # shoes" will not use a synonym of "sneakers".
+      class GoogleCloudRetailV2betaRuleOnewaySynonymsAction
+        include Google::Apis::Core::Hashable
+      
+        # Will be [deprecated = true] post migration;
+        # Corresponds to the JSON property `onewayTerms`
+        # @return [Array<String>]
+        attr_accessor :oneway_terms
+      
+        # Terms from the search query. Will treat synonyms as their synonyms. Not
+        # themselves synonyms of the synonyms. Can specify up to 100 terms.
+        # Corresponds to the JSON property `queryTerms`
+        # @return [Array<String>]
+        attr_accessor :query_terms
+      
+        # Defines a set of synonyms. Cannot contain duplicates. Can specify up to 100
+        # synonyms.
+        # Corresponds to the JSON property `synonyms`
+        # @return [Array<String>]
+        attr_accessor :synonyms
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @oneway_terms = args[:oneway_terms] if args.key?(:oneway_terms)
+          @query_terms = args[:query_terms] if args.key?(:query_terms)
+          @synonyms = args[:synonyms] if args.key?(:synonyms)
+        end
+      end
+      
+      # Redirects a shopper to a specific page. * Rule Condition: - Must specify
+      # Condition. * Action Input: Request Query * Action Result: Redirects shopper to
+      # provided uri.
+      class GoogleCloudRetailV2betaRuleRedirectAction
+        include Google::Apis::Core::Hashable
+      
+        # URL must have length equal or less than 2000 characters.
+        # Corresponds to the JSON property `redirectUri`
+        # @return [String]
+        attr_accessor :redirect_uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @redirect_uri = args[:redirect_uri] if args.key?(:redirect_uri)
+        end
+      end
+      
+      # Replaces a term in the query. Multiple replacement candidates can be specified.
+      # All `query_terms` will be replaced with the replacement term. Example:
+      # Replace "gShoe" with "google shoe".
+      class GoogleCloudRetailV2betaRuleReplacementAction
+        include Google::Apis::Core::Hashable
+      
+        # Terms from the search query. Will be replaced by replacement term. Can specify
+        # up to 100 terms.
+        # Corresponds to the JSON property `queryTerms`
+        # @return [Array<String>]
+        attr_accessor :query_terms
+      
+        # Term that will be used for replacement.
+        # Corresponds to the JSON property `replacementTerm`
+        # @return [String]
+        attr_accessor :replacement_term
+      
+        # Will be [deprecated = true] post migration;
+        # Corresponds to the JSON property `term`
+        # @return [String]
+        attr_accessor :term
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @query_terms = args[:query_terms] if args.key?(:query_terms)
+          @replacement_term = args[:replacement_term] if args.key?(:replacement_term)
+          @term = args[:term] if args.key?(:term)
+        end
+      end
+      
+      # Creates a set of terms that will be treated as synonyms of each other. Example:
+      # synonyms of "sneakers" and "shoes". * "sneakers" will use a synonym of "shoes"
+      # . * "shoes" will use a synonym of "sneakers".
+      class GoogleCloudRetailV2betaRuleTwowaySynonymsAction
+        include Google::Apis::Core::Hashable
+      
+        # Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at
+        # least 2 synonyms.
+        # Corresponds to the JSON property `synonyms`
+        # @return [Array<String>]
+        attr_accessor :synonyms
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @synonyms = args[:synonyms] if args.key?(:synonyms)
+        end
+      end
+      
       # Request message for SearchService.Search method.
       class GoogleCloudRetailV2betaSearchRequest
         include Google::Apis::Core::Hashable
@@ -3360,25 +3932,26 @@ module Google
         # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaUserInfo]
         attr_accessor :user_info
       
-        # The keys to fetch and rollup the matching variant Products attributes. The
-        # attributes from all the matching variant Products are merged and de-duplicated.
-        # Notice that rollup variant Products attributes will lead to extra query
-        # latency. Maximum number of keys is 10. For FulfillmentInfo, a fulfillment type
-        # and a fulfillment ID must be provided in the format of "fulfillmentType.
-        # fulfillmentId". E.g., in "pickupInStore.store123", "pickupInStore" is
-        # fulfillment type and "store123" is the store ID. Supported keys are: *
-        # colorFamilies * price * originalPrice * discount * inventory(place_id,price) *
-        # inventory(place_id,attributes.key), where key is any key in the Product.
-        # inventories.attributes map. * attributes.key, where key is any key in the
-        # Product.attributes map. * pickupInStore.id, where id is any FulfillmentInfo.
-        # place_ids for FulfillmentInfo.type "pickup-in-store". * shipToStore.id, where
-        # id is any FulfillmentInfo.place_ids for FulfillmentInfo.type "ship-to-store". *
-        # sameDayDelivery.id, where id is any FulfillmentInfo.place_ids for
-        # FulfillmentInfo.type "same-day-delivery". * nextDayDelivery.id, where id is
-        # any FulfillmentInfo.place_ids for FulfillmentInfo.type "next-day-delivery". *
-        # customFulfillment1.id, where id is any FulfillmentInfo.place_ids for
-        # FulfillmentInfo.type "custom-type-1". * customFulfillment2.id, where id is any
-        # FulfillmentInfo.place_ids for FulfillmentInfo.type "custom-type-2". *
+        # The keys to fetch and rollup the matching variant Products attributes,
+        # FulfillmentInfo or LocalInventorys attributes. The attributes from all the
+        # matching variant Products or LocalInventorys are merged and de-duplicated.
+        # Notice that rollup attributes will lead to extra query latency. Maximum number
+        # of keys is 30. For FulfillmentInfo, a fulfillment type and a fulfillment ID
+        # must be provided in the format of "fulfillmentType.fulfillmentId". E.g., in "
+        # pickupInStore.store123", "pickupInStore" is fulfillment type and "store123" is
+        # the store ID. Supported keys are: * colorFamilies * price * originalPrice *
+        # discount * variantId * inventory(place_id,price) * inventory(place_id,
+        # original_price) * inventory(place_id,attributes.key), where key is any key in
+        # the Product.inventories.attributes map. * attributes.key, where key is any key
+        # in the Product.attributes map. * pickupInStore.id, where id is any
+        # FulfillmentInfo.place_ids for FulfillmentInfo.type "pickup-in-store". *
+        # shipToStore.id, where id is any FulfillmentInfo.place_ids for FulfillmentInfo.
+        # type "ship-to-store". * sameDayDelivery.id, where id is any FulfillmentInfo.
+        # place_ids for FulfillmentInfo.type "same-day-delivery". * nextDayDelivery.id,
+        # where id is any FulfillmentInfo.place_ids for FulfillmentInfo.type "next-day-
+        # delivery". * customFulfillment1.id, where id is any FulfillmentInfo.place_ids
+        # for FulfillmentInfo.type "custom-type-1". * customFulfillment2.id, where id is
+        # any FulfillmentInfo.place_ids for FulfillmentInfo.type "custom-type-2". *
         # customFulfillment3.id, where id is any FulfillmentInfo.place_ids for
         # FulfillmentInfo.type "custom-type-3". * customFulfillment4.id, where id is any
         # FulfillmentInfo.place_ids for FulfillmentInfo.type "custom-type-4". *
@@ -3392,9 +3965,9 @@ 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 logs in or 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.
+        # visitor logs in or out of the website. This should be the same identifier as
+        # UserEvent.visitor_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 `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -3598,8 +4171,8 @@ module Google
         # customFulfillment1" * "customFulfillment2" * "customFulfillment3" * "
         # customFulfillment4" * "customFulfillment5" * "inventory(place_id,attributes.
         # key)" * numerical_field = * "price" * "discount" * "rating" * "ratingCount" * "
-        # attributes.key" * "inventory(place_id,price)" * "inventory(place_id,attributes.
-        # key)"
+        # attributes.key" * "inventory(place_id,price)" * "inventory(place_id,
+        # original_price)" * "inventory(place_id,attributes.key)"
         # Corresponds to the JSON property `key`
         # @return [String]
         attr_accessor :key
@@ -3698,6 +4271,12 @@ module Google
       class GoogleCloudRetailV2betaSearchResponse
         include Google::Apis::Core::Hashable
       
+        # The fully qualified resource name of applied [controls](https://cloud.google.
+        # com/retail/docs/serving-control-rules).
+        # Corresponds to the JSON property `appliedControls`
+        # @return [Array<String>]
+        attr_accessor :applied_controls
+      
         # A unique search token. This should be included in the UserEvent logs resulting
         # from this search, which enables accurate attribution of search model
         # performance.
@@ -3752,6 +4331,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @applied_controls = args[:applied_controls] if args.key?(:applied_controls)
           @attribution_token = args[:attribution_token] if args.key?(:attribution_token)
           @corrected_query = args[:corrected_query] if args.key?(:corrected_query)
           @facets = args[:facets] if args.key?(:facets)
@@ -3914,6 +4494,183 @@ module Google
         end
       end
       
+      # Configures metadata that is used to generate serving time results (e.g. search
+      # results or recommendation predictions). The ServingConfig is passed in the
+      # search and predict request and together with the Catalog.default_branch,
+      # generates results.
+      class GoogleCloudRetailV2betaServingConfig
+        include Google::Apis::Core::Hashable
+      
+        # Condition boost specifications. If a product matches multiple conditions in
+        # the specifications, boost scores from these specifications are all applied and
+        # combined in a non-linear way. Maximum number of specifications is 10. Notice
+        # that if both ServingConfig.boost_control_ids and [SearchRequest.boost_spec]
+        # are set, the boost conditions from both places are evaluated. If a search
+        # request matches multiple boost conditions, the final boost score is equal to
+        # the sum of the boost scores from all matched boost conditions. Can only be set
+        # if solution_types is SOLUTION_TYPE_SEARCH.
+        # Corresponds to the JSON property `boostControlIds`
+        # @return [Array<String>]
+        attr_accessor :boost_control_ids
+      
+        # Required. The human readable serving config display name. Used in Retail UI.
+        # This 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 `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # How much diversity to use in recommendation model results e.g. 'medium-
+        # diversity' or 'high-diversity'. Currently supported values: * 'no-diversity' *
+        # 'low-diversity' * 'medium-diversity' * 'high-diversity' * 'auto-diversity' If
+        # not specified, we choose default based on recommendation model type. Default
+        # value: 'no-diversity'. Can only be set if solution_types is
+        # SOLUTION_TYPE_RECOMMENDATION.
+        # Corresponds to the JSON property `diversityLevel`
+        # @return [String]
+        attr_accessor :diversity_level
+      
+        # Condition do not associate specifications. If multiple do not associate
+        # conditions match, all matching do not associate controls in the list will
+        # execute. - Order does not matter. - Maximum number of specifications is 100.
+        # Can only be set if solution_types is SOLUTION_TYPE_SEARCH.
+        # Corresponds to the JSON property `doNotAssociateControlIds`
+        # @return [Array<String>]
+        attr_accessor :do_not_associate_control_ids
+      
+        # The specifications of dynamically generated facets.
+        # Corresponds to the JSON property `dynamicFacetSpec`
+        # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaSearchRequestDynamicFacetSpec]
+        attr_accessor :dynamic_facet_spec
+      
+        # Whether to add additional category filters on the 'similar-items' model. If
+        # not specified, we enable it by default. Allowed values are: * 'no-category-
+        # match': No additional filtering of original results from the model and the
+        # customer's filters. * 'relaxed-category-match': Only keep results with
+        # categories that match at least one item categories in the PredictRequests's
+        # context item. * If customer also sends filters in the PredictRequest, then the
+        # results will satisfy both conditions (user given and category match). Can only
+        # be set if solution_types is SOLUTION_TYPE_RECOMMENDATION.
+        # Corresponds to the JSON property `enableCategoryFilterLevel`
+        # @return [String]
+        attr_accessor :enable_category_filter_level
+      
+        # Facet specifications for faceted search. If empty, no facets are returned. The
+        # ids refer to the ids of Control resources with only the Facet control set.
+        # These controls are assumed to be in the same Catalog as the ServingConfig. A
+        # maximum of 100 values are allowed. Otherwise, an INVALID_ARGUMENT error is
+        # returned. Can only be set if solution_types is SOLUTION_TYPE_SEARCH.
+        # Corresponds to the JSON property `facetControlIds`
+        # @return [Array<String>]
+        attr_accessor :facet_control_ids
+      
+        # Condition filter specifications. If a product matches multiple conditions in
+        # the specifications, filters from these specifications are all applied and
+        # combined via the AND operator. Maximum number of specifications is 100. Can
+        # only be set if solution_types is SOLUTION_TYPE_SEARCH.
+        # Corresponds to the JSON property `filterControlIds`
+        # @return [Array<String>]
+        attr_accessor :filter_control_ids
+      
+        # Condition ignore specifications. If multiple ignore conditions match, all
+        # matching ignore controls in the list will execute. - Order does not matter. -
+        # Maximum number of specifications is 100. Can only be set if solution_types is
+        # SOLUTION_TYPE_SEARCH.
+        # Corresponds to the JSON property `ignoreControlIds`
+        # @return [Array<String>]
+        attr_accessor :ignore_control_ids
+      
+        # The id of the model to use at serving time. Currently only
+        # RecommendationModels are supported: https://cloud.google.com/retail/
+        # recommendations-ai/docs/create-models Can be changed but only to a compatible
+        # model (e.g. others-you-may-like CTR to others-you-may-like CVR). Required when
+        # solution_types is SOLUTION_TYPE_RECOMMENDATION.
+        # Corresponds to the JSON property `modelId`
+        # @return [String]
+        attr_accessor :model_id
+      
+        # Immutable. Fully qualified name projects/*/locations/global/catalogs/*/
+        # servingConfig/*
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Condition oneway synonyms specifications. If multiple oneway synonyms
+        # conditions match, all matching oneway synonyms controls in the list will
+        # execute. Order of controls in the list will not matter. Maximum number of
+        # specifications is 100. Can only be set if solution_types is
+        # SOLUTION_TYPE_SEARCH.
+        # Corresponds to the JSON property `onewaySynonymsControlIds`
+        # @return [Array<String>]
+        attr_accessor :oneway_synonyms_control_ids
+      
+        # How much price ranking we want in serving results. Price reranking causes
+        # product items with a similar recommendation probability to be ordered by price,
+        # with the highest-priced items first. This setting could result in a decrease
+        # in click-through and conversion rates. Allowed values are: * 'no-price-
+        # reranking' * 'low-price-raranking' * 'medium-price-reranking' * 'high-price-
+        # reranking' If not specified, we choose default based on model type. Default
+        # value: 'no-price-reranking'. Can only be set if solution_types is
+        # SOLUTION_TYPE_RECOMMENDATION.
+        # Corresponds to the JSON property `priceRerankingLevel`
+        # @return [String]
+        attr_accessor :price_reranking_level
+      
+        # Condition redirect specifications. Only the first triggered redirect action is
+        # applied, even if multiple apply. Maximum number of specifications is 100. Can
+        # only be set if solution_types is SOLUTION_TYPE_SEARCH.
+        # Corresponds to the JSON property `redirectControlIds`
+        # @return [Array<String>]
+        attr_accessor :redirect_control_ids
+      
+        # Condition replacement specifications. - Applied according to the order in the
+        # list. - A previously replaced term can not be re-replaced. - Maximum number of
+        # specifications is 100. Can only be set if solution_types is
+        # SOLUTION_TYPE_SEARCH.
+        # Corresponds to the JSON property `replacementControlIds`
+        # @return [Array<String>]
+        attr_accessor :replacement_control_ids
+      
+        # Required. Immutable. Specifies the solution types that a serving config can be
+        # associated with. Currently we support setting only one type of solution.
+        # Corresponds to the JSON property `solutionTypes`
+        # @return [Array<String>]
+        attr_accessor :solution_types
+      
+        # Condition synonyms specifications. If multiple syonyms conditions match, all
+        # matching synonyms control in the list will execute. Order of controls in the
+        # list will not matter. Maximum number of specifications is 100. Can only be set
+        # if solution_types is SOLUTION_TYPE_SEARCH.
+        # Corresponds to the JSON property `twowaySynonymsControlIds`
+        # @return [Array<String>]
+        attr_accessor :twoway_synonyms_control_ids
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @boost_control_ids = args[:boost_control_ids] if args.key?(:boost_control_ids)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @diversity_level = args[:diversity_level] if args.key?(:diversity_level)
+          @do_not_associate_control_ids = args[:do_not_associate_control_ids] if args.key?(:do_not_associate_control_ids)
+          @dynamic_facet_spec = args[:dynamic_facet_spec] if args.key?(:dynamic_facet_spec)
+          @enable_category_filter_level = args[:enable_category_filter_level] if args.key?(:enable_category_filter_level)
+          @facet_control_ids = args[:facet_control_ids] if args.key?(:facet_control_ids)
+          @filter_control_ids = args[:filter_control_ids] if args.key?(:filter_control_ids)
+          @ignore_control_ids = args[:ignore_control_ids] if args.key?(:ignore_control_ids)
+          @model_id = args[:model_id] if args.key?(:model_id)
+          @name = args[:name] if args.key?(:name)
+          @oneway_synonyms_control_ids = args[:oneway_synonyms_control_ids] if args.key?(:oneway_synonyms_control_ids)
+          @price_reranking_level = args[:price_reranking_level] if args.key?(:price_reranking_level)
+          @redirect_control_ids = args[:redirect_control_ids] if args.key?(:redirect_control_ids)
+          @replacement_control_ids = args[:replacement_control_ids] if args.key?(:replacement_control_ids)
+          @solution_types = args[:solution_types] if args.key?(:solution_types)
+          @twoway_synonyms_control_ids = args[:twoway_synonyms_control_ids] if args.key?(:twoway_synonyms_control_ids)
+        end
+      end
+      
       # Request message to set a specified branch as new default_branch.
       class GoogleCloudRetailV2betaSetDefaultBranchRequest
         include Google::Apis::Core::Hashable
@@ -3977,10 +4734,9 @@ module Google
         # @return [Google::Apis::RetailV2beta::GoogleCloudRetailV2betaProduct]
         attr_accessor :inventory
       
-        # Indicates which inventory fields in the provided Product to update. If 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.
+        # Indicates which inventory fields in the provided Product to update. At least
+        # one field must be provided. 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 `setMask`
         # @return [String]
         attr_accessor :set_mask
@@ -4024,12 +4780,15 @@ module Google
       class GoogleCloudRetailV2betaUserEvent
         include Google::Apis::Core::Hashable
       
-        # Extra user event features to include in the recommendation model. The key must
-        # be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise,
-        # an INVALID_ARGUMENT error is returned. 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. 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.
         # Corresponds to the JSON property `attributes`
         # @return [Hash<String,Google::Apis::RetailV2beta::GoogleCloudRetailV2betaCustomAttribute>]
         attr_accessor :attributes
@@ -4071,12 +4830,11 @@ module Google
       
         # Required. User event type. Allowed values are: * `add-to-cart`: Products being
         # added to cart. * `category-page-view`: Special pages such as sale or promotion
-        # pages viewed. * `completion`: Completion query result showed/clicked. * `
-        # detail-page-view`: Products detail page viewed. * `home-page-view`: Homepage
-        # viewed. * `promotion-offered`: Promotion is offered to a user. * `promotion-
-        # not-offered`: Promotion is not offered to a user. * `purchase-complete`: User
-        # finishing a purchase. * `search`: Product search. * `shopping-cart-page-view`:
-        # User viewing a shopping cart.
+        # pages viewed. * `detail-page-view`: Products detail page viewed. * `home-page-
+        # view`: Homepage viewed. * `promotion-offered`: Promotion is offered to a user.
+        # * `promotion-not-offered`: Promotion is not offered to a user. * `purchase-
+        # complete`: User finishing a purchase. * `search`: Product search. * `shopping-
+        # cart-page-view`: User viewing a shopping cart.
         # Corresponds to the JSON property `eventType`
         # @return [String]
         attr_accessor :event_type
@@ -4143,12 +4901,12 @@ module Google
       
         # The main product details related to the event. This field is required for the
         # following event types: * `add-to-cart` * `detail-page-view` * `purchase-
-        # complete` In a `search` event, this field represents the products returned to
-        # the end user on the current page (the end user may have not finished browsing
-        # the whole page yet). When a new page is returned to the end user, after
-        # pagination/filtering/ordering even for the same query, a new `search` event
-        # with different product_details is desired. The end user may have not finished
-        # browsing the whole page yet.
+        # complete` * `search` In a `search` event, this field represents the products
+        # returned to the end user on the current page (the end user may have not
+        # finished browsing the whole page yet). When a new page is returned to the end
+        # user, after pagination/filtering/ordering even for the same query, a new `
+        # search` event with different product_details is desired. The end user may have
+        # not finished browsing the whole page yet.
         # Corresponds to the JSON property `productDetails`
         # @return [Array<Google::Apis::RetailV2beta::GoogleCloudRetailV2betaProductDetail>]
         attr_accessor :product_details