google-cloud-retail-v2 0.6.4 → 0.7.0

data/proto_docs/google/cloud/retail/v2/prediction_service.rb

@@ -73,9 +73,12 @@ module Google
         #      * filterOutOfStockItems  tag=(-"promotional")
         #      * filterOutOfStockItems
         #
-        #     If your filter blocks all prediction results, nothing will be returned. If
-        #     you want generic (unfiltered) popular products to be returned instead, set
-        #     `strictFiltering` to false in `PredictRequest.params`.
+        #     If your filter blocks all prediction results, the API will return generic
+        #     (unfiltered) popular products. If you only want results strictly matching
+        #     the filters, set `strictFiltering` to True in `PredictRequest.params` to
+        #     receive empty results instead.
+        #     Note that the API will never return items with storageStatus of "EXPIRED"
+        #     or "DELETED" regardless of filter choices.
         # @!attribute [rw] validate_only
         #   @return [::Boolean]
         #     Use validate only mode for this prediction query. If set to true, a

data/proto_docs/google/cloud/retail/v2/product.rb

@@ -42,7 +42,7 @@ module Google
         #     {::Google::Cloud::Retail::V2::Product#publish_time publish_time}, otherwise an
         #     INVALID_ARGUMENT error is thrown.
         #
-        #     Google Merchant Center property
+        #     Corresponding properties: Google Merchant Center property
         #     [expiration_date](https://support.google.com/merchants/answer/6324499).
         # @!attribute [rw] ttl
         #   @return [::Google::Protobuf::Duration]
@@ -77,9 +77,9 @@ module Google
         #     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
+        #     Corresponding properties: Google Merchant Center property
         #     [id](https://support.google.com/merchants/answer/6324405). Schema.org
-        #     Property [Product.sku](https://schema.org/sku).
+        #     property [Product.sku](https://schema.org/sku).
         # @!attribute [rw] type
         #   @return [::Google::Cloud::Retail::V2::Product::Type]
         #     Immutable. The type of the product. Default to
@@ -101,21 +101,23 @@ module Google
         #     {::Google::Cloud::Retail::V2::Product Product}. Otherwise, an INVALID_ARGUMENT
         #     error is returned.
         #
-        #     Google Merchant Center Property
+        #     Corresponding properties: Google Merchant Center property
         #     [item_group_id](https://support.google.com/merchants/answer/6324507).
-        #     Schema.org Property
+        #     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).
         # @!attribute [rw] collection_member_ids
         #   @return [::Array<::String>]
         #     The {::Google::Cloud::Retail::V2::Product#id id} of the collection members when
         #     {::Google::Cloud::Retail::V2::Product#type type} is
         #     {::Google::Cloud::Retail::V2::Product::Type::COLLECTION Type.COLLECTION}.
         #
-        #     Should not set it for other types. A maximum of 1000 values are allowed.
-        #     Otherwise, an INVALID_ARGUMENT error is return.
+        #     Non-existent product ids are allowed.
+        #     The {::Google::Cloud::Retail::V2::Product#type type} of the members must be
+        #     either {::Google::Cloud::Retail::V2::Product::Type::PRIMARY Type.PRIMARY} or
+        #     {::Google::Cloud::Retail::V2::Product::Type::VARIANT 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.
         # @!attribute [rw] gtin
         #   @return [::String]
         #     The Global Trade Item Number (GTIN) of the product.
@@ -126,13 +128,13 @@ module Google
         #     This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is
         #     returned.
         #
-        #     Google Merchant Center property
+        #     Corresponding properties: 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.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.
@@ -166,7 +168,7 @@ module Google
         #     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
+        #     Corresponding properties: Google Merchant Center property
         #     [google_product_category][mc_google_product_category]. Schema.org property
         #     [Product.category] (https://schema.org/category).
         #
@@ -179,7 +181,7 @@ module Google
         #     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
+        #     Corresponding properties: Google Merchant Center property
         #     [title](https://support.google.com/merchants/answer/6324415). Schema.org
         #     property [Product.name](https://schema.org/name).
         # @!attribute [rw] brands
@@ -190,7 +192,7 @@ module Google
         #     string with a length limit of 1,000 characters. Otherwise, an
         #     INVALID_ARGUMENT error is returned.
         #
-        #     Google Merchant Center property
+        #     Corresponding properties: Google Merchant Center property
         #     [brand](https://support.google.com/merchants/answer/6324351). Schema.org
         #     property [Product.brand](https://schema.org/brand).
         # @!attribute [rw] description
@@ -200,13 +202,13 @@ module Google
         #     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
+        #     Corresponding properties: Google Merchant Center property
         #     [description](https://support.google.com/merchants/answer/6324468).
-        #     schema.org property [Product.description](https://schema.org/description).
+        #     Schema.org property [Product.description](https://schema.org/description).
         # @!attribute [rw] language_code
         #   @return [::String]
         #     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].
+        #     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 {::Google::Cloud::Retail::V2::Product Product}
@@ -240,7 +242,12 @@ module Google
         #     * 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][a-zA-Z0-9_]*`. For example, key0LikeThis or KEY_1_LIKE_THIS.
+        #       `[a-zA-Z0-9][a-zA-Z0-9_]*`. For example, `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 non-empty UTF-8 encoded string with a
+        #       length limit of 256 characters.
+        #     * For number attributes, at most 400 values are allowed.
         # @!attribute [rw] tags
         #   @return [::Array<::String>]
         #     Custom tags associated with the product.
@@ -254,13 +261,13 @@ module Google
         #     tag as part of the
         #     {::Google::Cloud::Retail::V2::PredictRequest#filter PredictRequest.filter}.
         #
-        #     Google Merchant Center property
+        #     Corresponding properties: Google Merchant Center property
         #     [custom_label_0–4](https://support.google.com/merchants/answer/6324473).
         # @!attribute [rw] price_info
         #   @return [::Google::Cloud::Retail::V2::PriceInfo]
         #     Product price and cost information.
         #
-        #     Google Merchant Center property
+        #     Corresponding properties: Google Merchant Center property
         #     [price](https://support.google.com/merchants/answer/6324371).
         # @!attribute [rw] rating
         #   @return [::Google::Cloud::Retail::V2::Rating]
@@ -276,9 +283,9 @@ module Google
         #     Default to
         #     {::Google::Cloud::Retail::V2::Product::Availability::IN_STOCK Availability.IN_STOCK}.
         #
-        #     Google Merchant Center Property
+        #     Corresponding properties: Google Merchant Center property
         #     [availability](https://support.google.com/merchants/answer/6324448).
-        #     Schema.org Property [Offer.availability](https://schema.org/availability).
+        #     Schema.org property [Offer.availability](https://schema.org/availability).
         # @!attribute [rw] available_quantity
         #   @return [::Google::Protobuf::Int32Value]
         #     The available quantity of the item.
@@ -300,17 +307,17 @@ module Google
         #     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
+        #     Corresponding properties: Google Merchant Center property
         #     [link](https://support.google.com/merchants/answer/6324416). Schema.org
         #     property [Offer.url](https://schema.org/url).
         # @!attribute [rw] images
         #   @return [::Array<::Google::Cloud::Retail::V2::Image>]
-        #     Product images for the product.Highly recommended to put the main image
-        #     to the first.
+        #     Product images for the product. We highly recommend putting the main
+        #     image first.
         #
         #     A maximum of 300 images are allowed.
         #
-        #     Google Merchant Center property
+        #     Corresponding properties: Google Merchant Center property
         #     [image_link](https://support.google.com/merchants/answer/6324350).
         #     Schema.org property [Product.image](https://schema.org/image).
         # @!attribute [rw] audience
@@ -321,7 +328,7 @@ module Google
         #   @return [::Google::Cloud::Retail::V2::ColorInfo]
         #     The color of the product.
         #
-        #     Google Merchant Center property
+        #     Corresponding properties: Google Merchant Center property
         #     [color](https://support.google.com/merchants/answer/6324487). Schema.org
         #     property [Product.color](https://schema.org/color).
         # @!attribute [rw] sizes
@@ -339,9 +346,9 @@ module Google
         #     encoded string with a length limit of 128 characters. Otherwise, an
         #     INVALID_ARGUMENT error is returned.
         #
-        #     Google Merchant Center property
+        #     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_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).
         # @!attribute [rw] materials
@@ -349,10 +356,10 @@ 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
+        #     string with a length limit of 200 characters. Otherwise, an
         #     INVALID_ARGUMENT error is returned.
         #
-        #     Google Merchant Center property
+        #     Corresponding properties: Google Merchant Center property
         #     [material](https://support.google.com/merchants/answer/6324410). Schema.org
         #     property [Product.material](https://schema.org/material).
         # @!attribute [rw] patterns
@@ -365,7 +372,7 @@ module Google
         #     encoded string with a length limit of 128 characters. Otherwise, an
         #     INVALID_ARGUMENT error is returned.
         #
-        #     Google Merchant Center property
+        #     Corresponding properties: Google Merchant Center property
         #     [pattern](https://support.google.com/merchants/answer/6324483). Schema.org
         #     property [Product.pattern](https://schema.org/pattern).
         # @!attribute [rw] conditions
@@ -373,19 +380,21 @@ module Google
         #     The condition of the product. Strongly encouraged to use the standard
         #     values: "new", "refurbished", "used".
         #
-        #     A maximum of 5 values are allowed per
+        #     A maximum of 1 value is allowed per
         #     {::Google::Cloud::Retail::V2::Product 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
+        #     Corresponding properties: Google Merchant Center property
         #     [condition](https://support.google.com/merchants/answer/6324469).
         #     Schema.org property
         #     [Offer.itemCondition](https://schema.org/itemCondition).
         # @!attribute [rw] promotions
         #   @return [::Array<::Google::Cloud::Retail::V2::Promotion>]
         #     The promotions applied to the product. A maximum of 10 values are allowed
-        #     per {::Google::Cloud::Retail::V2::Product Product}.
+        #     per {::Google::Cloud::Retail::V2::Product Product}. Only
+        #     {::Google::Cloud::Retail::V2::Promotion#promotion_id Promotion.promotion_id}
+        #     will be used, other fields will be ignored if set.
         # @!attribute [rw] publish_time
         #   @return [::Google::Protobuf::Timestamp]
         #     The timestamp when the product is published by the retailer for the first

data/proto_docs/google/cloud/retail/v2/product_service.rb

@@ -263,6 +263,24 @@ module Google
         #     provided or default value for
         #     {::Google::Cloud::Retail::V2::SetInventoryRequest#set_time SetInventoryRequest.set_time}.
         #
+        #     The caller can replace place IDs for a subset of fulfillment types in the
+        #     following ways:
+        #
+        #     * Adds "fulfillment_info" in
+        #     {::Google::Cloud::Retail::V2::SetInventoryRequest#set_mask SetInventoryRequest.set_mask}
+        #     * Specifies only the desired fulfillment types and corresponding place IDs
+        #     to update in [SetInventoryRequest.inventory.fulfillment_info][]
+        #
+        #     The caller can clear all place IDs from a subset of fulfillment types in
+        #     the following ways:
+        #
+        #     * Adds "fulfillment_info" in
+        #     {::Google::Cloud::Retail::V2::SetInventoryRequest#set_mask SetInventoryRequest.set_mask}
+        #     * Specifies only the desired fulfillment types to clear in
+        #     [SetInventoryRequest.inventory.fulfillment_info][]
+        #     * Checks that only the desired fulfillment info types have empty
+        #     [SetInventoryRequest.inventory.fulfillment_info.place_ids][]
+        #
         #     The last update time is recorded for the following inventory fields:
         #     * {::Google::Cloud::Retail::V2::Product#price_info Product.price_info}
         #     * {::Google::Cloud::Retail::V2::Product#availability Product.availability}
@@ -274,8 +292,9 @@ module Google
         # @!attribute [rw] set_mask
         #   @return [::Google::Protobuf::FieldMask]
         #     Indicates which inventory fields in the provided
-        #     {::Google::Cloud::Retail::V2::Product Product} to update. If not set or set with
-        #     empty paths, all inventory fields will be updated.
+        #     {::Google::Cloud::Retail::V2::Product 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.
@@ -395,6 +414,119 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for [AddLocalInventories][] method.
+        # @!attribute [rw] product
+        #   @return [::String]
+        #     Required. Full resource name of {::Google::Cloud::Retail::V2::Product Product},
+        #     such as
+        #     `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/some_product_id`.
+        #
+        #     If the caller does not have permission to access the
+        #     {::Google::Cloud::Retail::V2::Product Product}, regardless of whether or not it
+        #     exists, a PERMISSION_DENIED error is returned.
+        # @!attribute [rw] local_inventories
+        #   @return [::Array<::Google::Cloud::Retail::V2::LocalInventory>]
+        #     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.
+        # @!attribute [rw] add_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Indicates which inventory fields in the provided list of
+        #     {::Google::Cloud::Retail::V2::LocalInventory 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.
+        # @!attribute [rw] add_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     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.
+        # @!attribute [rw] allow_missing
+        #   @return [::Boolean]
+        #     If set to true, and the {::Google::Cloud::Retail::V2::Product Product} is not
+        #     found, the local inventory will still be processed and retained for at most
+        #     1 day and processed once the {::Google::Cloud::Retail::V2::Product Product} is
+        #     created. If set to false, a NOT_FOUND error is returned if the
+        #     {::Google::Cloud::Retail::V2::Product Product} is not found.
+        class AddLocalInventoriesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Metadata related to the progress of the AddLocalInventories operation.
+        # Currently empty because there is no meaningful metadata populated from the
+        # [AddLocalInventories][] method.
+        class AddLocalInventoriesMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response of the [AddLocalInventories][] API.  Currently empty because
+        # there is no meaningful response populated from the [AddLocalInventories][]
+        # method.
+        class AddLocalInventoriesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for [RemoveLocalInventories][] method.
+        # @!attribute [rw] product
+        #   @return [::String]
+        #     Required. Full resource name of {::Google::Cloud::Retail::V2::Product Product},
+        #     such as
+        #     `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/some_product_id`.
+        #
+        #     If the caller does not have permission to access the
+        #     {::Google::Cloud::Retail::V2::Product Product}, regardless of whether or not it
+        #     exists, a PERMISSION_DENIED error is returned.
+        # @!attribute [rw] place_ids
+        #   @return [::Array<::String>]
+        #     Required. A list of place IDs to have their inventory deleted.
+        #     At most 3000 place IDs are allowed per request.
+        # @!attribute [rw] remove_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     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.
+        # @!attribute [rw] allow_missing
+        #   @return [::Boolean]
+        #     If set to true, and the {::Google::Cloud::Retail::V2::Product Product} is not
+        #     found, the local inventory removal request will still be processed and
+        #     retained for at most 1 day and processed once the
+        #     {::Google::Cloud::Retail::V2::Product Product} is created. If set to false, a
+        #     NOT_FOUND error is returned if the
+        #     {::Google::Cloud::Retail::V2::Product Product} is not found.
+        class RemoveLocalInventoriesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Metadata related to the progress of the RemoveLocalInventories operation.
+        # Currently empty because there is no meaningful metadata populated from the
+        # [RemoveLocalInventories][] method.
+        class RemoveLocalInventoriesMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response of the [RemoveLocalInventories][] API.  Currently empty because
+        # there is no meaningful response populated from the [RemoveLocalInventories][]
+        # method.
+        class RemoveLocalInventoriesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for [RemoveFulfillmentPlaces][] method.
         # @!attribute [rw] product
         #   @return [::String]

data/proto_docs/google/cloud/retail/v2/promotion.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Retail
+      module V2
+        # Promotion information.
+        # @!attribute [rw] promotion_id
+        #   @return [::String]
+        #     ID of the promotion. For example, "free gift".
+        #
+        #     The value must be a UTF-8 encoded string with a length limit of 128
+        #     characters, and match the pattern: `[a-zA-Z][a-zA-Z0-9_]*`. For example,
+        #     id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is
+        #     returned.
+        #
+        #     Google Merchant Center property
+        #     [promotion](https://support.google.com/merchants/answer/7050148).
+        class Promotion
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/retail/v2/search_service.rb

@@ -26,7 +26,7 @@ module Google
         # @!attribute [rw] placement
         #   @return [::String]
         #     Required. The resource name of the search engine placement, such as
-        #     `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
+        #     `projects/*/locations/global/catalogs/default_catalog/placements/default_search`
         #     This field is used to identify the serving configuration name and the set
         #     of models that will be used to make the search.
         # @!attribute [rw] branch
@@ -46,6 +46,9 @@ module Google
         #     identify a visitor on a single device. This unique identifier should not
         #     change if the visitor logs in or out of the website.
         #
+        #     This should be the same identifier as
+        #     {::Google::Cloud::Retail::V2::UserEvent#visitor_id 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.
         # @!attribute [rw] user_info
@@ -89,6 +92,9 @@ module Google
         #     If this field is unrecognizable, an INVALID_ARGUMENT is returned.
         # @!attribute [rw] canonical_filter
         #   @return [::String]
+        #     The default filter that is applied when a user performs a search without
+        #     checking any filters on the search page.
+        #
         #     The filter applied to every search request when quality improvement such as
         #     query expansion is needed. For example, if a query does not have enough
         #     results, an expanded query with
@@ -115,11 +121,11 @@ module Google
         #     is returned.
         # @!attribute [rw] dynamic_facet_spec
         #   @return [::Google::Cloud::Retail::V2::SearchRequest::DynamicFacetSpec]
+        #     Deprecated. Refer to https://cloud.google.com/retail/docs/configs#dynamic
+        #     to enable dynamic facets. Do not set this field.
+        #
         #     The specification for dynamically generated facets. Notice that only
         #     textual facets can be dynamically generated.
-        #
-        #     This feature requires additional allowlisting. Contact Retail Search
-        #     support team if you are interested in using dynamic facet feature.
         # @!attribute [rw] boost_spec
         #   @return [::Google::Cloud::Retail::V2::SearchRequest::BoostSpec]
         #     Boost specification to boost certain products. See more details at this
@@ -139,12 +145,15 @@ module Google
         #   @return [::Array<::String>]
         #     The keys to fetch and rollup the matching
         #     {::Google::Cloud::Retail::V2::Product::Type::VARIANT variant}
-        #     {::Google::Cloud::Retail::V2::Product Product}s attributes. The attributes from
-        #     all the matching {::Google::Cloud::Retail::V2::Product::Type::VARIANT variant}
-        #     {::Google::Cloud::Retail::V2::Product Product}s are merged and de-duplicated.
-        #     Notice that rollup {::Google::Cloud::Retail::V2::Product::Type::VARIANT variant}
-        #     {::Google::Cloud::Retail::V2::Product Product}s attributes will lead to extra
-        #     query latency. Maximum number of keys is 10.
+        #     {::Google::Cloud::Retail::V2::Product Product}s attributes,
+        #     {::Google::Cloud::Retail::V2::FulfillmentInfo FulfillmentInfo} or
+        #     {::Google::Cloud::Retail::V2::LocalInventory LocalInventory}s attributes. The
+        #     attributes from all the matching
+        #     {::Google::Cloud::Retail::V2::Product::Type::VARIANT variant}
+        #     {::Google::Cloud::Retail::V2::Product Product}s or
+        #     {::Google::Cloud::Retail::V2::LocalInventory LocalInventory}s are merged and
+        #     de-duplicated. Notice that rollup attributes will lead to extra query
+        #     latency. Maximum number of keys is 30.
         #
         #     For {::Google::Cloud::Retail::V2::FulfillmentInfo FulfillmentInfo}, a
         #     fulfillment type and a fulfillment ID must be provided in the format of
@@ -159,6 +168,7 @@ module Google
         #     * 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
@@ -220,6 +230,9 @@ module Google
         #   @return [::Google::Cloud::Retail::V2::SearchRequest::SearchMode]
         #     The search mode of the search request. If not specified, a single search
         #     request triggers both product search and faceted search.
+        # @!attribute [rw] personalization_spec
+        #   @return [::Google::Cloud::Retail::V2::SearchRequest::PersonalizationSpec]
+        #     The specification for personalization.
         class SearchRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -331,6 +344,7 @@ module Google
             #         * "ratingCount"
             #         * "attributes.key"
             #         * "inventory(place_id,price)"
+            #         * "inventory(place_id,original_price)"
             #         * "inventory(place_id,attributes.key)"
             # @!attribute [rw] intervals
             #   @return [::Array<::Google::Cloud::Retail::V2::Interval>]
@@ -457,6 +471,14 @@ module Google
           #     in the specifictions, boost scores from these specifications are all
           #     applied and combined in a non-linear way. Maximum number of
           #     specifications is 10.
+          # @!attribute [rw] skip_boost_spec_validation
+          #   @return [::Boolean]
+          #     Whether to skip boostspec validation. If this field is set to true,
+          #     invalid
+          #     {::Google::Cloud::Retail::V2::SearchRequest::BoostSpec#condition_boost_specs BoostSpec.condition_boost_specs}
+          #     will be ignored and valid
+          #     {::Google::Cloud::Retail::V2::SearchRequest::BoostSpec#condition_boost_specs BoostSpec.condition_boost_specs}
+          #     will still be applied.
           class BoostSpec
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -532,6 +554,29 @@ module Google
             end
           end
 
+          # The specification for personalization.
+          # @!attribute [rw] mode
+          #   @return [::Google::Cloud::Retail::V2::SearchRequest::PersonalizationSpec::Mode]
+          #     Defaults to
+          #     {::Google::Cloud::Retail::V2::SearchRequest::PersonalizationSpec::Mode::AUTO Mode.AUTO}.
+          class PersonalizationSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # The personalization mode of each search request.
+            module Mode
+              # Default value. Defaults to
+              # {::Google::Cloud::Retail::V2::SearchRequest::PersonalizationSpec::Mode::AUTO Mode.AUTO}.
+              MODE_UNSPECIFIED = 0
+
+              # Let CRS decide whether to use personalization.
+              AUTO = 1
+
+              # Disable personalization.
+              DISABLED = 2
+            end
+          end
+
           # The search mode of each search request.
           module SearchMode
             # Default value. In this case both product search and faceted search will
@@ -601,6 +646,15 @@ module Google
         #     {::Google::Cloud::Retail::V2::SearchResponse#redirect_uri redirect_uri} and
         #     {::Google::Cloud::Retail::V2::SearchResponse#attribution_token attribution_token}
         #     will be set in the response.
+        # @!attribute [rw] applied_controls
+        #   @return [::Array<::String>]
+        #     The fully qualified resource name of applied
+        #     [controls](https://cloud.google.com/retail/docs/serving-control-rules).
+        # @!attribute [rw] invalid_condition_boost_specs
+        #   @return [::Array<::Google::Cloud::Retail::V2::SearchRequest::BoostSpec::ConditionBoostSpec>]
+        #     The invalid
+        #     {::Google::Cloud::Retail::V2::SearchRequest::BoostSpec#condition_boost_specs SearchRequest.BoostSpec.condition_boost_specs}
+        #     that are not applied during serving.
         class SearchResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods