google-cloud-retail-v2 0.4.0 → 0.5.1

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

@@ -169,7 +169,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.list_operations.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_operations.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :list_operations, request, options: options do |response, operation|
@@ -239,7 +241,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.get_operation.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_operation.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
@@ -309,7 +313,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.delete_operation.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_operation.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
@@ -384,7 +390,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.cancel_operation.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.cancel_operation.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
@@ -456,7 +464,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.wait_operation.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.wait_operation.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
@@ -481,22 +491,21 @@ module Google
             # Configuration can be applied globally to all clients, or to a single client
             # on construction.
             #
-            # # Examples
-            #
-            # To modify the global config, setting the timeout for list_operations
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
-            #
-            #     ::Google::Longrunning::Operations::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_operations.timeout = 20.0
-            #     end
-            #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Longrunning::Operations::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_operations.timeout = 20.0
-            #     end
+            # @example
+            #
+            #   # Modify the global config, setting the timeout for
+            #   # list_operations to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Longrunning::Operations::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_operations.timeout = 20.0
+            #   end
+            #
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Longrunning::Operations::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_operations.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Retail
       module V2
-        VERSION = "0.4.0"
+        VERSION = "0.5.1"
       end
     end
   end

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

@@ -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

@@ -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

@@ -120,6 +120,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,13 +233,9 @@ 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.
         # @!attribute [rw] tags
@@ -346,7 +345,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 +357,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 +444,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/search_service.rb

@@ -87,8 +87,7 @@ module Google
         #   @return [::String]
         #     The filter syntax consists of an expression language for constructing a
         #     predicate from one or more fields of the products being filtered. Filter
-        #     expression is case-sensitive. See more details at this [user
-        #     guide](/retail/private/docs/filter-and-order#filter).
+        #     expression is case-sensitive.
         #
         #     If this field is unrecognizable, an INVALID_ARGUMENT is returned.
         # @!attribute [rw] canonical_filter
@@ -106,9 +105,7 @@ module Google
         #   @return [::String]
         #     The order in which products are returned. Products can be ordered by
         #     a field in an {::Google::Cloud::Retail::V2::Product Product} object. Leave it
-        #     unset if ordered by relevance. OrderBy expression is case-sensitive. See
-        #     more details at this [user
-        #     guide](/retail/private/docs/filter-and-order#order).
+        #     unset if ordered by relevance. OrderBy expression is case-sensitive.
         #
         #     If this field is unrecognizable, an INVALID_ARGUMENT is returned.
         # @!attribute [rw] facet_specs
@@ -122,18 +119,15 @@ module Google
         #     The specification for dynamically generated facets. Notice that only
         #     textual facets can be dynamically generated.
         #
-        #     This feature requires additional allowlisting. Contact Retail Support
-        #     (retail-search-support@google.com) if you are interested in using dynamic
-        #     facet feature.
+        #     This feature requires additional allowlisting. Contact Retail Search
+        #     support team if you are interested in using dynamic facet feature.
         # @!attribute [rw] boost_spec
         #   @return [::Google::Cloud::Retail::V2::SearchRequest::BoostSpec]
-        #     Boost specification to boost certain products. See more details at this
-        #     [user guide](/retail/private/docs/boosting).
+        #     Boost specification to boost certain products.
         # @!attribute [rw] query_expansion_spec
         #   @return [::Google::Cloud::Retail::V2::SearchRequest::QueryExpansionSpec]
         #     The query expansion specification that specifies the conditions under which
-        #     query expansion will occur. See more details at this [user
-        #     guide](/retail/private/docs/result-size#query_expansion).
+        #     query expansion will occur.
         # @!attribute [rw] variant_rollup_keys
         #   @return [::Array<::String>]
         #     The keys to fetch and rollup the matching
@@ -145,10 +139,9 @@ module Google
         #     {::Google::Cloud::Retail::V2::Product Product}s attributes will lead to extra
         #     query latency. Maximum number of keys is 10.
         #
-        #     For
-        #     {::Google::Cloud::Retail::V2::Product#fulfillment_info Product.fulfillment_info},
-        #     a fulfillment type and a fulfillment ID must be provided in the format of
-        #     "fulfillmentType.filfillmentId". E.g., in "pickupInStore.store123",
+        #     For {::Google::Cloud::Retail::V2::FulfillmentInfo FulfillmentInfo}, a
+        #     fulfillment type and a fulfillment ID must be provided in the format of
+        #     "fulfillmentType.fulfillmentId". E.g., in "pickupInStore.store123",
         #     "pickupInStore" is fulfillment type and "store123" is the store ID.
         #
         #     Supported keys are:
@@ -159,24 +152,42 @@ module Google
         #     * discount
         #     * attributes.key, where key is any key in the
         #       {::Google::Cloud::Retail::V2::Product#attributes Product.attributes} map.
-        #     * pickupInStore.id, where id is any [FulfillmentInfo.ids][] for type
-        #       [FulfillmentInfo.Type.PICKUP_IN_STORE][].
-        #     * shipToStore.id, where id is any [FulfillmentInfo.ids][] for type
-        #       [FulfillmentInfo.Type.SHIP_TO_STORE][].
-        #     * sameDayDelivery.id, where id is any [FulfillmentInfo.ids][] for type
-        #       [FulfillmentInfo.Type.SAME_DAY_DELIVERY][].
-        #     * nextDayDelivery.id, where id is any [FulfillmentInfo.ids][] for type
-        #       [FulfillmentInfo.Type.NEXT_DAY_DELIVERY][].
-        #     * customFulfillment1.id, where id is any [FulfillmentInfo.ids][] for type
-        #       [FulfillmentInfo.Type.CUSTOM_TYPE_1][].
-        #     * customFulfillment2.id, where id is any [FulfillmentInfo.ids][] for type
-        #       [FulfillmentInfo.Type.CUSTOM_TYPE_2][].
-        #     * customFulfillment3.id, where id is any [FulfillmentInfo.ids][] for type
-        #       [FulfillmentInfo.Type.CUSTOM_TYPE_3][].
-        #     * customFulfillment4.id, where id is any [FulfillmentInfo.ids][] for type
-        #       [FulfillmentInfo.Type.CUSTOM_TYPE_4][].
-        #     * customFulfillment5.id, where id is any [FulfillmentInfo.ids][] for type
-        #       [FulfillmentInfo.Type.CUSTOM_TYPE_5][].
+        #     * pickupInStore.id, where id is any
+        #     {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
+        #     for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
+        #       "pickup-in-store".
+        #     * shipToStore.id, where id is any
+        #     {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
+        #     for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
+        #       "ship-to-store".
+        #     * sameDayDelivery.id, where id is any
+        #     {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
+        #     for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
+        #       "same-day-delivery".
+        #     * nextDayDelivery.id, where id is any
+        #     {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
+        #     for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
+        #       "next-day-delivery".
+        #     * customFulfillment1.id, where id is any
+        #     {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
+        #     for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
+        #       "custom-type-1".
+        #     * customFulfillment2.id, where id is any
+        #     {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
+        #     for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
+        #       "custom-type-2".
+        #     * customFulfillment3.id, where id is any
+        #     {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
+        #     for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
+        #       "custom-type-3".
+        #     * customFulfillment4.id, where id is any
+        #     {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
+        #     for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
+        #       "custom-type-4".
+        #     * customFulfillment5.id, where id is any
+        #     {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
+        #     for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
+        #       "custom-type-5".
         #
         #     If this field is set to an invalid value other than these, an
         #     INVALID_ARGUMENT error is returned.
@@ -274,172 +285,35 @@ module Google
             #     {::Google::Cloud::Retail::V2::SearchRequest::FacetSpec::FacetKey#query FacetKey.query}
             #     is not specified:
             #
-            #     * textual_field =<br>
-            #         <font color='grey'>
-            #         *# The
-            #         {::Google::Cloud::Retail::V2::Product#brands Product.brands}.<br>*
-            #         </font>
-            #         "brands";
-            #         <br>
-            #         <font color='categories'>
-            #         *# The
-            #         {::Google::Cloud::Retail::V2::Product#categories Product.categories}.<br>*
-            #         </font>
-            #         "categories";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The
-            #         {::Google::Cloud::Retail::V2::Audience#genders Audience.genders}.<br>*
-            #         </font>
-            #         | "genders";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The
-            #         {::Google::Cloud::Retail::V2::Audience#age_groups Audience.age_groups}.<br>*
-            #         </font>
-            #         | "ageGroups";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The
-            #         {::Google::Cloud::Retail::V2::Product#availability Product.availability}.
-            #         Value is one of<br>*
-            #         *# "IN_STOCK", "OUT_OF_STOCK", PREORDER", "BACKORDER".<br>*
-            #         </font>
-            #         | "availability";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The
-            #         {::Google::Cloud::Retail::V2::ColorInfo#color_families ColorInfo.color_families}.<br>*
-            #         </font>
-            #         | "colorFamilies";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The
-            #         {::Google::Cloud::Retail::V2::ColorInfo#colors ColorInfo.colors}.<br>*
-            #         </font>
-            #         | "colors";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The {::Google::Cloud::Retail::V2::Product#sizes Product.sizes}.<br>*
-            #         </font>
-            #         | "sizes";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The
-            #         {::Google::Cloud::Retail::V2::Product#materials Product.materials}.<br>*
-            #         </font>
-            #         | "materials";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The
-            #         {::Google::Cloud::Retail::V2::Product#patterns Product.patterns}.<br>*
-            #         </font>
-            #         | "patterns";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The
-            #         {::Google::Cloud::Retail::V2::Product#conditions Product.conditions}.<br>*
-            #         </font>
-            #         | "conditions";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The textual custom attribute in
-            #         {::Google::Cloud::Retail::V2::Product Product} object. Key can<br>*
-            #         *# be any key in the
-            #         {::Google::Cloud::Retail::V2::Product#attributes Product.attributes}
-            #         map<br>*
-            #         *# if the attribute values are textual.<br>*
-            #         *# map.<br>*
-            #         </font>
-            #         | "attributes.key";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The [FulfillmentInfo.ids][] for type
-            #         *# [FulfillmentInfo.Type.PICKUP_IN_STORE][].<br>*
-            #         </font>
-            #         | "pickupInStore";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The [FulfillmentInfo.ids][] for type
-            #         *# [FulfillmentInfo.Type.SHIP_TO_STORE][].<br>*
-            #         </font>
-            #         | "shipToStore";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The [FulfillmentInfo.ids][] for type
-            #         *# [FulfillmentInfo.Type.SAME_DAY_DELIVERY][].<br>*
-            #         </font>
-            #         | "sameDayDelivery";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The [FulfillmentInfo.ids][] for type
-            #         *# [FulfillmentInfo.Type.NEXT_DAY_DELIVERY][].<br>*
-            #         </font>
-            #         | "nextDayDelivery";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The [FulfillmentInfo.ids][] for type
-            #         *# [FulfillmentInfo.Type.CUSTOM_TYPE_1][].<br>*
-            #         </font>
-            #         | "customFulfillment1";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The [FulfillmentInfo.ids][] for type
-            #         *# [FulfillmentInfo.Type.CUSTOM_TYPE_2][].<br>*
-            #         </font>
-            #         | "customFulfillment2";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The [FulfillmentInfo.ids][] for type
-            #         *# [FulfillmentInfo.Type.CUSTOM_TYPE_3][].<br>*
-            #         </font>
-            #         | "customFulfillment3";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The [FulfillmentInfo.ids][] for type
-            #         *# [FulfillmentInfo.Type.CUSTOM_TYPE_4][].<br>*
-            #         </font>
-            #         | "customFulfillment4";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The [FulfillmentInfo.ids][] for type
-            #         *# [FulfillmentInfo.Type.CUSTOM_TYPE_5][].<br>*
-            #         </font>
-            #         | "customFulfillment5";
+            #     * textual_field =
+            #         * "brands"
+            #         * "categories"
+            #         * "genders"
+            #         * "ageGroups"
+            #         * "availability"
+            #         * "colorFamilies"
+            #         * "colors"
+            #         * "sizes"
+            #         * "materials"
+            #         * "patterns"
+            #         * "conditions"
+            #         * "attributes.key"
+            #         * "pickupInStore"
+            #         * "shipToStore"
+            #         * "sameDayDelivery"
+            #         * "nextDayDelivery"
+            #         * "customFulfillment1"
+            #         * "customFulfillment2"
+            #         * "customFulfillment3"
+            #         * "customFulfillment4"
+            #         * "customFulfillment5"
             #
-            #     * numerical_field =<br>
-            #         <font color='grey'>
-            #         *# The
-            #         {::Google::Cloud::Retail::V2::PriceInfo#price PriceInfo.price}.<br>*
-            #         </font>
-            #         "price";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The discount. Computed by (original_price-price)/price <br>*
-            #         </font>
-            #         "discount";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The
-            #         {::Google::Cloud::Retail::V2::Rating#average_rating Rating.average_rating}.<br>*
-            #         </font>
-            #         "rating";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The
-            #         {::Google::Cloud::Retail::V2::Rating#rating_count Rating.rating_count}.<br>*
-            #         </font>
-            #         "ratingCount";
-            #         <br>
-            #         <font color='grey'>
-            #         *# The numerical custom attribute in
-            #         {::Google::Cloud::Retail::V2::Product Product} object. Key can<br>*
-            #         *# be any key in the
-            #         {::Google::Cloud::Retail::V2::Product#attributes Product.attributes}
-            #         map<br>*
-            #         *# if the attribute values are numerical.<br>*
-            #         </font>
-            #         | "attributes.key";
+            #     * numerical_field =
+            #         * "price"
+            #         * "discount"
+            #         * "rating"
+            #         * "ratingCount"
+            #         * "attributes.key"
             # @!attribute [rw] intervals
             #   @return [::Array<::Google::Cloud::Retail::V2::Interval>]
             #     Set only if values should be bucketized into intervals. Must be set
@@ -503,7 +377,8 @@ module Google
             #     order](https://en.wikipedia.org/wiki/Natural_sort_order); numerical
             #     intervals are sorted in the order given by
             #     {::Google::Cloud::Retail::V2::SearchRequest::FacetSpec::FacetKey#intervals FacetSpec.FacetKey.intervals};
-            #     [FulfillmentInfo.ids][] are sorted in the order given by
+            #     {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
+            #     are sorted in the order given by
             #     {::Google::Cloud::Retail::V2::SearchRequest::FacetSpec::FacetKey#restricted_values FacetSpec.FacetKey.restricted_values}.
             # @!attribute [rw] query
             #   @return [::String]
@@ -580,10 +455,9 @@ module Google
             #
             #     * To boost products with product ID "product_1" or "product_2", and
             #     color
-            #       "Red" or "Blue":<br>
-            #       *(id: ANY("product_1", "product_2"))<br>*
-            #       *AND<br>*
-            #       *(colorFamilies: ANY("Red", "Blue"))<br>*
+            #       "Red" or "Blue":
+            #         * (id: ANY("product_1", "product_2")) AND (colorFamilies:
+            #         ANY("Red","Blue"))
             # @!attribute [rw] boost
             #   @return [::Float]
             #     Strength of the condition boost, which should be in [-1, 1]. Negative
@@ -615,6 +489,11 @@ module Google
           #   @return [::Google::Cloud::Retail::V2::SearchRequest::QueryExpansionSpec::Condition]
           #     The condition under which query expansion should occur. Default to
           #     {::Google::Cloud::Retail::V2::SearchRequest::QueryExpansionSpec::Condition::DISABLED Condition.DISABLED}.
+          # @!attribute [rw] pin_unexpanded_results
+          #   @return [::Boolean]
+          #     Whether to pin unexpanded results. If this field is set to true,
+          #     unexpanded products are always at the top of the search results, followed
+          #     by the expanded results.
           class QueryExpansionSpec
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -735,21 +614,22 @@ module Google
           #     string or double values with type
           #     {::Google::Protobuf::ListValue google.protobuf.ListValue}. For example, if
           #     there are two variants with colors "red" and "blue", the rollup values
-          #     are { key: "colorFamilies"
-          #       value {
-          #         list_value {
-          #           values { string_value: "red" }
-          #           values { string_value: "blue" }
-          #          }
-          #       }
-          #     }
+          #     are
+          #
+          #         { key: "colorFamilies"
+          #           value {
+          #             list_value {
+          #               values { string_value: "red" }
+          #               values { string_value: "blue" }
+          #              }
+          #           }
+          #         }
           #
-          #     For
-          #     {::Google::Cloud::Retail::V2::Product#fulfillment_info Product.fulfillment_info},
-          #     the rollup values is a double value with type
-          #     {::Google::Protobuf::Value google.protobuf.Value}. For example, {key:
-          #     "pickupInStore.store1" value { number_value: 10 }} means a there are 10
-          #     variants in this product are available in the store "store1".
+          #     For {::Google::Cloud::Retail::V2::FulfillmentInfo FulfillmentInfo}, the rollup
+          #     values is a double value with type
+          #     {::Google::Protobuf::Value google.protobuf.Value}. For example,
+          #     `{key: "pickupInStore.store1" value { number_value: 10 }}` means a there
+          #     are 10 variants in this product are available in the store "store1".
           class SearchResult
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -809,6 +689,11 @@ module Google
           # @!attribute [rw] expanded_query
           #   @return [::Boolean]
           #     Bool describing whether query expansion has occurred.
+          # @!attribute [rw] pinned_result_count
+          #   @return [::Integer]
+          #     Number of pinned results. This field will only be set when expansion
+          #     happens and [SearchRequest.query_expansion_spec.pin_unexpanded_results][]
+          #     is set to true.
           class QueryExpansionInfo
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods