google-cloud-retail-v2 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac1d9a4731b52436b27d039833a64947536a4d01829e67222514a50e3155319d
-  data.tar.gz: 6f48023be7da11258abc4354a2b9e413bcd095057be10ab0fe42cc2b7380bb60
+  metadata.gz: d4df763185ea268c1b76c5bd40fbf66332d5deefae96183fede94683c06f7eea
+  data.tar.gz: 1ade5fffb7896518d8ef4411b3ba02ae8225d91002ce0e59d5b340fe2cde3df5
 SHA512:
-  metadata.gz: 23f52514bc53344d461a35b5b3e726ef5099af6eb4afa04c9550c13e78db52a51964fb5fc4444db98c3e0bc54946e67e0763b7213f85c58cab6625b33ef19656
-  data.tar.gz: 72a0285df4a4304728b0b17c1bd457593631f7286dc193058db05dd448c58ef971fe5ce12fc00c5776f8313213ac82d265715e27d533fbd67878a88e14470305
+  metadata.gz: 49ef27a2292d149e7fb763b13b07f41fe1bf5af5ebde1dbcfe6ba5cbb01c9586637f05b6fbe30c4b3ba24715dd3a458a573e7a74f63254b2a676f3cbe4233d9e
+  data.tar.gz: a135a6f28d70aec5096240f03713e65c35d5ca92022ccadd142ac7cf1e90b04b659141b32b342f79b5633406b517afb064f68db0978422d982f06a964a7e2973

data/AUTHENTICATION.md

@@ -114,7 +114,7 @@ credentials are discovered.
 To configure your system for this, simply:
 
 1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
-2. Authenticate using OAuth 2.0 `$ gcloud auth login`
+2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
 3. Write code as if already authenticated.
 
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK

data/README.md

@@ -46,7 +46,7 @@ for general usage information.
 ## Enabling Logging
 
 To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
-The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
+The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
 or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
 that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
 and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.

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

@@ -21,6 +21,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :indexable_option, :enum, 5, "google.cloud.retail.v2.CatalogAttribute.IndexableOption"
       optional :dynamic_facetable_option, :enum, 6, "google.cloud.retail.v2.CatalogAttribute.DynamicFacetableOption"
       optional :searchable_option, :enum, 7, "google.cloud.retail.v2.CatalogAttribute.SearchableOption"
+      optional :exact_searchable_option, :enum, 11, "google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption"
+      optional :retrievable_option, :enum, 12, "google.cloud.retail.v2.CatalogAttribute.RetrievableOption"
     end
     add_enum "google.cloud.retail.v2.CatalogAttribute.AttributeType" do
       value :UNKNOWN, 0
@@ -42,6 +44,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :SEARCHABLE_ENABLED, 1
       value :SEARCHABLE_DISABLED, 2
     end
+    add_enum "google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption" do
+      value :EXACT_SEARCHABLE_OPTION_UNSPECIFIED, 0
+      value :EXACT_SEARCHABLE_ENABLED, 1
+      value :EXACT_SEARCHABLE_DISABLED, 2
+    end
+    add_enum "google.cloud.retail.v2.CatalogAttribute.RetrievableOption" do
+      value :RETRIEVABLE_OPTION_UNSPECIFIED, 0
+      value :RETRIEVABLE_ENABLED, 1
+      value :RETRIEVABLE_DISABLED, 2
+    end
     add_message "google.cloud.retail.v2.AttributesConfig" do
       optional :name, :string, 1
       map :catalog_attributes, :string, :message, 2, "google.cloud.retail.v2.CatalogAttribute"
@@ -78,6 +90,8 @@ module Google
         CatalogAttribute::IndexableOption = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.CatalogAttribute.IndexableOption").enummodule
         CatalogAttribute::DynamicFacetableOption = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.CatalogAttribute.DynamicFacetableOption").enummodule
         CatalogAttribute::SearchableOption = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.CatalogAttribute.SearchableOption").enummodule
+        CatalogAttribute::ExactSearchableOption = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption").enummodule
+        CatalogAttribute::RetrievableOption = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.CatalogAttribute.RetrievableOption").enummodule
         AttributesConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.AttributesConfig").msgclass
         CompletionConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.CompletionConfig").msgclass
         Catalog = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.Catalog").msgclass

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

@@ -608,7 +608,7 @@ module Google
             #
             #   @param name [::String]
             #     Required. Full CompletionConfig resource name. Format:
-            #     projects/\\{project_number}/locations/\\{location_id}/catalogs/\\{catalog_id}/completionConfig
+            #     `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/completionConfig`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Retail::V2::CompletionConfig]

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

@@ -33,7 +33,7 @@ module Google
         ##
         # Service for managing catalog configuration.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/retail/v2/catalog_service"
         #     client = ::Google::Cloud::Retail::V2::CatalogService::Client.new

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

@@ -30,7 +30,7 @@ module Google
           # Auto-completion service for retail.
           #
           # This feature is only available for users who have Retail Search enabled.
-          # Please enable Retail Search on Cloud Console before using this feature.
+          # Enable Retail Search on Cloud Console before using this feature.
           #
           class Client
             include Paths
@@ -169,7 +169,7 @@ module Google
             # Completes the specified prefix with keyword suggestions.
             #
             # This feature is only available for users who have Retail Search enabled.
-            # Please enable Retail Search on Cloud Console before using this feature.
+            # Enable Retail Search on Cloud Console before using this feature.
             #
             # @overload complete_query(request, options = nil)
             #   Pass arguments to `complete_query` via a request object, either of type
@@ -214,8 +214,10 @@ module Google
             #     Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum
             #     number of language codes is 3.
             #   @param device_type [::String]
-            #     The device type context for completion suggestions.
-            #     It is useful to apply different suggestions on different device types, e.g.
+            #     The device type context for completion suggestions. We recommend that you
+            #     leave this field empty.
+            #
+            #     It can apply different suggestions on different device types, e.g.
             #     `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
             #     types.
             #
@@ -323,7 +325,7 @@ module Google
             # are indexed successfully and ready for serving. The process takes hours.
             #
             # This feature is only available for users who have Retail Search enabled.
-            # Please enable Retail Search on Cloud Console before using this feature.
+            # Enable Retail Search on Cloud Console before using this feature.
             #
             # @overload import_completion_data(request, options = nil)
             #   Pass arguments to `import_completion_data` via a request object, either of type

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

@@ -35,9 +35,9 @@ module Google
         # Auto-completion service for retail.
         #
         # This feature is only available for users who have Retail Search enabled.
-        # Please enable Retail Search on Cloud Console before using this feature.
+        # Enable Retail Search on Cloud Console before using this feature.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/retail/v2/completion_service"
         #     client = ::Google::Cloud::Retail::V2::CompletionService::Client.new

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

@@ -27,7 +27,7 @@ module Google
           # Auto-completion service for retail.
           #
           # This feature is only available for users who have Retail Search enabled.
-          # Please enable Retail Search on Cloud Console before using this feature.
+          # Enable Retail Search on Cloud Console before using this feature.
           class Service
 
             include ::GRPC::GenericService
@@ -39,7 +39,7 @@ module Google
             # Completes the specified prefix with keyword suggestions.
             #
             # This feature is only available for users who have Retail Search enabled.
-            # Please enable Retail Search on Cloud Console before using this feature.
+            # Enable Retail Search on Cloud Console before using this feature.
             rpc :CompleteQuery, ::Google::Cloud::Retail::V2::CompleteQueryRequest, ::Google::Cloud::Retail::V2::CompleteQueryResponse
             # Bulk import of processed completion dataset.
             #
@@ -49,7 +49,7 @@ module Google
             # are indexed successfully and ready for serving. The process takes hours.
             #
             # This feature is only available for users who have Retail Search enabled.
-            # Please enable Retail Search on Cloud Console before using this feature.
+            # Enable Retail Search on Cloud Console before using this feature.
             rpc :ImportCompletionData, ::Google::Cloud::Retail::V2::ImportCompletionDataRequest, ::Google::Longrunning::Operation
           end
 

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

@@ -33,7 +33,7 @@ module Google
         ##
         # Service for modifying Control.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/retail/v2/control_service"
         #     client = ::Google::Cloud::Retail::V2::ControlService::Client.new

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

@@ -177,7 +177,7 @@ module Google
             #     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]
+            #     [Manage serving configs]
             #     (https://cloud.google.com/retail/docs/manage-configs).
             #
             #     The full list of available serving configs can be seen at
@@ -228,12 +228,11 @@ module Google
             #      * filterOutOfStockItems  tag=(-"promotional")
             #      * filterOutOfStockItems
             #
-            #     If your filter blocks all prediction results, the API will return generic
-            #     (unfiltered) popular products. If you only want results strictly matching
-            #     the filters, set `strictFiltering` to True in `PredictRequest.params` to
-            #     receive empty results instead.
-            #     Note that the API will never return items with storageStatus of "EXPIRED"
-            #     or "DELETED" regardless of filter choices.
+            #     If your filter blocks all prediction results, the API will return *no*
+            #     results. If instead you want empty result sets to return generic
+            #     (unfiltered) popular products, set `strictFiltering` to False in
+            #     `PredictRequest.params`. 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
@@ -258,7 +257,7 @@ module Google
             #     * `returnScore`: Boolean. If set to true, the prediction 'score'
             #        corresponding to each returned product will be set in the
             #        `results.metadata` field in the prediction response. The given
-            #        'score' indicates the probability of an product being clicked/purchased
+            #        'score' indicates the probability of a product being clicked/purchased
             #        given the user's context and history.
             #     * `strictFiltering`: Boolean. True by default. If set to false, the service
             #        will return generic (unfiltered) popular products instead of empty if

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

@@ -33,7 +33,7 @@ module Google
         ##
         # Service for making recommendation prediction.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/retail/v2/prediction_service"
         #     client = ::Google::Cloud::Retail::V2::PredictionService::Client.new

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

@@ -6,6 +6,7 @@ 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/user_event_pb'
 require 'google/protobuf/struct_pb'
 

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

@@ -880,9 +880,9 @@ module Google
             #
             # 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
+            # fulfillment information. If the request is valid, the update is 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 ProductService.GetProduct}
             # or
@@ -892,10 +892,10 @@ module Google
             # {::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)
+            # the specified inventory field value(s) 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
+            # update times for the specified inventory fields are overwritten by the
+            # times of the
             # {::Google::Cloud::Retail::V2::ProductService::Client#create_product ProductService.CreateProduct}
             # or
             # {::Google::Cloud::Retail::V2::ProductService::Client#update_product ProductService.UpdateProduct}
@@ -903,11 +903,11 @@ module Google
             #
             # 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.
+            # then any pre-existing inventory information for this product is used.
             #
             # If no inventory fields are set in
             # {::Google::Cloud::Retail::V2::SetInventoryRequest#set_mask SetInventoryRequest.set_mask},
-            # then any existing inventory information will be preserved.
+            # then any existing inventory information is preserved.
             #
             # Pre-existing inventory information can only be updated with
             # {::Google::Cloud::Retail::V2::ProductService::Client#set_inventory ProductService.SetInventory},
@@ -915,15 +915,17 @@ module Google
             # and
             # {::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.
+            # The returned {::Google::Longrunning::Operation Operation}s is obsolete after
+            # one day, and the GetOperation
+            # API returns `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.
+            # If conflicting updates are issued, the
+            # {::Google::Longrunning::Operation Operation}s associated with the stale
+            # updates are not marked as {::Google::Longrunning::Operation#done done} until
+            # they are obsolete.
             #
             # This feature is only available for users who have Retail Search enabled.
-            # Please enable Retail Search on Cloud Console before using this feature.
+            # Enable Retail Search on Cloud Console before using this feature.
             #
             # @overload set_inventory(request, options = nil)
             #   Pass arguments to `set_inventory` via a request object, either of type
@@ -1105,15 +1107,17 @@ module Google
             # 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.
+            # The returned {::Google::Longrunning::Operation 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.
+            # If conflicting updates are issued, the
+            # {::Google::Longrunning::Operation Operation}s associated with the stale
+            # updates will not be marked as {::Google::Longrunning::Operation#done 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.
+            # Enable Retail Search on Cloud Console before using this feature.
             #
             # @overload add_fulfillment_places(request, options = nil)
             #   Pass arguments to `add_fulfillment_places` via a request object, either of type
@@ -1273,15 +1277,17 @@ module Google
             # 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.
+            # The returned {::Google::Longrunning::Operation 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.
+            # If conflicting updates are issued, the
+            # {::Google::Longrunning::Operation Operation}s associated with the stale
+            # updates will not be marked as {::Google::Longrunning::Operation#done 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.
+            # Enable Retail Search on Cloud Console before using this feature.
             #
             # @overload remove_fulfillment_places(request, options = nil)
             #   Pass arguments to `remove_fulfillment_places` via a request object, either of type
@@ -1443,15 +1449,17 @@ module Google
             # {::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.
+            # The returned {::Google::Longrunning::Operation 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.
+            # If conflicting updates are issued, the
+            # {::Google::Longrunning::Operation Operation}s associated with the stale
+            # updates will not be marked as {::Google::Longrunning::Operation#done 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.
+            # Enable Retail Search on Cloud Console before using this feature.
             #
             # @overload add_local_inventories(request, options = nil)
             #   Pass arguments to `add_local_inventories` via a request object, either of type
@@ -1598,15 +1606,17 @@ module Google
             # {::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.
+            # The returned {::Google::Longrunning::Operation 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.
+            # If conflicting updates are issued, the
+            # {::Google::Longrunning::Operation Operation}s associated with the stale
+            # updates will not be marked as {::Google::Longrunning::Operation#done 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.
+            # Enable Retail Search on Cloud Console before using this feature.
             #
             # @overload remove_local_inventories(request, options = nil)
             #   Pass arguments to `remove_local_inventories` via a request object, either of type

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

@@ -35,7 +35,7 @@ module Google
         # Service for ingesting {::Google::Cloud::Retail::V2::Product Product} information
         # of the customer's website.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/retail/v2/product_service"
         #     client = ::Google::Cloud::Retail::V2::ProductService::Client.new

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

@@ -58,9 +58,9 @@ module Google
             #
             # This process is asynchronous and does not require the
             # [Product][google.cloud.retail.v2.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
+            # fulfillment information. If the request is valid, the update is enqueued
+            # and processed downstream. As a consequence, when a response is returned,
+            # updates are not immediately manifested in the
             # [Product][google.cloud.retail.v2.Product] queried by
             # [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct]
             # or
@@ -70,10 +70,10 @@ module Google
             # [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct]
             # and
             # [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct],
-            # the specified inventory field value(s) will overwrite any existing value(s)
+            # the specified inventory field value(s) 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
+            # update times for the specified inventory fields are overwritten by the
+            # times of the
             # [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct]
             # or
             # [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct]
@@ -81,11 +81,11 @@ module Google
             #
             # If no inventory fields are set in
             # [CreateProductRequest.product][google.cloud.retail.v2.CreateProductRequest.product],
-            # then any pre-existing inventory information for this product will be used.
+            # then any pre-existing inventory information for this product is used.
             #
             # If no inventory fields are set in
             # [SetInventoryRequest.set_mask][google.cloud.retail.v2.SetInventoryRequest.set_mask],
-            # then any existing inventory information will be preserved.
+            # then any existing inventory information is preserved.
             #
             # Pre-existing inventory information can only be updated with
             # [ProductService.SetInventory][google.cloud.retail.v2.ProductService.SetInventory],
@@ -93,15 +93,17 @@ module Google
             # and
             # [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2.ProductService.RemoveFulfillmentPlaces].
             #
-            # The returned [Operation][]s will be obsolete after 1 day, and
-            # [GetOperation][] API will return NOT_FOUND afterwards.
+            # The returned [Operation][google.longrunning.Operation]s is obsolete after
+            # one day, and the [GetOperation][google.longrunning.Operations.GetOperation]
+            # API returns `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.
+            # If conflicting updates are issued, the
+            # [Operation][google.longrunning.Operation]s associated with the stale
+            # updates are not marked as [done][google.longrunning.Operation.done] until
+            # they are obsolete.
             #
             # This feature is only available for users who have Retail Search enabled.
-            # Please enable Retail Search on Cloud Console before using this feature.
+            # Enable Retail Search on Cloud Console before using this feature.
             rpc :SetInventory, ::Google::Cloud::Retail::V2::SetInventoryRequest, ::Google::Longrunning::Operation
             # Incrementally adds place IDs to
             # [Product.fulfillment_info.place_ids][google.cloud.retail.v2.FulfillmentInfo.place_ids].
@@ -116,15 +118,17 @@ module Google
             # or
             # [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
             #
-            # The returned [Operation][]s will be obsolete after 1 day, and
-            # [GetOperation][] API will return NOT_FOUND afterwards.
+            # The returned [Operation][google.longrunning.Operation]s will be obsolete
+            # after 1 day, and [GetOperation][google.longrunning.Operations.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.
+            # If conflicting updates are issued, the
+            # [Operation][google.longrunning.Operation]s associated with the stale
+            # updates will not be marked as [done][google.longrunning.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.
+            # Enable Retail Search on Cloud Console before using this feature.
             rpc :AddFulfillmentPlaces, ::Google::Cloud::Retail::V2::AddFulfillmentPlacesRequest, ::Google::Longrunning::Operation
             # Incrementally removes place IDs from a
             # [Product.fulfillment_info.place_ids][google.cloud.retail.v2.FulfillmentInfo.place_ids].
@@ -139,15 +143,17 @@ module Google
             # or
             # [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
             #
-            # The returned [Operation][]s will be obsolete after 1 day, and
-            # [GetOperation][] API will return NOT_FOUND afterwards.
+            # The returned [Operation][google.longrunning.Operation]s will be obsolete
+            # after 1 day, and [GetOperation][google.longrunning.Operations.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.
+            # If conflicting updates are issued, the
+            # [Operation][google.longrunning.Operation]s associated with the stale
+            # updates will not be marked as [done][google.longrunning.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.
+            # Enable Retail Search on Cloud Console before using this feature.
             rpc :RemoveFulfillmentPlaces, ::Google::Cloud::Retail::V2::RemoveFulfillmentPlacesRequest, ::Google::Longrunning::Operation
             # Updates local inventory information for a
             # [Product][google.cloud.retail.v2.Product] at a list of places, while
@@ -169,15 +175,17 @@ module Google
             # [ProductService.UpdateProduct][google.cloud.retail.v2.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.
+            # The returned [Operation][google.longrunning.Operation]s will be obsolete
+            # after 1 day, and [GetOperation][google.longrunning.Operations.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.
+            # If conflicting updates are issued, the
+            # [Operation][google.longrunning.Operation]s associated with the stale
+            # updates will not be marked as [done][google.longrunning.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.
+            # Enable Retail Search on Cloud Console before using this feature.
             rpc :AddLocalInventories, ::Google::Cloud::Retail::V2::AddLocalInventoriesRequest, ::Google::Longrunning::Operation
             # Remove local inventory information for a
             # [Product][google.cloud.retail.v2.Product] at a list of places at a removal
@@ -197,15 +205,17 @@ module Google
             # [ProductService.UpdateProduct][google.cloud.retail.v2.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.
+            # The returned [Operation][google.longrunning.Operation]s will be obsolete
+            # after 1 day, and [GetOperation][google.longrunning.Operations.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.
+            # If conflicting updates are issued, the
+            # [Operation][google.longrunning.Operation]s associated with the stale
+            # updates will not be marked as [done][google.longrunning.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.
+            # Enable Retail Search on Cloud Console before using this feature.
             rpc :RemoveLocalInventories, ::Google::Cloud::Retail::V2::RemoveLocalInventoriesRequest, ::Google::Longrunning::Operation
           end
 

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

@@ -30,7 +30,7 @@ module Google
           # Service for search.
           #
           # This feature is only available for users who have Retail Search enabled.
-          # Please enable Retail Search on Cloud Console before using this feature.
+          # Enable Retail Search on Cloud Console before using this feature.
           #
           class Client
             include Paths
@@ -156,7 +156,7 @@ module Google
             # Performs a search.
             #
             # This feature is only available for users who have Retail Search enabled.
-            # Please enable Retail Search on Cloud Console before using this feature.
+            # Enable Retail Search on Cloud Console before using this feature.
             #
             # @overload search(request, options = nil)
             #   Pass arguments to `search` via a request object, either of type
@@ -178,7 +178,7 @@ module Google
             #     `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
             #     or the name of the legacy placement resource, such as
             #     `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-            #     This field is used to identify the serving configuration name and the set
+            #     This field is used to identify the serving config name and the set
             #     of models that will be used to make the search.
             #   @param branch [::String]
             #     The branch resource name, such as
@@ -363,7 +363,7 @@ module Google
             #     {::Google::Cloud::Retail::V2::UserEvent#page_categories UserEvent.page_categories};
             #
             #     To represent full path of category, use '>' sign to separate different
-            #     hierarchies. If '>' is part of the category name, please replace it with
+            #     hierarchies. If '>' is part of the category name, replace it with
             #     other character(s).
             #
             #     Category pages include special pages such as sales or promotions. For

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

@@ -34,9 +34,9 @@ module Google
         # Service for search.
         #
         # This feature is only available for users who have Retail Search enabled.
-        # Please enable Retail Search on Cloud Console before using this feature.
+        # Enable Retail Search on Cloud Console before using this feature.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/retail/v2/search_service"
         #     client = ::Google::Cloud::Retail::V2::SearchService::Client.new