google-cloud-retail-v2 0.6.4 → 0.9.0

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

@@ -35,22 +35,21 @@ module Google
         #     The maximum number of allowed characters is 255.
         # @!attribute [rw] visitor_id
         #   @return [::String]
-        #     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.
+        #     Required field. 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.
         # @!attribute [rw] language_codes
         #   @return [::Array<::String>]
-        #     The list of languages of the query. This is
-        #     the BCP-47 language code, such as "en-US" or "sr-Latn".
-        #     For more information, see
-        #     [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
-        #
-        #     The maximum number of allowed characters is 255.
-        #     Only "en-US" is currently supported.
+        #     The language filters applied to the output suggestions. If set, it should
+        #     contain the language of the query. If not set, suggestions are returned
+        #     without considering language restrictions. This is the BCP-47 language
+        #     code, such as "en-US" or "sr-Latn". For more information, see [Tags for
+        #     Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum
+        #     number of language codes is 3.
         # @!attribute [rw] device_type
         #   @return [::String]
         #     The device type context for completion suggestions.
@@ -79,9 +78,9 @@ module Google
         #
         #     * user-data
         #
-        #     * cloud-retail
-        #       This option requires additional allowlisting. Before using cloud-retail,
-        #       contact Cloud Retail support team first.
+        #     * cloud-retail:
+        #       This option requires enabling auto-learning function first. See
+        #       [guidelines](https://cloud.google.com/retail/docs/completion-overview#generated-completion-dataset).
         # @!attribute [rw] max_suggestions
         #   @return [::Integer]
         #     Completion max suggestions. If left unset or set to 0, then will fallback
@@ -102,9 +101,9 @@ module Google
         # @!attribute [rw] attribution_token
         #   @return [::String]
         #     A unique complete token. This should be included in the
-        #     {::Google::Cloud::Retail::V2::SearchRequest SearchRequest} resulting from this
-        #     completion, which enables accurate attribution of complete model
-        #     performance.
+        #     {::Google::Cloud::Retail::V2::UserEvent#completion_detail UserEvent.completion_detail}
+        #     for search events resulting from this completion, which enables accurate
+        #     attribution of complete model performance.
         # @!attribute [rw] recent_search_results
         #   @return [::Array<::Google::Cloud::Retail::V2::CompleteQueryResponse::RecentSearchResult>]
         #     Matched recent searches of this user. The maximum number of recent searches
@@ -115,11 +114,15 @@ module Google
         #     {::Google::Cloud::Retail::V2::CompleteQueryRequest#visitor_id CompleteQueryRequest.visitor_id}
         #     field is set and {::Google::Cloud::Retail::V2::UserEvent UserEvent} is imported.
         #     The recent searches satisfy the follow rules:
+        #
         #      * They are ordered from latest to oldest.
+        #
         #      * They are matched with
         #      {::Google::Cloud::Retail::V2::CompleteQueryRequest#query CompleteQueryRequest.query}
         #      case insensitively.
+        #
         #      * They are transformed to lower cases.
+        #
         #      * They are UTF-8 safe.
         #
         #     Recent searches are deduplicated. More recent searches will be reserved
@@ -134,7 +137,14 @@ module Google
           #     The suggestion for the query.
           # @!attribute [rw] attributes
           #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Retail::V2::CustomAttribute}]
-          #     Additional custom attributes ingested through BigQuery.
+          #     Custom attributes for the suggestion term.
+          #
+          #     * For "user-data", the attributes are additional custom attributes
+          #     ingested through BigQuery.
+          #
+          #     * For "cloud-retail", the attributes are product attributes generated
+          #     by Cloud Retail. This is an experimental feature. Contact Retail Search
+          #     support team if you are interested in enabling it.
           class CompletionResult
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -51,6 +51,14 @@ module Google
         #     {::Google::Cloud::Retail::V2::UserEvent 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.
         class GcsSource
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -98,8 +106,19 @@ module Google
         #
         #     * `user_event` (default): One JSON
         #     {::Google::Cloud::Retail::V2::UserEvent UserEvent} per line.
-        #     * `user_event_ga360`: Using
+        #     * `user_event_ga360`:
+        #       The schema is available here:
         #       https://support.google.com/analytics/answer/3437719.
+        #     * `user_event_ga4`: This feature is in private preview. Please contact the
+        #       support team for importing Google Analytics 4 events.
+        #       The schema is available here:
+        #       https://support.google.com/analytics/answer/7029846.
+        #
+        #     Supported values for auto-completion imports:
+        #
+        #     * `suggestions` (default): One JSON completion suggestion per line.
+        #     * `denylist`:  One JSON deny suggestion per line.
+        #     * `allowlist`:  One JSON allow suggestion per line.
         class BigQuerySource
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -128,9 +147,9 @@ module Google
         # Configuration of destination for Import related errors.
         # @!attribute [rw] gcs_prefix
         #   @return [::String]
-        #     Google Cloud Storage path for import errors. This must be an empty,
-        #     existing Cloud Storage bucket. Import errors will be written to a file in
-        #     this bucket, one per line, as a JSON-encoded
+        #     Google Cloud Storage prefix for import errors. This must be an empty,
+        #     existing Cloud Storage directory. Import errors will be written to
+        #     sharded files in this directory, one per line, as a JSON-encoded
         #     `google.rpc.Status` message.
         class ImportErrorsConfig
           include ::Google::Protobuf::MessageExts
@@ -147,15 +166,7 @@ module Google
         #     If updateMask is specified, requires products.update permission.
         # @!attribute [rw] request_id
         #   @return [::String]
-        #     Unique identifier provided by client, within the ancestor
-        #     dataset scope. Ensures idempotency and used for request deduplication.
-        #     Server-generated if unspecified. Up to 128 characters long and must match
-        #     the pattern: `[a-zA-Z0-9_]+`. This is returned as [Operation.name][] in
-        #     {::Google::Cloud::Retail::V2::ImportMetadata ImportMetadata}.
-        #
-        #     Only supported when
-        #     {::Google::Cloud::Retail::V2::ImportProductsRequest#reconciliation_mode ImportProductsRequest.reconciliation_mode}
-        #     is set to `FULL`.
+        #     Deprecated. This field has no effect.
         # @!attribute [rw] input_config
         #   @return [::Google::Cloud::Retail::V2::ProductInputConfig]
         #     Required. The desired input location of the data.
@@ -173,11 +184,18 @@ module Google
         #     {::Google::Cloud::Retail::V2::ImportProductsRequest::ReconciliationMode::INCREMENTAL ReconciliationMode.INCREMENTAL}.
         # @!attribute [rw] notification_pubsub_topic
         #   @return [::String]
-        #     Pub/Sub topic for receiving notification. If this field is set,
+        #     Full Pub/Sub topic name for receiving notification. If this field is set,
         #     when the import is finished, a notification will be sent to
         #     specified Pub/Sub topic. The message data will be JSON string of a
         #     {::Google::Longrunning::Operation Operation}.
-        #     Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
+        #
+        #     Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has
+        #     to be within the same project as
+        #     {::Google::Cloud::Retail::V2::ImportProductsRequest#parent ImportProductsRequest.parent}.
+        #     Make sure that both
+        #     `cloud-retail-customer-data-access@system.gserviceaccount.com` and
+        #     `service-<project number>@gcp-sa-retail.iam.gserviceaccount.com`
+        #     have the `pubsub.topics.publish` IAM permission on the topic.
         #
         #     Only supported when
         #     {::Google::Cloud::Retail::V2::ImportProductsRequest#reconciliation_mode ImportProductsRequest.reconciliation_mode}
@@ -198,16 +216,14 @@ module Google
             # Calculates diff and replaces the entire product dataset. Existing
             # products may be deleted if they are not present in the source location.
             #
-            # Can only be while using
-            # {::Google::Cloud::Retail::V2::BigQuerySource BigQuerySource}.
+            # Can only be set while using
+            # {::Google::Cloud::Retail::V2::BigQuerySource BigQuerySource}. And the BigQuery
+            # dataset must be created in the data location "us (multiple regions in
+            # United States)", otherwise a PERMISSION_DENIED error is thrown.
             #
             # Add the IAM permission "BigQuery Data Viewer" for
             # cloud-retail-customer-data-access@system.gserviceaccount.com before
             # using this feature otherwise an error is thrown.
-            #
-            # This feature is only available for users who have Retail Search enabled.
-            # Please submit a form [here](https://cloud.google.com/contact) to contact
-            # cloud sales if you are interested in using Retail Search.
             FULL = 2
           end
         end
@@ -309,8 +325,7 @@ module Google
         #     Count of entries that encountered errors while processing.
         # @!attribute [rw] request_id
         #   @return [::String]
-        #     Id of the request / operation. This is parroting back the requestId
-        #     that was passed in the request.
+        #     Deprecated. This field is never set.
         # @!attribute [rw] notification_pubsub_topic
         #   @return [::String]
         #     Pub/Sub topic for receiving notification. If this field is set,

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

@@ -39,6 +39,16 @@ module Google
         #     they took to trigger the predict request. Note that this user event detail
         #     won't be ingested to userEvent logs. Thus, a separate userEvent write
         #     request is required for event logging.
+        #
+        #     Don't set
+        #     {::Google::Cloud::Retail::V2::UserEvent#visitor_id UserEvent.visitor_id} or
+        #     {::Google::Cloud::Retail::V2::UserInfo#user_id UserInfo.user_id} to the same
+        #     fixed ID for different users. If you are trying to receive non-personalized
+        #     recommendations (not recommended; this can negatively impact model
+        #     performance), instead set
+        #     {::Google::Cloud::Retail::V2::UserEvent#visitor_id UserEvent.visitor_id} to a
+        #     random unique ID and leave
+        #     {::Google::Cloud::Retail::V2::UserInfo#user_id UserInfo.user_id} unset.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Maximum number of results to return per page. Set this property
@@ -73,9 +83,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
@@ -116,7 +129,7 @@ module Google
         #     * Each resource can have multiple labels, up to a maximum of 64.
         #     * Each label must be a key-value pair.
         #     * Keys have a minimum length of 1 character and a maximum length of 63
-        #       characters, and cannot be empty. Values can be empty, and have a maximum
+        #       characters and cannot be empty. Values can be empty and have a maximum
         #       length of 63 characters.
         #     * Keys and values can contain only lowercase letters, numeric characters,
         #       underscores, and dashes. All characters must use UTF-8 encoding, and
@@ -182,9 +195,9 @@ module Google
           #
           #     Possible values:
           #
-          #     * `product`: JSON representation of the product. Will be set if
+          #     * `product`: JSON representation of the product. Is set if
           #       `returnProduct` is set to true in `PredictRequest.params`.
-          #     * `score`: Prediction score in double value. Will be set if
+          #     * `score`: Prediction score in double value. Is set if
           #       `returnScore` is set to true in `PredictRequest.params`.
           class PredictionResult
             include ::Google::Protobuf::MessageExts

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
@@ -447,11 +456,11 @@ module Google
         #     * {::Google::Cloud::Retail::V2::Product#name name}
         #     * {::Google::Cloud::Retail::V2::Product#color_info color_info}
         #
-        #     Maximum number of paths is 30. Otherwise, an INVALID_ARGUMENT error is
+        #     The maximum number of paths is 30. Otherwise, an INVALID_ARGUMENT error is
         #     returned.
         #
         #     Note: Returning more fields in
-        #     {::Google::Cloud::Retail::V2::SearchResponse SearchResponse} may increase
+        #     {::Google::Cloud::Retail::V2::SearchResponse SearchResponse} can increase
         #     response payload size and serving latency.
         # @!attribute [r] variants
         #   @return [::Array<::Google::Cloud::Retail::V2::Product>]