google-cloud-retail-v2 0.3.2 → 0.4.0

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

@@ -78,8 +78,10 @@ module Google
         #     {::Google::Cloud::Retail::V2::Product Product}, regardless of whether or not it
         #     exists, a PERMISSION_DENIED error is returned.
         #
-        #     If the {::Google::Cloud::Retail::V2::Product Product} to update does not exist,
-        #     a NOT_FOUND error is returned.
+        #     If the {::Google::Cloud::Retail::V2::Product Product} to update does not exist
+        #     and
+        #     {::Google::Cloud::Retail::V2::UpdateProductRequest#allow_missing allow_missing}
+        #     is not set, a NOT_FOUND error is returned.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
         #     Indicates which fields in the provided
@@ -89,6 +91,11 @@ module Google
         #
         #     If an unsupported or unknown field is provided, an INVALID_ARGUMENT error
         #     is returned.
+        # @!attribute [rw] allow_missing
+        #   @return [::Boolean]
+        #     If set to true, and the {::Google::Cloud::Retail::V2::Product Product} is not
+        #     found, a new {::Google::Cloud::Retail::V2::Product Product} will be created. In
+        #     this situation, `update_mask` is ignored.
         class UpdateProductRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -107,10 +114,363 @@ module Google
         #
         #     If the {::Google::Cloud::Retail::V2::Product Product} to delete does not exist,
         #     a NOT_FOUND error is returned.
+        #
+        #     The {::Google::Cloud::Retail::V2::Product Product} to delete can neither be a
+        #     {::Google::Cloud::Retail::V2::Product::Type::COLLECTION Product.Type.COLLECTION}
+        #     {::Google::Cloud::Retail::V2::Product Product} member nor a
+        #     {::Google::Cloud::Retail::V2::Product::Type::PRIMARY Product.Type.PRIMARY}
+        #     {::Google::Cloud::Retail::V2::Product Product} with more than one
+        #     {::Google::Cloud::Retail::V2::Product::Type::VARIANT variants}. Otherwise, an
+        #     INVALID_ARGUMENT error is returned.
+        #
+        #     All inventory information for the named
+        #     {::Google::Cloud::Retail::V2::Product Product} will be deleted.
         class DeleteProductRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Request message for
+        # {::Google::Cloud::Retail::V2::ProductService::Client#list_products ProductService.ListProducts}
+        # method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent branch resource name, such as
+        #     `projects/*/locations/global/catalogs/default_catalog/branches/0`. Use
+        #     `default_branch` as the branch ID, to list products under the default
+        #     branch.
+        #
+        #     If the caller does not have permission to list
+        #     {::Google::Cloud::Retail::V2::Product Product}s under this branch, regardless of
+        #     whether or not this branch exists, a PERMISSION_DENIED error is returned.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Maximum number of {::Google::Cloud::Retail::V2::Product Product}s to return. If
+        #     unspecified, defaults to 100. The maximum allowed value is 1000. Values
+        #     above 1000 will be coerced to 1000.
+        #
+        #     If this field is negative, an INVALID_ARGUMENT error is returned.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     A page token
+        #     {::Google::Cloud::Retail::V2::ListProductsResponse#next_page_token ListProductsResponse.next_page_token},
+        #     received from a previous
+        #     {::Google::Cloud::Retail::V2::ProductService::Client#list_products ProductService.ListProducts}
+        #     call. Provide this to retrieve the subsequent page.
+        #
+        #     When paginating, all other parameters provided to
+        #     {::Google::Cloud::Retail::V2::ProductService::Client#list_products ProductService.ListProducts}
+        #     must match the call that provided the page token. Otherwise, an
+        #     INVALID_ARGUMENT error is returned.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     A filter to apply on the list results. Supported features:
+        #
+        #     * List all the products under the parent branch if
+        #     {::Google::Cloud::Retail::V2::ListProductsRequest#filter filter} is unset.
+        #     * List {::Google::Cloud::Retail::V2::Product::Type::VARIANT Product.Type.VARIANT}
+        #     {::Google::Cloud::Retail::V2::Product Product}s sharing the same
+        #       {::Google::Cloud::Retail::V2::Product::Type::PRIMARY Product.Type.PRIMARY}
+        #       {::Google::Cloud::Retail::V2::Product Product}. For example:
+        #         `primary_product_id = "some_product_id"`
+        #     * List {::Google::Cloud::Retail::V2::Product Product}s bundled in a
+        #     {::Google::Cloud::Retail::V2::Product::Type::COLLECTION Product.Type.COLLECTION}
+        #     {::Google::Cloud::Retail::V2::Product Product}.
+        #       For example:
+        #         `collection_product_id = "some_product_id"`
+        #     * List {::Google::Cloud::Retail::V2::Product Product}s with a partibular type.
+        #     For example:
+        #         `type = "PRIMARY"`
+        #         `type = "VARIANT"`
+        #         `type = "COLLECTION"`
+        #
+        #     If the field is unrecognizable, an INVALID_ARGUMENT error is returned.
+        #
+        #     If the specified
+        #     {::Google::Cloud::Retail::V2::Product::Type::PRIMARY Product.Type.PRIMARY}
+        #     {::Google::Cloud::Retail::V2::Product Product} or
+        #     {::Google::Cloud::Retail::V2::Product::Type::COLLECTION Product.Type.COLLECTION}
+        #     {::Google::Cloud::Retail::V2::Product Product} does not exist, a NOT_FOUND error
+        #     is returned.
+        # @!attribute [rw] read_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     The fields of {::Google::Cloud::Retail::V2::Product Product} to return in the
+        #     responses. If not set or empty, the following fields are returned:
+        #
+        #     * {::Google::Cloud::Retail::V2::Product#name Product.name}
+        #     * {::Google::Cloud::Retail::V2::Product#id Product.id}
+        #     * {::Google::Cloud::Retail::V2::Product#title Product.title}
+        #     * {::Google::Cloud::Retail::V2::Product#uri Product.uri}
+        #     * {::Google::Cloud::Retail::V2::Product#images Product.images}
+        #     * {::Google::Cloud::Retail::V2::Product#price_info Product.price_info}
+        #     * {::Google::Cloud::Retail::V2::Product#brands Product.brands}
+        #
+        #     If "*" is provided, all fields are returned.
+        #     {::Google::Cloud::Retail::V2::Product#name Product.name} is always returned no
+        #     matter what mask is set.
+        #
+        #     If an unsupported or unknown field is provided, an INVALID_ARGUMENT error
+        #     is returned.
+        class ListProductsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for
+        # {::Google::Cloud::Retail::V2::ProductService::Client#list_products ProductService.ListProducts}
+        # method.
+        # @!attribute [rw] products
+        #   @return [::Array<::Google::Cloud::Retail::V2::Product>]
+        #     The {::Google::Cloud::Retail::V2::Product Product}s.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token that can be sent as
+        #     {::Google::Cloud::Retail::V2::ListProductsRequest#page_token ListProductsRequest.page_token}
+        #     to retrieve the next page. If this field is omitted, there are no
+        #     subsequent pages.
+        class ListProductsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for [SetInventory][] method.
+        # @!attribute [rw] inventory
+        #   @return [::Google::Cloud::Retail::V2::Product]
+        #     Required. The inventory information to update. The allowable fields to
+        #     update are:
+        #     * {::Google::Cloud::Retail::V2::Product#price_info Product.price_info}
+        #     * {::Google::Cloud::Retail::V2::Product#availability Product.availability}
+        #     * {::Google::Cloud::Retail::V2::Product#available_quantity Product.available_quantity}
+        #     * {::Google::Cloud::Retail::V2::Product#fulfillment_info Product.fulfillment_info}
+        #     The updated inventory fields must be specified in
+        #     {::Google::Cloud::Retail::V2::SetInventoryRequest#set_mask SetInventoryRequest.set_mask}.
+        #
+        #     If [SetInventoryRequest.inventory.name][] is empty or invalid, an
+        #     INVALID_ARGUMENT error is returned.
+        #
+        #     If the caller does not have permission to update the
+        #     {::Google::Cloud::Retail::V2::Product Product} named in
+        #     {::Google::Cloud::Retail::V2::Product#name Product.name}, regardless of whether
+        #     or not it exists, a PERMISSION_DENIED error is returned.
+        #
+        #     If the {::Google::Cloud::Retail::V2::Product Product} to update does not have
+        #     existing inventory information, the provided inventory information will be
+        #     inserted.
+        #
+        #     If the {::Google::Cloud::Retail::V2::Product Product} to update has existing
+        #     inventory information, the provided inventory information will be merged
+        #     while respecting the last update time for each inventory field, using the
+        #     provided or default value for
+        #     {::Google::Cloud::Retail::V2::SetInventoryRequest#set_time SetInventoryRequest.set_time}.
+        #
+        #     The last update time is recorded for the following inventory fields:
+        #     * {::Google::Cloud::Retail::V2::Product#price_info Product.price_info}
+        #     * {::Google::Cloud::Retail::V2::Product#availability Product.availability}
+        #     * {::Google::Cloud::Retail::V2::Product#available_quantity Product.available_quantity}
+        #     * {::Google::Cloud::Retail::V2::Product#fulfillment_info Product.fulfillment_info}
+        #
+        #     If a full overwrite of inventory information while ignoring timestamps is
+        #     needed, [UpdateProduct][] should be invoked instead.
+        # @!attribute [rw] set_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Indicates which inventory fields in the provided
+        #     {::Google::Cloud::Retail::V2::Product Product} to update. If not set or set with
+        #     empty paths, all inventory fields will be updated.
+        #
+        #     If an unsupported or unknown field is provided, an INVALID_ARGUMENT error
+        #     is returned and the entire update will be ignored.
+        # @!attribute [rw] set_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time when the request is issued, used to prevent
+        #     out-of-order updates on inventory fields with the last update time
+        #     recorded. If not provided, the internal system time will be used.
+        # @!attribute [rw] allow_missing
+        #   @return [::Boolean]
+        #     If set to true, and the {::Google::Cloud::Retail::V2::Product Product} with name
+        #     {::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
+        #     {::Google::Cloud::Retail::V2::Product Product} is not found.
+        class SetInventoryRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Metadata related to the progress of the SetInventory operation.
+        # Currently empty because there is no meaningful metadata populated from the
+        # [SetInventory][] method.
+        class SetInventoryMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response of the SetInventoryRequest.  Currently empty because
+        # there is no meaningful response populated from the [SetInventory][]
+        # method.
+        class SetInventoryResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for [AddFulfillmentPlaces][] method.
+        # @!attribute [rw] product
+        #   @return [::String]
+        #     Required. Full resource name of {::Google::Cloud::Retail::V2::Product Product},
+        #     such as
+        #     `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/some_product_id`.
+        #
+        #     If the caller does not have permission to access the
+        #     {::Google::Cloud::Retail::V2::Product Product}, regardless of whether or not it
+        #     exists, a PERMISSION_DENIED error is returned.
+        # @!attribute [rw] type
+        #   @return [::String]
+        #     Required. The fulfillment type, including commonly used types (such as
+        #     pickup in store and same day delivery), and custom types.
+        #
+        #     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.
+        #
+        #     This field directly corresponds to [Product.fulfillment_info.type][].
+        # @!attribute [rw] place_ids
+        #   @return [::Array<::String>]
+        #     Required. The IDs for this
+        #     {::Google::Cloud::Retail::V2::AddFulfillmentPlacesRequest#type type}, such as
+        #     the store IDs for "pickup-in-store" or the region IDs for
+        #     "same-day-delivery" to be added for this
+        #     {::Google::Cloud::Retail::V2::AddFulfillmentPlacesRequest#type type}. Duplicate
+        #     IDs will be automatically ignored.
+        #
+        #     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
+        #     INVALID_ARGUMENT error is returned.
+        #
+        #     If the total number of place IDs exceeds 2000 for this
+        #     {::Google::Cloud::Retail::V2::AddFulfillmentPlacesRequest#type type} after
+        #     adding, then the update will be rejected.
+        # @!attribute [rw] add_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time when the fulfillment updates are issued, used to prevent
+        #     out-of-order updates on fulfillment information. If not provided, the
+        #     internal system time will be used.
+        # @!attribute [rw] allow_missing
+        #   @return [::Boolean]
+        #     If set to true, and the {::Google::Cloud::Retail::V2::Product Product} is not
+        #     found, the 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 not found.
+        class AddFulfillmentPlacesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Metadata related to the progress of the AddFulfillmentPlaces operation.
+        # Currently empty because there is no meaningful metadata populated from the
+        # [AddFulfillmentPlaces][] method.
+        class AddFulfillmentPlacesMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response of the RemoveFulfillmentPlacesRequest.  Currently empty because
+        # there is no meaningful response populated from the [AddFulfillmentPlaces][]
+        # method.
+        class AddFulfillmentPlacesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for [RemoveFulfillmentPlaces][] method.
+        # @!attribute [rw] product
+        #   @return [::String]
+        #     Required. Full resource name of {::Google::Cloud::Retail::V2::Product Product},
+        #     such as
+        #     `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/some_product_id`.
+        #
+        #     If the caller does not have permission to access the
+        #     {::Google::Cloud::Retail::V2::Product Product}, regardless of whether or not it
+        #     exists, a PERMISSION_DENIED error is returned.
+        # @!attribute [rw] type
+        #   @return [::String]
+        #     Required. The fulfillment type, including commonly used types (such as
+        #     pickup in store and same day delivery), and custom types.
+        #
+        #     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.
+        #
+        #     This field directly corresponds to [Product.fulfillment_info.type][].
+        # @!attribute [rw] place_ids
+        #   @return [::Array<::String>]
+        #     Required. The IDs for this
+        #     {::Google::Cloud::Retail::V2::RemoveFulfillmentPlacesRequest#type type}, such as
+        #     the store IDs for "pickup-in-store" or the region IDs for
+        #     "same-day-delivery", to be removed for this
+        #     {::Google::Cloud::Retail::V2::RemoveFulfillmentPlacesRequest#type type}.
+        #
+        #     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
+        #     INVALID_ARGUMENT error is returned.
+        # @!attribute [rw] remove_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time when the fulfillment updates are issued, used to prevent
+        #     out-of-order updates on fulfillment information. If not provided, the
+        #     internal system time will be used.
+        # @!attribute [rw] allow_missing
+        #   @return [::Boolean]
+        #     If set to true, and the {::Google::Cloud::Retail::V2::Product Product} is not
+        #     found, the 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 not found.
+        class RemoveFulfillmentPlacesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Metadata related to the progress of the RemoveFulfillmentPlaces operation.
+        # Currently empty because there is no meaningful metadata populated from the
+        # [RemoveFulfillmentPlaces][] method.
+        class RemoveFulfillmentPlacesMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response of the RemoveFulfillmentPlacesRequest. Currently empty because there
+        # is no meaningful response populated from the [RemoveFulfillmentPlaces][]
+        # method.
+        class RemoveFulfillmentPlacesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

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

@@ -33,7 +33,7 @@ module Google
         #   @return [::String]
         #     Required. The resource name of the catalog under which the events are
         #     created. The format is
-        #     "projects/$\\{projectId}/locations/global/catalogs/$\\{catalogId}"
+        #     `projects/${projectId}/locations/global/catalogs/${catalogId}`
         # @!attribute [rw] filter
         #   @return [::String]
         #     Required. The filter string to specify the events to be deleted with a

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

@@ -0,0 +1,820 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Retail
+      module V2
+        # Request message for
+        # {::Google::Cloud::Retail::V2::SearchService::Client#search SearchService.Search} method.
+        # @!attribute [rw] placement
+        #   @return [::String]
+        #     Required. The resource name of the search engine placement, such as
+        #     `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
+        #     This field is used to identify the set of models that will be used to make
+        #     the search.
+        #
+        #     We currently support one placement with the following ID:
+        #
+        #     * `default_search`.
+        # @!attribute [rw] branch
+        #   @return [::String]
+        #     The branch resource name, such as
+        #     `projects/*/locations/global/catalogs/default_catalog/branches/0`.
+        #
+        #     Use "default_branch" as the branch ID or leave this field empty, to search
+        #     products under the default branch.
+        # @!attribute [rw] query
+        #   @return [::String]
+        #     Raw search query.
+        # @!attribute [rw] visitor_id
+        #   @return [::String]
+        #     Required. 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] user_info
+        #   @return [::Google::Cloud::Retail::V2::UserInfo]
+        #     User information.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Maximum number of {::Google::Cloud::Retail::V2::Product Product}s to return. If
+        #     unspecified, defaults to a reasonable value. The maximum allowed value is
+        #     120. Values above 120 will be coerced to 120.
+        #
+        #     If this field is negative, an INVALID_ARGUMENT is returned.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     A page token
+        #     {::Google::Cloud::Retail::V2::SearchResponse#next_page_token SearchResponse.next_page_token},
+        #     received from a previous
+        #     {::Google::Cloud::Retail::V2::SearchService::Client#search SearchService.Search} call.
+        #     Provide this to retrieve the subsequent page.
+        #
+        #     When paginating, all other parameters provided to
+        #     {::Google::Cloud::Retail::V2::SearchService::Client#search SearchService.Search} must
+        #     match the call that provided the page token. Otherwise, an INVALID_ARGUMENT
+        #     error is returned.
+        # @!attribute [rw] offset
+        #   @return [::Integer]
+        #     A 0-indexed integer that specifies the current offset (that is, starting
+        #     result location, amongst the {::Google::Cloud::Retail::V2::Product Product}s
+        #     deemed by the API as relevant) in search results. This field is only
+        #     considered if {::Google::Cloud::Retail::V2::SearchRequest#page_token page_token}
+        #     is unset.
+        #
+        #     If this field is negative, an INVALID_ARGUMENT is returned.
+        # @!attribute [rw] filter
+        #   @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).
+        #
+        #     If this field is unrecognizable, an INVALID_ARGUMENT is returned.
+        # @!attribute [rw] canonical_filter
+        #   @return [::String]
+        #     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
+        #     {::Google::Cloud::Retail::V2::SearchRequest#canonical_filter SearchRequest.canonical_filter}
+        #     will be returned as a supplement of the original query. This field is
+        #     strongly recommended to achieve high search quality.
+        #
+        #     See {::Google::Cloud::Retail::V2::SearchRequest#filter SearchRequest.filter} for
+        #     more details about filter syntax.
+        # @!attribute [rw] order_by
+        #   @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).
+        #
+        #     If this field is unrecognizable, an INVALID_ARGUMENT is returned.
+        # @!attribute [rw] facet_specs
+        #   @return [::Array<::Google::Cloud::Retail::V2::SearchRequest::FacetSpec>]
+        #     Facet specifications for faceted search. If empty, no facets are returned.
+        #
+        #     A maximum of 100 values are allowed. Otherwise, an INVALID_ARGUMENT error
+        #     is returned.
+        # @!attribute [rw] dynamic_facet_spec
+        #   @return [::Google::Cloud::Retail::V2::SearchRequest::DynamicFacetSpec]
+        #     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.
+        # @!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).
+        # @!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).
+        # @!attribute [rw] variant_rollup_keys
+        #   @return [::Array<::String>]
+        #     The keys to fetch and rollup the matching
+        #     {::Google::Cloud::Retail::V2::Product::Type::VARIANT variant}
+        #     {::Google::Cloud::Retail::V2::Product Product}s attributes. The attributes from
+        #     all the matching {::Google::Cloud::Retail::V2::Product::Type::VARIANT variant}
+        #     {::Google::Cloud::Retail::V2::Product Product}s are merged and de-duplicated.
+        #     Notice that rollup {::Google::Cloud::Retail::V2::Product::Type::VARIANT variant}
+        #     {::Google::Cloud::Retail::V2::Product Product}s attributes will lead to extra
+        #     query latency. Maximum number of keys is 10.
+        #
+        #     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",
+        #     "pickupInStore" is fulfillment type and "store123" is the store ID.
+        #
+        #     Supported keys are:
+        #
+        #     * colorFamilies
+        #     * price
+        #     * originalPrice
+        #     * 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][].
+        #
+        #     If this field is set to an invalid value other than these, an
+        #     INVALID_ARGUMENT error is returned.
+        # @!attribute [rw] page_categories
+        #   @return [::Array<::String>]
+        #     The categories associated with a category page. Required for category
+        #     navigation queries to achieve good search quality. The format should be
+        #     the same as
+        #     {::Google::Cloud::Retail::V2::UserEvent#page_categories UserEvent.page_categories};
+        #
+        #     To represent full path of category, use '>' sign to separate different
+        #     hierarchies. If '>' is part of the category name, please replace it with
+        #     other character(s).
+        #
+        #     Category pages include special pages such as sales or promotions. For
+        #     instance, a special sale page may have the category hierarchy:
+        #     "pageCategories" : ["Sales > 2017 Black Friday Deals"].
+        class SearchRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # A facet specification to perform faceted search.
+          # @!attribute [rw] facet_key
+          #   @return [::Google::Cloud::Retail::V2::SearchRequest::FacetSpec::FacetKey]
+          #     Required. The facet key specification.
+          # @!attribute [rw] limit
+          #   @return [::Integer]
+          #     Maximum of facet values that should be returned for this facet. If
+          #     unspecified, defaults to 20. The maximum allowed value is 300. Values
+          #     above 300 will be coerced to 300.
+          #
+          #     If this field is negative, an INVALID_ARGUMENT is returned.
+          # @!attribute [rw] excluded_filter_keys
+          #   @return [::Array<::String>]
+          #     List of keys to exclude when faceting.
+          #
+          #     By default,
+          #     {::Google::Cloud::Retail::V2::SearchRequest::FacetSpec::FacetKey#key FacetKey.key}
+          #     is not excluded from the filter unless it is listed in this field.
+          #
+          #     For example, suppose there are 100 products with color facet "Red" and
+          #     200 products with color facet "Blue". A query containing the filter
+          #     "colorFamilies:ANY("Red")" and have "colorFamilies" as
+          #     {::Google::Cloud::Retail::V2::SearchRequest::FacetSpec::FacetKey#key FacetKey.key}
+          #     will by default return the "Red" with count 100.
+          #
+          #     If this field contains "colorFamilies", then the query returns both the
+          #     "Red" with count 100 and "Blue" with count 200, because the
+          #     "colorFamilies" key is now excluded from the filter.
+          #
+          #     A maximum of 100 values are allowed. Otherwise, an INVALID_ARGUMENT error
+          #     is returned.
+          # @!attribute [rw] enable_dynamic_position
+          #   @return [::Boolean]
+          #     Enables dynamic position for this facet. If set to true, the position of
+          #     this facet among all facets in the response is determined by Google
+          #     Retail Search. It will be ordered together with dynamic facets if dynamic
+          #     facets is enabled. If set to false, the position of this facet in the
+          #     response will be the same as in the request, and it will be ranked before
+          #     the facets with dynamic position enable and all dynamic facets.
+          #
+          #     For example, you may always want to have rating facet returned in
+          #     the response, but it's not necessarily to always display the rating facet
+          #     at the top. In that case, you can set enable_dynamic_position to true so
+          #     that the position of rating facet in response will be determined by
+          #     Google Retail Search.
+          #
+          #     Another example, assuming you have the following facets in the request:
+          #
+          #     * "rating", enable_dynamic_position = true
+          #
+          #     * "price", enable_dynamic_position = false
+          #
+          #     * "brands", enable_dynamic_position = false
+          #
+          #     And also you have a dynamic facets enable, which will generate a facet
+          #     'gender'. Then the final order of the facets in the response can be
+          #     ("price", "brands", "rating", "gender") or ("price", "brands", "gender",
+          #     "rating") depends on how Google Retail Search orders "gender" and
+          #     "rating" facets. However, notice that "price" and "brands" will always be
+          #     ranked at 1st and 2nd position since their enable_dynamic_position are
+          #     false.
+          class FacetSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Specifies how a facet is computed.
+            # @!attribute [rw] key
+            #   @return [::String]
+            #     Required. Supported textual and numerical facet keys in
+            #     {::Google::Cloud::Retail::V2::Product Product} object, over which the facet
+            #     values are computed. Facet key is case-sensitive.
+            #
+            #     Allowed facet keys when
+            #     {::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";
+            #
+            #     * 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";
+            # @!attribute [rw] intervals
+            #   @return [::Array<::Google::Cloud::Retail::V2::Interval>]
+            #     Set only if values should be bucketized into intervals. Must be set
+            #     for facets with numerical values. Must not be set for facet with text
+            #     values. Maximum number of intervals is 30.
+            # @!attribute [rw] restricted_values
+            #   @return [::Array<::String>]
+            #     Only get facet for the given restricted values. For example, when using
+            #     "pickupInStore" as key and set restricted values to
+            #     ["store123", "store456"], only facets for "store123" and "store456" are
+            #     returned. Only supported on textual fields and fulfillments.
+            #     Maximum is 20.
+            #
+            #     Must be set for the fulfillment facet keys:
+            #
+            #     * pickupInStore
+            #
+            #     * shipToStore
+            #
+            #     * sameDayDelivery
+            #
+            #     * nextDayDelivery
+            #
+            #     * customFulfillment1
+            #
+            #     * customFulfillment2
+            #
+            #     * customFulfillment3
+            #
+            #     * customFulfillment4
+            #
+            #     * customFulfillment5
+            # @!attribute [rw] prefixes
+            #   @return [::Array<::String>]
+            #     Only get facet values that start with the given string prefix. For
+            #     example, suppose "categories" has three values "Women > Shoe",
+            #     "Women > Dress" and "Men > Shoe". If set "prefixes" to "Women", the
+            #     "categories" facet will give only "Women > Shoe" and "Women > Dress".
+            #     Only supported on textual fields. Maximum is 10.
+            # @!attribute [rw] contains
+            #   @return [::Array<::String>]
+            #     Only get facet values that contains the given strings. For example,
+            #     suppose "categories" has three values "Women > Shoe",
+            #     "Women > Dress" and "Men > Shoe". If set "contains" to "Shoe", the
+            #     "categories" facet will give only "Women > Shoe" and "Men > Shoe".
+            #     Only supported on textual fields. Maximum is 10.
+            # @!attribute [rw] order_by
+            #   @return [::String]
+            #     The order in which [Facet.values][] are returned.
+            #
+            #     Allowed values are:
+            #
+            #     * "count desc", which means order by [Facet.FacetValue.count][]
+            #     descending.
+            #
+            #     * "value desc", which means order by [Facet.FacetValue.value][]
+            #     descending.
+            #       Only applies to textual facets.
+            #
+            #     If not set, textual values are sorted in [natural
+            #     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::SearchRequest::FacetSpec::FacetKey#restricted_values FacetSpec.FacetKey.restricted_values}.
+            # @!attribute [rw] query
+            #   @return [::String]
+            #     The query that is used to compute facet for the given facet key.
+            #     When provided, it will override the default behavior of facet
+            #     computation. The query syntax is the same as a filter expression. See
+            #     {::Google::Cloud::Retail::V2::SearchRequest#filter SearchRequest.filter} for
+            #     detail syntax and limitations. Notice that there is no limitation on
+            #     {::Google::Cloud::Retail::V2::SearchRequest::FacetSpec::FacetKey#key FacetKey.key}
+            #     when query is specified.
+            #
+            #     In the response, [FacetValue.value][] will be always "1" and
+            #     [FacetValue.count][] will be the number of results that matches the
+            #     query.
+            #
+            #     For example, you can set a customized facet for "shipToStore",
+            #     where
+            #     {::Google::Cloud::Retail::V2::SearchRequest::FacetSpec::FacetKey#key FacetKey.key}
+            #     is "customizedShipToStore", and
+            #     {::Google::Cloud::Retail::V2::SearchRequest::FacetSpec::FacetKey#query FacetKey.query}
+            #     is "availability: ANY(\"IN_STOCK\") AND shipToStore: ANY(\"123\")".
+            #     Then the facet will count the products that are both in stock and ship
+            #     to store "123".
+            class FacetKey
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # The specifications of dynamically generated facets.
+          # @!attribute [rw] mode
+          #   @return [::Google::Cloud::Retail::V2::SearchRequest::DynamicFacetSpec::Mode]
+          #     Mode of the DynamicFacet feature.
+          #     Defaults to
+          #     {::Google::Cloud::Retail::V2::SearchRequest::DynamicFacetSpec::Mode::DISABLED Mode.DISABLED}
+          #     if it's unset.
+          class DynamicFacetSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Enum to control DynamicFacet mode
+            module Mode
+              # Default value.
+              MODE_UNSPECIFIED = 0
+
+              # Disable Dynamic Facet.
+              DISABLED = 1
+
+              # Automatic mode built by Google Retail Search.
+              ENABLED = 2
+            end
+          end
+
+          # Boost specification to boost certain items.
+          # @!attribute [rw] condition_boost_specs
+          #   @return [::Array<::Google::Cloud::Retail::V2::SearchRequest::BoostSpec::ConditionBoostSpec>]
+          #     Condition boost specifications. If a product matches multiple conditions
+          #     in the specifictions, boost scores from these specifications are all
+          #     applied and combined in a non-linear way. Maximum number of
+          #     specifications is 10.
+          class BoostSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Boost applies to products which match a condition.
+            # @!attribute [rw] condition
+            #   @return [::String]
+            #     An expression which specifies a boost condition. The syntax and
+            #     supported fields are the same as a filter expression. See
+            #     {::Google::Cloud::Retail::V2::SearchRequest#filter SearchRequest.filter} for
+            #     detail syntax and limitations.
+            #
+            #     Examples:
+            #
+            #     * 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>*
+            # @!attribute [rw] boost
+            #   @return [::Float]
+            #     Strength of the condition boost, which should be in [-1, 1]. Negative
+            #     boost means demotion. Default is 0.0.
+            #
+            #     Setting to 1.0 gives the item a big promotion. However, it does not
+            #     necessarily mean that the boosted item will be the top result at all
+            #     times, nor that other items will be excluded. Results could still be
+            #     shown even when none of them matches the condition. And results that
+            #     are significantly more relevant to the search query can still trump
+            #     your heavily favored but irrelevant items.
+            #
+            #     Setting to -1.0 gives the item a big demotion. However, results that
+            #     are deeply relevant might still be shown. The item will have an
+            #     upstream battle to get a fairly high ranking, but it is not blocked out
+            #     completely.
+            #
+            #     Setting to 0.0 means no boost applied. The boosting condition is
+            #     ignored.
+            class ConditionBoostSpec
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # Specification to determine under which conditions query expansion should
+          # occur.
+          # @!attribute [rw] condition
+          #   @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}.
+          class QueryExpansionSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Enum describing under which condition query expansion should occur.
+            module Condition
+              # Unspecified query expansion condition. This defaults to
+              # {::Google::Cloud::Retail::V2::SearchRequest::QueryExpansionSpec::Condition::DISABLED Condition.DISABLED}.
+              CONDITION_UNSPECIFIED = 0
+
+              # Disabled query expansion. Only the exact search query is used, even if
+              # {::Google::Cloud::Retail::V2::SearchResponse#total_size SearchResponse.total_size}
+              # is zero.
+              DISABLED = 1
+
+              # Automatic query expansion built by Google Retail Search.
+              AUTO = 3
+            end
+          end
+        end
+
+        # Response message for
+        # {::Google::Cloud::Retail::V2::SearchService::Client#search SearchService.Search} method.
+        # @!attribute [rw] results
+        #   @return [::Array<::Google::Cloud::Retail::V2::SearchResponse::SearchResult>]
+        #     A list of matched items. The order represents the ranking.
+        # @!attribute [rw] facets
+        #   @return [::Array<::Google::Cloud::Retail::V2::SearchResponse::Facet>]
+        #     Results of facets requested by user.
+        # @!attribute [rw] total_size
+        #   @return [::Integer]
+        #     The estimated total count of matched items irrespective of pagination. The
+        #     count of {::Google::Cloud::Retail::V2::SearchResponse#results results} returned
+        #     by pagination may be less than the
+        #     {::Google::Cloud::Retail::V2::SearchResponse#total_size total_size} that
+        #     matches.
+        # @!attribute [rw] corrected_query
+        #   @return [::String]
+        #     If spell correction applies, the corrected query. Otherwise, empty.
+        # @!attribute [rw] attribution_token
+        #   @return [::String]
+        #     A unique search token. This should be included in the
+        #     {::Google::Cloud::Retail::V2::UserEvent UserEvent} logs resulting from this
+        #     search, which enables accurate attribution of search model performance.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token that can be sent as
+        #     {::Google::Cloud::Retail::V2::SearchRequest#page_token SearchRequest.page_token}
+        #     to retrieve the next page. If this field is omitted, there are no
+        #     subsequent pages.
+        # @!attribute [rw] query_expansion_info
+        #   @return [::Google::Cloud::Retail::V2::SearchResponse::QueryExpansionInfo]
+        #     Query expansion information for the returned results.
+        # @!attribute [rw] redirect_uri
+        #   @return [::String]
+        #     The URI of a customer-defined redirect page. If redirect action is
+        #     triggered, no search will be performed, and only
+        #     {::Google::Cloud::Retail::V2::SearchResponse#redirect_uri redirect_uri} and
+        #     {::Google::Cloud::Retail::V2::SearchResponse#attribution_token attribution_token}
+        #     will be set in the response.
+        class SearchResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Represents the search results.
+          # @!attribute [rw] id
+          #   @return [::String]
+          #     {::Google::Cloud::Retail::V2::Product#id Product.id} of the searched
+          #     {::Google::Cloud::Retail::V2::Product Product}.
+          # @!attribute [rw] product
+          #   @return [::Google::Cloud::Retail::V2::Product]
+          #     The product data snippet in the search response. Only
+          #     {::Google::Cloud::Retail::V2::Product#name Product.name} is guaranteed to be
+          #     populated.
+          #
+          #     {::Google::Cloud::Retail::V2::Product#variants Product.variants} contains the
+          #     product variants that match the search query. If there are multiple
+          #     product variants matching the query, top 5 most relevant product variants
+          #     are returned and ordered by relevancy.
+          #
+          #     If relevancy can be deternmined, use
+          #     {::Google::Cloud::Retail::V2::SearchResponse::SearchResult#matching_variant_fields matching_variant_fields}
+          #     to look up matched product variants fields. If relevancy cannot be
+          #     determined, e.g. when searching "shoe" all products in a shoe product can
+          #     be a match, 5 product variants are returned but order is meaningless.
+          # @!attribute [rw] matching_variant_count
+          #   @return [::Integer]
+          #     The count of matched
+          #     {::Google::Cloud::Retail::V2::Product::Type::VARIANT variant}
+          #     {::Google::Cloud::Retail::V2::Product Product}s.
+          # @!attribute [rw] matching_variant_fields
+          #   @return [::Google::Protobuf::Map{::String => ::Google::Protobuf::FieldMask}]
+          #     If a {::Google::Cloud::Retail::V2::Product::Type::VARIANT variant}
+          #     {::Google::Cloud::Retail::V2::Product Product} matches the search query, this
+          #     map indicates which {::Google::Cloud::Retail::V2::Product Product} fields are
+          #     matched. The key is the
+          #     {::Google::Cloud::Retail::V2::Product#name Product.name}, the value is a field
+          #     mask of the matched {::Google::Cloud::Retail::V2::Product Product} fields. If
+          #     matched attributes cannot be determined, this map will be empty.
+          #
+          #     For example, a key "sku1" with field mask
+          #     "products.color_info" indicates there is a match between
+          #     "sku1" {::Google::Cloud::Retail::V2::ColorInfo ColorInfo} and the query.
+          # @!attribute [rw] variant_rollup_values
+          #   @return [::Google::Protobuf::Map{::String => ::Google::Protobuf::Value}]
+          #     The rollup matching
+          #     {::Google::Cloud::Retail::V2::Product::Type::VARIANT variant}
+          #     {::Google::Cloud::Retail::V2::Product Product} attributes. The key is one of
+          #     the
+          #     {::Google::Cloud::Retail::V2::SearchRequest#variant_rollup_keys SearchRequest.variant_rollup_keys}.
+          #     The values are the merged and de-duplicated
+          #     {::Google::Cloud::Retail::V2::Product Product} attributes. Notice that the
+          #     rollup values are respect filter. For example, when filtering by
+          #     "colorFamilies:ANY(\"red\")" and rollup "colorFamilies", only "red" is
+          #     returned.
+          #
+          #     For textual and numerical attributes, the rollup values is a list of
+          #     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" }
+          #          }
+          #       }
+          #     }
+          #
+          #     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".
+          class SearchResult
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # @!attribute [rw] key
+            #   @return [::String]
+            # @!attribute [rw] value
+            #   @return [::Google::Protobuf::FieldMask]
+            class MatchingVariantFieldsEntry
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # @!attribute [rw] key
+            #   @return [::String]
+            # @!attribute [rw] value
+            #   @return [::Google::Protobuf::Value]
+            class VariantRollupValuesEntry
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # A facet result.
+          # @!attribute [rw] key
+          #   @return [::String]
+          #     The key for this facet. E.g., "colorFamilies" or "price" or
+          #     "attributes.attr1".
+          # @!attribute [rw] values
+          #   @return [::Array<::Google::Cloud::Retail::V2::SearchResponse::Facet::FacetValue>]
+          #     The facet values for this field.
+          # @!attribute [rw] dynamic_facet
+          #   @return [::Boolean]
+          #     Whether the facet is dynamically generated.
+          class Facet
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # A facet value which contains value names and their count.
+            # @!attribute [rw] value
+            #   @return [::String]
+            #     Text value of a facet, such as "Black" for facet "colorFamilies".
+            # @!attribute [rw] interval
+            #   @return [::Google::Cloud::Retail::V2::Interval]
+            #     Interval value for a facet, such as [10, 20) for facet "price".
+            # @!attribute [rw] count
+            #   @return [::Integer]
+            #     Number of items that have this facet value.
+            class FacetValue
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # Information describing query expansion including whether expansion has
+          # occurred.
+          # @!attribute [rw] expanded_query
+          #   @return [::Boolean]
+          #     Bool describing whether query expansion has occurred.
+          class QueryExpansionInfo
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end