1. Packages
  2. Google Cloud Native
  3. API Docs
  4. retail
  5. retail/v2beta
  6. getControl

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi

google-native.retail/v2beta.getControl

Explore with Pulumi AI

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi

Gets a Control.

Using getControl

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getControl(args: GetControlArgs, opts?: InvokeOptions): Promise<GetControlResult>
function getControlOutput(args: GetControlOutputArgs, opts?: InvokeOptions): Output<GetControlResult>
Copy
def get_control(catalog_id: Optional[str] = None,
                control_id: Optional[str] = None,
                location: Optional[str] = None,
                project: Optional[str] = None,
                opts: Optional[InvokeOptions] = None) -> GetControlResult
def get_control_output(catalog_id: Optional[pulumi.Input[str]] = None,
                control_id: Optional[pulumi.Input[str]] = None,
                location: Optional[pulumi.Input[str]] = None,
                project: Optional[pulumi.Input[str]] = None,
                opts: Optional[InvokeOptions] = None) -> Output[GetControlResult]
Copy
func LookupControl(ctx *Context, args *LookupControlArgs, opts ...InvokeOption) (*LookupControlResult, error)
func LookupControlOutput(ctx *Context, args *LookupControlOutputArgs, opts ...InvokeOption) LookupControlResultOutput
Copy

> Note: This function is named LookupControl in the Go SDK.

public static class GetControl 
{
    public static Task<GetControlResult> InvokeAsync(GetControlArgs args, InvokeOptions? opts = null)
    public static Output<GetControlResult> Invoke(GetControlInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetControlResult> getControl(GetControlArgs args, InvokeOptions options)
public static Output<GetControlResult> getControl(GetControlArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: google-native:retail/v2beta:getControl
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

CatalogId This property is required. string
ControlId This property is required. string
Location This property is required. string
Project string
CatalogId This property is required. string
ControlId This property is required. string
Location This property is required. string
Project string
catalogId This property is required. String
controlId This property is required. String
location This property is required. String
project String
catalogId This property is required. string
controlId This property is required. string
location This property is required. string
project string
catalog_id This property is required. str
control_id This property is required. str
location This property is required. str
project str
catalogId This property is required. String
controlId This property is required. String
location This property is required. String
project String

getControl Result

The following output properties are available:

AssociatedServingConfigIds List<string>
List of serving config ids that are associated with this control in the same Catalog. Note the association is managed via the ServingConfig, this is an output only denormalized view.
DisplayName string
The human readable control 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 thrown.
FacetSpec Pulumi.GoogleNative.Retail.V2Beta.Outputs.GoogleCloudRetailV2betaSearchRequestFacetSpecResponse
A facet specification to perform faceted search. Note that this field is deprecated and will throw NOT_IMPLEMENTED if used for creating a control.
Name string
Immutable. Fully qualified name projects/*/locations/global/catalogs/*/controls/*
Rule Pulumi.GoogleNative.Retail.V2Beta.Outputs.GoogleCloudRetailV2betaRuleResponse
A rule control - a condition-action pair. Enacts a set action when the condition is triggered. For example: Boost "gShoe" when query full matches "Running Shoes".
SearchSolutionUseCase List<string>
Specifies the use case for the control. Affects what condition fields can be set. Only settable by search controls. Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one search_solution_use_case per control.
SolutionTypes List<string>
Immutable. The solution types that the control is used for. Currently we support setting only one type of solution at creation time. Only SOLUTION_TYPE_SEARCH value is supported at the moment. If no solution type is provided at creation time, will default to SOLUTION_TYPE_SEARCH.
AssociatedServingConfigIds []string
List of serving config ids that are associated with this control in the same Catalog. Note the association is managed via the ServingConfig, this is an output only denormalized view.
DisplayName string
The human readable control 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 thrown.
FacetSpec GoogleCloudRetailV2betaSearchRequestFacetSpecResponse
A facet specification to perform faceted search. Note that this field is deprecated and will throw NOT_IMPLEMENTED if used for creating a control.
Name string
Immutable. Fully qualified name projects/*/locations/global/catalogs/*/controls/*
Rule GoogleCloudRetailV2betaRuleResponse
A rule control - a condition-action pair. Enacts a set action when the condition is triggered. For example: Boost "gShoe" when query full matches "Running Shoes".
SearchSolutionUseCase []string
Specifies the use case for the control. Affects what condition fields can be set. Only settable by search controls. Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one search_solution_use_case per control.
SolutionTypes []string
Immutable. The solution types that the control is used for. Currently we support setting only one type of solution at creation time. Only SOLUTION_TYPE_SEARCH value is supported at the moment. If no solution type is provided at creation time, will default to SOLUTION_TYPE_SEARCH.
associatedServingConfigIds List<String>
List of serving config ids that are associated with this control in the same Catalog. Note the association is managed via the ServingConfig, this is an output only denormalized view.
displayName String
The human readable control 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 thrown.
facetSpec GoogleCloudRetailV2betaSearchRequestFacetSpecResponse
A facet specification to perform faceted search. Note that this field is deprecated and will throw NOT_IMPLEMENTED if used for creating a control.
name String
Immutable. Fully qualified name projects/*/locations/global/catalogs/*/controls/*
rule GoogleCloudRetailV2betaRuleResponse
A rule control - a condition-action pair. Enacts a set action when the condition is triggered. For example: Boost "gShoe" when query full matches "Running Shoes".
searchSolutionUseCase List<String>
Specifies the use case for the control. Affects what condition fields can be set. Only settable by search controls. Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one search_solution_use_case per control.
solutionTypes List<String>
Immutable. The solution types that the control is used for. Currently we support setting only one type of solution at creation time. Only SOLUTION_TYPE_SEARCH value is supported at the moment. If no solution type is provided at creation time, will default to SOLUTION_TYPE_SEARCH.
associatedServingConfigIds string[]
List of serving config ids that are associated with this control in the same Catalog. Note the association is managed via the ServingConfig, this is an output only denormalized view.
displayName string
The human readable control 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 thrown.
facetSpec GoogleCloudRetailV2betaSearchRequestFacetSpecResponse
A facet specification to perform faceted search. Note that this field is deprecated and will throw NOT_IMPLEMENTED if used for creating a control.
name string
Immutable. Fully qualified name projects/*/locations/global/catalogs/*/controls/*
rule GoogleCloudRetailV2betaRuleResponse
A rule control - a condition-action pair. Enacts a set action when the condition is triggered. For example: Boost "gShoe" when query full matches "Running Shoes".
searchSolutionUseCase string[]
Specifies the use case for the control. Affects what condition fields can be set. Only settable by search controls. Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one search_solution_use_case per control.
solutionTypes string[]
Immutable. The solution types that the control is used for. Currently we support setting only one type of solution at creation time. Only SOLUTION_TYPE_SEARCH value is supported at the moment. If no solution type is provided at creation time, will default to SOLUTION_TYPE_SEARCH.
associated_serving_config_ids Sequence[str]
List of serving config ids that are associated with this control in the same Catalog. Note the association is managed via the ServingConfig, this is an output only denormalized view.
display_name str
The human readable control 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 thrown.
facet_spec GoogleCloudRetailV2betaSearchRequestFacetSpecResponse
A facet specification to perform faceted search. Note that this field is deprecated and will throw NOT_IMPLEMENTED if used for creating a control.
name str
Immutable. Fully qualified name projects/*/locations/global/catalogs/*/controls/*
rule GoogleCloudRetailV2betaRuleResponse
A rule control - a condition-action pair. Enacts a set action when the condition is triggered. For example: Boost "gShoe" when query full matches "Running Shoes".
search_solution_use_case Sequence[str]
Specifies the use case for the control. Affects what condition fields can be set. Only settable by search controls. Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one search_solution_use_case per control.
solution_types Sequence[str]
Immutable. The solution types that the control is used for. Currently we support setting only one type of solution at creation time. Only SOLUTION_TYPE_SEARCH value is supported at the moment. If no solution type is provided at creation time, will default to SOLUTION_TYPE_SEARCH.
associatedServingConfigIds List<String>
List of serving config ids that are associated with this control in the same Catalog. Note the association is managed via the ServingConfig, this is an output only denormalized view.
displayName String
The human readable control 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 thrown.
facetSpec Property Map
A facet specification to perform faceted search. Note that this field is deprecated and will throw NOT_IMPLEMENTED if used for creating a control.
name String
Immutable. Fully qualified name projects/*/locations/global/catalogs/*/controls/*
rule Property Map
A rule control - a condition-action pair. Enacts a set action when the condition is triggered. For example: Boost "gShoe" when query full matches "Running Shoes".
searchSolutionUseCase List<String>
Specifies the use case for the control. Affects what condition fields can be set. Only settable by search controls. Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one search_solution_use_case per control.
solutionTypes List<String>
Immutable. The solution types that the control is used for. Currently we support setting only one type of solution at creation time. Only SOLUTION_TYPE_SEARCH value is supported at the moment. If no solution type is provided at creation time, will default to SOLUTION_TYPE_SEARCH.

Supporting Types

GoogleCloudRetailV2betaConditionQueryTermResponse

FullMatch This property is required. bool
Whether this is supposed to be a full or partial match.
Value This property is required. string
The value of the term to match on. Value cannot be empty. Value can have at most 3 terms if specified as a partial match. Each space separated string is considered as one term. For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms and not allowed for a partial match.
FullMatch This property is required. bool
Whether this is supposed to be a full or partial match.
Value This property is required. string
The value of the term to match on. Value cannot be empty. Value can have at most 3 terms if specified as a partial match. Each space separated string is considered as one term. For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms and not allowed for a partial match.
fullMatch This property is required. Boolean
Whether this is supposed to be a full or partial match.
value This property is required. String
The value of the term to match on. Value cannot be empty. Value can have at most 3 terms if specified as a partial match. Each space separated string is considered as one term. For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms and not allowed for a partial match.
fullMatch This property is required. boolean
Whether this is supposed to be a full or partial match.
value This property is required. string
The value of the term to match on. Value cannot be empty. Value can have at most 3 terms if specified as a partial match. Each space separated string is considered as one term. For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms and not allowed for a partial match.
full_match This property is required. bool
Whether this is supposed to be a full or partial match.
value This property is required. str
The value of the term to match on. Value cannot be empty. Value can have at most 3 terms if specified as a partial match. Each space separated string is considered as one term. For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms and not allowed for a partial match.
fullMatch This property is required. Boolean
Whether this is supposed to be a full or partial match.
value This property is required. String
The value of the term to match on. Value cannot be empty. Value can have at most 3 terms if specified as a partial match. Each space separated string is considered as one term. For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms and not allowed for a partial match.

GoogleCloudRetailV2betaConditionResponse

ActiveTimeRange This property is required. List<Pulumi.GoogleNative.Retail.V2Beta.Inputs.GoogleCloudRetailV2betaConditionTimeRangeResponse>
Range of time(s) specifying when Condition is active. Condition true if any time range matches.
PageCategories This property is required. List<string>
Used to support browse uses cases. A list (up to 10 entries) of categories or departments. The format should be the same as UserEvent.page_categories;
QueryTerms This property is required. List<Pulumi.GoogleNative.Retail.V2Beta.Inputs.GoogleCloudRetailV2betaConditionQueryTermResponse>
A list (up to 10 entries) of terms to match the query on. If not specified, match all queries. If many query terms are specified, the condition is matched if any of the terms is a match (i.e. using the OR operator).
ActiveTimeRange This property is required. []GoogleCloudRetailV2betaConditionTimeRangeResponse
Range of time(s) specifying when Condition is active. Condition true if any time range matches.
PageCategories This property is required. []string
Used to support browse uses cases. A list (up to 10 entries) of categories or departments. The format should be the same as UserEvent.page_categories;
QueryTerms This property is required. []GoogleCloudRetailV2betaConditionQueryTermResponse
A list (up to 10 entries) of terms to match the query on. If not specified, match all queries. If many query terms are specified, the condition is matched if any of the terms is a match (i.e. using the OR operator).
activeTimeRange This property is required. List<GoogleCloudRetailV2betaConditionTimeRangeResponse>
Range of time(s) specifying when Condition is active. Condition true if any time range matches.
pageCategories This property is required. List<String>
Used to support browse uses cases. A list (up to 10 entries) of categories or departments. The format should be the same as UserEvent.page_categories;
queryTerms This property is required. List<GoogleCloudRetailV2betaConditionQueryTermResponse>
A list (up to 10 entries) of terms to match the query on. If not specified, match all queries. If many query terms are specified, the condition is matched if any of the terms is a match (i.e. using the OR operator).
activeTimeRange This property is required. GoogleCloudRetailV2betaConditionTimeRangeResponse[]
Range of time(s) specifying when Condition is active. Condition true if any time range matches.
pageCategories This property is required. string[]
Used to support browse uses cases. A list (up to 10 entries) of categories or departments. The format should be the same as UserEvent.page_categories;
queryTerms This property is required. GoogleCloudRetailV2betaConditionQueryTermResponse[]
A list (up to 10 entries) of terms to match the query on. If not specified, match all queries. If many query terms are specified, the condition is matched if any of the terms is a match (i.e. using the OR operator).
active_time_range This property is required. Sequence[GoogleCloudRetailV2betaConditionTimeRangeResponse]
Range of time(s) specifying when Condition is active. Condition true if any time range matches.
page_categories This property is required. Sequence[str]
Used to support browse uses cases. A list (up to 10 entries) of categories or departments. The format should be the same as UserEvent.page_categories;
query_terms This property is required. Sequence[GoogleCloudRetailV2betaConditionQueryTermResponse]
A list (up to 10 entries) of terms to match the query on. If not specified, match all queries. If many query terms are specified, the condition is matched if any of the terms is a match (i.e. using the OR operator).
activeTimeRange This property is required. List<Property Map>
Range of time(s) specifying when Condition is active. Condition true if any time range matches.
pageCategories This property is required. List<String>
Used to support browse uses cases. A list (up to 10 entries) of categories or departments. The format should be the same as UserEvent.page_categories;
queryTerms This property is required. List<Property Map>
A list (up to 10 entries) of terms to match the query on. If not specified, match all queries. If many query terms are specified, the condition is matched if any of the terms is a match (i.e. using the OR operator).

GoogleCloudRetailV2betaConditionTimeRangeResponse

EndTime This property is required. string
End of time range. Range is inclusive.
StartTime This property is required. string
Start of time range. Range is inclusive.
EndTime This property is required. string
End of time range. Range is inclusive.
StartTime This property is required. string
Start of time range. Range is inclusive.
endTime This property is required. String
End of time range. Range is inclusive.
startTime This property is required. String
Start of time range. Range is inclusive.
endTime This property is required. string
End of time range. Range is inclusive.
startTime This property is required. string
Start of time range. Range is inclusive.
end_time This property is required. str
End of time range. Range is inclusive.
start_time This property is required. str
Start of time range. Range is inclusive.
endTime This property is required. String
End of time range. Range is inclusive.
startTime This property is required. String
Start of time range. Range is inclusive.

GoogleCloudRetailV2betaIntervalResponse

ExclusiveMaximum This property is required. double
Exclusive upper bound.
ExclusiveMinimum This property is required. double
Exclusive lower bound.
Maximum This property is required. double
Inclusive upper bound.
Minimum This property is required. double
Inclusive lower bound.
ExclusiveMaximum This property is required. float64
Exclusive upper bound.
ExclusiveMinimum This property is required. float64
Exclusive lower bound.
Maximum This property is required. float64
Inclusive upper bound.
Minimum This property is required. float64
Inclusive lower bound.
exclusiveMaximum This property is required. Double
Exclusive upper bound.
exclusiveMinimum This property is required. Double
Exclusive lower bound.
maximum This property is required. Double
Inclusive upper bound.
minimum This property is required. Double
Inclusive lower bound.
exclusiveMaximum This property is required. number
Exclusive upper bound.
exclusiveMinimum This property is required. number
Exclusive lower bound.
maximum This property is required. number
Inclusive upper bound.
minimum This property is required. number
Inclusive lower bound.
exclusive_maximum This property is required. float
Exclusive upper bound.
exclusive_minimum This property is required. float
Exclusive lower bound.
maximum This property is required. float
Inclusive upper bound.
minimum This property is required. float
Inclusive lower bound.
exclusiveMaximum This property is required. Number
Exclusive upper bound.
exclusiveMinimum This property is required. Number
Exclusive lower bound.
maximum This property is required. Number
Inclusive upper bound.
minimum This property is required. Number
Inclusive lower bound.

GoogleCloudRetailV2betaRuleBoostActionResponse

Boost This property is required. double
Strength of the condition boost, which must be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the item a big promotion. However, it does not necessarily mean that the boosted item will be the top result at all times, nor that other items will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant items. Setting to -1.0 gives the item a big demotion. However, results that are deeply relevant might still be shown. The item will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored.
ProductsFilter This property is required. string
The filter can have a max size of 5000 characters. An expression which specifies which products to apply an action to. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost products with product ID "product_1" or "product_2", and color "Red" or "Blue": *(id: ANY("product_1", "product_2")) * *AND * *(colorFamilies: ANY("Red", "Blue")) *
Boost This property is required. float64
Strength of the condition boost, which must be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the item a big promotion. However, it does not necessarily mean that the boosted item will be the top result at all times, nor that other items will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant items. Setting to -1.0 gives the item a big demotion. However, results that are deeply relevant might still be shown. The item will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored.
ProductsFilter This property is required. string
The filter can have a max size of 5000 characters. An expression which specifies which products to apply an action to. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost products with product ID "product_1" or "product_2", and color "Red" or "Blue": *(id: ANY("product_1", "product_2")) * *AND * *(colorFamilies: ANY("Red", "Blue")) *
boost This property is required. Double
Strength of the condition boost, which must be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the item a big promotion. However, it does not necessarily mean that the boosted item will be the top result at all times, nor that other items will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant items. Setting to -1.0 gives the item a big demotion. However, results that are deeply relevant might still be shown. The item will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored.
productsFilter This property is required. String
The filter can have a max size of 5000 characters. An expression which specifies which products to apply an action to. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost products with product ID "product_1" or "product_2", and color "Red" or "Blue": *(id: ANY("product_1", "product_2")) * *AND * *(colorFamilies: ANY("Red", "Blue")) *
boost This property is required. number
Strength of the condition boost, which must be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the item a big promotion. However, it does not necessarily mean that the boosted item will be the top result at all times, nor that other items will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant items. Setting to -1.0 gives the item a big demotion. However, results that are deeply relevant might still be shown. The item will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored.
productsFilter This property is required. string
The filter can have a max size of 5000 characters. An expression which specifies which products to apply an action to. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost products with product ID "product_1" or "product_2", and color "Red" or "Blue": *(id: ANY("product_1", "product_2")) * *AND * *(colorFamilies: ANY("Red", "Blue")) *
boost This property is required. float
Strength of the condition boost, which must be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the item a big promotion. However, it does not necessarily mean that the boosted item will be the top result at all times, nor that other items will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant items. Setting to -1.0 gives the item a big demotion. However, results that are deeply relevant might still be shown. The item will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored.
products_filter This property is required. str
The filter can have a max size of 5000 characters. An expression which specifies which products to apply an action to. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost products with product ID "product_1" or "product_2", and color "Red" or "Blue": *(id: ANY("product_1", "product_2")) * *AND * *(colorFamilies: ANY("Red", "Blue")) *
boost This property is required. Number
Strength of the condition boost, which must be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the item a big promotion. However, it does not necessarily mean that the boosted item will be the top result at all times, nor that other items will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant items. Setting to -1.0 gives the item a big demotion. However, results that are deeply relevant might still be shown. The item will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored.
productsFilter This property is required. String
The filter can have a max size of 5000 characters. An expression which specifies which products to apply an action to. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost products with product ID "product_1" or "product_2", and color "Red" or "Blue": *(id: ANY("product_1", "product_2")) * *AND * *(colorFamilies: ANY("Red", "Blue")) *

GoogleCloudRetailV2betaRuleDoNotAssociateActionResponse

DoNotAssociateTerms This property is required. List<string>
Cannot contain duplicates or the query term. Can specify up to 100 terms.
QueryTerms This property is required. List<string>
Terms from the search query. Will not consider do_not_associate_terms for search if in search query. Can specify up to 100 terms.
Terms This property is required. List<string>
Will be [deprecated = true] post migration;
DoNotAssociateTerms This property is required. []string
Cannot contain duplicates or the query term. Can specify up to 100 terms.
QueryTerms This property is required. []string
Terms from the search query. Will not consider do_not_associate_terms for search if in search query. Can specify up to 100 terms.
Terms This property is required. []string
Will be [deprecated = true] post migration;
doNotAssociateTerms This property is required. List<String>
Cannot contain duplicates or the query term. Can specify up to 100 terms.
queryTerms This property is required. List<String>
Terms from the search query. Will not consider do_not_associate_terms for search if in search query. Can specify up to 100 terms.
terms This property is required. List<String>
Will be [deprecated = true] post migration;
doNotAssociateTerms This property is required. string[]
Cannot contain duplicates or the query term. Can specify up to 100 terms.
queryTerms This property is required. string[]
Terms from the search query. Will not consider do_not_associate_terms for search if in search query. Can specify up to 100 terms.
terms This property is required. string[]
Will be [deprecated = true] post migration;
do_not_associate_terms This property is required. Sequence[str]
Cannot contain duplicates or the query term. Can specify up to 100 terms.
query_terms This property is required. Sequence[str]
Terms from the search query. Will not consider do_not_associate_terms for search if in search query. Can specify up to 100 terms.
terms This property is required. Sequence[str]
Will be [deprecated = true] post migration;
doNotAssociateTerms This property is required. List<String>
Cannot contain duplicates or the query term. Can specify up to 100 terms.
queryTerms This property is required. List<String>
Terms from the search query. Will not consider do_not_associate_terms for search if in search query. Can specify up to 100 terms.
terms This property is required. List<String>
Will be [deprecated = true] post migration;

GoogleCloudRetailV2betaRuleFilterActionResponse

Filter This property is required. string
A filter to apply on the matching condition results. Supported features: * filter must be set. * Filter syntax is identical to SearchRequest.filter. For more information, see Filter. * To filter products with product ID "product_1" or "product_2", and color "Red" or "Blue": *(id: ANY("product_1", "product_2")) * *AND * *(colorFamilies: ANY("Red", "Blue")) *
Filter This property is required. string
A filter to apply on the matching condition results. Supported features: * filter must be set. * Filter syntax is identical to SearchRequest.filter. For more information, see Filter. * To filter products with product ID "product_1" or "product_2", and color "Red" or "Blue": *(id: ANY("product_1", "product_2")) * *AND * *(colorFamilies: ANY("Red", "Blue")) *
filter This property is required. String
A filter to apply on the matching condition results. Supported features: * filter must be set. * Filter syntax is identical to SearchRequest.filter. For more information, see Filter. * To filter products with product ID "product_1" or "product_2", and color "Red" or "Blue": *(id: ANY("product_1", "product_2")) * *AND * *(colorFamilies: ANY("Red", "Blue")) *
filter This property is required. string
A filter to apply on the matching condition results. Supported features: * filter must be set. * Filter syntax is identical to SearchRequest.filter. For more information, see Filter. * To filter products with product ID "product_1" or "product_2", and color "Red" or "Blue": *(id: ANY("product_1", "product_2")) * *AND * *(colorFamilies: ANY("Red", "Blue")) *
filter This property is required. str
A filter to apply on the matching condition results. Supported features: * filter must be set. * Filter syntax is identical to SearchRequest.filter. For more information, see Filter. * To filter products with product ID "product_1" or "product_2", and color "Red" or "Blue": *(id: ANY("product_1", "product_2")) * *AND * *(colorFamilies: ANY("Red", "Blue")) *
filter This property is required. String
A filter to apply on the matching condition results. Supported features: * filter must be set. * Filter syntax is identical to SearchRequest.filter. For more information, see Filter. * To filter products with product ID "product_1" or "product_2", and color "Red" or "Blue": *(id: ANY("product_1", "product_2")) * *AND * *(colorFamilies: ANY("Red", "Blue")) *

GoogleCloudRetailV2betaRuleForceReturnFacetActionFacetPositionAdjustmentResponse

AttributeName This property is required. string
The attribute name to force return as a facet. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters long.
Position This property is required. int
This is the position in the request as explained above. It should be strictly positive be at most 100.
AttributeName This property is required. string
The attribute name to force return as a facet. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters long.
Position This property is required. int
This is the position in the request as explained above. It should be strictly positive be at most 100.
attributeName This property is required. String
The attribute name to force return as a facet. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters long.
position This property is required. Integer
This is the position in the request as explained above. It should be strictly positive be at most 100.
attributeName This property is required. string
The attribute name to force return as a facet. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters long.
position This property is required. number
This is the position in the request as explained above. It should be strictly positive be at most 100.
attribute_name This property is required. str
The attribute name to force return as a facet. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters long.
position This property is required. int
This is the position in the request as explained above. It should be strictly positive be at most 100.
attributeName This property is required. String
The attribute name to force return as a facet. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters long.
position This property is required. Number
This is the position in the request as explained above. It should be strictly positive be at most 100.

GoogleCloudRetailV2betaRuleForceReturnFacetActionResponse

FacetPositionAdjustments This property is required. List<Pulumi.GoogleNative.Retail.V2Beta.Inputs.GoogleCloudRetailV2betaRuleForceReturnFacetActionFacetPositionAdjustmentResponse>
Each instance corresponds to a force return attribute for the given condition. There can't be more 3 instances here.
FacetPositionAdjustments This property is required. []GoogleCloudRetailV2betaRuleForceReturnFacetActionFacetPositionAdjustmentResponse
Each instance corresponds to a force return attribute for the given condition. There can't be more 3 instances here.
facetPositionAdjustments This property is required. List<GoogleCloudRetailV2betaRuleForceReturnFacetActionFacetPositionAdjustmentResponse>
Each instance corresponds to a force return attribute for the given condition. There can't be more 3 instances here.
facetPositionAdjustments This property is required. GoogleCloudRetailV2betaRuleForceReturnFacetActionFacetPositionAdjustmentResponse[]
Each instance corresponds to a force return attribute for the given condition. There can't be more 3 instances here.
facet_position_adjustments This property is required. Sequence[GoogleCloudRetailV2betaRuleForceReturnFacetActionFacetPositionAdjustmentResponse]
Each instance corresponds to a force return attribute for the given condition. There can't be more 3 instances here.
facetPositionAdjustments This property is required. List<Property Map>
Each instance corresponds to a force return attribute for the given condition. There can't be more 3 instances here.

GoogleCloudRetailV2betaRuleIgnoreActionResponse

IgnoreTerms This property is required. List<string>
Terms to ignore in the search query.
IgnoreTerms This property is required. []string
Terms to ignore in the search query.
ignoreTerms This property is required. List<String>
Terms to ignore in the search query.
ignoreTerms This property is required. string[]
Terms to ignore in the search query.
ignore_terms This property is required. Sequence[str]
Terms to ignore in the search query.
ignoreTerms This property is required. List<String>
Terms to ignore in the search query.

GoogleCloudRetailV2betaRuleOnewaySynonymsActionResponse

OnewayTerms This property is required. List<string>
Will be [deprecated = true] post migration;
QueryTerms This property is required. List<string>
Terms from the search query. Will treat synonyms as their synonyms. Not themselves synonyms of the synonyms. Can specify up to 100 terms.
Synonyms This property is required. List<string>
Defines a set of synonyms. Cannot contain duplicates. Can specify up to 100 synonyms.
OnewayTerms This property is required. []string
Will be [deprecated = true] post migration;
QueryTerms This property is required. []string
Terms from the search query. Will treat synonyms as their synonyms. Not themselves synonyms of the synonyms. Can specify up to 100 terms.
Synonyms This property is required. []string
Defines a set of synonyms. Cannot contain duplicates. Can specify up to 100 synonyms.
onewayTerms This property is required. List<String>
Will be [deprecated = true] post migration;
queryTerms This property is required. List<String>
Terms from the search query. Will treat synonyms as their synonyms. Not themselves synonyms of the synonyms. Can specify up to 100 terms.
synonyms This property is required. List<String>
Defines a set of synonyms. Cannot contain duplicates. Can specify up to 100 synonyms.
onewayTerms This property is required. string[]
Will be [deprecated = true] post migration;
queryTerms This property is required. string[]
Terms from the search query. Will treat synonyms as their synonyms. Not themselves synonyms of the synonyms. Can specify up to 100 terms.
synonyms This property is required. string[]
Defines a set of synonyms. Cannot contain duplicates. Can specify up to 100 synonyms.
oneway_terms This property is required. Sequence[str]
Will be [deprecated = true] post migration;
query_terms This property is required. Sequence[str]
Terms from the search query. Will treat synonyms as their synonyms. Not themselves synonyms of the synonyms. Can specify up to 100 terms.
synonyms This property is required. Sequence[str]
Defines a set of synonyms. Cannot contain duplicates. Can specify up to 100 synonyms.
onewayTerms This property is required. List<String>
Will be [deprecated = true] post migration;
queryTerms This property is required. List<String>
Terms from the search query. Will treat synonyms as their synonyms. Not themselves synonyms of the synonyms. Can specify up to 100 terms.
synonyms This property is required. List<String>
Defines a set of synonyms. Cannot contain duplicates. Can specify up to 100 synonyms.

GoogleCloudRetailV2betaRuleRedirectActionResponse

RedirectUri This property is required. string
URL must have length equal or less than 2000 characters.
RedirectUri This property is required. string
URL must have length equal or less than 2000 characters.
redirectUri This property is required. String
URL must have length equal or less than 2000 characters.
redirectUri This property is required. string
URL must have length equal or less than 2000 characters.
redirect_uri This property is required. str
URL must have length equal or less than 2000 characters.
redirectUri This property is required. String
URL must have length equal or less than 2000 characters.

GoogleCloudRetailV2betaRuleRemoveFacetActionResponse

AttributeNames This property is required. List<string>
The attribute names (i.e. facet keys) to remove from the dynamic facets (if present in the request). There can't be more 3 attribute names. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters.
AttributeNames This property is required. []string
The attribute names (i.e. facet keys) to remove from the dynamic facets (if present in the request). There can't be more 3 attribute names. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters.
attributeNames This property is required. List<String>
The attribute names (i.e. facet keys) to remove from the dynamic facets (if present in the request). There can't be more 3 attribute names. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters.
attributeNames This property is required. string[]
The attribute names (i.e. facet keys) to remove from the dynamic facets (if present in the request). There can't be more 3 attribute names. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters.
attribute_names This property is required. Sequence[str]
The attribute names (i.e. facet keys) to remove from the dynamic facets (if present in the request). There can't be more 3 attribute names. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters.
attributeNames This property is required. List<String>
The attribute names (i.e. facet keys) to remove from the dynamic facets (if present in the request). There can't be more 3 attribute names. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters.

GoogleCloudRetailV2betaRuleReplacementActionResponse

QueryTerms This property is required. List<string>
Terms from the search query. Will be replaced by replacement term. Can specify up to 100 terms.
ReplacementTerm This property is required. string
Term that will be used for replacement.
Term This property is required. string
Will be [deprecated = true] post migration;
QueryTerms This property is required. []string
Terms from the search query. Will be replaced by replacement term. Can specify up to 100 terms.
ReplacementTerm This property is required. string
Term that will be used for replacement.
Term This property is required. string
Will be [deprecated = true] post migration;
queryTerms This property is required. List<String>
Terms from the search query. Will be replaced by replacement term. Can specify up to 100 terms.
replacementTerm This property is required. String
Term that will be used for replacement.
term This property is required. String
Will be [deprecated = true] post migration;
queryTerms This property is required. string[]
Terms from the search query. Will be replaced by replacement term. Can specify up to 100 terms.
replacementTerm This property is required. string
Term that will be used for replacement.
term This property is required. string
Will be [deprecated = true] post migration;
query_terms This property is required. Sequence[str]
Terms from the search query. Will be replaced by replacement term. Can specify up to 100 terms.
replacement_term This property is required. str
Term that will be used for replacement.
term This property is required. str
Will be [deprecated = true] post migration;
queryTerms This property is required. List<String>
Terms from the search query. Will be replaced by replacement term. Can specify up to 100 terms.
replacementTerm This property is required. String
Term that will be used for replacement.
term This property is required. String
Will be [deprecated = true] post migration;

GoogleCloudRetailV2betaRuleResponse

BoostAction This property is required. Pulumi.GoogleNative.Retail.V2Beta.Inputs.GoogleCloudRetailV2betaRuleBoostActionResponse
A boost action.
Condition This property is required. Pulumi.GoogleNative.Retail.V2Beta.Inputs.GoogleCloudRetailV2betaConditionResponse
The condition that triggers the rule. If the condition is empty, the rule will always apply.
DoNotAssociateAction This property is required. Pulumi.GoogleNative.Retail.V2Beta.Inputs.GoogleCloudRetailV2betaRuleDoNotAssociateActionResponse
Prevents term from being associated with other terms.
FilterAction This property is required. Pulumi.GoogleNative.Retail.V2Beta.Inputs.GoogleCloudRetailV2betaRuleFilterActionResponse
Filters results.
ForceReturnFacetAction This property is required. Pulumi.GoogleNative.Retail.V2Beta.Inputs.GoogleCloudRetailV2betaRuleForceReturnFacetActionResponse
Force returns an attribute as a facet in the request.
IgnoreAction This property is required. Pulumi.GoogleNative.Retail.V2Beta.Inputs.GoogleCloudRetailV2betaRuleIgnoreActionResponse
Ignores specific terms from query during search.
OnewaySynonymsAction This property is required. Pulumi.GoogleNative.Retail.V2Beta.Inputs.GoogleCloudRetailV2betaRuleOnewaySynonymsActionResponse
Treats specific term as a synonym with a group of terms. Group of terms will not be treated as synonyms with the specific term.
RedirectAction This property is required. Pulumi.GoogleNative.Retail.V2Beta.Inputs.GoogleCloudRetailV2betaRuleRedirectActionResponse
Redirects a shopper to a specific page.
RemoveFacetAction This property is required. Pulumi.GoogleNative.Retail.V2Beta.Inputs.GoogleCloudRetailV2betaRuleRemoveFacetActionResponse
Remove an attribute as a facet in the request (if present).
ReplacementAction This property is required. Pulumi.GoogleNative.Retail.V2Beta.Inputs.GoogleCloudRetailV2betaRuleReplacementActionResponse
Replaces specific terms in the query.
TwowaySynonymsAction This property is required. Pulumi.GoogleNative.Retail.V2Beta.Inputs.GoogleCloudRetailV2betaRuleTwowaySynonymsActionResponse
Treats a set of terms as synonyms of one another.
BoostAction This property is required. GoogleCloudRetailV2betaRuleBoostActionResponse
A boost action.
Condition This property is required. GoogleCloudRetailV2betaConditionResponse
The condition that triggers the rule. If the condition is empty, the rule will always apply.
DoNotAssociateAction This property is required. GoogleCloudRetailV2betaRuleDoNotAssociateActionResponse
Prevents term from being associated with other terms.
FilterAction This property is required. GoogleCloudRetailV2betaRuleFilterActionResponse
Filters results.
ForceReturnFacetAction This property is required. GoogleCloudRetailV2betaRuleForceReturnFacetActionResponse
Force returns an attribute as a facet in the request.
IgnoreAction This property is required. GoogleCloudRetailV2betaRuleIgnoreActionResponse
Ignores specific terms from query during search.
OnewaySynonymsAction This property is required. GoogleCloudRetailV2betaRuleOnewaySynonymsActionResponse
Treats specific term as a synonym with a group of terms. Group of terms will not be treated as synonyms with the specific term.
RedirectAction This property is required. GoogleCloudRetailV2betaRuleRedirectActionResponse
Redirects a shopper to a specific page.
RemoveFacetAction This property is required. GoogleCloudRetailV2betaRuleRemoveFacetActionResponse
Remove an attribute as a facet in the request (if present).
ReplacementAction This property is required. GoogleCloudRetailV2betaRuleReplacementActionResponse
Replaces specific terms in the query.
TwowaySynonymsAction This property is required. GoogleCloudRetailV2betaRuleTwowaySynonymsActionResponse
Treats a set of terms as synonyms of one another.
boostAction This property is required. GoogleCloudRetailV2betaRuleBoostActionResponse
A boost action.
condition This property is required. GoogleCloudRetailV2betaConditionResponse
The condition that triggers the rule. If the condition is empty, the rule will always apply.
doNotAssociateAction This property is required. GoogleCloudRetailV2betaRuleDoNotAssociateActionResponse
Prevents term from being associated with other terms.
filterAction This property is required. GoogleCloudRetailV2betaRuleFilterActionResponse
Filters results.
forceReturnFacetAction This property is required. GoogleCloudRetailV2betaRuleForceReturnFacetActionResponse
Force returns an attribute as a facet in the request.
ignoreAction This property is required. GoogleCloudRetailV2betaRuleIgnoreActionResponse
Ignores specific terms from query during search.
onewaySynonymsAction This property is required. GoogleCloudRetailV2betaRuleOnewaySynonymsActionResponse
Treats specific term as a synonym with a group of terms. Group of terms will not be treated as synonyms with the specific term.
redirectAction This property is required. GoogleCloudRetailV2betaRuleRedirectActionResponse
Redirects a shopper to a specific page.
removeFacetAction This property is required. GoogleCloudRetailV2betaRuleRemoveFacetActionResponse
Remove an attribute as a facet in the request (if present).
replacementAction This property is required. GoogleCloudRetailV2betaRuleReplacementActionResponse
Replaces specific terms in the query.
twowaySynonymsAction This property is required. GoogleCloudRetailV2betaRuleTwowaySynonymsActionResponse
Treats a set of terms as synonyms of one another.
boostAction This property is required. GoogleCloudRetailV2betaRuleBoostActionResponse
A boost action.
condition This property is required. GoogleCloudRetailV2betaConditionResponse
The condition that triggers the rule. If the condition is empty, the rule will always apply.
doNotAssociateAction This property is required. GoogleCloudRetailV2betaRuleDoNotAssociateActionResponse
Prevents term from being associated with other terms.
filterAction This property is required. GoogleCloudRetailV2betaRuleFilterActionResponse
Filters results.
forceReturnFacetAction This property is required. GoogleCloudRetailV2betaRuleForceReturnFacetActionResponse
Force returns an attribute as a facet in the request.
ignoreAction This property is required. GoogleCloudRetailV2betaRuleIgnoreActionResponse
Ignores specific terms from query during search.
onewaySynonymsAction This property is required. GoogleCloudRetailV2betaRuleOnewaySynonymsActionResponse
Treats specific term as a synonym with a group of terms. Group of terms will not be treated as synonyms with the specific term.
redirectAction This property is required. GoogleCloudRetailV2betaRuleRedirectActionResponse
Redirects a shopper to a specific page.
removeFacetAction This property is required. GoogleCloudRetailV2betaRuleRemoveFacetActionResponse
Remove an attribute as a facet in the request (if present).
replacementAction This property is required. GoogleCloudRetailV2betaRuleReplacementActionResponse
Replaces specific terms in the query.
twowaySynonymsAction This property is required. GoogleCloudRetailV2betaRuleTwowaySynonymsActionResponse
Treats a set of terms as synonyms of one another.
boost_action This property is required. GoogleCloudRetailV2betaRuleBoostActionResponse
A boost action.
condition This property is required. GoogleCloudRetailV2betaConditionResponse
The condition that triggers the rule. If the condition is empty, the rule will always apply.
do_not_associate_action This property is required. GoogleCloudRetailV2betaRuleDoNotAssociateActionResponse
Prevents term from being associated with other terms.
filter_action This property is required. GoogleCloudRetailV2betaRuleFilterActionResponse
Filters results.
force_return_facet_action This property is required. GoogleCloudRetailV2betaRuleForceReturnFacetActionResponse
Force returns an attribute as a facet in the request.
ignore_action This property is required. GoogleCloudRetailV2betaRuleIgnoreActionResponse
Ignores specific terms from query during search.
oneway_synonyms_action This property is required. GoogleCloudRetailV2betaRuleOnewaySynonymsActionResponse
Treats specific term as a synonym with a group of terms. Group of terms will not be treated as synonyms with the specific term.
redirect_action This property is required. GoogleCloudRetailV2betaRuleRedirectActionResponse
Redirects a shopper to a specific page.
remove_facet_action This property is required. GoogleCloudRetailV2betaRuleRemoveFacetActionResponse
Remove an attribute as a facet in the request (if present).
replacement_action This property is required. GoogleCloudRetailV2betaRuleReplacementActionResponse
Replaces specific terms in the query.
twoway_synonyms_action This property is required. GoogleCloudRetailV2betaRuleTwowaySynonymsActionResponse
Treats a set of terms as synonyms of one another.
boostAction This property is required. Property Map
A boost action.
condition This property is required. Property Map
The condition that triggers the rule. If the condition is empty, the rule will always apply.
doNotAssociateAction This property is required. Property Map
Prevents term from being associated with other terms.
filterAction This property is required. Property Map
Filters results.
forceReturnFacetAction This property is required. Property Map
Force returns an attribute as a facet in the request.
ignoreAction This property is required. Property Map
Ignores specific terms from query during search.
onewaySynonymsAction This property is required. Property Map
Treats specific term as a synonym with a group of terms. Group of terms will not be treated as synonyms with the specific term.
redirectAction This property is required. Property Map
Redirects a shopper to a specific page.
removeFacetAction This property is required. Property Map
Remove an attribute as a facet in the request (if present).
replacementAction This property is required. Property Map
Replaces specific terms in the query.
twowaySynonymsAction This property is required. Property Map
Treats a set of terms as synonyms of one another.

GoogleCloudRetailV2betaRuleTwowaySynonymsActionResponse

Synonyms This property is required. List<string>
Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms.
Synonyms This property is required. []string
Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms.
synonyms This property is required. List<String>
Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms.
synonyms This property is required. string[]
Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms.
synonyms This property is required. Sequence[str]
Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms.
synonyms This property is required. List<String>
Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms.

GoogleCloudRetailV2betaSearchRequestFacetSpecFacetKeyResponse

CaseInsensitive This property is required. bool
True to make facet keys case insensitive when getting faceting values with prefixes or contains; false otherwise.
Contains This property is required. List<string>
Only get facet values that contains the given strings. For example, suppose "categories" has three values "Women > Shoe", "Women > Dress" and "Men > Shoe". If set "contains" to "Shoe", the "categories" facet gives only "Women > Shoe" and "Men > Shoe". Only supported on textual fields. Maximum is 10.
Intervals This property is required. List<Pulumi.GoogleNative.Retail.V2Beta.Inputs.GoogleCloudRetailV2betaIntervalResponse>
Set only if values should be bucketized into intervals. Must be set for facets with numerical values. Must not be set for facet with text values. Maximum number of intervals is 40. For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
Key This property is required. string
Supported textual and numerical facet keys in Product object, over which the facet values are computed. Facet key is case-sensitive. Allowed facet keys when FacetKey.query is not specified: * textual_field = * "brands" * "categories" * "genders" * "ageGroups" * "availability" * "colorFamilies" * "colors" * "sizes" * "materials" * "patterns" * "conditions" * "attributes.key" * "pickupInStore" * "shipToStore" * "sameDayDelivery" * "nextDayDelivery" * "customFulfillment1" * "customFulfillment2" * "customFulfillment3" * "customFulfillment4" * "customFulfillment5" * "inventory(place_id,attributes.key)" * numerical_field = * "price" * "discount" * "rating" * "ratingCount" * "attributes.key" * "inventory(place_id,price)" * "inventory(place_id,original_price)" * "inventory(place_id,attributes.key)"
OrderBy This property is required. string
The order in which SearchResponse.Facet.values are returned. Allowed values are: * "count desc", which means order by SearchResponse.Facet.values.count descending. * "value desc", which means order by SearchResponse.Facet.values.value descending. Only applies to textual facets. If not set, textual values are sorted in natural order; numerical intervals are sorted in the order given by FacetSpec.FacetKey.intervals; FulfillmentInfo.place_ids are sorted in the order given by FacetSpec.FacetKey.restricted_values.
Prefixes This property is required. List<string>
Only get facet values that start with the given string prefix. For example, suppose "categories" has three values "Women > Shoe", "Women > Dress" and "Men > Shoe". If set "prefixes" to "Women", the "categories" facet gives only "Women > Shoe" and "Women > Dress". Only supported on textual fields. Maximum is 10.
Query This property is required. string
The query that is used to compute facet for the given facet key. When provided, it overrides the default behavior of facet computation. The query syntax is the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Notice that there is no limitation on FacetKey.key when query is specified. In the response, SearchResponse.Facet.values.value is always "1" and SearchResponse.Facet.values.count is the number of results that match the query. For example, you can set a customized facet for "shipToStore", where FacetKey.key is "customizedShipToStore", and FacetKey.query is "availability: ANY("IN_STOCK") AND shipToStore: ANY("123")". Then the facet counts the products that are both in stock and ship to store "123".
RestrictedValues This property is required. List<string>
Only get facet for the given restricted values. For example, when using "pickupInStore" as key and set restricted values to ["store123", "store456"], only facets for "store123" and "store456" are returned. Only supported on predefined textual fields, custom textual attributes and fulfillments. Maximum is 20. Must be set for the fulfillment facet keys: * pickupInStore * shipToStore * sameDayDelivery * nextDayDelivery * customFulfillment1 * customFulfillment2 * customFulfillment3 * customFulfillment4 * customFulfillment5
ReturnMinMax This property is required. bool
Returns the min and max value for each numerical facet intervals. Ignored for textual facets.
CaseInsensitive This property is required. bool
True to make facet keys case insensitive when getting faceting values with prefixes or contains; false otherwise.
Contains This property is required. []string
Only get facet values that contains the given strings. For example, suppose "categories" has three values "Women > Shoe", "Women > Dress" and "Men > Shoe". If set "contains" to "Shoe", the "categories" facet gives only "Women > Shoe" and "Men > Shoe". Only supported on textual fields. Maximum is 10.
Intervals This property is required. []GoogleCloudRetailV2betaIntervalResponse
Set only if values should be bucketized into intervals. Must be set for facets with numerical values. Must not be set for facet with text values. Maximum number of intervals is 40. For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
Key This property is required. string
Supported textual and numerical facet keys in Product object, over which the facet values are computed. Facet key is case-sensitive. Allowed facet keys when FacetKey.query is not specified: * textual_field = * "brands" * "categories" * "genders" * "ageGroups" * "availability" * "colorFamilies" * "colors" * "sizes" * "materials" * "patterns" * "conditions" * "attributes.key" * "pickupInStore" * "shipToStore" * "sameDayDelivery" * "nextDayDelivery" * "customFulfillment1" * "customFulfillment2" * "customFulfillment3" * "customFulfillment4" * "customFulfillment5" * "inventory(place_id,attributes.key)" * numerical_field = * "price" * "discount" * "rating" * "ratingCount" * "attributes.key" * "inventory(place_id,price)" * "inventory(place_id,original_price)" * "inventory(place_id,attributes.key)"
OrderBy This property is required. string
The order in which SearchResponse.Facet.values are returned. Allowed values are: * "count desc", which means order by SearchResponse.Facet.values.count descending. * "value desc", which means order by SearchResponse.Facet.values.value descending. Only applies to textual facets. If not set, textual values are sorted in natural order; numerical intervals are sorted in the order given by FacetSpec.FacetKey.intervals; FulfillmentInfo.place_ids are sorted in the order given by FacetSpec.FacetKey.restricted_values.
Prefixes This property is required. []string
Only get facet values that start with the given string prefix. For example, suppose "categories" has three values "Women > Shoe", "Women > Dress" and "Men > Shoe". If set "prefixes" to "Women", the "categories" facet gives only "Women > Shoe" and "Women > Dress". Only supported on textual fields. Maximum is 10.
Query This property is required. string
The query that is used to compute facet for the given facet key. When provided, it overrides the default behavior of facet computation. The query syntax is the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Notice that there is no limitation on FacetKey.key when query is specified. In the response, SearchResponse.Facet.values.value is always "1" and SearchResponse.Facet.values.count is the number of results that match the query. For example, you can set a customized facet for "shipToStore", where FacetKey.key is "customizedShipToStore", and FacetKey.query is "availability: ANY("IN_STOCK") AND shipToStore: ANY("123")". Then the facet counts the products that are both in stock and ship to store "123".
RestrictedValues This property is required. []string
Only get facet for the given restricted values. For example, when using "pickupInStore" as key and set restricted values to ["store123", "store456"], only facets for "store123" and "store456" are returned. Only supported on predefined textual fields, custom textual attributes and fulfillments. Maximum is 20. Must be set for the fulfillment facet keys: * pickupInStore * shipToStore * sameDayDelivery * nextDayDelivery * customFulfillment1 * customFulfillment2 * customFulfillment3 * customFulfillment4 * customFulfillment5
ReturnMinMax This property is required. bool
Returns the min and max value for each numerical facet intervals. Ignored for textual facets.
caseInsensitive This property is required. Boolean
True to make facet keys case insensitive when getting faceting values with prefixes or contains; false otherwise.
contains This property is required. List<String>
Only get facet values that contains the given strings. For example, suppose "categories" has three values "Women > Shoe", "Women > Dress" and "Men > Shoe". If set "contains" to "Shoe", the "categories" facet gives only "Women > Shoe" and "Men > Shoe". Only supported on textual fields. Maximum is 10.
intervals This property is required. List<GoogleCloudRetailV2betaIntervalResponse>
Set only if values should be bucketized into intervals. Must be set for facets with numerical values. Must not be set for facet with text values. Maximum number of intervals is 40. For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
key This property is required. String
Supported textual and numerical facet keys in Product object, over which the facet values are computed. Facet key is case-sensitive. Allowed facet keys when FacetKey.query is not specified: * textual_field = * "brands" * "categories" * "genders" * "ageGroups" * "availability" * "colorFamilies" * "colors" * "sizes" * "materials" * "patterns" * "conditions" * "attributes.key" * "pickupInStore" * "shipToStore" * "sameDayDelivery" * "nextDayDelivery" * "customFulfillment1" * "customFulfillment2" * "customFulfillment3" * "customFulfillment4" * "customFulfillment5" * "inventory(place_id,attributes.key)" * numerical_field = * "price" * "discount" * "rating" * "ratingCount" * "attributes.key" * "inventory(place_id,price)" * "inventory(place_id,original_price)" * "inventory(place_id,attributes.key)"
orderBy This property is required. String
The order in which SearchResponse.Facet.values are returned. Allowed values are: * "count desc", which means order by SearchResponse.Facet.values.count descending. * "value desc", which means order by SearchResponse.Facet.values.value descending. Only applies to textual facets. If not set, textual values are sorted in natural order; numerical intervals are sorted in the order given by FacetSpec.FacetKey.intervals; FulfillmentInfo.place_ids are sorted in the order given by FacetSpec.FacetKey.restricted_values.
prefixes This property is required. List<String>
Only get facet values that start with the given string prefix. For example, suppose "categories" has three values "Women > Shoe", "Women > Dress" and "Men > Shoe". If set "prefixes" to "Women", the "categories" facet gives only "Women > Shoe" and "Women > Dress". Only supported on textual fields. Maximum is 10.
query This property is required. String
The query that is used to compute facet for the given facet key. When provided, it overrides the default behavior of facet computation. The query syntax is the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Notice that there is no limitation on FacetKey.key when query is specified. In the response, SearchResponse.Facet.values.value is always "1" and SearchResponse.Facet.values.count is the number of results that match the query. For example, you can set a customized facet for "shipToStore", where FacetKey.key is "customizedShipToStore", and FacetKey.query is "availability: ANY("IN_STOCK") AND shipToStore: ANY("123")". Then the facet counts the products that are both in stock and ship to store "123".
restrictedValues This property is required. List<String>
Only get facet for the given restricted values. For example, when using "pickupInStore" as key and set restricted values to ["store123", "store456"], only facets for "store123" and "store456" are returned. Only supported on predefined textual fields, custom textual attributes and fulfillments. Maximum is 20. Must be set for the fulfillment facet keys: * pickupInStore * shipToStore * sameDayDelivery * nextDayDelivery * customFulfillment1 * customFulfillment2 * customFulfillment3 * customFulfillment4 * customFulfillment5
returnMinMax This property is required. Boolean
Returns the min and max value for each numerical facet intervals. Ignored for textual facets.
caseInsensitive This property is required. boolean
True to make facet keys case insensitive when getting faceting values with prefixes or contains; false otherwise.
contains This property is required. string[]
Only get facet values that contains the given strings. For example, suppose "categories" has three values "Women > Shoe", "Women > Dress" and "Men > Shoe". If set "contains" to "Shoe", the "categories" facet gives only "Women > Shoe" and "Men > Shoe". Only supported on textual fields. Maximum is 10.
intervals This property is required. GoogleCloudRetailV2betaIntervalResponse[]
Set only if values should be bucketized into intervals. Must be set for facets with numerical values. Must not be set for facet with text values. Maximum number of intervals is 40. For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
key This property is required. string
Supported textual and numerical facet keys in Product object, over which the facet values are computed. Facet key is case-sensitive. Allowed facet keys when FacetKey.query is not specified: * textual_field = * "brands" * "categories" * "genders" * "ageGroups" * "availability" * "colorFamilies" * "colors" * "sizes" * "materials" * "patterns" * "conditions" * "attributes.key" * "pickupInStore" * "shipToStore" * "sameDayDelivery" * "nextDayDelivery" * "customFulfillment1" * "customFulfillment2" * "customFulfillment3" * "customFulfillment4" * "customFulfillment5" * "inventory(place_id,attributes.key)" * numerical_field = * "price" * "discount" * "rating" * "ratingCount" * "attributes.key" * "inventory(place_id,price)" * "inventory(place_id,original_price)" * "inventory(place_id,attributes.key)"
orderBy This property is required. string
The order in which SearchResponse.Facet.values are returned. Allowed values are: * "count desc", which means order by SearchResponse.Facet.values.count descending. * "value desc", which means order by SearchResponse.Facet.values.value descending. Only applies to textual facets. If not set, textual values are sorted in natural order; numerical intervals are sorted in the order given by FacetSpec.FacetKey.intervals; FulfillmentInfo.place_ids are sorted in the order given by FacetSpec.FacetKey.restricted_values.
prefixes This property is required. string[]
Only get facet values that start with the given string prefix. For example, suppose "categories" has three values "Women > Shoe", "Women > Dress" and "Men > Shoe". If set "prefixes" to "Women", the "categories" facet gives only "Women > Shoe" and "Women > Dress". Only supported on textual fields. Maximum is 10.
query This property is required. string
The query that is used to compute facet for the given facet key. When provided, it overrides the default behavior of facet computation. The query syntax is the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Notice that there is no limitation on FacetKey.key when query is specified. In the response, SearchResponse.Facet.values.value is always "1" and SearchResponse.Facet.values.count is the number of results that match the query. For example, you can set a customized facet for "shipToStore", where FacetKey.key is "customizedShipToStore", and FacetKey.query is "availability: ANY("IN_STOCK") AND shipToStore: ANY("123")". Then the facet counts the products that are both in stock and ship to store "123".
restrictedValues This property is required. string[]
Only get facet for the given restricted values. For example, when using "pickupInStore" as key and set restricted values to ["store123", "store456"], only facets for "store123" and "store456" are returned. Only supported on predefined textual fields, custom textual attributes and fulfillments. Maximum is 20. Must be set for the fulfillment facet keys: * pickupInStore * shipToStore * sameDayDelivery * nextDayDelivery * customFulfillment1 * customFulfillment2 * customFulfillment3 * customFulfillment4 * customFulfillment5
returnMinMax This property is required. boolean
Returns the min and max value for each numerical facet intervals. Ignored for textual facets.
case_insensitive This property is required. bool
True to make facet keys case insensitive when getting faceting values with prefixes or contains; false otherwise.
contains This property is required. Sequence[str]
Only get facet values that contains the given strings. For example, suppose "categories" has three values "Women > Shoe", "Women > Dress" and "Men > Shoe". If set "contains" to "Shoe", the "categories" facet gives only "Women > Shoe" and "Men > Shoe". Only supported on textual fields. Maximum is 10.
intervals This property is required. Sequence[GoogleCloudRetailV2betaIntervalResponse]
Set only if values should be bucketized into intervals. Must be set for facets with numerical values. Must not be set for facet with text values. Maximum number of intervals is 40. For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
key This property is required. str
Supported textual and numerical facet keys in Product object, over which the facet values are computed. Facet key is case-sensitive. Allowed facet keys when FacetKey.query is not specified: * textual_field = * "brands" * "categories" * "genders" * "ageGroups" * "availability" * "colorFamilies" * "colors" * "sizes" * "materials" * "patterns" * "conditions" * "attributes.key" * "pickupInStore" * "shipToStore" * "sameDayDelivery" * "nextDayDelivery" * "customFulfillment1" * "customFulfillment2" * "customFulfillment3" * "customFulfillment4" * "customFulfillment5" * "inventory(place_id,attributes.key)" * numerical_field = * "price" * "discount" * "rating" * "ratingCount" * "attributes.key" * "inventory(place_id,price)" * "inventory(place_id,original_price)" * "inventory(place_id,attributes.key)"
order_by This property is required. str
The order in which SearchResponse.Facet.values are returned. Allowed values are: * "count desc", which means order by SearchResponse.Facet.values.count descending. * "value desc", which means order by SearchResponse.Facet.values.value descending. Only applies to textual facets. If not set, textual values are sorted in natural order; numerical intervals are sorted in the order given by FacetSpec.FacetKey.intervals; FulfillmentInfo.place_ids are sorted in the order given by FacetSpec.FacetKey.restricted_values.
prefixes This property is required. Sequence[str]
Only get facet values that start with the given string prefix. For example, suppose "categories" has three values "Women > Shoe", "Women > Dress" and "Men > Shoe". If set "prefixes" to "Women", the "categories" facet gives only "Women > Shoe" and "Women > Dress". Only supported on textual fields. Maximum is 10.
query This property is required. str
The query that is used to compute facet for the given facet key. When provided, it overrides the default behavior of facet computation. The query syntax is the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Notice that there is no limitation on FacetKey.key when query is specified. In the response, SearchResponse.Facet.values.value is always "1" and SearchResponse.Facet.values.count is the number of results that match the query. For example, you can set a customized facet for "shipToStore", where FacetKey.key is "customizedShipToStore", and FacetKey.query is "availability: ANY("IN_STOCK") AND shipToStore: ANY("123")". Then the facet counts the products that are both in stock and ship to store "123".
restricted_values This property is required. Sequence[str]
Only get facet for the given restricted values. For example, when using "pickupInStore" as key and set restricted values to ["store123", "store456"], only facets for "store123" and "store456" are returned. Only supported on predefined textual fields, custom textual attributes and fulfillments. Maximum is 20. Must be set for the fulfillment facet keys: * pickupInStore * shipToStore * sameDayDelivery * nextDayDelivery * customFulfillment1 * customFulfillment2 * customFulfillment3 * customFulfillment4 * customFulfillment5
return_min_max This property is required. bool
Returns the min and max value for each numerical facet intervals. Ignored for textual facets.
caseInsensitive This property is required. Boolean
True to make facet keys case insensitive when getting faceting values with prefixes or contains; false otherwise.
contains This property is required. List<String>
Only get facet values that contains the given strings. For example, suppose "categories" has three values "Women > Shoe", "Women > Dress" and "Men > Shoe". If set "contains" to "Shoe", the "categories" facet gives only "Women > Shoe" and "Men > Shoe". Only supported on textual fields. Maximum is 10.
intervals This property is required. List<Property Map>
Set only if values should be bucketized into intervals. Must be set for facets with numerical values. Must not be set for facet with text values. Maximum number of intervals is 40. For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90, and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles become the bounds for its intervals and are returned in the response. If the facet key intervals are specified in the request, then the specified intervals are returned instead.
key This property is required. String
Supported textual and numerical facet keys in Product object, over which the facet values are computed. Facet key is case-sensitive. Allowed facet keys when FacetKey.query is not specified: * textual_field = * "brands" * "categories" * "genders" * "ageGroups" * "availability" * "colorFamilies" * "colors" * "sizes" * "materials" * "patterns" * "conditions" * "attributes.key" * "pickupInStore" * "shipToStore" * "sameDayDelivery" * "nextDayDelivery" * "customFulfillment1" * "customFulfillment2" * "customFulfillment3" * "customFulfillment4" * "customFulfillment5" * "inventory(place_id,attributes.key)" * numerical_field = * "price" * "discount" * "rating" * "ratingCount" * "attributes.key" * "inventory(place_id,price)" * "inventory(place_id,original_price)" * "inventory(place_id,attributes.key)"
orderBy This property is required. String
The order in which SearchResponse.Facet.values are returned. Allowed values are: * "count desc", which means order by SearchResponse.Facet.values.count descending. * "value desc", which means order by SearchResponse.Facet.values.value descending. Only applies to textual facets. If not set, textual values are sorted in natural order; numerical intervals are sorted in the order given by FacetSpec.FacetKey.intervals; FulfillmentInfo.place_ids are sorted in the order given by FacetSpec.FacetKey.restricted_values.
prefixes This property is required. List<String>
Only get facet values that start with the given string prefix. For example, suppose "categories" has three values "Women > Shoe", "Women > Dress" and "Men > Shoe". If set "prefixes" to "Women", the "categories" facet gives only "Women > Shoe" and "Women > Dress". Only supported on textual fields. Maximum is 10.
query This property is required. String
The query that is used to compute facet for the given facet key. When provided, it overrides the default behavior of facet computation. The query syntax is the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Notice that there is no limitation on FacetKey.key when query is specified. In the response, SearchResponse.Facet.values.value is always "1" and SearchResponse.Facet.values.count is the number of results that match the query. For example, you can set a customized facet for "shipToStore", where FacetKey.key is "customizedShipToStore", and FacetKey.query is "availability: ANY("IN_STOCK") AND shipToStore: ANY("123")". Then the facet counts the products that are both in stock and ship to store "123".
restrictedValues This property is required. List<String>
Only get facet for the given restricted values. For example, when using "pickupInStore" as key and set restricted values to ["store123", "store456"], only facets for "store123" and "store456" are returned. Only supported on predefined textual fields, custom textual attributes and fulfillments. Maximum is 20. Must be set for the fulfillment facet keys: * pickupInStore * shipToStore * sameDayDelivery * nextDayDelivery * customFulfillment1 * customFulfillment2 * customFulfillment3 * customFulfillment4 * customFulfillment5
returnMinMax This property is required. Boolean
Returns the min and max value for each numerical facet intervals. Ignored for textual facets.

GoogleCloudRetailV2betaSearchRequestFacetSpecResponse

EnableDynamicPosition This property is required. bool
Enables dynamic position for this facet. If set to true, the position of this facet among all facets in the response is determined by Google Retail Search. It is ordered together with dynamic facets if dynamic facets is enabled. If set to false, the position of this facet in the response is the same as in the request, and it is ranked before the facets with dynamic position enable and all dynamic facets. For example, you may always want to have rating facet returned in the response, but it's not necessarily to always display the rating facet at the top. In that case, you can set enable_dynamic_position to true so that the position of rating facet in response is determined by Google Retail Search. Another example, assuming you have the following facets in the request: * "rating", enable_dynamic_position = true * "price", enable_dynamic_position = false * "brands", enable_dynamic_position = false And also you have a dynamic facets enable, which generates a facet "gender". Then, the final order of the facets in the response can be ("price", "brands", "rating", "gender") or ("price", "brands", "gender", "rating") depends on how Google Retail Search orders "gender" and "rating" facets. However, notice that "price" and "brands" are always ranked at first and second position because their enable_dynamic_position values are false.
ExcludedFilterKeys This property is required. List<string>
List of keys to exclude when faceting. By default, FacetKey.key is not excluded from the filter unless it is listed in this field. Listing a facet key in this field allows its values to appear as facet results, even when they are filtered out of search results. Using this field does not affect what search results are returned. For example, suppose there are 100 products with the color facet "Red" and 200 products with the color facet "Blue". A query containing the filter "colorFamilies:ANY("Red")" and having "colorFamilies" as FacetKey.key would by default return only "Red" products in the search results, and also return "Red" with count 100 as the only color facet. Although there are also blue products available, "Blue" would not be shown as an available facet value. If "colorFamilies" is listed in "excludedFilterKeys", then the query returns the facet values "Red" with count 100 and "Blue" with count 200, because the "colorFamilies" key is now excluded from the filter. Because this field doesn't affect search results, the search results are still correctly filtered to return only "Red" products. A maximum of 100 values are allowed. Otherwise, an INVALID_ARGUMENT error is returned.
FacetKey This property is required. Pulumi.GoogleNative.Retail.V2Beta.Inputs.GoogleCloudRetailV2betaSearchRequestFacetSpecFacetKeyResponse
The facet key specification.
Limit This property is required. int
Maximum of facet values that should be returned for this facet. If unspecified, defaults to 50. The maximum allowed value is 300. Values above 300 will be coerced to 300. If this field is negative, an INVALID_ARGUMENT is returned.
EnableDynamicPosition This property is required. bool
Enables dynamic position for this facet. If set to true, the position of this facet among all facets in the response is determined by Google Retail Search. It is ordered together with dynamic facets if dynamic facets is enabled. If set to false, the position of this facet in the response is the same as in the request, and it is ranked before the facets with dynamic position enable and all dynamic facets. For example, you may always want to have rating facet returned in the response, but it's not necessarily to always display the rating facet at the top. In that case, you can set enable_dynamic_position to true so that the position of rating facet in response is determined by Google Retail Search. Another example, assuming you have the following facets in the request: * "rating", enable_dynamic_position = true * "price", enable_dynamic_position = false * "brands", enable_dynamic_position = false And also you have a dynamic facets enable, which generates a facet "gender". Then, the final order of the facets in the response can be ("price", "brands", "rating", "gender") or ("price", "brands", "gender", "rating") depends on how Google Retail Search orders "gender" and "rating" facets. However, notice that "price" and "brands" are always ranked at first and second position because their enable_dynamic_position values are false.
ExcludedFilterKeys This property is required. []string
List of keys to exclude when faceting. By default, FacetKey.key is not excluded from the filter unless it is listed in this field. Listing a facet key in this field allows its values to appear as facet results, even when they are filtered out of search results. Using this field does not affect what search results are returned. For example, suppose there are 100 products with the color facet "Red" and 200 products with the color facet "Blue". A query containing the filter "colorFamilies:ANY("Red")" and having "colorFamilies" as FacetKey.key would by default return only "Red" products in the search results, and also return "Red" with count 100 as the only color facet. Although there are also blue products available, "Blue" would not be shown as an available facet value. If "colorFamilies" is listed in "excludedFilterKeys", then the query returns the facet values "Red" with count 100 and "Blue" with count 200, because the "colorFamilies" key is now excluded from the filter. Because this field doesn't affect search results, the search results are still correctly filtered to return only "Red" products. A maximum of 100 values are allowed. Otherwise, an INVALID_ARGUMENT error is returned.
FacetKey This property is required. GoogleCloudRetailV2betaSearchRequestFacetSpecFacetKeyResponse
The facet key specification.
Limit This property is required. int
Maximum of facet values that should be returned for this facet. If unspecified, defaults to 50. The maximum allowed value is 300. Values above 300 will be coerced to 300. If this field is negative, an INVALID_ARGUMENT is returned.
enableDynamicPosition This property is required. Boolean
Enables dynamic position for this facet. If set to true, the position of this facet among all facets in the response is determined by Google Retail Search. It is ordered together with dynamic facets if dynamic facets is enabled. If set to false, the position of this facet in the response is the same as in the request, and it is ranked before the facets with dynamic position enable and all dynamic facets. For example, you may always want to have rating facet returned in the response, but it's not necessarily to always display the rating facet at the top. In that case, you can set enable_dynamic_position to true so that the position of rating facet in response is determined by Google Retail Search. Another example, assuming you have the following facets in the request: * "rating", enable_dynamic_position = true * "price", enable_dynamic_position = false * "brands", enable_dynamic_position = false And also you have a dynamic facets enable, which generates a facet "gender". Then, the final order of the facets in the response can be ("price", "brands", "rating", "gender") or ("price", "brands", "gender", "rating") depends on how Google Retail Search orders "gender" and "rating" facets. However, notice that "price" and "brands" are always ranked at first and second position because their enable_dynamic_position values are false.
excludedFilterKeys This property is required. List<String>
List of keys to exclude when faceting. By default, FacetKey.key is not excluded from the filter unless it is listed in this field. Listing a facet key in this field allows its values to appear as facet results, even when they are filtered out of search results. Using this field does not affect what search results are returned. For example, suppose there are 100 products with the color facet "Red" and 200 products with the color facet "Blue". A query containing the filter "colorFamilies:ANY("Red")" and having "colorFamilies" as FacetKey.key would by default return only "Red" products in the search results, and also return "Red" with count 100 as the only color facet. Although there are also blue products available, "Blue" would not be shown as an available facet value. If "colorFamilies" is listed in "excludedFilterKeys", then the query returns the facet values "Red" with count 100 and "Blue" with count 200, because the "colorFamilies" key is now excluded from the filter. Because this field doesn't affect search results, the search results are still correctly filtered to return only "Red" products. A maximum of 100 values are allowed. Otherwise, an INVALID_ARGUMENT error is returned.
facetKey This property is required. GoogleCloudRetailV2betaSearchRequestFacetSpecFacetKeyResponse
The facet key specification.
limit This property is required. Integer
Maximum of facet values that should be returned for this facet. If unspecified, defaults to 50. The maximum allowed value is 300. Values above 300 will be coerced to 300. If this field is negative, an INVALID_ARGUMENT is returned.
enableDynamicPosition This property is required. boolean
Enables dynamic position for this facet. If set to true, the position of this facet among all facets in the response is determined by Google Retail Search. It is ordered together with dynamic facets if dynamic facets is enabled. If set to false, the position of this facet in the response is the same as in the request, and it is ranked before the facets with dynamic position enable and all dynamic facets. For example, you may always want to have rating facet returned in the response, but it's not necessarily to always display the rating facet at the top. In that case, you can set enable_dynamic_position to true so that the position of rating facet in response is determined by Google Retail Search. Another example, assuming you have the following facets in the request: * "rating", enable_dynamic_position = true * "price", enable_dynamic_position = false * "brands", enable_dynamic_position = false And also you have a dynamic facets enable, which generates a facet "gender". Then, the final order of the facets in the response can be ("price", "brands", "rating", "gender") or ("price", "brands", "gender", "rating") depends on how Google Retail Search orders "gender" and "rating" facets. However, notice that "price" and "brands" are always ranked at first and second position because their enable_dynamic_position values are false.
excludedFilterKeys This property is required. string[]
List of keys to exclude when faceting. By default, FacetKey.key is not excluded from the filter unless it is listed in this field. Listing a facet key in this field allows its values to appear as facet results, even when they are filtered out of search results. Using this field does not affect what search results are returned. For example, suppose there are 100 products with the color facet "Red" and 200 products with the color facet "Blue". A query containing the filter "colorFamilies:ANY("Red")" and having "colorFamilies" as FacetKey.key would by default return only "Red" products in the search results, and also return "Red" with count 100 as the only color facet. Although there are also blue products available, "Blue" would not be shown as an available facet value. If "colorFamilies" is listed in "excludedFilterKeys", then the query returns the facet values "Red" with count 100 and "Blue" with count 200, because the "colorFamilies" key is now excluded from the filter. Because this field doesn't affect search results, the search results are still correctly filtered to return only "Red" products. A maximum of 100 values are allowed. Otherwise, an INVALID_ARGUMENT error is returned.
facetKey This property is required. GoogleCloudRetailV2betaSearchRequestFacetSpecFacetKeyResponse
The facet key specification.
limit This property is required. number
Maximum of facet values that should be returned for this facet. If unspecified, defaults to 50. The maximum allowed value is 300. Values above 300 will be coerced to 300. If this field is negative, an INVALID_ARGUMENT is returned.
enable_dynamic_position This property is required. bool
Enables dynamic position for this facet. If set to true, the position of this facet among all facets in the response is determined by Google Retail Search. It is ordered together with dynamic facets if dynamic facets is enabled. If set to false, the position of this facet in the response is the same as in the request, and it is ranked before the facets with dynamic position enable and all dynamic facets. For example, you may always want to have rating facet returned in the response, but it's not necessarily to always display the rating facet at the top. In that case, you can set enable_dynamic_position to true so that the position of rating facet in response is determined by Google Retail Search. Another example, assuming you have the following facets in the request: * "rating", enable_dynamic_position = true * "price", enable_dynamic_position = false * "brands", enable_dynamic_position = false And also you have a dynamic facets enable, which generates a facet "gender". Then, the final order of the facets in the response can be ("price", "brands", "rating", "gender") or ("price", "brands", "gender", "rating") depends on how Google Retail Search orders "gender" and "rating" facets. However, notice that "price" and "brands" are always ranked at first and second position because their enable_dynamic_position values are false.
excluded_filter_keys This property is required. Sequence[str]
List of keys to exclude when faceting. By default, FacetKey.key is not excluded from the filter unless it is listed in this field. Listing a facet key in this field allows its values to appear as facet results, even when they are filtered out of search results. Using this field does not affect what search results are returned. For example, suppose there are 100 products with the color facet "Red" and 200 products with the color facet "Blue". A query containing the filter "colorFamilies:ANY("Red")" and having "colorFamilies" as FacetKey.key would by default return only "Red" products in the search results, and also return "Red" with count 100 as the only color facet. Although there are also blue products available, "Blue" would not be shown as an available facet value. If "colorFamilies" is listed in "excludedFilterKeys", then the query returns the facet values "Red" with count 100 and "Blue" with count 200, because the "colorFamilies" key is now excluded from the filter. Because this field doesn't affect search results, the search results are still correctly filtered to return only "Red" products. A maximum of 100 values are allowed. Otherwise, an INVALID_ARGUMENT error is returned.
facet_key This property is required. GoogleCloudRetailV2betaSearchRequestFacetSpecFacetKeyResponse
The facet key specification.
limit This property is required. int
Maximum of facet values that should be returned for this facet. If unspecified, defaults to 50. The maximum allowed value is 300. Values above 300 will be coerced to 300. If this field is negative, an INVALID_ARGUMENT is returned.
enableDynamicPosition This property is required. Boolean
Enables dynamic position for this facet. If set to true, the position of this facet among all facets in the response is determined by Google Retail Search. It is ordered together with dynamic facets if dynamic facets is enabled. If set to false, the position of this facet in the response is the same as in the request, and it is ranked before the facets with dynamic position enable and all dynamic facets. For example, you may always want to have rating facet returned in the response, but it's not necessarily to always display the rating facet at the top. In that case, you can set enable_dynamic_position to true so that the position of rating facet in response is determined by Google Retail Search. Another example, assuming you have the following facets in the request: * "rating", enable_dynamic_position = true * "price", enable_dynamic_position = false * "brands", enable_dynamic_position = false And also you have a dynamic facets enable, which generates a facet "gender". Then, the final order of the facets in the response can be ("price", "brands", "rating", "gender") or ("price", "brands", "gender", "rating") depends on how Google Retail Search orders "gender" and "rating" facets. However, notice that "price" and "brands" are always ranked at first and second position because their enable_dynamic_position values are false.
excludedFilterKeys This property is required. List<String>
List of keys to exclude when faceting. By default, FacetKey.key is not excluded from the filter unless it is listed in this field. Listing a facet key in this field allows its values to appear as facet results, even when they are filtered out of search results. Using this field does not affect what search results are returned. For example, suppose there are 100 products with the color facet "Red" and 200 products with the color facet "Blue". A query containing the filter "colorFamilies:ANY("Red")" and having "colorFamilies" as FacetKey.key would by default return only "Red" products in the search results, and also return "Red" with count 100 as the only color facet. Although there are also blue products available, "Blue" would not be shown as an available facet value. If "colorFamilies" is listed in "excludedFilterKeys", then the query returns the facet values "Red" with count 100 and "Blue" with count 200, because the "colorFamilies" key is now excluded from the filter. Because this field doesn't affect search results, the search results are still correctly filtered to return only "Red" products. A maximum of 100 values are allowed. Otherwise, an INVALID_ARGUMENT error is returned.
facetKey This property is required. Property Map
The facet key specification.
limit This property is required. Number
Maximum of facet values that should be returned for this facet. If unspecified, defaults to 50. The maximum allowed value is 300. Values above 300 will be coerced to 300. If this field is negative, an INVALID_ARGUMENT is returned.

Package Details

Repository
Google Cloud Native pulumi/pulumi-google-native
License
Apache-2.0

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi