Google Cloud Retail V2 Client - Class ServingConfig (1.3.1)

Reference documentation and code samples for the Google Cloud Retail V2 Client class ServingConfig.

Configures metadata that is used to generate serving time results (e.g.

search results or recommendation predictions).

Generated from protobuf message google.cloud.retail.v2.ServingConfig

Namespace

Google \ Cloud \ Retail \ V2

Methods

__construct

Constructor.

Parameters
Name	Description
`data`	`array` Optional. Data for populating the Message object.
`↳ name`	`string` Immutable. Fully qualified name `projects//locations/global/catalogs//servingConfig/*`
`↳ display_name`	`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.
`↳ model_id`	`string` 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.
`↳ price_reranking_level`	`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-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.
`↳ facet_control_ids`	`array` 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.
`↳ dynamic_facet_spec`	`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 solution_types is SOLUTION_TYPE_SEARCH.
`↳ boost_control_ids`	`array` 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.
`↳ filter_control_ids`	`array` 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.
`↳ redirect_control_ids`	`array` 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.
`↳ twoway_synonyms_control_ids`	`array` 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.
`↳ oneway_synonyms_control_ids`	`array` 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.
`↳ do_not_associate_control_ids`	`array` 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.
`↳ replacement_control_ids`	`array` 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.
`↳ ignore_control_ids`	`array` 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.
`↳ diversity_level`	`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 solution_types is SOLUTION_TYPE_RECOMMENDATION.
`↳ diversity_type`	`int` What kind of diversity to use - data driven or rule based. If unset, the server behavior defaults to RULE_BASED_DIVERSITY.
`↳ enable_category_filter_level`	`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 solution_types is SOLUTION_TYPE_RECOMMENDATION.
`↳ personalization_spec`	`Google\Cloud\Retail\V2\SearchRequest\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.
`↳ solution_types`	`array` Required. Immutable. Specifies the solution types that a serving config can be associated with. Currently we support setting only one type of solution.

getName

Immutable. Fully qualified name projects/*/locations/global/catalogs/*/servingConfig/*

Returns
Type	Description
`string`

setName

Immutable. Fully qualified name projects/*/locations/global/catalogs/*/servingConfig/*

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getDisplayName

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.

Returns
Type	Description
`string`

setDisplayName

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.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getModelId

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.

Returns
Type	Description
`string`

setModelId

others-you-may-like CTR to others-you-may-like CVR). Required when solution_types is SOLUTION_TYPE_RECOMMENDATION.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getPriceRerankingLevel

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.

Returns
Type	Description
`string`

setPriceRerankingLevel

How much price ranking we want in serving results.

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.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getFacetControlIds

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.

Returns
Type	Description
`Google\Protobuf\Internal\RepeatedField`

setFacetControlIds

Facet specifications for faceted search. If empty, no facets are returned.

Parameter
Name	Description
`var`	`string[]`

Returns
Type	Description
`$this`

getDynamicFacetSpec

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.

Returns
Type	Description
`Google\Cloud\Retail\V2\SearchRequest\DynamicFacetSpec\|null`

hasDynamicFacetSpec

clearDynamicFacetSpec

setDynamicFacetSpec

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.

Parameter
Name	Description
`var`	`Google\Cloud\Retail\V2\SearchRequest\DynamicFacetSpec`

Returns
Type	Description
`$this`

getBoostControlIds

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.

Returns
Type	Description
`Google\Protobuf\Internal\RepeatedField`

setBoostControlIds

Parameter
Name	Description
`var`	`string[]`

Returns
Type	Description
`$this`

getFilterControlIds

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.

Returns
Type	Description
`Google\Protobuf\Internal\RepeatedField`

setFilterControlIds

Can only be set if solution_types is SOLUTION_TYPE_SEARCH.

Parameter
Name	Description
`var`	`string[]`

Returns
Type	Description
`$this`

getRedirectControlIds

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.

Returns
Type	Description
`Google\Protobuf\Internal\RepeatedField`

setRedirectControlIds

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.

Parameter
Name	Description
`var`	`string[]`

Returns
Type	Description
`$this`

getTwowaySynonymsControlIds

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.

Returns
Type	Description
`Google\Protobuf\Internal\RepeatedField`

setTwowaySynonymsControlIds

Can only be set if solution_types is SOLUTION_TYPE_SEARCH.

Parameter
Name	Description
`var`	`string[]`

Returns
Type	Description
`$this`

getOnewaySynonymsControlIds

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.

Returns
Type	Description
`Google\Protobuf\Internal\RepeatedField`

setOnewaySynonymsControlIds

Can only be set if solution_types is SOLUTION_TYPE_SEARCH.

Parameter
Name	Description
`var`	`string[]`

Returns
Type	Description
`$this`

getDoNotAssociateControlIds

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.

Returns
Type	Description
`Google\Protobuf\Internal\RepeatedField`

setDoNotAssociateControlIds

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.

Parameter
Name	Description
`var`	`string[]`

Returns
Type	Description
`$this`

getReplacementControlIds

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.

Returns
Type	Description
`Google\Protobuf\Internal\RepeatedField`

setReplacementControlIds

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.

Parameter
Name	Description
`var`	`string[]`

Returns
Type	Description
`$this`

getIgnoreControlIds

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.

Returns
Type	Description
`Google\Protobuf\Internal\RepeatedField`

setIgnoreControlIds

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.

Parameter
Name	Description
`var`	`string[]`

Returns
Type	Description
`$this`

getDiversityLevel

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.

Returns
Type	Description
`string`

setDiversityLevel

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.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getDiversityType

What kind of diversity to use - data driven or rule based. If unset, the server behavior defaults to RULE_BASED_DIVERSITY.

Returns
Type	Description
`int`

setDiversityType

What kind of diversity to use - data driven or rule based. If unset, the server behavior defaults to RULE_BASED_DIVERSITY.

Parameter
Name	Description
`var`	`int`

Returns
Type	Description
`$this`

getEnableCategoryFilterLevel

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.

Returns
Type	Description
`string`

setEnableCategoryFilterLevel

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.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getPersonalizationSpec

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.

Returns
Type	Description
`Google\Cloud\Retail\V2\SearchRequest\PersonalizationSpec\|null`

hasPersonalizationSpec

clearPersonalizationSpec

setPersonalizationSpec

The specification for personalization spec.

Parameter
Name	Description
`var`	`Google\Cloud\Retail\V2\SearchRequest\PersonalizationSpec`

Returns
Type	Description
`$this`

getSolutionTypes

Required. Immutable. Specifies the solution types that a serving config can be associated with. Currently we support setting only one type of solution.

Returns
Type	Description
`Google\Protobuf\Internal\RepeatedField`

setSolutionTypes

Required. Immutable. Specifies the solution types that a serving config can be associated with. Currently we support setting only one type of solution.

Parameter
Name	Description
`var`	`int[]`

Returns
Type	Description
`$this`