google-cloud-retail-v2 0.4.2 → 0.6.1

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

@@ -65,9 +65,14 @@ module Google
                                 end
                 default_config = Client::Configuration.new parent_config
 
-                default_config.timeout = 60.0
+                default_config.timeout = 30.0
                 default_config.retry_policy = {
-                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
+                  initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14, 4]
+                }
+
+                default_config.rpcs.import_products.timeout = 300.0
+                default_config.rpcs.import_products.retry_policy = {
+                  initial_delay: 0.1, max_delay: 300.0, multiplier: 1.3, retry_codes: [14, 4]
                 }
 
                 default_config
@@ -227,9 +232,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -304,9 +311,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -443,9 +452,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -533,9 +544,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "product.name" => request.product.name
-              }
+              header_params = {}
+              if request.product&.name
+                header_params["product.name"] = request.product.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -621,9 +634,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -677,7 +692,7 @@ module Google
             #     Unique identifier provided by client, within the ancestor
             #     dataset scope. Ensures idempotency and used for request deduplication.
             #     Server-generated if unspecified. Up to 128 characters long and must match
-            #     the pattern: "[a-zA-Z0-9_]+". This is returned as [Operation.name][] in
+            #     the pattern: `[a-zA-Z0-9_]+`. This is returned as [Operation.name][] in
             #     {::Google::Cloud::Retail::V2::ImportMetadata ImportMetadata}.
             #
             #     Only supported when
@@ -730,9 +745,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -792,8 +809,8 @@ module Google
             # {::Google::Cloud::Retail::V2::ProductService::Client#remove_fulfillment_places RemoveFulfillmentPlaces}.
             #
             # 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.
             #
             # @overload set_inventory(request, options = nil)
             #   Pass arguments to `set_inventory` via a request object, either of type
@@ -862,7 +879,7 @@ module Google
             #     {::Google::Cloud::Retail::V2::Product#name Product.name} is not found, the
             #     inventory update will still be processed and retained for at most 1 day
             #     until the {::Google::Cloud::Retail::V2::Product Product} is created. If set to
-            #     false, an INVALID_ARGUMENT error is returned if the
+            #     false, a NOT_FOUND error is returned if the
             #     {::Google::Cloud::Retail::V2::Product Product} is not found.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -890,9 +907,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "inventory.name" => request.inventory.name
-              }
+              header_params = {}
+              if request.inventory&.name
+                header_params["inventory.name"] = request.inventory.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -927,8 +946,8 @@ module Google
             # {::Google::Cloud::Retail::V2::ProductService::Client#list_products ListProducts}.
             #
             # 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.
             #
             # @overload add_fulfillment_places(request, options = nil)
             #   Pass arguments to `add_fulfillment_places` via a request object, either of type
@@ -983,7 +1002,7 @@ module Google
             #
             #     At least 1 value is required, and a maximum of 2000 values are allowed.
             #     Each value must be a string with a length limit of 10 characters, matching
-            #     the pattern [a-zA-Z0-9_-]+, such as "store1" or "REGION-2". Otherwise, an
+            #     the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an
             #     INVALID_ARGUMENT error is returned.
             #
             #     If the total number of place IDs exceeds 2000 for this
@@ -997,8 +1016,8 @@ module Google
             #     If set to true, and the {::Google::Cloud::Retail::V2::Product Product} is not
             #     found, the fulfillment information will still be processed and retained for
             #     at most 1 day and processed once the
-            #     {::Google::Cloud::Retail::V2::Product Product} is created. If set to false, an
-            #     INVALID_ARGUMENT error is returned if the
+            #     {::Google::Cloud::Retail::V2::Product Product} is created. If set to false, a
+            #     NOT_FOUND error is returned if the
             #     {::Google::Cloud::Retail::V2::Product Product} is not found.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -1026,9 +1045,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "product" => request.product
-              }
+              header_params = {}
+              if request.product
+                header_params["product"] = request.product
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1063,8 +1084,8 @@ module Google
             # {::Google::Cloud::Retail::V2::ProductService::Client#list_products ListProducts}.
             #
             # 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.
             #
             # @overload remove_fulfillment_places(request, options = nil)
             #   Pass arguments to `remove_fulfillment_places` via a request object, either of type
@@ -1118,7 +1139,7 @@ module Google
             #
             #     At least 1 value is required, and a maximum of 2000 values are allowed.
             #     Each value must be a string with a length limit of 10 characters, matching
-            #     the pattern [a-zA-Z0-9_-]+, such as "store1" or "REGION-2". Otherwise, an
+            #     the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an
             #     INVALID_ARGUMENT error is returned.
             #   @param remove_time [::Google::Protobuf::Timestamp, ::Hash]
             #     The time when the fulfillment updates are issued, used to prevent
@@ -1128,8 +1149,8 @@ module Google
             #     If set to true, and the {::Google::Cloud::Retail::V2::Product Product} is not
             #     found, the fulfillment information will still be processed and retained for
             #     at most 1 day and processed once the
-            #     {::Google::Cloud::Retail::V2::Product Product} is created. If set to false, an
-            #     INVALID_ARGUMENT error is returned if the
+            #     {::Google::Cloud::Retail::V2::Product Product} is created. If set to false, a
+            #     NOT_FOUND error is returned if the
             #     {::Google::Cloud::Retail::V2::Product Product} is not found.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -1157,9 +1178,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "product" => request.product
-              }
+              header_params = {}
+              if request.product
+                header_params["product"] = request.product
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 

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

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

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

@@ -1,12 +1,11 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/retail/v2/product_service.proto
 
-require 'google/protobuf'
-
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
+require 'google/cloud/retail/v2/common_pb'
 require 'google/cloud/retail/v2/import_config_pb'
 require 'google/cloud/retail/v2/product_pb'
 require 'google/cloud/retail/v2/purge_config_pb'
@@ -14,6 +13,8 @@ require 'google/longrunning/operations_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
+require 'google/protobuf'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/retail/v2/product_service.proto", :syntax => :proto3) do
     add_message "google.cloud.retail.v2.CreateProductRequest" do

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

@@ -28,7 +28,7 @@ module Google
           # of the customer's website.
           class Service
 
-            include GRPC::GenericService
+            include ::GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode
@@ -90,8 +90,8 @@ module Google
             # [RemoveFulfillmentPlaces][google.cloud.retail.v2.ProductService.RemoveFulfillmentPlaces].
             #
             # This feature is only available for users who have Retail Search enabled.
-            # Contact Retail Support (retail-search-support@google.com) if you are
-            # interested in using Retail Search.
+            # Please submit a form [here](https://cloud.google.com/contact) to contact
+            # cloud sales if you are interested in using Retail Search.
             rpc :SetInventory, ::Google::Cloud::Retail::V2::SetInventoryRequest, ::Google::Longrunning::Operation
             # Incrementally adds place IDs to
             # [Product.fulfillment_info.place_ids][google.cloud.retail.v2.FulfillmentInfo.place_ids].
@@ -106,8 +106,8 @@ module Google
             # [ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
             #
             # This feature is only available for users who have Retail Search enabled.
-            # Contact Retail Support (retail-search-support@google.com) if you are
-            # interested in using Retail Search.
+            # Please submit a form [here](https://cloud.google.com/contact) to contact
+            # cloud sales if you are interested in using Retail Search.
             rpc :AddFulfillmentPlaces, ::Google::Cloud::Retail::V2::AddFulfillmentPlacesRequest, ::Google::Longrunning::Operation
             # Incrementally removes place IDs from a
             # [Product.fulfillment_info.place_ids][google.cloud.retail.v2.FulfillmentInfo.place_ids].
@@ -122,8 +122,8 @@ module Google
             # [ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
             #
             # This feature is only available for users who have Retail Search enabled.
-            # Contact Retail Support (retail-search-support@google.com) if you are
-            # interested in using Retail Search.
+            # Please submit a form [here](https://cloud.google.com/contact) to contact
+            # cloud sales if you are interested in using Retail Search.
             rpc :RemoveFulfillmentPlaces, ::Google::Cloud::Retail::V2::RemoveFulfillmentPlacesRequest, ::Google::Longrunning::Operation
           end
 

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

@@ -1,10 +1,10 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/retail/v2/purge_config.proto
 
-require 'google/protobuf'
-
 require 'google/api/annotations_pb'
 require 'google/api/field_behavior_pb'
+require 'google/protobuf'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/retail/v2/purge_config.proto", :syntax => :proto3) do
     add_message "google.cloud.retail.v2.PurgeMetadata" do

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

@@ -30,8 +30,8 @@ module Google
           # Service for search.
           #
           # This feature is only available for users who have Retail Search enabled.
-          # Contact Retail Support (retail-search-support@google.com) if you are
-          # interested in using Retail Search.
+          # Please submit a form [here](https://cloud.google.com/contact) to contact
+          # cloud sales if you are interested in using Retail Search.
           #
           class Client
             include Paths
@@ -68,9 +68,9 @@ module Google
                                 end
                 default_config = Client::Configuration.new parent_config
 
-                default_config.timeout = 60.0
+                default_config.timeout = 5.0
                 default_config.retry_policy = {
-                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
+                  initial_delay: 0.1, max_delay: 5.0, multiplier: 1.3, retry_codes: [14, 4]
                 }
 
                 default_config
@@ -157,8 +157,8 @@ module Google
             # Performs a search.
             #
             # This feature is only available for users who have Retail Search enabled.
-            # Contact Retail Support (retail-search-support@google.com) if you are
-            # interested in using Retail Search.
+            # Please submit a form [here](https://cloud.google.com/contact) to contact
+            # cloud sales if you are interested in using Retail Search.
             #
             # @overload search(request, options = nil)
             #   Pass arguments to `search` via a request object, either of type
@@ -170,7 +170,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload search(placement: nil, branch: nil, query: nil, visitor_id: nil, user_info: nil, page_size: nil, page_token: nil, offset: nil, filter: nil, canonical_filter: nil, order_by: nil, facet_specs: nil, dynamic_facet_spec: nil, boost_spec: nil, query_expansion_spec: nil, variant_rollup_keys: nil, page_categories: nil)
+            # @overload search(placement: nil, branch: nil, query: nil, visitor_id: nil, user_info: nil, page_size: nil, page_token: nil, offset: nil, filter: nil, canonical_filter: nil, order_by: nil, facet_specs: nil, dynamic_facet_spec: nil, boost_spec: nil, query_expansion_spec: nil, variant_rollup_keys: nil, page_categories: nil, search_mode: nil)
             #   Pass arguments to `search` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -178,12 +178,8 @@ module Google
             #   @param placement [::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`.
+            #     This field is used to identify the serving configuration name and the set
+            #     of models that will be used to make the search.
             #   @param branch [::String]
             #     The branch resource name, such as
             #     `projects/*/locations/global/catalogs/default_catalog/branches/0`.
@@ -230,7 +226,8 @@ module Google
             #   @param filter [::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.
+            #     expression is case-sensitive. See more details at this [user
+            #     guide](https://cloud.google.com/retail/docs/filter-and-order#filter).
             #
             #     If this field is unrecognizable, an INVALID_ARGUMENT is returned.
             #   @param canonical_filter [::String]
@@ -246,7 +243,9 @@ module Google
             #   @param order_by [::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.
+            #     unset if ordered by relevance. OrderBy expression is case-sensitive. See
+            #     more details at this [user
+            #     guide](https://cloud.google.com/retail/docs/filter-and-order#order).
             #
             #     If this field is unrecognizable, an INVALID_ARGUMENT is returned.
             #   @param facet_specs [::Array<::Google::Cloud::Retail::V2::SearchRequest::FacetSpec, ::Hash>]
@@ -258,14 +257,21 @@ 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.
             #   @param boost_spec [::Google::Cloud::Retail::V2::SearchRequest::BoostSpec, ::Hash]
-            #     Boost specification to boost certain products.
+            #     Boost specification to boost certain products. See more details at this
+            #     [user guide](https://cloud.google.com/retail/docs/boosting).
+            #
+            #     Notice that if both [ServingConfig.boost_control_ids][] and
+            #     [SearchRequest.boost_spec] are set, the boost conditions from both places
+            #     are evaluated. If a search request matches multiple boost conditions,
+            #     the final boost score is equal to the sum of the boost scores from all
+            #     matched boost conditions.
             #   @param query_expansion_spec [::Google::Cloud::Retail::V2::SearchRequest::QueryExpansionSpec, ::Hash]
             #     The query expansion specification that specifies the conditions under which
-            #     query expansion will occur.
+            #     query expansion will occur. See more details at this [user
+            #     guide](https://cloud.google.com/retail/docs/result-size#query_expansion).
             #   @param variant_rollup_keys [::Array<::String>]
             #     The keys to fetch and rollup the matching
             #     {::Google::Cloud::Retail::V2::Product::Type::VARIANT variant}
@@ -276,10 +282,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:
@@ -288,26 +293,45 @@ module Google
             #     * price
             #     * originalPrice
             #     * discount
+            #     * inventory(place_id,price)
             #     * 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.
@@ -324,6 +348,9 @@ module Google
             #     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"].
+            #   @param search_mode [::Google::Cloud::Retail::V2::SearchRequest::SearchMode]
+            #     The search mode of the search request. If not specified, a single search
+            #     request triggers both product search and faceted search.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Retail::V2::SearchResponse::SearchResult>]
@@ -350,9 +377,11 @@ module Google
                 gapic_version: ::Google::Cloud::Retail::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "placement" => request.placement
-              }
+              header_params = {}
+              if request.placement
+                header_params["placement"] = request.placement
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 

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

@@ -34,8 +34,8 @@ module Google
         # Service for search.
         #
         # This feature is only available for users who have Retail Search enabled.
-        # Contact Retail Support (retail-search-support@google.com) if you are
-        # interested in using Retail Search.
+        # Please submit a form [here](https://cloud.google.com/contact) to contact
+        # cloud sales if you are interested in using Retail Search.
         #
         # To load this service and instantiate a client:
         #