google-cloud-retail-v2 0.3.0 → 0.4.1

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

@@ -0,0 +1,52 @@
+# 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
+        module CompletionService
+          # Path helper methods for the CompletionService API.
+          module Paths
+            ##
+            # Create a fully-qualified Catalog resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/catalogs/{catalog}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param catalog [String]
+            #
+            # @return [::String]
+            def catalog_path project:, location:, catalog:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/catalogs/#{catalog}"
+            end
+
+            extend self
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,50 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/retail/v2/completion_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/longrunning/operations_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/retail/v2/completion_service.proto", :syntax => :proto3) do
+    add_message "google.cloud.retail.v2.CompleteQueryRequest" do
+      optional :catalog, :string, 1
+      optional :query, :string, 2
+      optional :visitor_id, :string, 7
+      repeated :language_codes, :string, 3
+      optional :device_type, :string, 4
+      optional :dataset, :string, 6
+      optional :max_suggestions, :int32, 5
+    end
+    add_message "google.cloud.retail.v2.CompleteQueryResponse" do
+      repeated :completion_results, :message, 1, "google.cloud.retail.v2.CompleteQueryResponse.CompletionResult"
+      optional :attribution_token, :string, 2
+      repeated :recent_search_results, :message, 3, "google.cloud.retail.v2.CompleteQueryResponse.RecentSearchResult"
+    end
+    add_message "google.cloud.retail.v2.CompleteQueryResponse.CompletionResult" do
+      optional :suggestion, :string, 1
+      map :attributes, :string, :message, 2, "google.cloud.retail.v2.CustomAttribute"
+    end
+    add_message "google.cloud.retail.v2.CompleteQueryResponse.RecentSearchResult" do
+      optional :recent_search, :string, 1
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Retail
+      module V2
+        CompleteQueryRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.CompleteQueryRequest").msgclass
+        CompleteQueryResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.CompleteQueryResponse").msgclass
+        CompleteQueryResponse::CompletionResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.CompleteQueryResponse.CompletionResult").msgclass
+        CompleteQueryResponse::RecentSearchResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.CompleteQueryResponse.RecentSearchResult").msgclass
+      end
+    end
+  end
+end

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

@@ -0,0 +1,61 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/cloud/retail/v2/completion_service.proto for package 'Google.Cloud.Retail.V2'
+# Original file comments:
+# Copyright 2020 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
+#
+#     http://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.
+#
+
+require 'grpc'
+require 'google/cloud/retail/v2/completion_service_pb'
+
+module Google
+  module Cloud
+    module Retail
+      module V2
+        module CompletionService
+          # Auto-completion service for retail.
+          #
+          # 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.
+          class Service
+
+            include GRPC::GenericService
+
+            self.marshal_class_method = :encode
+            self.unmarshal_class_method = :decode
+            self.service_name = 'google.cloud.retail.v2.CompletionService'
+
+            # Completes the specified prefix with keyword suggestions.
+            #
+            # 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.
+            rpc :CompleteQuery, ::Google::Cloud::Retail::V2::CompleteQueryRequest, ::Google::Cloud::Retail::V2::CompleteQueryResponse
+            # Bulk import of processed completion dataset.
+            #
+            # Request processing may be synchronous. Partial updating is not supported.
+            #
+            # 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.
+            rpc :ImportCompletionData, ::Google::Cloud::Retail::V2::ImportCompletionDataRequest, ::Google::Longrunning::Operation
+          end
+
+          Stub = Service.rpc_stub_class
+        end
+      end
+    end
+  end
+end

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

@@ -5,11 +5,13 @@ require 'google/protobuf'
 
 require 'google/api/annotations_pb'
 require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
 require 'google/cloud/retail/v2/product_pb'
 require 'google/cloud/retail/v2/user_event_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/rpc/status_pb'
+require 'google/type/date_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/retail/v2/import_config.proto", :syntax => :proto3) do
     add_message "google.cloud.retail.v2.GcsSource" do
@@ -22,6 +24,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :table_id, :string, 2
       optional :gcs_staging_dir, :string, 3
       optional :data_schema, :string, 4
+      oneof :partition do
+        optional :partition_date, :message, 6, "google.type.Date"
+      end
     end
     add_message "google.cloud.retail.v2.ProductInlineSource" do
       repeated :products, :message, 1, "google.cloud.retail.v2.Product"
@@ -36,15 +41,28 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.retail.v2.ImportProductsRequest" do
       optional :parent, :string, 1
+      optional :request_id, :string, 6
       optional :input_config, :message, 2, "google.cloud.retail.v2.ProductInputConfig"
       optional :errors_config, :message, 3, "google.cloud.retail.v2.ImportErrorsConfig"
       optional :update_mask, :message, 4, "google.protobuf.FieldMask"
+      optional :reconciliation_mode, :enum, 5, "google.cloud.retail.v2.ImportProductsRequest.ReconciliationMode"
+      optional :notification_pubsub_topic, :string, 7
+    end
+    add_enum "google.cloud.retail.v2.ImportProductsRequest.ReconciliationMode" do
+      value :RECONCILIATION_MODE_UNSPECIFIED, 0
+      value :INCREMENTAL, 1
+      value :FULL, 2
     end
     add_message "google.cloud.retail.v2.ImportUserEventsRequest" do
       optional :parent, :string, 1
       optional :input_config, :message, 2, "google.cloud.retail.v2.UserEventInputConfig"
       optional :errors_config, :message, 3, "google.cloud.retail.v2.ImportErrorsConfig"
     end
+    add_message "google.cloud.retail.v2.ImportCompletionDataRequest" do
+      optional :parent, :string, 1
+      optional :input_config, :message, 2, "google.cloud.retail.v2.CompletionDataInputConfig"
+      optional :notification_pubsub_topic, :string, 3
+    end
     add_message "google.cloud.retail.v2.ProductInputConfig" do
       oneof :source do
         optional :product_inline_source, :message, 1, "google.cloud.retail.v2.ProductInlineSource"
@@ -59,11 +77,18 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
         optional :big_query_source, :message, 3, "google.cloud.retail.v2.BigQuerySource"
       end
     end
+    add_message "google.cloud.retail.v2.CompletionDataInputConfig" do
+      oneof :source do
+        optional :big_query_source, :message, 1, "google.cloud.retail.v2.BigQuerySource"
+      end
+    end
     add_message "google.cloud.retail.v2.ImportMetadata" do
       optional :create_time, :message, 1, "google.protobuf.Timestamp"
       optional :update_time, :message, 2, "google.protobuf.Timestamp"
       optional :success_count, :int64, 3
       optional :failure_count, :int64, 4
+      optional :request_id, :string, 5
+      optional :notification_pubsub_topic, :string, 6
     end
     add_message "google.cloud.retail.v2.ImportProductsResponse" do
       repeated :error_samples, :message, 1, "google.rpc.Status"
@@ -78,6 +103,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :joined_events_count, :int64, 1
       optional :unjoined_events_count, :int64, 2
     end
+    add_message "google.cloud.retail.v2.ImportCompletionDataResponse" do
+      repeated :error_samples, :message, 1, "google.rpc.Status"
+    end
   end
 end
 
@@ -91,13 +119,17 @@ module Google
         UserEventInlineSource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.UserEventInlineSource").msgclass
         ImportErrorsConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ImportErrorsConfig").msgclass
         ImportProductsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ImportProductsRequest").msgclass
+        ImportProductsRequest::ReconciliationMode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ImportProductsRequest.ReconciliationMode").enummodule
         ImportUserEventsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ImportUserEventsRequest").msgclass
+        ImportCompletionDataRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ImportCompletionDataRequest").msgclass
         ProductInputConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ProductInputConfig").msgclass
         UserEventInputConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.UserEventInputConfig").msgclass
+        CompletionDataInputConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.CompletionDataInputConfig").msgclass
         ImportMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ImportMetadata").msgclass
         ImportProductsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ImportProductsResponse").msgclass
         ImportUserEventsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ImportUserEventsResponse").msgclass
         UserEventImportSummary = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.UserEventImportSummary").msgclass
+        ImportCompletionDataResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ImportCompletionDataResponse").msgclass
       end
     end
   end

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

@@ -67,10 +67,7 @@ module Google
 
                 default_config.timeout = 60.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: 60.0, multiplier: 1.3, retry_codes: [14, 4]
                 }
 
                 default_config
@@ -141,7 +138,7 @@ module Google
                                        !@config.endpoint.split(".").first.include?("-")
               credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
-              if credentials.is_a?(String) || credentials.is_a?(Hash)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -179,30 +176,10 @@ module Google
             #   @param placement [::String]
             #     Required. Full resource name of the format:
             #     \\{name=projects/*/locations/global/catalogs/default_catalog/placements/*}
-            #     The id of the recommendation engine placement. This id is used to identify
-            #     the set of models that will be used to make the prediction.
-            #
-            #     We currently support three placements with the following IDs by default:
-            #
-            #     * `shopping_cart`: Predicts products frequently bought together with one or
-            #       more  products in the same shopping session. Commonly displayed after
-            #       `add-to-cart` events, on product detail pages, or on the shopping cart
-            #       page.
-            #
-            #     * `home_page`: Predicts the next product that a user will most likely
-            #       engage with or purchase based on the shopping or viewing history of the
-            #       specified `userId` or `visitorId`. For example - Recommendations for you.
-            #
-            #     * `product_detail`: Predicts the next product that a user will most likely
-            #       engage with or purchase. The prediction is based on the shopping or
-            #       viewing history of the specified `userId` or `visitorId` and its
-            #       relevance to a specified `CatalogItem`. Typically used on product detail
-            #       pages. For example - More products like this.
-            #
-            #     * `recently_viewed_default`: Returns up to 75 products recently viewed by
-            #       the specified `userId` or `visitorId`, most recent ones first. Returns
-            #       nothing if neither of them has viewed any products yet. For example -
-            #       Recently viewed.
+            #     The ID of the Recommendations AI placement. Before you can request
+            #     predictions from your model, you must create at least one placement for it.
+            #     For more information, see [Managing
+            #     placements](https://cloud.google.com/retail/recommendations-ai/docs/manage-placements).
             #
             #     The full list of available placements can be seen at
             #     https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements
@@ -229,6 +206,9 @@ module Google
             #        `NOT "tagA"`. Tag values must be double quoted UTF-8 encoded strings
             #        with a size limit of 1,000 characters.
             #
+            #        Note: "Recently viewed" models don't support tag filtering at the
+            #        moment.
+            #
             #      * filterOutOfStockItems. Restricts predictions to products that do not
             #      have a
             #        stockState value of OUT_OF_STOCK.
@@ -263,16 +243,34 @@ module Google
             #     * `strictFiltering`: Boolean. True by default. If set to false, the service
             #        will return generic (unfiltered) popular products instead of empty if
             #        your filter blocks all prediction results.
+            #     * `priceRerankLevel`: String. Default empty. If set to be non-empty, then
+            #        it needs to be one of {'no-price-reranking', 'low-price-reranking',
+            #        'medium-price-reranking', 'high-price-reranking'}. This gives
+            #        request-level control and adjusts prediction results based on product
+            #        price.
+            #     * `diversityLevel`: String. Default empty. If set to be non-empty, then
+            #        it needs to be one of {'no-diversity', 'low-diversity',
+            #        'medium-diversity', 'high-diversity', 'auto-diversity'}. This gives
+            #        request-level control and adjusts prediction results based on product
+            #        category.
             #   @param labels [::Hash{::String => ::String}]
-            #     The labels for the predict request.
-            #
-            #      * Label keys can contain lowercase letters, digits and hyphens, must start
-            #        with a letter, and must end with a letter or digit.
-            #      * Non-zero label values can contain lowercase letters, digits and hyphens,
-            #        must start with a letter, and must end with a letter or digit.
-            #      * No more than 64 labels can be associated with a given request.
-            #
-            #     See https://goo.gl/xmQnxf for more information on and examples of labels.
+            #     The labels applied to a resource must meet the following requirements:
+            #
+            #     * Each resource can have multiple labels, up to a maximum of 64.
+            #     * Each label must be a key-value pair.
+            #     * Keys have a minimum length of 1 character and a maximum length of 63
+            #       characters, and cannot be empty. Values can be empty, and have a maximum
+            #       length of 63 characters.
+            #     * Keys and values can contain only lowercase letters, numeric characters,
+            #       underscores, and dashes. All characters must use UTF-8 encoding, and
+            #       international characters are allowed.
+            #     * The key portion of a label must be unique. However, you can use the same
+            #       key with multiple resources.
+            #     * Keys must start with a lowercase letter or international character.
+            #
+            #     See [Google Cloud
+            #     Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
+            #     for more details.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Retail::V2::PredictResponse]

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

@@ -7,6 +7,7 @@ require 'google/api/annotations_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/cloud/retail/v2/common_pb'
+require 'google/protobuf/duration_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/protobuf/wrappers_pb'
@@ -17,17 +18,37 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :id, :string, 2
       optional :type, :enum, 3, "google.cloud.retail.v2.Product.Type"
       optional :primary_product_id, :string, 4
+      repeated :collection_member_ids, :string, 5
+      optional :gtin, :string, 6
       repeated :categories, :string, 7
       optional :title, :string, 8
+      repeated :brands, :string, 9
       optional :description, :string, 10
+      optional :language_code, :string, 11
       map :attributes, :string, :message, 12, "google.cloud.retail.v2.CustomAttribute"
       repeated :tags, :string, 13
       optional :price_info, :message, 14, "google.cloud.retail.v2.PriceInfo"
+      optional :rating, :message, 15, "google.cloud.retail.v2.Rating"
       optional :available_time, :message, 18, "google.protobuf.Timestamp"
       optional :availability, :enum, 19, "google.cloud.retail.v2.Product.Availability"
       optional :available_quantity, :message, 20, "google.protobuf.Int32Value"
+      repeated :fulfillment_info, :message, 21, "google.cloud.retail.v2.FulfillmentInfo"
       optional :uri, :string, 22
       repeated :images, :message, 23, "google.cloud.retail.v2.Image"
+      optional :audience, :message, 24, "google.cloud.retail.v2.Audience"
+      optional :color_info, :message, 25, "google.cloud.retail.v2.ColorInfo"
+      repeated :sizes, :string, 26
+      repeated :materials, :string, 27
+      repeated :patterns, :string, 28
+      repeated :conditions, :string, 29
+      repeated :promotions, :message, 34, "google.cloud.retail.v2.Promotion"
+      optional :publish_time, :message, 33, "google.protobuf.Timestamp"
+      optional :retrievable_fields, :message, 30, "google.protobuf.FieldMask"
+      repeated :variants, :message, 31, "google.cloud.retail.v2.Product"
+      oneof :expiration do
+        optional :expire_time, :message, 16, "google.protobuf.Timestamp"
+        optional :ttl, :message, 17, "google.protobuf.Duration"
+      end
     end
     add_enum "google.cloud.retail.v2.Product.Type" do
       value :TYPE_UNSPECIFIED, 0

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

@@ -68,10 +68,7 @@ module Google
 
                 default_config.timeout = 60.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: 60.0, multiplier: 1.3, retry_codes: [14, 4]
                 }
 
                 default_config
@@ -142,7 +139,7 @@ module Google
                                        !@config.endpoint.split(".").first.include?("-")
               credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
-              if credentials.is_a?(String) || credentials.is_a?(Hash)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -331,6 +328,144 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Gets a list of {::Google::Cloud::Retail::V2::Product Product}s.
+            #
+            # @overload list_products(request, options = nil)
+            #   Pass arguments to `list_products` via a request object, either of type
+            #   {::Google::Cloud::Retail::V2::ListProductsRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Retail::V2::ListProductsRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload list_products(parent: nil, page_size: nil, page_token: nil, filter: nil, read_mask: nil)
+            #   Pass arguments to `list_products` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param parent [::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.
+            #   @param page_size [::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.
+            #   @param page_token [::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.
+            #   @param filter [::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.
+            #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
+            #     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.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Retail::V2::Product>]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::PagedEnumerable<::Google::Cloud::Retail::V2::Product>]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def list_products request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Retail::V2::ListProductsRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.list_products.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Retail::V2::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {
+                "parent" => request.parent
+              }
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.list_products.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.list_products.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @product_service_stub.call_rpc :list_products, request, options: options do |response, operation|
+                response = ::Gapic::PagedEnumerable.new @product_service_stub, :list_products, request, response, operation, options
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Updates a {::Google::Cloud::Retail::V2::Product Product}.
             #
@@ -344,7 +479,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload update_product(product: nil, update_mask: nil)
+            # @overload update_product(product: nil, update_mask: nil, allow_missing: nil)
             #   Pass arguments to `update_product` 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).
@@ -356,8 +491,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.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Indicates which fields in the provided
             #     {::Google::Cloud::Retail::V2::Product Product} to update. The immutable and
@@ -366,6 +503,10 @@ module Google
             #
             #     If an unsupported or unknown field is provided, an INVALID_ARGUMENT error
             #     is returned.
+            #   @param allow_missing [::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.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Retail::V2::Product]
@@ -442,6 +583,17 @@ 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.
+            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
             # @yieldparam operation [::GRPC::ActiveCall::Operation]
@@ -506,7 +658,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload import_products(parent: nil, input_config: nil, errors_config: nil, update_mask: nil)
+            # @overload import_products(parent: nil, request_id: nil, input_config: nil, errors_config: nil, update_mask: nil, reconciliation_mode: nil, notification_pubsub_topic: nil)
             #   Pass arguments to `import_products` 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).
@@ -517,6 +669,16 @@ module Google
             #
             #     If no updateMask is specified, requires products.create permission.
             #     If updateMask is specified, requires products.update permission.
+            #   @param request_id [::String]
+            #     Unique identifier provided by client, within the ancestor
+            #     dataset scope. Ensures idempotency and used for request deduplication.
+            #     Server-generated if unspecified. Up to 128 characters long and must match
+            #     the pattern: "[a-zA-Z0-9_]+". This is returned as [Operation.name][] in
+            #     {::Google::Cloud::Retail::V2::ImportMetadata ImportMetadata}.
+            #
+            #     Only supported when
+            #     {::Google::Cloud::Retail::V2::ImportProductsRequest#reconciliation_mode ImportProductsRequest.reconciliation_mode}
+            #     is set to `FULL`.
             #   @param input_config [::Google::Cloud::Retail::V2::ProductInputConfig, ::Hash]
             #     Required. The desired input location of the data.
             #   @param errors_config [::Google::Cloud::Retail::V2::ImportErrorsConfig, ::Hash]
@@ -524,6 +686,20 @@ module Google
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Indicates which fields in the provided imported 'products' to update. If
             #     not set, will by default update all fields.
+            #   @param reconciliation_mode [::Google::Cloud::Retail::V2::ImportProductsRequest::ReconciliationMode]
+            #     The mode of reconciliation between existing products and the products to be
+            #     imported. Defaults to
+            #     {::Google::Cloud::Retail::V2::ImportProductsRequest::ReconciliationMode::INCREMENTAL ReconciliationMode.INCREMENTAL}.
+            #   @param notification_pubsub_topic [::String]
+            #     Pub/Sub topic for receiving notification. If this field is set,
+            #     when the import is finished, a notification will be sent to
+            #     specified Pub/Sub topic. The message data will be JSON string of a
+            #     {::Google::Longrunning::Operation Operation}.
+            #     Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
+            #
+            #     Only supported when
+            #     {::Google::Cloud::Retail::V2::ImportProductsRequest#reconciliation_mode ImportProductsRequest.reconciliation_mode}
+            #     is set to `FULL`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -571,6 +747,427 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Updates inventory information for a
+            # {::Google::Cloud::Retail::V2::Product Product} while respecting the last update
+            # timestamps of each inventory field.
+            #
+            # This process is asynchronous and does not require the
+            # {::Google::Cloud::Retail::V2::Product Product} to exist before updating
+            # fulfillment information. If the request is valid, the update will be
+            # enqueued and processed downstream. As a consequence, when a response is
+            # returned, updates are not immediately manifested in the
+            # {::Google::Cloud::Retail::V2::Product Product} queried by
+            # {::Google::Cloud::Retail::V2::ProductService::Client#get_product GetProduct} or
+            # {::Google::Cloud::Retail::V2::ProductService::Client#list_products ListProducts}.
+            #
+            # When inventory is updated with
+            # {::Google::Cloud::Retail::V2::ProductService::Client#create_product CreateProduct} and
+            # {::Google::Cloud::Retail::V2::ProductService::Client#update_product UpdateProduct}, the
+            # specified inventory field value(s) will overwrite any existing value(s)
+            # while ignoring the last update time for this field. Furthermore, the last
+            # update time for the specified inventory fields will be overwritten to the
+            # time of the
+            # {::Google::Cloud::Retail::V2::ProductService::Client#create_product CreateProduct} or
+            # {::Google::Cloud::Retail::V2::ProductService::Client#update_product UpdateProduct}
+            # request.
+            #
+            # If no inventory fields are set in
+            # {::Google::Cloud::Retail::V2::CreateProductRequest#product CreateProductRequest.product},
+            # then any pre-existing inventory information for this product will be used.
+            #
+            # If no inventory fields are set in [UpdateProductRequest.set_mask][],
+            # then any existing inventory information will be preserved.
+            #
+            # Pre-existing inventory information can only be updated with
+            # {::Google::Cloud::Retail::V2::ProductService::Client#set_inventory SetInventory},
+            # {::Google::Cloud::Retail::V2::ProductService::Client#add_fulfillment_places AddFulfillmentPlaces},
+            # and
+            # {::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.
+            #
+            # @overload set_inventory(request, options = nil)
+            #   Pass arguments to `set_inventory` via a request object, either of type
+            #   {::Google::Cloud::Retail::V2::SetInventoryRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Retail::V2::SetInventoryRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload set_inventory(inventory: nil, set_mask: nil, set_time: nil, allow_missing: nil)
+            #   Pass arguments to `set_inventory` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param inventory [::Google::Cloud::Retail::V2::Product, ::Hash]
+            #     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.
+            #   @param set_mask [::Google::Protobuf::FieldMask, ::Hash]
+            #     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.
+            #   @param set_time [::Google::Protobuf::Timestamp, ::Hash]
+            #     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.
+            #   @param allow_missing [::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.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::Operation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::Operation]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def set_inventory request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Retail::V2::SetInventoryRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.set_inventory.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                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
+              }
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.set_inventory.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.set_inventory.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @product_service_stub.call_rpc :set_inventory, request, options: options do |response, operation|
+                response = ::Gapic::Operation.new response, @operations_client, options: options
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
+            ##
+            # Incrementally adds place IDs to
+            # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids Product.fulfillment_info.place_ids}.
+            #
+            # This process is asynchronous and does not require the
+            # {::Google::Cloud::Retail::V2::Product Product} to exist before updating
+            # fulfillment information. If the request is valid, the update will be
+            # enqueued and processed downstream. As a consequence, when a response is
+            # returned, the added place IDs are not immediately manifested in the
+            # {::Google::Cloud::Retail::V2::Product Product} queried by
+            # {::Google::Cloud::Retail::V2::ProductService::Client#get_product GetProduct} or
+            # {::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.
+            #
+            # @overload add_fulfillment_places(request, options = nil)
+            #   Pass arguments to `add_fulfillment_places` via a request object, either of type
+            #   {::Google::Cloud::Retail::V2::AddFulfillmentPlacesRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Retail::V2::AddFulfillmentPlacesRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload add_fulfillment_places(product: nil, type: nil, place_ids: nil, add_time: nil, allow_missing: nil)
+            #   Pass arguments to `add_fulfillment_places` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param product [::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.
+            #   @param type [::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][].
+            #   @param place_ids [::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.
+            #   @param add_time [::Google::Protobuf::Timestamp, ::Hash]
+            #     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.
+            #   @param allow_missing [::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.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::Operation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::Operation]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def add_fulfillment_places request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Retail::V2::AddFulfillmentPlacesRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.add_fulfillment_places.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Retail::V2::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {
+                "product" => request.product
+              }
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.add_fulfillment_places.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.add_fulfillment_places.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @product_service_stub.call_rpc :add_fulfillment_places, request, options: options do |response, operation|
+                response = ::Gapic::Operation.new response, @operations_client, options: options
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
+            ##
+            # Incrementally removes place IDs from a
+            # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids Product.fulfillment_info.place_ids}.
+            #
+            # This process is asynchronous and does not require the
+            # {::Google::Cloud::Retail::V2::Product Product} to exist before updating
+            # fulfillment information. If the request is valid, the update will be
+            # enqueued and processed downstream. As a consequence, when a response is
+            # returned, the removed place IDs are not immediately manifested in the
+            # {::Google::Cloud::Retail::V2::Product Product} queried by
+            # {::Google::Cloud::Retail::V2::ProductService::Client#get_product GetProduct} or
+            # {::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.
+            #
+            # @overload remove_fulfillment_places(request, options = nil)
+            #   Pass arguments to `remove_fulfillment_places` via a request object, either of type
+            #   {::Google::Cloud::Retail::V2::RemoveFulfillmentPlacesRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Retail::V2::RemoveFulfillmentPlacesRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload remove_fulfillment_places(product: nil, type: nil, place_ids: nil, remove_time: nil, allow_missing: nil)
+            #   Pass arguments to `remove_fulfillment_places` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param product [::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.
+            #   @param type [::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][].
+            #   @param place_ids [::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.
+            #   @param remove_time [::Google::Protobuf::Timestamp, ::Hash]
+            #     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.
+            #   @param allow_missing [::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.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::Operation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::Operation]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def remove_fulfillment_places request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Retail::V2::RemoveFulfillmentPlacesRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.remove_fulfillment_places.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Retail::V2::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {
+                "product" => request.product
+              }
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.remove_fulfillment_places.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.remove_fulfillment_places.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @product_service_stub.call_rpc :remove_fulfillment_places, request, options: options do |response, operation|
+                response = ::Gapic::Operation.new response, @operations_client, options: options
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Configuration class for the ProductService API.
             #
@@ -718,6 +1315,11 @@ module Google
                 #
                 attr_reader :get_product
                 ##
+                # RPC-specific configuration for `list_products`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :list_products
+                ##
                 # RPC-specific configuration for `update_product`
                 # @return [::Gapic::Config::Method]
                 #
@@ -732,6 +1334,21 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :import_products
+                ##
+                # RPC-specific configuration for `set_inventory`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :set_inventory
+                ##
+                # RPC-specific configuration for `add_fulfillment_places`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :add_fulfillment_places
+                ##
+                # RPC-specific configuration for `remove_fulfillment_places`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :remove_fulfillment_places
 
                 # @private
                 def initialize parent_rpcs = nil
@@ -739,12 +1356,20 @@ module Google
                   @create_product = ::Gapic::Config::Method.new create_product_config
                   get_product_config = parent_rpcs.get_product if parent_rpcs.respond_to? :get_product
                   @get_product = ::Gapic::Config::Method.new get_product_config
+                  list_products_config = parent_rpcs.list_products if parent_rpcs.respond_to? :list_products
+                  @list_products = ::Gapic::Config::Method.new list_products_config
                   update_product_config = parent_rpcs.update_product if parent_rpcs.respond_to? :update_product
                   @update_product = ::Gapic::Config::Method.new update_product_config
                   delete_product_config = parent_rpcs.delete_product if parent_rpcs.respond_to? :delete_product
                   @delete_product = ::Gapic::Config::Method.new delete_product_config
                   import_products_config = parent_rpcs.import_products if parent_rpcs.respond_to? :import_products
                   @import_products = ::Gapic::Config::Method.new import_products_config
+                  set_inventory_config = parent_rpcs.set_inventory if parent_rpcs.respond_to? :set_inventory
+                  @set_inventory = ::Gapic::Config::Method.new set_inventory_config
+                  add_fulfillment_places_config = parent_rpcs.add_fulfillment_places if parent_rpcs.respond_to? :add_fulfillment_places
+                  @add_fulfillment_places = ::Gapic::Config::Method.new add_fulfillment_places_config
+                  remove_fulfillment_places_config = parent_rpcs.remove_fulfillment_places if parent_rpcs.respond_to? :remove_fulfillment_places
+                  @remove_fulfillment_places = ::Gapic::Config::Method.new remove_fulfillment_places_config
 
                   yield self if block_given?
                 end