google-cloud-retail-v2 0.8.0 → 0.11.0

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

@@ -0,0 +1,122 @@
+# 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
+        # Request for CreateControl method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Full resource name of parent catalog. Format:
+        #     `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
+        # @!attribute [rw] control
+        #   @return [::Google::Cloud::Retail::V2::Control]
+        #     Required. The Control to create.
+        # @!attribute [rw] control_id
+        #   @return [::String]
+        #     Required. The ID to use for the Control, which will become the final
+        #     component of the Control's resource name.
+        #
+        #     This value should be 4-63 characters, and valid characters
+        #     are /[a-z][0-9]-_/.
+        class CreateControlRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for UpdateControl method.
+        # @!attribute [rw] control
+        #   @return [::Google::Cloud::Retail::V2::Control]
+        #     Required. The Control to update.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Indicates which fields in the provided
+        #     {::Google::Cloud::Retail::V2::Control Control} to update. The following are NOT
+        #     supported:
+        #
+        #     * {::Google::Cloud::Retail::V2::Control#name Control.name}
+        #
+        #     If not set or empty, all supported fields are updated.
+        class UpdateControlRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for DeleteControl method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the Control to delete. Format:
+        #     `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}`
+        class DeleteControlRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for GetControl method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the Control to get. Format:
+        #     `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}`
+        class GetControlRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for ListControls method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The catalog resource name. Format:
+        #     `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. Maximum number of results to return. If unspecified, defaults
+        #     to 50. Max allowed value is 1000.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A page token, received from a previous `ListControls` call.
+        #     Provide this to retrieve the subsequent page.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. A filter to apply on the list results. Supported features:
+        #
+        #     * List all the products under the parent branch if
+        #     {::Google::Cloud::Retail::V2::ListControlsRequest#filter filter} is unset.
+        #     * List controls that are used in a single ServingConfig:
+        #         'serving_config = "boosted_home_page_cvr"'
+        class ListControlsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response for ListControls method.
+        # @!attribute [rw] controls
+        #   @return [::Array<::Google::Cloud::Retail::V2::Control>]
+        #     All the Controls for a given catalog.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     Pagination token, if not returned indicates the last page.
+        class ListControlsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/retail/v2/import_config.rb

@@ -22,7 +22,6 @@ module Google
     module Retail
       module V2
         # Google Cloud Storage location for input content.
-        # format.
         # @!attribute [rw] input_uris
         #   @return [::Array<::String>]
         #     Required. Google Cloud Storage URIs to input files. URI can be up to
@@ -54,11 +53,13 @@ module Google
         #
         #     Supported values for control imports:
         #
-        #     * 'control' (default): One JSON [Control][] per line.
+        #     * `control` (default): One JSON {::Google::Cloud::Retail::V2::Control Control}
+        #     per line.
         #
         #     Supported values for catalog attribute imports:
         #
-        #     * 'catalog_attribute' (default): One CSV [CatalogAttribute][] per line.
+        #     * `catalog_attribute` (default): One CSV
+        #     {::Google::Cloud::Retail::V2::CatalogAttribute CatalogAttribute} per line.
         class GcsSource
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -69,9 +70,8 @@ module Google
         #   @return [::Google::Type::Date]
         #     BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
         #
-        #     Only supported when
-        #     {::Google::Cloud::Retail::V2::ImportProductsRequest#reconciliation_mode ImportProductsRequest.reconciliation_mode}
-        #     is set to `FULL`.
+        #     Only supported in
+        #     {::Google::Cloud::Retail::V2::ImportProductsRequest ImportProductsRequest}.
         # @!attribute [rw] project_id
         #   @return [::String]
         #     The project ID (can be project # or ID) that the BigQuery source is in with
@@ -109,8 +109,7 @@ module Google
         #     * `user_event_ga360`:
         #       The schema is available here:
         #       https://support.google.com/analytics/answer/3437719.
-        #     * `user_event_ga4`: This feature is in private preview. Please contact the
-        #       support team for importing Google Analytics 4 events.
+        #     * `user_event_ga4`:
         #       The schema is available here:
         #       https://support.google.com/analytics/answer/7029846.
         #
@@ -148,7 +147,7 @@ module Google
         # @!attribute [rw] gcs_prefix
         #   @return [::String]
         #     Google Cloud Storage prefix for import errors. This must be an empty,
-        #     existing Cloud Storage directory. Import errors will be written to
+        #     existing Cloud Storage directory. Import errors are written to
         #     sharded files in this directory, one per line, as a JSON-encoded
         #     `google.rpc.Status` message.
         class ImportErrorsConfig
@@ -175,8 +174,8 @@ module Google
         #     The desired location of errors incurred during the Import.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
-        #     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.
         # @!attribute [rw] reconciliation_mode
         #   @return [::Google::Cloud::Retail::V2::ImportProductsRequest::ReconciliationMode]
         #     The mode of reconciliation between existing products and the products to be
@@ -185,21 +184,16 @@ module Google
         # @!attribute [rw] notification_pubsub_topic
         #   @return [::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.
         class ImportProductsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -215,15 +209,6 @@ module Google
 
             # Calculates diff and replaces the entire product dataset. Existing
             # products may be deleted if they are not present in the source location.
-            #
-            # Can only be set while using
-            # {::Google::Cloud::Retail::V2::BigQuerySource BigQuerySource}. And the BigQuery
-            # dataset must be created in the data location "us (multiple regions in
-            # United States)", otherwise a PERMISSION_DENIED error is thrown.
-            #
-            # Add the IAM permission "BigQuery Data Viewer" for
-            # cloud-retail-customer-data-access@system.gserviceaccount.com before
-            # using this feature otherwise an error is thrown.
             FULL = 2
           end
         end
@@ -256,8 +241,8 @@ module Google
         # @!attribute [rw] notification_pubsub_topic
         #   @return [::String]
         #     Pub/Sub topic for receiving notification. If this field is set,
-        #     when the import is finished, a notification will be sent to
-        #     specified Pub/Sub topic. The message data will be JSON string of a
+        #     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}`.
         class ImportCompletionDataRequest
@@ -308,7 +293,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Metadata related to the progress of the Import operation. This will be
+        # Metadata related to the progress of the Import operation. This is
         # returned by the google.longrunning.Operation.metadata field.
         # @!attribute [rw] create_time
         #   @return [::Google::Protobuf::Timestamp]
@@ -329,8 +314,8 @@ module Google
         # @!attribute [rw] notification_pubsub_topic
         #   @return [::String]
         #     Pub/Sub topic for receiving notification. If this field is set,
-        #     when the import is finished, a notification will be sent to
-        #     specified Pub/Sub topic. The message data will be JSON string of a
+        #     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}`.
         class ImportMetadata

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

@@ -25,14 +25,19 @@ module Google
         # @!attribute [rw] placement
         #   @return [::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).
+        #     `{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 placements can be seen at
-        #     https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements
+        #     The full list of available serving configs can be seen at
+        #     https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
         # @!attribute [rw] user_event
         #   @return [::Google::Cloud::Retail::V2::UserEvent]
         #     Required. Context about the user, what they are looking at and what action
@@ -51,13 +56,13 @@ module Google
         #     {::Google::Cloud::Retail::V2::UserInfo#user_id UserInfo.user_id} unset.
         # @!attribute [rw] page_size
         #   @return [::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.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     The previous PredictResponse.next_page_token.
+        #     This field is not used; leave it unset.
         # @!attribute [rw] filter
         #   @return [::String]
         #     Filter for restricting prediction results with a length limit of 5,000
@@ -89,6 +94,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"))
         # @!attribute [rw] validate_only
         #   @return [::Boolean]
         #     Use validate only mode for this prediction query. If set to true, a
@@ -122,6 +135,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.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     The labels applied to a resource must meet the following requirements:

data/proto_docs/google/cloud/retail/v2/product.rb

@@ -114,7 +114,7 @@ module Google
         #     Non-existent product ids are allowed.
         #     The {::Google::Cloud::Retail::V2::Product#type type} of the members must be
         #     either {::Google::Cloud::Retail::V2::Product::Type::PRIMARY Type.PRIMARY} or
-        #     {::Google::Cloud::Retail::V2::Product::Type::VARIANT Type.VARIANT} otherwise and
+        #     {::Google::Cloud::Retail::V2::Product::Type::VARIANT Type.VARIANT} otherwise an
         #     INVALID_ARGUMENT error is thrown. Should not set it for other types. A
         #     maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
         #     return.
@@ -474,6 +474,12 @@ module Google
         #     Note: This field is OUTPUT_ONLY for
         #     {::Google::Cloud::Retail::V2::ProductService::Client#get_product ProductService.GetProduct}.
         #     Do not set this field in API requests.
+        # @!attribute [r] local_inventories
+        #   @return [::Array<::Google::Cloud::Retail::V2::LocalInventory>]
+        #     Output only. A list of local inventories specific to different places.
+        #
+        #     This is only available for users who have Retail Search enabled, and it can
+        #     be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
         class Product
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -21,7 +21,9 @@ module Google
   module Cloud
     module Retail
       module V2
-        # Request message for [CreateProduct][] method.
+        # Request message for
+        # {::Google::Cloud::Retail::V2::ProductService::Client#create_product ProductService.CreateProduct}
+        # method.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The parent catalog resource name, such as
@@ -51,7 +53,9 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Request message for [GetProduct][] method.
+        # Request message for
+        # {::Google::Cloud::Retail::V2::ProductService::Client#get_product ProductService.GetProduct}
+        # method.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. Full resource name of {::Google::Cloud::Retail::V2::Product Product},
@@ -69,7 +73,9 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Request message for [UpdateProduct][] method.
+        # Request message for
+        # {::Google::Cloud::Retail::V2::ProductService::Client#update_product ProductService.UpdateProduct}
+        # method.
         # @!attribute [rw] product
         #   @return [::Google::Cloud::Retail::V2::Product]
         #     Required. The product to update/create.
@@ -106,7 +112,9 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Request message for [DeleteProduct][] method.
+        # Request message for
+        # {::Google::Cloud::Retail::V2::ProductService::Client#delete_product ProductService.DeleteProduct}
+        # method.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. Full resource name of {::Google::Cloud::Retail::V2::Product Product},
@@ -238,11 +246,14 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Request message for [SetInventory][] method.
+        # Request message for
+        # {::Google::Cloud::Retail::V2::ProductService::Client#set_inventory ProductService.SetInventory}
+        # method.
         # @!attribute [rw] inventory
         #   @return [::Google::Cloud::Retail::V2::Product]
         #     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}
@@ -250,8 +261,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
@@ -274,7 +286,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:
@@ -282,9 +295,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}
@@ -293,7 +306,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.
         # @!attribute [rw] set_mask
         #   @return [::Google::Protobuf::FieldMask]
         #     Indicates which inventory fields in the provided
@@ -323,14 +338,16 @@ module Google
 
         # Metadata related to the progress of the SetInventory operation.
         # Currently empty because there is no meaningful metadata populated from the
-        # [SetInventory][] method.
+        # {::Google::Cloud::Retail::V2::ProductService::Client#set_inventory ProductService.SetInventory}
+        # method.
         class SetInventoryMetadata
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
         # Response of the SetInventoryRequest.  Currently empty because
-        # there is no meaningful response populated from the [SetInventory][]
+        # there is no meaningful response populated from the
+        # {::Google::Cloud::Retail::V2::ProductService::Client#set_inventory ProductService.SetInventory}
         # method.
         class SetInventoryResponse
           include ::Google::Protobuf::MessageExts
@@ -369,7 +386,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}.
         # @!attribute [rw] place_ids
         #   @return [::Array<::String>]
         #     Required. The IDs for this
@@ -494,7 +512,9 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Request message for [RemoveLocalInventories][] method.
+        # Request message for
+        # {::Google::Cloud::Retail::V2::ProductService::Client#remove_local_inventories ProductService.RemoveLocalInventories}
+        # method.
         # @!attribute [rw] product
         #   @return [::String]
         #     Required. Full resource name of {::Google::Cloud::Retail::V2::Product Product},
@@ -528,21 +548,27 @@ module Google
 
         # Metadata related to the progress of the RemoveLocalInventories operation.
         # Currently empty because there is no meaningful metadata populated from the
-        # [RemoveLocalInventories][] method.
+        # {::Google::Cloud::Retail::V2::ProductService::Client#remove_local_inventories ProductService.RemoveLocalInventories}
+        # method.
         class RemoveLocalInventoriesMetadata
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Response of the [RemoveLocalInventories][] API.  Currently empty because
-        # there is no meaningful response populated from the [RemoveLocalInventories][]
+        # Response of the
+        # {::Google::Cloud::Retail::V2::ProductService::Client#remove_local_inventories ProductService.RemoveLocalInventories}
+        # API.  Currently empty because there is no meaningful response populated from
+        # the
+        # {::Google::Cloud::Retail::V2::ProductService::Client#remove_local_inventories ProductService.RemoveLocalInventories}
         # method.
         class RemoveLocalInventoriesResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Request message for [RemoveFulfillmentPlaces][] method.
+        # Request message for
+        # {::Google::Cloud::Retail::V2::ProductService::Client#remove_fulfillment_places ProductService.RemoveFulfillmentPlaces}
+        # method.
         # @!attribute [rw] product
         #   @return [::String]
         #     Required. Full resource name of {::Google::Cloud::Retail::V2::Product Product},
@@ -606,14 +632,16 @@ module Google
 
         # Metadata related to the progress of the RemoveFulfillmentPlaces operation.
         # Currently empty because there is no meaningful metadata populated from the
-        # [RemoveFulfillmentPlaces][] method.
+        # {::Google::Cloud::Retail::V2::ProductService::Client#remove_fulfillment_places ProductService.RemoveFulfillmentPlaces}
+        # method.
         class RemoveFulfillmentPlacesMetadata
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
         # Response of the RemoveFulfillmentPlacesRequest. Currently empty because there
-        # is no meaningful response populated from the [RemoveFulfillmentPlaces][]
+        # is no meaningful response populated from the
+        # {::Google::Cloud::Retail::V2::ProductService::Client#remove_fulfillment_places ProductService.RemoveFulfillmentPlaces}
         # method.
         class RemoveFulfillmentPlacesResponse
           include ::Google::Protobuf::MessageExts