google-cloud-retail-v2 0.8.0 → 0.11.0

data/lib/google/cloud/retail/v2/control_service/credentials.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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!
+
+require "googleauth"
+
+module Google
+  module Cloud
+    module Retail
+      module V2
+        module ControlService
+          # Credentials for the ControlService API.
+          class Credentials < ::Google::Auth::Credentials
+            self.scope = [
+              "https://www.googleapis.com/auth/cloud-platform"
+            ]
+            self.env_vars = [
+              "RETAIL_CREDENTIALS",
+              "RETAIL_KEYFILE",
+              "GOOGLE_CLOUD_CREDENTIALS",
+              "GOOGLE_CLOUD_KEYFILE",
+              "GCLOUD_KEYFILE",
+              "RETAIL_CREDENTIALS_JSON",
+              "RETAIL_KEYFILE_JSON",
+              "GOOGLE_CLOUD_CREDENTIALS_JSON",
+              "GOOGLE_CLOUD_KEYFILE_JSON",
+              "GCLOUD_KEYFILE_JSON"
+            ]
+            self.paths = [
+              "~/.config/google_cloud/application_default_credentials.json"
+            ]
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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 ControlService
+          # Path helper methods for the ControlService 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
+
+            ##
+            # Create a fully-qualified Control resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/catalogs/{catalog}/controls/{control}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param catalog [String]
+            # @param control [String]
+            #
+            # @return [::String]
+            def control_path project:, location:, catalog:, control:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+              raise ::ArgumentError, "catalog cannot contain /" if catalog.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/catalogs/#{catalog}/controls/#{control}"
+            end
+
+            extend self
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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!
+
+require "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/retail/v2/version"
+
+require "google/cloud/retail/v2/control_service/credentials"
+require "google/cloud/retail/v2/control_service/paths"
+require "google/cloud/retail/v2/control_service/client"
+
+module Google
+  module Cloud
+    module Retail
+      module V2
+        ##
+        # Service for modifying Control.
+        #
+        # To load this service and instantiate a client:
+        #
+        #     require "google/cloud/retail/v2/control_service"
+        #     client = ::Google::Cloud::Retail::V2::ControlService::Client.new
+        #
+        module ControlService
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "control_service", "helpers.rb"
+require "google/cloud/retail/v2/control_service/helpers" if ::File.file? helper_path

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

@@ -0,0 +1,57 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/retail/v2/control_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/control_pb'
+require 'google/protobuf/empty_pb'
+require 'google/protobuf/field_mask_pb'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/retail/v2/control_service.proto", :syntax => :proto3) do
+    add_message "google.cloud.retail.v2.CreateControlRequest" do
+      optional :parent, :string, 1
+      optional :control, :message, 2, "google.cloud.retail.v2.Control"
+      optional :control_id, :string, 3
+    end
+    add_message "google.cloud.retail.v2.UpdateControlRequest" do
+      optional :control, :message, 1, "google.cloud.retail.v2.Control"
+      optional :update_mask, :message, 2, "google.protobuf.FieldMask"
+    end
+    add_message "google.cloud.retail.v2.DeleteControlRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.retail.v2.GetControlRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.retail.v2.ListControlsRequest" do
+      optional :parent, :string, 1
+      optional :page_size, :int32, 2
+      optional :page_token, :string, 3
+      optional :filter, :string, 4
+    end
+    add_message "google.cloud.retail.v2.ListControlsResponse" do
+      repeated :controls, :message, 1, "google.cloud.retail.v2.Control"
+      optional :next_page_token, :string, 2
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Retail
+      module V2
+        CreateControlRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.CreateControlRequest").msgclass
+        UpdateControlRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.UpdateControlRequest").msgclass
+        DeleteControlRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.DeleteControlRequest").msgclass
+        GetControlRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.GetControlRequest").msgclass
+        ListControlsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ListControlsRequest").msgclass
+        ListControlsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ListControlsResponse").msgclass
+      end
+    end
+  end
+end

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

@@ -0,0 +1,65 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/cloud/retail/v2/control_service.proto for package 'Google.Cloud.Retail.V2'
+# Original file comments:
+# 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
+#
+#     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/control_service_pb'
+
+module Google
+  module Cloud
+    module Retail
+      module V2
+        module ControlService
+          # Service for modifying Control.
+          class Service
+
+            include ::GRPC::GenericService
+
+            self.marshal_class_method = :encode
+            self.unmarshal_class_method = :decode
+            self.service_name = 'google.cloud.retail.v2.ControlService'
+
+            # Creates a Control.
+            #
+            # If the [Control][google.cloud.retail.v2.Control] to create already exists,
+            # an ALREADY_EXISTS error is returned.
+            rpc :CreateControl, ::Google::Cloud::Retail::V2::CreateControlRequest, ::Google::Cloud::Retail::V2::Control
+            # Deletes a Control.
+            #
+            # If the [Control][google.cloud.retail.v2.Control] to delete does not exist,
+            # a NOT_FOUND error is returned.
+            rpc :DeleteControl, ::Google::Cloud::Retail::V2::DeleteControlRequest, ::Google::Protobuf::Empty
+            # Updates a Control.
+            #
+            # [Control][google.cloud.retail.v2.Control] cannot be set to a different
+            # oneof field, if so an INVALID_ARGUMENT is returned. If the
+            # [Control][google.cloud.retail.v2.Control] to update does not exist, a
+            # NOT_FOUND error is returned.
+            rpc :UpdateControl, ::Google::Cloud::Retail::V2::UpdateControlRequest, ::Google::Cloud::Retail::V2::Control
+            # Gets a Control.
+            rpc :GetControl, ::Google::Cloud::Retail::V2::GetControlRequest, ::Google::Cloud::Retail::V2::Control
+            # Lists all Controls by their parent
+            # [Catalog][google.cloud.retail.v2.Catalog].
+            rpc :ListControls, ::Google::Cloud::Retail::V2::ListControlsRequest, ::Google::Cloud::Retail::V2::ListControlsResponse
+          end
+
+          Stub = Service.rpc_stub_class
+        end
+      end
+    end
+  end
+end

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

@@ -169,14 +169,19 @@ module Google
             #
             #   @param placement [::String]
             #     Required. Full resource name of the format:
-            #     \\{name=projects/*/locations/global/catalogs/default_catalog/placements/*}
-            #     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
+            #     `{placement=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*}`
+            #     or
+            #     `{placement=projects/*/locations/global/catalogs/default_catalog/placements/*}`.
+            #     We recommend using the `servingConfigs` resource. `placements` is a legacy
+            #     resource.
+            #     The ID of the Recommendations AI serving config or placement.
+            #     Before you can request predictions from your model, you must create at
+            #     least one serving config or placement for it. For more information, see
+            #     [Managing serving configurations]
+            #     (https://cloud.google.com/retail/docs/manage-configs).
+            #
+            #     The full list of available serving configs can be seen at
+            #     https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
             #   @param user_event [::Google::Cloud::Retail::V2::UserEvent, ::Hash]
             #     Required. Context about the user, what they are looking at and what action
             #     they took to trigger the predict request. Note that this user event detail
@@ -193,12 +198,12 @@ module Google
             #     random unique ID and leave
             #     {::Google::Cloud::Retail::V2::UserInfo#user_id UserInfo.user_id} unset.
             #   @param page_size [::Integer]
-            #     Maximum number of results to return per page. Set this property
-            #     to the number of prediction results needed. If zero, the service will
-            #     choose a reasonable default. The maximum allowed value is 100. Values
-            #     above 100 will be coerced to 100.
+            #     Maximum number of results to return. Set this property to the number of
+            #     prediction results needed. If zero, the service will choose a reasonable
+            #     default. The maximum allowed value is 100. Values above 100 will be coerced
+            #     to 100.
             #   @param page_token [::String]
-            #     The previous PredictResponse.next_page_token.
+            #     This field is not used; leave it unset.
             #   @param filter [::String]
             #     Filter for restricting prediction results with a length limit of 5,000
             #     characters. Accepts values for tags and the `filterOutOfStockItems` flag.
@@ -229,6 +234,14 @@ module Google
             #     receive empty results instead.
             #     Note that the API will never return items with storageStatus of "EXPIRED"
             #     or "DELETED" regardless of filter choices.
+            #
+            #     If `filterSyntaxV2` is set to true under the `params` field, then
+            #     attribute-based expressions are expected instead of the above described
+            #     tag-based syntax. Examples:
+            #
+            #      * (colors: ANY("Red", "Blue")) AND NOT (categories: ANY("Phones"))
+            #      * (availability: ANY("IN_STOCK")) AND
+            #        (colors: ANY("Red") OR categories: ANY("Phones"))
             #   @param validate_only [::Boolean]
             #     Use validate only mode for this prediction query. If set to true, a
             #     dummy model will be used that returns arbitrary products.
@@ -260,6 +273,8 @@ module Google
             #        'medium-diversity', 'high-diversity', 'auto-diversity'}. This gives
             #        request-level control and adjusts prediction results based on product
             #        category.
+            #     * `filterSyntaxV2`: Boolean. False by default. If set to true, the `filter`
+            #       field is interpreteted according to the new, attribute-based syntax.
             #   @param labels [::Hash{::String => ::String}]
             #     The labels applied to a resource must meet the following requirements:
             #

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

@@ -46,6 +46,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       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"
+      repeated :local_inventories, :message, 35, "google.cloud.retail.v2.LocalInventory"
       oneof :expiration do
         optional :expire_time, :message, 16, "google.protobuf.Timestamp"
         optional :ttl, :message, 17, "google.protobuf.Duration"

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

@@ -782,29 +782,24 @@ module Google
             #   @param errors_config [::Google::Cloud::Retail::V2::ImportErrorsConfig, ::Hash]
             #     The desired location of errors incurred during the Import.
             #   @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.
+            #     Indicates which fields in the provided imported `products` to update. If
+            #     not set, all fields are updated.
             #   @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]
             #     Full Pub/Sub topic name 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
+            #     when the import is finished, a notification is sent to
+            #     specified Pub/Sub topic. The message data is JSON string of a
             #     {::Google::Longrunning::Operation Operation}.
             #
             #     Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has
             #     to be within the same project as
             #     {::Google::Cloud::Retail::V2::ImportProductsRequest#parent ImportProductsRequest.parent}.
-            #     Make sure that both
-            #     `cloud-retail-customer-data-access@system.gserviceaccount.com` and
-            #     `service-<project number>@gcp-sa-retail.iam.gserviceaccount.com`
-            #     have the `pubsub.topics.publish` IAM permission on the topic.
-            #
-            #     Only supported when
-            #     {::Google::Cloud::Retail::V2::ImportProductsRequest#reconciliation_mode ImportProductsRequest.reconciliation_mode}
-            #     is set to `FULL`.
+            #     Make sure that `service-<project
+            #     number>@gcp-sa-retail.iam.gserviceaccount.com` has the
+            #     `pubsub.topics.publish` IAM permission on the topic.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -889,18 +884,21 @@ module Google
             # 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}.
+            # {::Google::Cloud::Retail::V2::ProductService::Client#get_product ProductService.GetProduct}
+            # or
+            # {::Google::Cloud::Retail::V2::ProductService::Client#list_products ProductService.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)
+            # {::Google::Cloud::Retail::V2::ProductService::Client#create_product ProductService.CreateProduct}
+            # and
+            # {::Google::Cloud::Retail::V2::ProductService::Client#update_product ProductService.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}
+            # {::Google::Cloud::Retail::V2::ProductService::Client#create_product ProductService.CreateProduct}
+            # or
+            # {::Google::Cloud::Retail::V2::ProductService::Client#update_product ProductService.UpdateProduct}
             # request.
             #
             # If no inventory fields are set in
@@ -912,10 +910,17 @@ module Google
             # 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#set_inventory ProductService.SetInventory},
             # {::Google::Cloud::Retail::V2::ProductService::Client#add_fulfillment_places ProductService.AddFulfillmentPlaces},
             # and
-            # {::Google::Cloud::Retail::V2::ProductService::Client#remove_fulfillment_places RemoveFulfillmentPlaces}.
+            # {::Google::Cloud::Retail::V2::ProductService::Client#remove_fulfillment_places ProductService.RemoveFulfillmentPlaces}.
+            #
+            # The returned [Operation][]s will be obsolete after 1 day, and
+            # [GetOperation][] API will return NOT_FOUND afterwards.
+            #
+            # If conflicting updates are issued, the [Operation][]s associated with the
+            # stale updates will not be marked as [done][Operation.done] until being
+            # obsolete.
             #
             # This feature is only available for users who have Retail Search enabled.
             # Please enable Retail Search on Cloud Console before using this feature.
@@ -938,6 +943,7 @@ module Google
             #   @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}
@@ -945,8 +951,9 @@ module Google
             #     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
+            #     {::Google::Cloud::Retail::V2::Product#name 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
@@ -969,7 +976,8 @@ module Google
             #     * Adds "fulfillment_info" in
             #     {::Google::Cloud::Retail::V2::SetInventoryRequest#set_mask SetInventoryRequest.set_mask}
             #     * Specifies only the desired fulfillment types and corresponding place IDs
-            #     to update in [SetInventoryRequest.inventory.fulfillment_info][]
+            #     to update in
+            #     {::Google::Cloud::Retail::V2::Product#fulfillment_info SetInventoryRequest.inventory.fulfillment_info}
             #
             #     The caller can clear all place IDs from a subset of fulfillment types in
             #     the following ways:
@@ -977,9 +985,9 @@ module Google
             #     * Adds "fulfillment_info" in
             #     {::Google::Cloud::Retail::V2::SetInventoryRequest#set_mask SetInventoryRequest.set_mask}
             #     * Specifies only the desired fulfillment types to clear in
-            #     [SetInventoryRequest.inventory.fulfillment_info][]
+            #     {::Google::Cloud::Retail::V2::Product#fulfillment_info SetInventoryRequest.inventory.fulfillment_info}
             #     * Checks that only the desired fulfillment info types have empty
-            #     [SetInventoryRequest.inventory.fulfillment_info.place_ids][]
+            #     {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids SetInventoryRequest.inventory.fulfillment_info.place_ids}
             #
             #     The last update time is recorded for the following inventory fields:
             #     * {::Google::Cloud::Retail::V2::Product#price_info Product.price_info}
@@ -988,7 +996,9 @@ module Google
             #     * {::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.
+            #     needed,
+            #     {::Google::Cloud::Retail::V2::ProductService::Client#update_product ProductService.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.
@@ -1091,8 +1101,16 @@ module Google
             # 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}.
+            # {::Google::Cloud::Retail::V2::ProductService::Client#get_product ProductService.GetProduct}
+            # or
+            # {::Google::Cloud::Retail::V2::ProductService::Client#list_products ProductService.ListProducts}.
+            #
+            # The returned [Operation][]s will be obsolete after 1 day, and
+            # [GetOperation][] API will return NOT_FOUND afterwards.
+            #
+            # If conflicting updates are issued, the [Operation][]s associated with the
+            # stale updates will not be marked as [done][Operation.done] until being
+            # obsolete.
             #
             # This feature is only available for users who have Retail Search enabled.
             # Please enable Retail Search on Cloud Console before using this feature.
@@ -1139,7 +1157,8 @@ module Google
             #     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][].
+            #     This field directly corresponds to
+            #     {::Google::Cloud::Retail::V2::FulfillmentInfo#type Product.fulfillment_info.type}.
             #   @param place_ids [::Array<::String>]
             #     Required. The IDs for this
             #     {::Google::Cloud::Retail::V2::AddFulfillmentPlacesRequest#type type}, such as
@@ -1250,8 +1269,16 @@ module Google
             # 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}.
+            # {::Google::Cloud::Retail::V2::ProductService::Client#get_product ProductService.GetProduct}
+            # or
+            # {::Google::Cloud::Retail::V2::ProductService::Client#list_products ProductService.ListProducts}.
+            #
+            # The returned [Operation][]s will be obsolete after 1 day, and
+            # [GetOperation][] API will return NOT_FOUND afterwards.
+            #
+            # If conflicting updates are issued, the [Operation][]s associated with the
+            # stale updates will not be marked as [done][Operation.done] until being
+            # obsolete.
             #
             # This feature is only available for users who have Retail Search enabled.
             # Please enable Retail Search on Cloud Console before using this feature.
@@ -1406,13 +1433,22 @@ module Google
             # 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}.
+            # {::Google::Cloud::Retail::V2::ProductService::Client#get_product ProductService.GetProduct}
+            # or
+            # {::Google::Cloud::Retail::V2::ProductService::Client#list_products ProductService.ListProducts}.
             #
             # Local inventory information can only be modified using this method.
-            # {::Google::Cloud::Retail::V2::ProductService::Client#create_product CreateProduct} and
-            # {::Google::Cloud::Retail::V2::ProductService::Client#update_product UpdateProduct} has no
-            # effect on local inventories.
+            # {::Google::Cloud::Retail::V2::ProductService::Client#create_product ProductService.CreateProduct}
+            # and
+            # {::Google::Cloud::Retail::V2::ProductService::Client#update_product ProductService.UpdateProduct}
+            # has no effect on local inventories.
+            #
+            # The returned [Operation][]s will be obsolete after 1 day, and
+            # [GetOperation][] API will return NOT_FOUND afterwards.
+            #
+            # If conflicting updates are issued, the [Operation][]s associated with the
+            # stale updates will not be marked as [done][Operation.done] until being
+            # obsolete.
             #
             # This feature is only available for users who have Retail Search enabled.
             # Please enable Retail Search on Cloud Console before using this feature.
@@ -1552,13 +1588,22 @@ module Google
             # enqueued and processed downstream. As a consequence, when a response is
             # returned, removals 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}.
+            # {::Google::Cloud::Retail::V2::ProductService::Client#get_product ProductService.GetProduct}
+            # or
+            # {::Google::Cloud::Retail::V2::ProductService::Client#list_products ProductService.ListProducts}.
             #
             # Local inventory information can only be removed using this method.
-            # {::Google::Cloud::Retail::V2::ProductService::Client#create_product CreateProduct} and
-            # {::Google::Cloud::Retail::V2::ProductService::Client#update_product UpdateProduct} has no
-            # effect on local inventories.
+            # {::Google::Cloud::Retail::V2::ProductService::Client#create_product ProductService.CreateProduct}
+            # and
+            # {::Google::Cloud::Retail::V2::ProductService::Client#update_product ProductService.UpdateProduct}
+            # has no effect on local inventories.
+            #
+            # The returned [Operation][]s will be obsolete after 1 day, and
+            # [GetOperation][] API will return NOT_FOUND afterwards.
+            #
+            # If conflicting updates are issued, the [Operation][]s associated with the
+            # stale updates will not be marked as [done][Operation.done] until being
+            # obsolete.
             #
             # This feature is only available for users who have Retail Search enabled.
             # Please enable Retail Search on Cloud Console before using this feature.

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

@@ -95,6 +95,9 @@ module Google
                 channel_args: @config.channel_args,
                 interceptors: @config.interceptors
               )
+
+              # Used by an LRO wrapper for some methods of this service
+              @operations_client = self
             end
 
             # Service calls