google-cloud-retail-v2 0.4.2 → 0.6.1

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

@@ -1,8 +1,6 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/retail/v2/search_service.proto
 
-require 'google/protobuf'
-
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
@@ -13,6 +11,8 @@ 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
   add_file("google/cloud/retail/v2/search_service.proto", :syntax => :proto3) do
     add_message "google.cloud.retail.v2.SearchRequest" do
@@ -33,6 +33,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :query_expansion_spec, :message, 14, "google.cloud.retail.v2.SearchRequest.QueryExpansionSpec"
       repeated :variant_rollup_keys, :string, 17
       repeated :page_categories, :string, 23
+      optional :search_mode, :enum, 31, "google.cloud.retail.v2.SearchRequest.SearchMode"
     end
     add_message "google.cloud.retail.v2.SearchRequest.FacetSpec" do
       optional :facet_key, :message, 1, "google.cloud.retail.v2.SearchRequest.FacetSpec.FacetKey"
@@ -66,12 +67,18 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.retail.v2.SearchRequest.QueryExpansionSpec" do
       optional :condition, :enum, 1, "google.cloud.retail.v2.SearchRequest.QueryExpansionSpec.Condition"
+      optional :pin_unexpanded_results, :bool, 2
     end
     add_enum "google.cloud.retail.v2.SearchRequest.QueryExpansionSpec.Condition" do
       value :CONDITION_UNSPECIFIED, 0
       value :DISABLED, 1
       value :AUTO, 3
     end
+    add_enum "google.cloud.retail.v2.SearchRequest.SearchMode" do
+      value :SEARCH_MODE_UNSPECIFIED, 0
+      value :PRODUCT_SEARCH_ONLY, 1
+      value :FACETED_SEARCH_ONLY, 2
+    end
     add_message "google.cloud.retail.v2.SearchResponse" do
       repeated :results, :message, 1, "google.cloud.retail.v2.SearchResponse.SearchResult"
       repeated :facets, :message, 2, "google.cloud.retail.v2.SearchResponse.Facet"
@@ -103,6 +110,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.retail.v2.SearchResponse.QueryExpansionInfo" do
       optional :expanded_query, :bool, 1
+      optional :pinned_result_count, :int64, 2
     end
   end
 end
@@ -120,6 +128,7 @@ 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::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
         SearchResponse::Facet = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.SearchResponse.Facet").msgclass

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

@@ -27,11 +27,11 @@ module Google
           # Service for search.
           #
           # This feature is only available for users who have Retail Search enabled.
-          # Contact Retail Support (retail-search-support@google.com) if you are
-          # interested in using Retail Search.
+          # Please submit a form [here](https://cloud.google.com/contact) to contact
+          # cloud sales if you are interested in using Retail Search.
           class Service
 
-            include GRPC::GenericService
+            include ::GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode
@@ -40,8 +40,8 @@ module Google
             # Performs a search.
             #
             # This feature is only available for users who have Retail Search enabled.
-            # Contact Retail Support (retail-search-support@google.com) if you are
-            # interested in using Retail Search.
+            # Please submit a form [here](https://cloud.google.com/contact) to contact
+            # cloud sales if you are interested in using Retail Search.
             rpc :Search, ::Google::Cloud::Retail::V2::SearchRequest, ::Google::Cloud::Retail::V2::SearchResponse
           end
 

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

@@ -1,14 +1,14 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/retail/v2/user_event.proto
 
-require 'google/protobuf'
-
 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'
 require 'google/protobuf/timestamp_pb'
 require 'google/protobuf/wrappers_pb'
+require 'google/protobuf'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/retail/v2/user_event.proto", :syntax => :proto3) do
     add_message "google.cloud.retail.v2.UserEvent" do

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

@@ -64,9 +64,19 @@ module Google
                                 end
                 default_config = Client::Configuration.new parent_config
 
-                default_config.timeout = 60.0
+                default_config.timeout = 5.0
                 default_config.retry_policy = {
-                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
+                  initial_delay: 0.1, max_delay: 5.0, multiplier: 1.3, retry_codes: [14, 4]
+                }
+
+                default_config.rpcs.purge_user_events.timeout = 30.0
+                default_config.rpcs.purge_user_events.retry_policy = {
+                  initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14, 4]
+                }
+
+                default_config.rpcs.import_user_events.timeout = 300.0
+                default_config.rpcs.import_user_events.retry_policy = {
+                  initial_delay: 0.1, max_delay: 300.0, multiplier: 1.3, retry_codes: [14, 4]
                 }
 
                 default_config
@@ -210,9 +220,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -295,9 +307,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -396,9 +410,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -476,9 +492,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -557,9 +575,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 

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

@@ -160,9 +160,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -232,9 +234,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -304,9 +308,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -381,9 +387,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 

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

@@ -1,8 +1,6 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/retail/v2/user_event_service.proto
 
-require 'google/protobuf'
-
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
@@ -11,6 +9,8 @@ require 'google/cloud/retail/v2/import_config_pb'
 require 'google/cloud/retail/v2/purge_config_pb'
 require 'google/cloud/retail/v2/user_event_pb'
 require 'google/longrunning/operations_pb'
+require 'google/protobuf'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/retail/v2/user_event_service.proto", :syntax => :proto3) do
     add_message "google.cloud.retail.v2.WriteUserEventRequest" do

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

@@ -27,7 +27,7 @@ module Google
           # Service for ingesting end user actions on the customer website.
           class Service
 
-            include GRPC::GenericService
+            include ::GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Retail
       module V2
-        VERSION = "0.4.2"
+        VERSION = "0.6.1"
       end
     end
   end

data/proto_docs/google/api/httpbody.rb

@@ -39,12 +39,15 @@ module Google
     #
     #       // The raw HTTP body is bound to this field.
     #       google.api.HttpBody http_body = 2;
+    #
     #     }
     #
     #     service ResourceService {
-    #       rpc GetResource(GetResourceRequest) returns (google.api.HttpBody);
-    #       rpc UpdateResource(google.api.HttpBody) returns
-    #       (google.protobuf.Empty);
+    #       rpc GetResource(GetResourceRequest)
+    #         returns (google.api.HttpBody);
+    #       rpc UpdateResource(google.api.HttpBody)
+    #         returns (google.protobuf.Empty);
+    #
     #     }
     #
     # Example with streaming methods:
@@ -54,6 +57,7 @@ module Google
     #         returns (stream google.api.HttpBody);
     #       rpc UpdateCalendar(stream google.api.HttpBody)
     #         returns (stream google.api.HttpBody);
+    #
     #     }
     #
     # Use of this type only changes how the request and response bodies are

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

@@ -80,7 +80,7 @@ module Google
         #     it is expected to have only 1 color. May consider using single "Mixed"
         #     instead of multiple values.
         #
-        #     A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+        #     A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
         #     string with a length limit of 128 characters. Otherwise, an
         #     INVALID_ARGUMENT error is returned.
         #
@@ -174,9 +174,10 @@ module Google
         #     or the region IDs for
         #     {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type.same-day-delivery}.
         #
-        #     A maximum of 2000 values are allowed. Each value must be a string with a
-        #     length limit of 10 characters, matching the pattern [a-zA-Z0-9_-]+, such as
-        #     "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+        #     A maximum of 3000 values are allowed. Each value must be a string with a
+        #     length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such
+        #     as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is
+        #     returned.
         class FulfillmentInfo
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -421,7 +422,7 @@ module Google
         #     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,
+        #     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.
         #

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

@@ -55,18 +55,18 @@ module Google
         #   @return [::String]
         #     The device type context for completion suggestions.
         #     It is useful to apply different suggestions on different device types, e.g.
-        #     DESKTOP, MOBILE. If it is empty, the suggestions are across all device
+        #     `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
         #     types.
         #
         #     Supported formats:
         #
-        #     * UNKNOWN_DEVICE_TYPE
+        #     * `UNKNOWN_DEVICE_TYPE`
         #
-        #     * DESKTOP
+        #     * `DESKTOP`
         #
-        #     * MOBILE
+        #     * `MOBILE`
         #
-        #     * A customized string starts with OTHER_, e.g. OTHER_IPHONE.
+        #     * A customized string starts with `OTHER_`, e.g. `OTHER_IPHONE`.
         # @!attribute [rw] dataset
         #   @return [::String]
         #     Determines which dataset to use for fetching completion. "user-data" will
@@ -80,13 +80,15 @@ module Google
         #     * user-data
         #
         #     * cloud-retail
-        #       This option is not automatically enabled. Before using cloud-retail,
-        #       contact retail-search-support@google.com first.
+        #       This option requires additional allowlisting. Before using cloud-retail,
+        #       contact Cloud Retail support team first.
         # @!attribute [rw] max_suggestions
         #   @return [::Integer]
-        #     Completion max suggestions.
+        #     Completion max suggestions. If left unset or set to 0, then will fallback
+        #     to the configured value [CompletionConfig.max_suggestions][].
         #
-        #     The maximum allowed max suggestions is 20. The default value is 20.
+        #     The maximum allowed max suggestions is 20. If it is set higher, it will be
+        #     capped by 20.
         class CompleteQueryRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -105,9 +107,9 @@ module Google
         #     performance.
         # @!attribute [rw] recent_search_results
         #   @return [::Array<::Google::Cloud::Retail::V2::CompleteQueryResponse::RecentSearchResult>]
-        #     Matched recent searches of this user. This field is a restricted feature.
-        #     Contact Retail Support (retail-search-support@google.com) if you are
-        #     interested in enabling it.
+        #     Matched recent searches of this user. The maximum number of recent searches
+        #     is 10. This field is a restricted feature. Contact Retail Search support
+        #     team if you are interested in enabling it.
         #
         #     This feature is only available when
         #     {::Google::Cloud::Retail::V2::CompleteQueryRequest#visitor_id CompleteQueryRequest.visitor_id}

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

@@ -150,7 +150,7 @@ module Google
         #     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
+        #     the pattern: `[a-zA-Z0-9_]+`. This is returned as [Operation.name][] in
         #     {::Google::Cloud::Retail::V2::ImportMetadata ImportMetadata}.
         #
         #     Only supported when
@@ -201,13 +201,13 @@ module Google
             # Can only be while using
             # {::Google::Cloud::Retail::V2::BigQuerySource BigQuerySource}.
             #
-            # Add the IAM permission “BigQuery Data Viewer” for
+            # 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.
-            # Contact Retail Support (retail-search-support@google.com) if you are
-            # interested in using Retail Search.
+            # 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
@@ -284,7 +284,7 @@ module Google
         #   @return [::Google::Cloud::Retail::V2::BigQuerySource]
         #     Required. BigQuery input source.
         #
-        #     Add the IAM permission “BigQuery Data Viewer” for
+        #     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.
         class CompletionDataInputConfig

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

@@ -37,18 +37,23 @@ module Google
         #     and
         #     {::Google::Cloud::Retail::V2::ProductService::Client#list_products ProductService.ListProducts}.
         #
+        #     {::Google::Cloud::Retail::V2::Product#expire_time expire_time} must be later
+        #     than {::Google::Cloud::Retail::V2::Product#available_time available_time} and
+        #     {::Google::Cloud::Retail::V2::Product#publish_time publish_time}, otherwise an
+        #     INVALID_ARGUMENT error is thrown.
+        #
         #     Google Merchant Center property
         #     [expiration_date](https://support.google.com/merchants/answer/6324499).
         # @!attribute [rw] ttl
         #   @return [::Google::Protobuf::Duration]
         #     Input only. The TTL (time to live) of the product.
         #
-        #     If it is set, {::Google::Cloud::Retail::V2::Product#expire_time expire_time}
-        #     is set as current timestamp plus
-        #     {::Google::Cloud::Retail::V2::Product#ttl ttl}. The derived
-        #     {::Google::Cloud::Retail::V2::Product#expire_time expire_time} is returned in
-        #     the output and {::Google::Cloud::Retail::V2::Product#ttl ttl} is left blank
-        #     when retrieving the {::Google::Cloud::Retail::V2::Product Product}.
+        #     If it is set, it must be a non-negative value, and
+        #     {::Google::Cloud::Retail::V2::Product#expire_time expire_time} is set as
+        #     current timestamp plus {::Google::Cloud::Retail::V2::Product#ttl ttl}. The
+        #     derived {::Google::Cloud::Retail::V2::Product#expire_time expire_time} is
+        #     returned in the output and {::Google::Cloud::Retail::V2::Product#ttl ttl} is
+        #     left blank when retrieving the {::Google::Cloud::Retail::V2::Product Product}.
         #
         #     If it is set, the product is not available for
         #     {::Google::Cloud::Retail::V2::SearchService::Client#search SearchService.Search} after
@@ -61,8 +66,6 @@ module Google
         #   @return [::String]
         #     Immutable. Full resource name of the product, such as
         #     `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id`.
-        #
-        #     The branch ID must be "default_branch".
         # @!attribute [rw] id
         #   @return [::String]
         #     Immutable. {::Google::Cloud::Retail::V2::Product Product} identifier, which is
@@ -120,6 +123,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.
         #
+        #     This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is
+        #     returned.
+        #
         #     Google Merchant Center property
         #     [gtin](https://support.google.com/merchants/answer/6324461).
         #     Schema.org property
@@ -230,15 +236,11 @@ module Google
         #     This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT
         #     error is returned:
         #
-        #     * Max entries count: 200 by default; 100 for
-        #     {::Google::Cloud::Retail::V2::Product::Type::VARIANT Type.VARIANT}.
+        #     * Max entries count: 200.
         #     * The key must be a UTF-8 encoded string with a length limit of 128
         #       characters.
-        #     * Max indexable entries count: 200 by default; 40 for
-        #     {::Google::Cloud::Retail::V2::Product::Type::VARIANT Type.VARIANT}.
-        #     * Max searchable entries count: 30.
         #     * 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.
         # @!attribute [rw] tags
         #   @return [::Array<::String>]
         #     Custom tags associated with the product.
@@ -346,7 +348,7 @@ module Google
         #   @return [::Array<::String>]
         #     The material of the product. For example, "leather", "wooden".
         #
-        #     A maximum of 5 values are allowed. Each value must be a UTF-8 encoded
+        #     A maximum of 20 values are allowed. Each value must be a UTF-8 encoded
         #     string with a length limit of 128 characters. Otherwise, an
         #     INVALID_ARGUMENT error is returned.
         #
@@ -358,7 +360,7 @@ module Google
         #     The pattern or graphic print of the product. For example, "striped", "polka
         #     dot", "paisley".
         #
-        #     A maximum of 5 values are allowed per
+        #     A maximum of 20 values are 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.
@@ -445,8 +447,12 @@ module Google
         #     * {::Google::Cloud::Retail::V2::Product#name name}
         #     * {::Google::Cloud::Retail::V2::Product#color_info color_info}
         #
-        #     Maximum number of paths is 20. Otherwise, an INVALID_ARGUMENT error is
+        #     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
+        #     response payload size and serving latency.
         # @!attribute [r] variants
         #   @return [::Array<::Google::Cloud::Retail::V2::Product>]
         #     Output only. Product variants grouped together on primary product which

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

@@ -290,7 +290,7 @@ module Google
         #     {::Google::Cloud::Retail::V2::Product#name Product.name} is not found, the
         #     inventory update will still be processed and retained for at most 1 day
         #     until the {::Google::Cloud::Retail::V2::Product Product} is created. If set to
-        #     false, an INVALID_ARGUMENT error is returned if the
+        #     false, a NOT_FOUND error is returned if the
         #     {::Google::Cloud::Retail::V2::Product Product} is not found.
         class SetInventoryRequest
           include ::Google::Protobuf::MessageExts
@@ -355,7 +355,7 @@ module Google
         #
         #     At least 1 value is required, and a maximum of 2000 values are allowed.
         #     Each value must be a string with a length limit of 10 characters, matching
-        #     the pattern [a-zA-Z0-9_-]+, such as "store1" or "REGION-2". Otherwise, an
+        #     the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an
         #     INVALID_ARGUMENT error is returned.
         #
         #     If the total number of place IDs exceeds 2000 for this
@@ -371,8 +371,8 @@ module Google
         #     If set to true, and the {::Google::Cloud::Retail::V2::Product Product} is not
         #     found, the fulfillment information 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, an
-        #     INVALID_ARGUMENT error is returned if 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 AddFulfillmentPlacesRequest
           include ::Google::Protobuf::MessageExts
@@ -387,7 +387,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Response of the RemoveFulfillmentPlacesRequest.  Currently empty because
+        # Response of the AddFulfillmentPlacesRequest.  Currently empty because
         # there is no meaningful response populated from the [AddFulfillmentPlaces][]
         # method.
         class AddFulfillmentPlacesResponse
@@ -436,7 +436,7 @@ module Google
         #
         #     At least 1 value is required, and a maximum of 2000 values are allowed.
         #     Each value must be a string with a length limit of 10 characters, matching
-        #     the pattern [a-zA-Z0-9_-]+, such as "store1" or "REGION-2". Otherwise, an
+        #     the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an
         #     INVALID_ARGUMENT error is returned.
         # @!attribute [rw] remove_time
         #   @return [::Google::Protobuf::Timestamp]
@@ -448,8 +448,8 @@ module Google
         #     If set to true, and the {::Google::Cloud::Retail::V2::Product Product} is not
         #     found, the fulfillment information 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, an
-        #     INVALID_ARGUMENT error is returned if 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 RemoveFulfillmentPlacesRequest
           include ::Google::Protobuf::MessageExts