google-cloud-retail-v2 0.11.0 → 0.13.0

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

@@ -18,6 +18,7 @@
 
 require "google/cloud/errors"
 require "google/cloud/retail/v2/product_service_pb"
+require "google/cloud/location"
 
 module Google
   module Cloud
@@ -150,6 +151,12 @@ module Google
                 config.endpoint = @config.endpoint
               end
 
+              @location_client = Google::Cloud::Location::Locations::Client.new do |config|
+                config.credentials = credentials
+                config.quota_project = @quota_project_id
+                config.endpoint = @config.endpoint
+              end
+
               @product_service_stub = ::Gapic::ServiceStub.new(
                 ::Google::Cloud::Retail::V2::ProductService::Stub,
                 credentials:  credentials,
@@ -166,6 +173,13 @@ module Google
             #
             attr_reader :operations_client
 
+            ##
+            # Get the associated client for mix-in of the Locations.
+            #
+            # @return [Google::Cloud::Location::Locations::Client]
+            #
+            attr_reader :location_client
+
             # Service calls
 
             ##
@@ -478,13 +492,11 @@ module Google
             #   # Call the list_products method.
             #   result = client.list_products request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::Retail::V2::Product.
-            #     p response
+            #     p item
             #   end
             #
             def list_products request, options = nil
@@ -821,14 +833,14 @@ module Google
             #   # Call the import_products method.
             #   result = client.import_products request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def import_products request, options = nil
@@ -880,9 +892,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 +904,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 +915,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 +927,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
@@ -1039,14 +1053,14 @@ module Google
             #   # Call the set_inventory method.
             #   result = client.set_inventory request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def set_inventory request, options = nil
@@ -1105,15 +1119,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
@@ -1207,14 +1223,14 @@ module Google
             #   # Call the add_fulfillment_places method.
             #   result = client.add_fulfillment_places request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def add_fulfillment_places request, options = nil
@@ -1273,15 +1289,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
@@ -1370,14 +1388,14 @@ module Google
             #   # Call the remove_fulfillment_places method.
             #   result = client.remove_fulfillment_places request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def remove_fulfillment_places request, options = nil
@@ -1443,15 +1461,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
@@ -1527,14 +1547,14 @@ module Google
             #   # Call the add_local_inventories method.
             #   result = client.add_local_inventories request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def add_local_inventories request, options = nil
@@ -1598,15 +1618,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
@@ -1666,14 +1688,14 @@ module Google
             #   # Call the remove_local_inventories method.
             #   result = client.remove_local_inventories request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def remove_local_inventories request, options = nil

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

@@ -158,13 +158,11 @@ module Google
             #   # Call the list_operations method.
             #   result = client.list_operations request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Longrunning::Operation.
-            #     p response
+            #     p item
             #   end
             #
             def list_operations request, options = nil
@@ -253,14 +251,14 @@ module Google
             #   # Call the get_operation method.
             #   result = client.get_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def get_operation request, options = nil
@@ -540,14 +538,14 @@ module Google
             #   # Call the wait_operation method.
             #   result = client.wait_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def wait_operation request, options = nil

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

@@ -18,6 +18,7 @@
 
 require "google/cloud/errors"
 require "google/cloud/retail/v2/search_service_pb"
+require "google/cloud/location"
 
 module Google
   module Cloud
@@ -30,7 +31,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
@@ -141,6 +142,12 @@ module Google
               @quota_project_id = @config.quota_project
               @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
 
+              @location_client = Google::Cloud::Location::Locations::Client.new do |config|
+                config.credentials = credentials
+                config.quota_project = @quota_project_id
+                config.endpoint = @config.endpoint
+              end
+
               @search_service_stub = ::Gapic::ServiceStub.new(
                 ::Google::Cloud::Retail::V2::SearchService::Stub,
                 credentials:  credentials,
@@ -150,13 +157,20 @@ module Google
               )
             end
 
+            ##
+            # Get the associated client for mix-in of the Locations.
+            #
+            # @return [Google::Cloud::Location::Locations::Client]
+            #
+            attr_reader :location_client
+
             # Service calls
 
             ##
             # 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 +192,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 +377,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
@@ -425,13 +439,11 @@ module Google
             #   # Call the search method.
             #   result = client.search request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::Retail::V2::SearchResponse::SearchResult.
-            #     p response
+            #     p item
             #   end
             #
             def search request, options = nil