google-cloud-retail-v2 0.10.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/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/search_service.rb

@@ -138,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
@@ -241,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:
@@ -625,7 +636,8 @@ module Google
               # {::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.
@@ -829,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

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