google-cloud-retail-v2 0.8.0 → 0.11.0

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

@@ -25,7 +25,9 @@ module Google
         # {::Google::Cloud::Retail::V2::SearchService::Client#search SearchService.Search} method.
         # @!attribute [rw] placement
         #   @return [::String]
-        #     Required. The resource name of the search engine placement, such as
+        #     Required. The resource name of the Retail Search serving config, such as
+        #     `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
         #     of models that will be used to make the search.
@@ -136,7 +138,9 @@ module Google
         #     Boost specification to boost certain products. See more details at this
         #     [user guide](https://cloud.google.com/retail/docs/boosting).
         #
-        #     Notice that if both [ServingConfig.boost_control_ids][] and
+        #     Notice that if both
+        #     {::Google::Cloud::Retail::V2::ServingConfig#boost_control_ids ServingConfig.boost_control_ids}
+        #     and
         #     {::Google::Cloud::Retail::V2::SearchRequest#boost_spec SearchRequest.boost_spec}
         #     are set, the boost conditions from both places are evaluated. If a search
         #     request matches multiple boost conditions, the final boost score is equal
@@ -239,6 +243,15 @@ module Google
         # @!attribute [rw] personalization_spec
         #   @return [::Google::Cloud::Retail::V2::SearchRequest::PersonalizationSpec]
         #     The specification for personalization.
+        #
+        #     Notice that if both
+        #     {::Google::Cloud::Retail::V2::ServingConfig#personalization_spec ServingConfig.personalization_spec}
+        #     and
+        #     {::Google::Cloud::Retail::V2::SearchRequest#personalization_spec SearchRequest.personalization_spec}
+        #     are set.
+        #     {::Google::Cloud::Retail::V2::SearchRequest#personalization_spec SearchRequest.personalization_spec}
+        #     will override
+        #     {::Google::Cloud::Retail::V2::ServingConfig#personalization_spec ServingConfig.personalization_spec}.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     The labels applied to a resource must meet the following requirements:
@@ -431,16 +444,24 @@ module Google
             #     "Women > Dress" and "Men > Shoe". If set "contains" to "Shoe", the
             #     "categories" facet will give only "Women > Shoe" and "Men > Shoe".
             #     Only supported on textual fields. Maximum is 10.
+            # @!attribute [rw] case_insensitive
+            #   @return [::Boolean]
+            #     True to make facet keys case insensitive when getting faceting
+            #     values with prefixes or contains; false otherwise.
             # @!attribute [rw] order_by
             #   @return [::String]
-            #     The order in which [Facet.values][] are returned.
+            #     The order in which
+            #     {::Google::Cloud::Retail::V2::SearchResponse::Facet#values SearchResponse.Facet.values}
+            #     are returned.
             #
             #     Allowed values are:
             #
-            #     * "count desc", which means order by [Facet.FacetValue.count][]
+            #     * "count desc", which means order by
+            #     {::Google::Cloud::Retail::V2::SearchResponse::Facet::FacetValue#count SearchResponse.Facet.values.count}
             #     descending.
             #
-            #     * "value desc", which means order by [Facet.FacetValue.value][]
+            #     * "value desc", which means order by
+            #     {::Google::Cloud::Retail::V2::SearchResponse::Facet::FacetValue#value SearchResponse.Facet.values.value}
             #     descending.
             #       Only applies to textual facets.
             #
@@ -461,9 +482,11 @@ module Google
             #     {::Google::Cloud::Retail::V2::SearchRequest::FacetSpec::FacetKey#key FacetKey.key}
             #     when query is specified.
             #
-            #     In the response, [FacetValue.value][] will be always "1" and
-            #     [FacetValue.count][] will be the number of results that matches the
-            #     query.
+            #     In the response,
+            #     {::Google::Cloud::Retail::V2::SearchResponse::Facet::FacetValue#value SearchResponse.Facet.values.value}
+            #     will be always "1" and
+            #     {::Google::Cloud::Retail::V2::SearchResponse::Facet::FacetValue#count SearchResponse.Facet.values.count}
+            #     will be the number of results that match the query.
             #
             #     For example, you can set a customized facet for "shipToStore",
             #     where
@@ -473,6 +496,10 @@ module Google
             #     is "availability: ANY(\"IN_STOCK\") AND shipToStore: ANY(\"123\")".
             #     Then the facet will count the products that are both in stock and ship
             #     to store "123".
+            # @!attribute [rw] return_min_max
+            #   @return [::Boolean]
+            #     Returns the min and max value for each numerical facet intervals.
+            #     Ignored for textual facets.
             class FacetKey
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -579,7 +606,8 @@ module Google
 
             # Enum describing under which condition query expansion should occur.
             module Condition
-              # Unspecified query expansion condition. This defaults to
+              # Unspecified query expansion condition. In this case, server behavior
+              # defaults to
               # {::Google::Cloud::Retail::V2::SearchRequest::QueryExpansionSpec::Condition::DISABLED Condition.DISABLED}.
               CONDITION_UNSPECIFIED = 0
 
@@ -604,11 +632,12 @@ module Google
 
             # The personalization mode of each search request.
             module Mode
-              # Default value. Defaults to
+              # Default value. In this case, server behavior defaults to
               # {::Google::Cloud::Retail::V2::SearchRequest::PersonalizationSpec::Mode::AUTO Mode.AUTO}.
               MODE_UNSPECIFIED = 0
 
-              # Let CRS decide whether to use personalization.
+              # Let CRS decide whether to use personalization based on quality of user
+              # event data.
               AUTO = 1
 
               # Disable personalization.
@@ -628,7 +657,8 @@ module Google
 
             # Enum describing under which mode spell correction should occur.
             module Mode
-              # Unspecified spell correction mode. This defaults to
+              # Unspecified spell correction mode. In this case, server behavior
+              # defaults to
               # {::Google::Cloud::Retail::V2::SearchRequest::SpellCorrectionSpec::Mode::AUTO Mode.AUTO}.
               MODE_UNSPECIFIED = 0
 
@@ -704,7 +734,7 @@ module Google
         #   @return [::String]
         #     Contains the spell corrected query, if found. If the spell correction type
         #     is AUTOMATIC, then the search results are based on corrected_query.
-        #     Otherwise the original query will be used for search.
+        #     Otherwise the original query is used for search.
         # @!attribute [rw] attribution_token
         #   @return [::String]
         #     A unique search token. This should be included in the
@@ -811,6 +841,21 @@ module Google
           #     {::Google::Protobuf::Value google.protobuf.Value}. For example,
           #     `{key: "pickupInStore.store1" value { number_value: 10 }}` means a there
           #     are 10 variants in this product are available in the store "store1".
+          # @!attribute [rw] personal_labels
+          #   @return [::Array<::String>]
+          #     Specifies previous events related to this product for this user based on
+          #     {::Google::Cloud::Retail::V2::UserEvent UserEvent} with same
+          #     {::Google::Cloud::Retail::V2::SearchRequest#visitor_id SearchRequest.visitor_id}
+          #     or {::Google::Cloud::Retail::V2::UserInfo#user_id UserInfo.user_id}.
+          #
+          #     This is set only when
+          #     {::Google::Cloud::Retail::V2::SearchRequest::PersonalizationSpec#mode SearchRequest.PersonalizationSpec.mode}
+          #     is
+          #     {::Google::Cloud::Retail::V2::SearchRequest::PersonalizationSpec::Mode::AUTO SearchRequest.PersonalizationSpec.Mode.AUTO}.
+          #
+          #     Possible values:
+          #
+          #     * `purchased`: Indicates that this product has been purchased before.
           class SearchResult
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -859,6 +904,20 @@ module Google
             # @!attribute [rw] count
             #   @return [::Integer]
             #     Number of items that have this facet value.
+            # @!attribute [rw] min_value
+            #   @return [::Float]
+            #     The minimum value in the
+            #     {::Google::Cloud::Retail::V2::SearchResponse::Facet::FacetValue#interval FacetValue.interval}.
+            #     Only supported on numerical facets and returned if
+            #     {::Google::Cloud::Retail::V2::SearchRequest::FacetSpec::FacetKey#return_min_max SearchRequest.FacetSpec.FacetKey.return_min_max}
+            #     is true.
+            # @!attribute [rw] max_value
+            #   @return [::Float]
+            #     The maximum value in the
+            #     {::Google::Cloud::Retail::V2::SearchResponse::Facet::FacetValue#interval FacetValue.interval}.
+            #     Only supported on numerical facets and returned if
+            #     {::Google::Cloud::Retail::V2::SearchRequest::FacetSpec::FacetKey#return_min_max SearchRequest.FacetSpec.FacetKey.return_min_max}
+            #     is true.
             class FacetValue
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -0,0 +1,238 @@
+# 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
+        # Configures metadata that is used to generate serving time results (e.g.
+        # search results or recommendation predictions).
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Immutable. Fully qualified name
+        #     `projects/*/locations/global/catalogs/*/servingConfig/*`
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Required. The human readable serving config display name. Used in Retail
+        #     UI.
+        #
+        #     This field must be a UTF-8 encoded string with a length limit of 128
+        #     characters. Otherwise, an INVALID_ARGUMENT error is returned.
+        # @!attribute [rw] model_id
+        #   @return [::String]
+        #     The id of the model in the same {::Google::Cloud::Retail::V2::Catalog Catalog}
+        #     to use at serving time. Currently only RecommendationModels are supported:
+        #     https://cloud.google.com/retail/recommendations-ai/docs/create-models
+        #     Can be changed but only to a compatible model (e.g.
+        #     others-you-may-like CTR to others-you-may-like CVR).
+        #
+        #     Required when
+        #     {::Google::Cloud::Retail::V2::ServingConfig#solution_types solution_types} is
+        #     [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
+        # @!attribute [rw] price_reranking_level
+        #   @return [::String]
+        #     How much price ranking we want in serving results.
+        #     Price reranking causes product items with a similar
+        #     recommendation probability to be ordered by price, with the
+        #     highest-priced items first. This setting could result in a decrease in
+        #     click-through and conversion rates.
+        #      Allowed values are:
+        #
+        #     * 'no-price-reranking'
+        #     * 'low-price-raranking'
+        #     * 'medium-price-reranking'
+        #     * 'high-price-reranking'
+        #
+        #     If not specified, we choose default based on model type. Default value:
+        #     'no-price-reranking'.
+        #
+        #     Can only be set if
+        #     {::Google::Cloud::Retail::V2::ServingConfig#solution_types solution_types} is
+        #     [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
+        # @!attribute [rw] facet_control_ids
+        #   @return [::Array<::String>]
+        #     Facet specifications for faceted search. If empty, no facets are returned.
+        #     The ids refer to the ids of {::Google::Cloud::Retail::V2::Control Control}
+        #     resources with only the Facet control set. These controls are assumed to be
+        #     in the same {::Google::Cloud::Retail::V2::Catalog Catalog} as the
+        #     {::Google::Cloud::Retail::V2::ServingConfig ServingConfig}.
+        #     A maximum of 100 values are allowed. Otherwise, an INVALID_ARGUMENT error
+        #     is returned.
+        #
+        #     Can only be set if
+        #     {::Google::Cloud::Retail::V2::ServingConfig#solution_types solution_types} is
+        #     [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+        # @!attribute [rw] dynamic_facet_spec
+        #   @return [::Google::Cloud::Retail::V2::SearchRequest::DynamicFacetSpec]
+        #     The specification for dynamically generated facets. Notice that only
+        #     textual facets can be dynamically generated.
+        #
+        #     Can only be set if
+        #     {::Google::Cloud::Retail::V2::ServingConfig#solution_types solution_types} is
+        #     [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+        # @!attribute [rw] boost_control_ids
+        #   @return [::Array<::String>]
+        #     Condition boost specifications. If a product matches multiple conditions
+        #     in the specifications, boost scores from these specifications are all
+        #     applied and combined in a non-linear way. Maximum number of
+        #     specifications is 100.
+        #
+        #     Notice that if both
+        #     {::Google::Cloud::Retail::V2::ServingConfig#boost_control_ids ServingConfig.boost_control_ids}
+        #     and
+        #     {::Google::Cloud::Retail::V2::SearchRequest#boost_spec SearchRequest.boost_spec}
+        #     are set, the boost conditions from both places are evaluated. If a search
+        #     request matches multiple boost conditions, the final boost score is equal
+        #     to the sum of the boost scores from all matched boost conditions.
+        #
+        #     Can only be set if
+        #     {::Google::Cloud::Retail::V2::ServingConfig#solution_types solution_types} is
+        #     [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+        # @!attribute [rw] filter_control_ids
+        #   @return [::Array<::String>]
+        #     Condition filter specifications. If a product matches multiple conditions
+        #     in the specifications, filters from these specifications are all
+        #     applied and combined via the AND operator. Maximum number of
+        #     specifications is 100.
+        #
+        #     Can only be set if
+        #     {::Google::Cloud::Retail::V2::ServingConfig#solution_types solution_types} is
+        #     [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+        # @!attribute [rw] redirect_control_ids
+        #   @return [::Array<::String>]
+        #     Condition redirect specifications. Only the first triggered redirect action
+        #     is applied, even if multiple apply. Maximum number of specifications is
+        #     1000.
+        #
+        #     Can only be set if
+        #     {::Google::Cloud::Retail::V2::ServingConfig#solution_types solution_types} is
+        #     [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+        # @!attribute [rw] twoway_synonyms_control_ids
+        #   @return [::Array<::String>]
+        #     Condition synonyms specifications. If multiple syonyms conditions match,
+        #     all matching synonyms control in the list will execute. Order of controls
+        #     in the list will not matter. Maximum number of specifications is
+        #     100.
+        #
+        #     Can only be set if
+        #     {::Google::Cloud::Retail::V2::ServingConfig#solution_types solution_types} is
+        #     [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+        # @!attribute [rw] oneway_synonyms_control_ids
+        #   @return [::Array<::String>]
+        #     Condition oneway synonyms specifications. If multiple oneway synonyms
+        #     conditions match, all matching oneway synonyms controls in the list will
+        #     execute. Order of controls in the list will not matter. Maximum number of
+        #     specifications is 100.
+        #
+        #     Can only be set if
+        #     {::Google::Cloud::Retail::V2::ServingConfig#solution_types solution_types} is
+        #     [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+        # @!attribute [rw] do_not_associate_control_ids
+        #   @return [::Array<::String>]
+        #     Condition do not associate specifications. If multiple do not associate
+        #     conditions match, all matching do not associate controls in the list will
+        #     execute.
+        #     - Order does not matter.
+        #     - Maximum number of specifications is 100.
+        #
+        #     Can only be set if
+        #     {::Google::Cloud::Retail::V2::ServingConfig#solution_types solution_types} is
+        #     [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+        # @!attribute [rw] replacement_control_ids
+        #   @return [::Array<::String>]
+        #     Condition replacement specifications.
+        #     - Applied according to the order in the list.
+        #     - A previously replaced term can not be re-replaced.
+        #     - Maximum number of specifications is 100.
+        #
+        #     Can only be set if
+        #     {::Google::Cloud::Retail::V2::ServingConfig#solution_types solution_types} is
+        #     [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+        # @!attribute [rw] ignore_control_ids
+        #   @return [::Array<::String>]
+        #     Condition ignore specifications. If multiple ignore
+        #     conditions match, all matching ignore controls in the list will
+        #     execute.
+        #     - Order does not matter.
+        #     - Maximum number of specifications is 100.
+        #
+        #     Can only be set if
+        #     {::Google::Cloud::Retail::V2::ServingConfig#solution_types solution_types} is
+        #     [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+        # @!attribute [rw] diversity_level
+        #   @return [::String]
+        #     How much diversity to use in recommendation model results e.g.
+        #     'medium-diversity' or 'high-diversity'. Currently supported values:
+        #
+        #     * 'no-diversity'
+        #     * 'low-diversity'
+        #     * 'medium-diversity'
+        #     * 'high-diversity'
+        #     * 'auto-diversity'
+        #
+        #     If not specified, we choose default based on recommendation model
+        #     type. Default value: 'no-diversity'.
+        #
+        #     Can only be set if
+        #     {::Google::Cloud::Retail::V2::ServingConfig#solution_types solution_types} is
+        #     [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
+        # @!attribute [rw] enable_category_filter_level
+        #   @return [::String]
+        #     Whether to add additional category filters on the 'similar-items' model.
+        #     If not specified, we enable it by default.
+        #      Allowed values are:
+        #
+        #     * 'no-category-match': No additional filtering of original results from
+        #       the model and the customer's filters.
+        #     * 'relaxed-category-match': Only keep results with categories that match
+        #       at least one item categories in the PredictRequests's context item.
+        #       * If customer also sends filters in the PredictRequest, then the results
+        #       will satisfy both conditions (user given and category match).
+        #
+        #     Can only be set if
+        #     {::Google::Cloud::Retail::V2::ServingConfig#solution_types solution_types} is
+        #     [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
+        # @!attribute [rw] personalization_spec
+        #   @return [::Google::Cloud::Retail::V2::SearchRequest::PersonalizationSpec]
+        #     The specification for personalization spec.
+        #
+        #     Can only be set if
+        #     {::Google::Cloud::Retail::V2::ServingConfig#solution_types solution_types} is
+        #     [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+        #
+        #     Notice that if both
+        #     {::Google::Cloud::Retail::V2::ServingConfig#personalization_spec ServingConfig.personalization_spec}
+        #     and
+        #     {::Google::Cloud::Retail::V2::SearchRequest#personalization_spec SearchRequest.personalization_spec}
+        #     are set.
+        #     {::Google::Cloud::Retail::V2::SearchRequest#personalization_spec SearchRequest.personalization_spec}
+        #     will override
+        #     {::Google::Cloud::Retail::V2::ServingConfig#personalization_spec ServingConfig.personalization_spec}.
+        # @!attribute [rw] solution_types
+        #   @return [::Array<::Google::Cloud::Retail::V2::SolutionType>]
+        #     Required. Immutable. Specifies the solution types that a serving config can
+        #     be associated with. Currently we support setting only one type of solution.
+        class ServingConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,143 @@
+# 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 CreateServingConfig method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Full resource name of parent. Format:
+        #     `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
+        # @!attribute [rw] serving_config
+        #   @return [::Google::Cloud::Retail::V2::ServingConfig]
+        #     Required. The ServingConfig to create.
+        # @!attribute [rw] serving_config_id
+        #   @return [::String]
+        #     Required. The ID to use for the ServingConfig, which will become the final
+        #     component of the ServingConfig's resource name.
+        #
+        #     This value should be 4-63 characters, and valid characters
+        #     are /[a-z][0-9]-_/.
+        class CreateServingConfigRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for UpdateServingConfig method.
+        # @!attribute [rw] serving_config
+        #   @return [::Google::Cloud::Retail::V2::ServingConfig]
+        #     Required. The ServingConfig to update.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Indicates which fields in the provided
+        #     {::Google::Cloud::Retail::V2::ServingConfig ServingConfig} to update. The
+        #     following are NOT supported:
+        #
+        #     * {::Google::Cloud::Retail::V2::ServingConfig#name ServingConfig.name}
+        #
+        #     If not set, all supported fields are updated.
+        class UpdateServingConfigRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for DeleteServingConfig method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the ServingConfig to delete. Format:
+        #     projects/\\{project_number}/locations/\\{location_id}/catalogs/\\{catalog_id}/servingConfigs/\\{serving_config_id}
+        class DeleteServingConfigRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for GetServingConfig method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the ServingConfig to get. Format:
+        #     projects/\\{project_number}/locations/\\{location_id}/catalogs/\\{catalog_id}/servingConfigs/\\{serving_config_id}
+        class GetServingConfigRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for ListServingConfigs 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 100. If a value greater than 100 is provided, at most 100 results are
+        #     returned.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A page token, received from a previous `ListServingConfigs` call.
+        #     Provide this to retrieve the subsequent page.
+        class ListServingConfigsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response for ListServingConfigs method.
+        # @!attribute [rw] serving_configs
+        #   @return [::Array<::Google::Cloud::Retail::V2::ServingConfig>]
+        #     All the ServingConfigs for a given catalog.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     Pagination token, if not returned indicates the last page.
+        class ListServingConfigsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for AddControl method.
+        # @!attribute [rw] serving_config
+        #   @return [::String]
+        #     Required. The source ServingConfig resource name . Format:
+        #     projects/\\{project_number}/locations/\\{location_id}/catalogs/\\{catalog_id}/servingConfigs/\\{serving_config_id}
+        # @!attribute [rw] control_id
+        #   @return [::String]
+        #     Required. The id of the control to apply. Assumed to be in the same catalog
+        #     as the serving config - if id is not found a NOT_FOUND error is returned.
+        class AddControlRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for RemoveControl method.
+        # @!attribute [rw] serving_config
+        #   @return [::String]
+        #     Required. The source ServingConfig resource name . Format:
+        #     projects/\\{project_number}/locations/\\{location_id}/catalogs/\\{catalog_id}/servingConfigs/\\{serving_config_id}
+        # @!attribute [rw] control_id
+        #   @return [::String]
+        #     Required. The id of the control to apply. Assumed to be in the same catalog
+        #     as the serving config.
+        class RemoveControlRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/protobuf/empty.rb

@@ -26,8 +26,6 @@ module Google
     #     service Foo {
     #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
     #     }
-    #
-    # The JSON representation for `Empty` is empty JSON object `{}`.
     class Empty
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods