google-cloud-retail-v2 0.6.4 → 0.7.0

data/lib/google/cloud/retail/v2/search_service/client.rb

@@ -30,8 +30,7 @@ module Google
           # Service for search.
           #
           # 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.
+          # Please enable Retail Search on Cloud Console before using this feature.
           #
           class Client
             include Paths
@@ -157,8 +156,7 @@ module Google
             # Performs a search.
             #
             # 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.
+            # Please enable Retail Search on Cloud Console before using this feature.
             #
             # @overload search(request, options = nil)
             #   Pass arguments to `search` via a request object, either of type
@@ -170,14 +168,14 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload search(placement: nil, branch: nil, query: nil, visitor_id: nil, user_info: nil, page_size: nil, page_token: nil, offset: nil, filter: nil, canonical_filter: nil, order_by: nil, facet_specs: nil, dynamic_facet_spec: nil, boost_spec: nil, query_expansion_spec: nil, variant_rollup_keys: nil, page_categories: nil, search_mode: nil)
+            # @overload search(placement: nil, branch: nil, query: nil, visitor_id: nil, user_info: nil, page_size: nil, page_token: nil, offset: nil, filter: nil, canonical_filter: nil, order_by: nil, facet_specs: nil, dynamic_facet_spec: nil, boost_spec: nil, query_expansion_spec: nil, variant_rollup_keys: nil, page_categories: nil, search_mode: nil, personalization_spec: nil)
             #   Pass arguments to `search` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param placement [::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.
             #   @param branch [::String]
@@ -194,6 +192,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.
             #   @param user_info [::Google::Cloud::Retail::V2::UserInfo, ::Hash]
@@ -231,6 +232,9 @@ module Google
             #
             #     If this field is unrecognizable, an INVALID_ARGUMENT is returned.
             #   @param canonical_filter [::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
@@ -254,11 +258,11 @@ module Google
             #     A maximum of 100 values are allowed. Otherwise, an INVALID_ARGUMENT error
             #     is returned.
             #   @param dynamic_facet_spec [::Google::Cloud::Retail::V2::SearchRequest::DynamicFacetSpec, ::Hash]
+            #     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.
             #   @param boost_spec [::Google::Cloud::Retail::V2::SearchRequest::BoostSpec, ::Hash]
             #     Boost specification to boost certain products. See more details at this
             #     [user guide](https://cloud.google.com/retail/docs/boosting).
@@ -275,12 +279,15 @@ module Google
             #   @param variant_rollup_keys [::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
@@ -295,6 +302,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
@@ -354,6 +362,8 @@ module Google
             #   @param search_mode [::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.
+            #   @param personalization_spec [::Google::Cloud::Retail::V2::SearchRequest::PersonalizationSpec, ::Hash]
+            #     The specification for personalization.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Retail::V2::SearchResponse::SearchResult>]

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

@@ -34,8 +34,7 @@ module Google
         # Service for search.
         #
         # 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.
+        # Please enable Retail Search on Cloud Console before using this feature.
         #
         # To load this service and instantiate a client:
         #

data/lib/google/cloud/retail/v2/search_service_pb.rb

@@ -9,8 +9,6 @@ require 'google/cloud/retail/v2/common_pb'
 require 'google/cloud/retail/v2/product_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/struct_pb'
-require 'google/protobuf/timestamp_pb'
-require 'google/protobuf/wrappers_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
@@ -34,6 +32,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :variant_rollup_keys, :string, 17
       repeated :page_categories, :string, 23
       optional :search_mode, :enum, 31, "google.cloud.retail.v2.SearchRequest.SearchMode"
+      optional :personalization_spec, :message, 32, "google.cloud.retail.v2.SearchRequest.PersonalizationSpec"
     end
     add_message "google.cloud.retail.v2.SearchRequest.FacetSpec" do
       optional :facet_key, :message, 1, "google.cloud.retail.v2.SearchRequest.FacetSpec.FacetKey"
@@ -60,6 +59,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.retail.v2.SearchRequest.BoostSpec" do
       repeated :condition_boost_specs, :message, 1, "google.cloud.retail.v2.SearchRequest.BoostSpec.ConditionBoostSpec"
+      proto3_optional :skip_boost_spec_validation, :bool, 2
     end
     add_message "google.cloud.retail.v2.SearchRequest.BoostSpec.ConditionBoostSpec" do
       optional :condition, :string, 1
@@ -74,6 +74,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :DISABLED, 1
       value :AUTO, 3
     end
+    add_message "google.cloud.retail.v2.SearchRequest.PersonalizationSpec" do
+      optional :mode, :enum, 1, "google.cloud.retail.v2.SearchRequest.PersonalizationSpec.Mode"
+    end
+    add_enum "google.cloud.retail.v2.SearchRequest.PersonalizationSpec.Mode" do
+      value :MODE_UNSPECIFIED, 0
+      value :AUTO, 1
+      value :DISABLED, 2
+    end
     add_enum "google.cloud.retail.v2.SearchRequest.SearchMode" do
       value :SEARCH_MODE_UNSPECIFIED, 0
       value :PRODUCT_SEARCH_ONLY, 1
@@ -88,6 +96,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :next_page_token, :string, 6
       optional :query_expansion_info, :message, 7, "google.cloud.retail.v2.SearchResponse.QueryExpansionInfo"
       optional :redirect_uri, :string, 10
+      repeated :applied_controls, :string, 12
+      repeated :invalid_condition_boost_specs, :message, 14, "google.cloud.retail.v2.SearchRequest.BoostSpec.ConditionBoostSpec"
     end
     add_message "google.cloud.retail.v2.SearchResponse.SearchResult" do
       optional :id, :string, 1
@@ -128,6 +138,8 @@ module Google
         SearchRequest::BoostSpec::ConditionBoostSpec = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.SearchRequest.BoostSpec.ConditionBoostSpec").msgclass
         SearchRequest::QueryExpansionSpec = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.SearchRequest.QueryExpansionSpec").msgclass
         SearchRequest::QueryExpansionSpec::Condition = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.SearchRequest.QueryExpansionSpec.Condition").enummodule
+        SearchRequest::PersonalizationSpec = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.SearchRequest.PersonalizationSpec").msgclass
+        SearchRequest::PersonalizationSpec::Mode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.SearchRequest.PersonalizationSpec.Mode").enummodule
         SearchRequest::SearchMode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.SearchRequest.SearchMode").enummodule
         SearchResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.SearchResponse").msgclass
         SearchResponse::SearchResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.SearchResponse.SearchResult").msgclass

data/lib/google/cloud/retail/v2/search_service_services_pb.rb

@@ -27,8 +27,7 @@ module Google
           # Service for search.
           #
           # 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.
+          # Please enable Retail Search on Cloud Console before using this feature.
           class Service
 
             include ::GRPC::GenericService
@@ -40,8 +39,7 @@ module Google
             # Performs a search.
             #
             # 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.
+            # Please enable Retail Search on Cloud Console before using this feature.
             rpc :Search, ::Google::Cloud::Retail::V2::SearchRequest, ::Google::Cloud::Retail::V2::SearchResponse
           end
 

data/lib/google/cloud/retail/v2/user_event_pb.rb

@@ -1,7 +1,6 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/retail/v2/user_event.proto
 
-require 'google/api/annotations_pb'
 require 'google/api/field_behavior_pb'
 require 'google/cloud/retail/v2/common_pb'
 require 'google/cloud/retail/v2/product_pb'

data/lib/google/cloud/retail/v2/user_event_service/client.rb

@@ -593,13 +593,14 @@ module Google
             end
 
             ##
-            # Triggers a user event rejoin operation with latest product catalog. Events
+            # Starts a user event rejoin operation with latest product catalog. Events
             # will not be annotated with detailed product information if product is
             # missing from the catalog at the time the user event is ingested, and these
             # events are stored as unjoined events with a limited usage on training and
-            # serving. This API can be used to trigger a 'join' operation on specified
+            # serving. This method can be used to start a join operation on specified
             # events with latest version of product catalog. It can also be used to
-            # correct events joined with wrong product catalog.
+            # correct events joined with the wrong product catalog. A rejoin operation
+            # can take hours or days to complete.
             #
             # @overload rejoin_user_events(request, options = nil)
             #   Pass arguments to `rejoin_user_events` via a request object, either of type

data/lib/google/cloud/retail/v2/user_event_service_pb.rb

@@ -5,6 +5,7 @@ require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/httpbody_pb'
+require 'google/api/resource_pb'
 require 'google/cloud/retail/v2/import_config_pb'
 require 'google/cloud/retail/v2/purge_config_pb'
 require 'google/cloud/retail/v2/user_event_pb'

data/lib/google/cloud/retail/v2/user_event_service_services_pb.rb

@@ -54,13 +54,14 @@ module Google
             # possible for a subset of the items to be successfully inserted.
             # Operation.metadata is of type ImportMetadata.
             rpc :ImportUserEvents, ::Google::Cloud::Retail::V2::ImportUserEventsRequest, ::Google::Longrunning::Operation
-            # Triggers a user event rejoin operation with latest product catalog. Events
+            # Starts a user event rejoin operation with latest product catalog. Events
             # will not be annotated with detailed product information if product is
             # missing from the catalog at the time the user event is ingested, and these
             # events are stored as unjoined events with a limited usage on training and
-            # serving. This API can be used to trigger a 'join' operation on specified
+            # serving. This method can be used to start a join operation on specified
             # events with latest version of product catalog. It can also be used to
-            # correct events joined with wrong product catalog.
+            # correct events joined with the wrong product catalog. A rejoin operation
+            # can take hours or days to complete.
             rpc :RejoinUserEvents, ::Google::Cloud::Retail::V2::RejoinUserEventsRequest, ::Google::Longrunning::Operation
           end
 

data/lib/google/cloud/retail/v2/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Retail
       module V2
-        VERSION = "0.6.4"
+        VERSION = "0.7.0"
       end
     end
   end

data/lib/google/cloud/retail/v2.rb

@@ -30,6 +30,8 @@ module Google
       ##
       # To load this package, including all its services, and instantiate a client:
       #
+      # @example
+      #
       #     require "google/cloud/retail/v2"
       #     client = ::Google::Cloud::Retail::V2::CatalogService::Client.new
       #

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

@@ -109,6 +109,10 @@ module Google
         #
         #     This field must be one of "0", "1" or "2". Otherwise, an INVALID_ARGUMENT
         #     error is returned.
+        #
+        #     If there are no sufficient active products in the targeted branch and
+        #     {::Google::Cloud::Retail::V2::SetDefaultBranchRequest#force force} is not set, a
+        #     FAILED_PRECONDITION error is returned.
         # @!attribute [rw] note
         #   @return [::String]
         #     Some note on this request, this can be retrieved by
@@ -117,6 +121,11 @@ 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.
+        # @!attribute [rw] force
+        #   @return [::Boolean]
+        #     If set to true, it permits switching to a branch with
+        #     {::Google::Cloud::Retail::V2::SetDefaultBranchRequest#branch_id branch_id} even
+        #     if it has no sufficient active products.
         class SetDefaultBranchRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -99,9 +99,8 @@ module Google
         #     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.
+        #     Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is
+        #     returned.
         #
         #     Exactly one of {::Google::Cloud::Retail::V2::CustomAttribute#text text} or
         #     {::Google::Cloud::Retail::V2::CustomAttribute#numbers numbers} should be set.
@@ -111,15 +110,16 @@ module Google
         #     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 {::Google::Cloud::Retail::V2::CustomAttribute#text text} or
         #     {::Google::Cloud::Retail::V2::CustomAttribute#numbers numbers} should be set.
         #     Otherwise, an INVALID_ARGUMENT error is returned.
         # @!attribute [rw] searchable
         #   @return [::Boolean]
-        #     If true, custom attribute values are searchable by text queries in
+        #     This field will only be used when
+        #     [AttributesConfig.attribute_config_level][] of the
+        #     {::Google::Cloud::Retail::V2::Catalog Catalog} is
+        #     'PRODUCT_LEVEL_ATTRIBUTE_CONFIG', if true, custom attribute values are
+        #     searchable by text queries in
         #     {::Google::Cloud::Retail::V2::SearchService::Client#search SearchService.Search}.
         #
         #     This field is ignored in a {::Google::Cloud::Retail::V2::UserEvent UserEvent}.
@@ -128,8 +128,11 @@ module Google
         #     set. Otherwise, a INVALID_ARGUMENT error is returned.
         # @!attribute [rw] indexable
         #   @return [::Boolean]
-        #     If true, custom attribute values are indexed, so that it can be filtered,
-        #     faceted or boosted in
+        #     This field will only be used when
+        #     [AttributesConfig.attribute_config_level][] of the
+        #     {::Google::Cloud::Retail::V2::Catalog Catalog} is
+        #     'PRODUCT_LEVEL_ATTRIBUTE_CONFIG', if true, custom attribute values are
+        #     indexed, so that it can be filtered, faceted or boosted in
         #     {::Google::Cloud::Retail::V2::SearchService::Client#search SearchService.Search}.
         #
         #     This field is ignored in a {::Google::Cloud::Retail::V2::UserEvent UserEvent}.
@@ -183,7 +186,10 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # {::Google::Cloud::Retail::V2::Product Product} thumbnail/detail image.
+        # {::Google::Cloud::Retail::V2::Product Product} image. Recommendations AI and
+        # Retail Search do not use product images to improve prediction and search
+        # results. However, product images can be returned in results, and are shown in
+        # prediction or search previews in the console.
         # @!attribute [rw] uri
         #   @return [::String]
         #     Required. URI of the image.
@@ -250,7 +256,7 @@ module Google
         #
         #     Google Merchant Center property
         #     [price](https://support.google.com/merchants/answer/6324371). Schema.org
-        #     property [Offer.priceSpecification](https://schema.org/priceSpecification).
+        #     property [Offer.price](https://schema.org/price).
         # @!attribute [rw] original_price
         #   @return [::Float]
         #     Price of the product without any discount. If zero, by default set to be
@@ -369,19 +375,24 @@ module Google
         #     Highly recommended for logged-in users. Unique identifier for logged-in
         #     user, such as a user name.
         #
+        #     Always use a hashed value for this ID.
+        #
         #     The field must be a UTF-8 encoded string with a length limit of 128
         #     characters. Otherwise, an INVALID_ARGUMENT error is returned.
         # @!attribute [rw] ip_address
         #   @return [::String]
-        #     The end user's IP address. Required for getting
-        #     [SearchResponse.sponsored_results][google.cloud.retail.v2.SearchResponse.sponsored_results].
-        #     This field is used to extract location information for personalization.
+        #     The end user's IP address. This field is used to extract location
+        #     information for personalization.
         #
         #     This field must be either an IPv4 address (e.g. "104.133.9.80") or an IPv6
         #     address (e.g. "2001:0db8:85a3:0000:0000:8a2e:0370:7334"). Otherwise, an
         #     INVALID_ARGUMENT error is returned.
         #
-        #     This should not be set when using the JavaScript tag in
+        #     This should not be set when:
+        #
+        #     * setting
+        #     {::Google::Cloud::Retail::V2::SearchRequest#user_info SearchRequest.user_info}.
+        #     * using the JavaScript tag in
         #     {::Google::Cloud::Retail::V2::UserEventService::Client#collect_user_event UserEventService.CollectUserEvent}
         #     or if
         #     {::Google::Cloud::Retail::V2::UserInfo#direct_user_request direct_user_request}
@@ -416,21 +427,73 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Promotion information.
-        # @!attribute [rw] promotion_id
+        # The inventory information at a place (e.g. a store) identified
+        # by a place ID.
+        # @!attribute [rw] place_id
         #   @return [::String]
-        #     ID of the promotion. For example, "free gift".
-        #
-        #     The value 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.
+        #     The place ID for the current set of inventory information.
+        # @!attribute [rw] price_info
+        #   @return [::Google::Cloud::Retail::V2::PriceInfo]
+        #     Product price and cost information.
         #
         #     Google Merchant Center property
-        #     [promotion](https://support.google.com/merchants/answer/7050148).
-        class Promotion
+        #     [price](https://support.google.com/merchants/answer/6324371).
+        # @!attribute [rw] attributes
+        #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Retail::V2::CustomAttribute}]
+        #     Additional local inventory attributes, for example, store name, promotion
+        #     tags, etc.
+        #
+        #     This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT
+        #     error is returned:
+        #
+        #     * At most 30 attributes are allowed.
+        #     * The key must be a UTF-8 encoded string with a length limit of 32
+        #       characters.
+        #     * The key must match the pattern: `[a-zA-Z0-9][a-zA-Z0-9_]*`. For example,
+        #       key0LikeThis or KEY_1_LIKE_THIS.
+        #     * The attribute values must be of the same type (text or number).
+        #     * Only 1 value is allowed for each attribute.
+        #     * For text values, the length limit is 256 UTF-8 characters.
+        #     * The attribute does not support search. The `searchable` field should be
+        #       unset or set to false.
+        #     * The max summed total bytes of custom attribute keys and values per
+        #       product is 5MiB.
+        # @!attribute [rw] fulfillment_types
+        #   @return [::Array<::String>]
+        #     Input only. Supported fulfillment types. Valid fulfillment type values
+        #     include commonly used types (such as pickup in store and same day
+        #     delivery), and custom types. Customers have to map custom types to their
+        #     display names before rendering UI.
+        #
+        #     Supported values:
+        #
+        #     * "pickup-in-store"
+        #     * "ship-to-store"
+        #     * "same-day-delivery"
+        #     * "next-day-delivery"
+        #     * "custom-type-1"
+        #     * "custom-type-2"
+        #     * "custom-type-3"
+        #     * "custom-type-4"
+        #     * "custom-type-5"
+        #
+        #     If this field is set to an invalid value other than these, an
+        #     INVALID_ARGUMENT error is returned.
+        #
+        #     All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is
+        #     returned.
+        class LocalInventory
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::Google::Cloud::Retail::V2::CustomAttribute]
+          class AttributesEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
       end
     end

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.
@@ -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
@@ -134,7 +133,11 @@ 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.
           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.
@@ -198,16 +209,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 +318,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,