Class GoogleCloudRetailV2ServingConfig
Configures metadata that is used to generate serving time results (e.g. search results or recommendation predictions).
Implements
Inherited Members
Namespace: Google.Apis.CloudRetail.v2.Data
Assembly: Google.Apis.CloudRetail.v2.dll
Syntax
public class GoogleCloudRetailV2ServingConfig : IDirectResponseSchema
Properties
BoostControlIds
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 ServingConfig.boost_control_ids and 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 solution_types is SOLUTION_TYPE_SEARCH.
Declaration
[JsonProperty("boostControlIds")]
public virtual IList<string> BoostControlIds { get; set; }
Property Value
Type | Description |
---|---|
IList<string> |
DisplayName
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.
Declaration
[JsonProperty("displayName")]
public virtual string DisplayName { get; set; }
Property Value
Type | Description |
---|---|
string |
DiversityLevel
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 solution_types is SOLUTION_TYPE_RECOMMENDATION.
Declaration
[JsonProperty("diversityLevel")]
public virtual string DiversityLevel { get; set; }
Property Value
Type | Description |
---|---|
string |
DiversityType
What kind of diversity to use - data driven or rule based. If unset, the server behavior defaults to RULE_BASED_DIVERSITY.
Declaration
[JsonProperty("diversityType")]
public virtual string DiversityType { get; set; }
Property Value
Type | Description |
---|---|
string |
DoNotAssociateControlIds
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 solution_types is SOLUTION_TYPE_SEARCH.
Declaration
[JsonProperty("doNotAssociateControlIds")]
public virtual IList<string> DoNotAssociateControlIds { get; set; }
Property Value
Type | Description |
---|---|
IList<string> |
DynamicFacetSpec
The specification for dynamically generated facets. Notice that only textual facets can be dynamically generated. Can only be set if solution_types is SOLUTION_TYPE_SEARCH.
Declaration
[JsonProperty("dynamicFacetSpec")]
public virtual GoogleCloudRetailV2SearchRequestDynamicFacetSpec DynamicFacetSpec { get; set; }
Property Value
Type | Description |
---|---|
GoogleCloudRetailV2SearchRequestDynamicFacetSpec |
ETag
The ETag of the item.
Declaration
public virtual string ETag { get; set; }
Property Value
Type | Description |
---|---|
string |
EnableCategoryFilterLevel
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 solution_types is SOLUTION_TYPE_RECOMMENDATION.
Declaration
[JsonProperty("enableCategoryFilterLevel")]
public virtual string EnableCategoryFilterLevel { get; set; }
Property Value
Type | Description |
---|---|
string |
FacetControlIds
Facet specifications for faceted search. If empty, no facets are returned. The ids refer to the ids of Control resources with only the Facet control set. These controls are assumed to be in the same Catalog as the ServingConfig. A maximum of 100 values are allowed. Otherwise, an INVALID_ARGUMENT error is returned. Can only be set if solution_types is SOLUTION_TYPE_SEARCH.
Declaration
[JsonProperty("facetControlIds")]
public virtual IList<string> FacetControlIds { get; set; }
Property Value
Type | Description |
---|---|
IList<string> |
FilterControlIds
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 solution_types is SOLUTION_TYPE_SEARCH.
Declaration
[JsonProperty("filterControlIds")]
public virtual IList<string> FilterControlIds { get; set; }
Property Value
Type | Description |
---|---|
IList<string> |
IgnoreControlIds
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 solution_types is SOLUTION_TYPE_SEARCH.
Declaration
[JsonProperty("ignoreControlIds")]
public virtual IList<string> IgnoreControlIds { get; set; }
Property Value
Type | Description |
---|---|
IList<string> |
IgnoreRecsDenylist
When the flag is enabled, the products in the denylist will not be filtered out in the recommendation filtering results.
Declaration
[JsonProperty("ignoreRecsDenylist")]
public virtual bool? IgnoreRecsDenylist { get; set; }
Property Value
Type | Description |
---|---|
bool? |
ModelId
The id of the model in the same 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 solution_types is SOLUTION_TYPE_RECOMMENDATION.
Declaration
[JsonProperty("modelId")]
public virtual string ModelId { get; set; }
Property Value
Type | Description |
---|---|
string |
Name
Immutable. Fully qualified name projects/*/locations/global/catalogs/*/servingConfig/*
Declaration
[JsonProperty("name")]
public virtual string Name { get; set; }
Property Value
Type | Description |
---|---|
string |
OnewaySynonymsControlIds
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 solution_types is SOLUTION_TYPE_SEARCH.
Declaration
[JsonProperty("onewaySynonymsControlIds")]
public virtual IList<string> OnewaySynonymsControlIds { get; set; }
Property Value
Type | Description |
---|---|
IList<string> |
PersonalizationSpec
The specification for personalization spec. Can only be set if solution_types is SOLUTION_TYPE_SEARCH. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set. SearchRequest.personalization_spec will override ServingConfig.personalization_spec.
Declaration
[JsonProperty("personalizationSpec")]
public virtual GoogleCloudRetailV2SearchRequestPersonalizationSpec PersonalizationSpec { get; set; }
Property Value
Type | Description |
---|---|
GoogleCloudRetailV2SearchRequestPersonalizationSpec |
PriceRerankingLevel
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-reranking
* 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 solution_types is
SOLUTION_TYPE_RECOMMENDATION.
Declaration
[JsonProperty("priceRerankingLevel")]
public virtual string PriceRerankingLevel { get; set; }
Property Value
Type | Description |
---|---|
string |
RedirectControlIds
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 solution_types is SOLUTION_TYPE_SEARCH.
Declaration
[JsonProperty("redirectControlIds")]
public virtual IList<string> RedirectControlIds { get; set; }
Property Value
Type | Description |
---|---|
IList<string> |
ReplacementControlIds
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 solution_types is SOLUTION_TYPE_SEARCH.
Declaration
[JsonProperty("replacementControlIds")]
public virtual IList<string> ReplacementControlIds { get; set; }
Property Value
Type | Description |
---|---|
IList<string> |
SolutionTypes
Required. Immutable. Specifies the solution types that a serving config can be associated with. Currently we support setting only one type of solution.
Declaration
[JsonProperty("solutionTypes")]
public virtual IList<string> SolutionTypes { get; set; }
Property Value
Type | Description |
---|---|
IList<string> |
TwowaySynonymsControlIds
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 solution_types is SOLUTION_TYPE_SEARCH.
Declaration
[JsonProperty("twowaySynonymsControlIds")]
public virtual IList<string> TwowaySynonymsControlIds { get; set; }
Property Value
Type | Description |
---|---|
IList<string> |