Console
    Contact Us Start free

    SearchResponse

    Response message for SearchService.Search method.

    JSON representation 
     { 
 "results" 
 : 
 [ 
 { 
 object (  SearchResult 
 
) 
 } 
 ] 
 , 
 "facets" 
 : 
 [ 
 { 
 object (  Facet 
 
) 
 } 
 ] 
 , 
 "totalSize" 
 : 
 integer 
 , 
 "correctedQuery" 
 : 
 string 
 , 
 "attributionToken" 
 : 
 string 
 , 
 "nextPageToken" 
 : 
 string 
 , 
 "queryExpansionInfo" 
 : 
 { 
 object (  QueryExpansionInfo 
 
) 
 } 
 , 
 "redirectUri" 
 : 
 string 
 , 
 "appliedControls" 
 : 
 [ 
 string 
 ] 
 , 
 "pinControlMetadata" 
 : 
 { 
 object (  PinControlMetadata 
 
) 
 } 
 , 
 "invalidConditionBoostSpecs" 
 : 
 [ 
 { 
 object (  ConditionBoostSpec 
 
) 
 } 
 ] 
 , 
 "experimentInfo" 
 : 
 [ 
 { 
 object (  ExperimentInfo 
 
) 
 } 
 ] 
 , 
 "conversationalSearchResult" 
 : 
 { 
 object (  ConversationalSearchResult 
 
) 
 } 
 , 
 "tileNavigationResult" 
 : 
 { 
 object (  TileNavigationResult 
 
) 
 } 
 }
    Fields
    results[]

    object ( SearchResult )

    A list of matched items. The order represents the ranking.
    facets[]

    object ( Facet )

    Results of facets requested by user.
    totalSize

    integer

    The estimated total count of matched items irrespective of pagination. The count of results returned by pagination may be less than the totalSize that matches.
    correctedQuery

    string

    Contains the spell corrected query, if found. If the spell correction type is AUTOMATIC, then the search results are based on correctedQuery. Otherwise the original query is used for search.
    attributionToken

    string

    A unique search token. This should be included in the UserEvent logs resulting from this search, which enables accurate attribution of search model performance.
    nextPageToken

    string

    A token that can be sent as SearchRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.
    queryExpansionInfo

    object ( QueryExpansionInfo )

    Query expansion information for the returned results.
    redirectUri

    string

    The URI of a customer-defined redirect page. If redirect action is triggered, no search is performed, and only redirectUri and attributionToken are set in the response.
    appliedControls[]

    string

    The fully qualified resource name of applied controls .
    pinControlMetadata

    object ( PinControlMetadata )

    Metadata for pin controls which were applicable to the request. This contains two map fields, one for all matched pins and one for pins which were matched but not applied.

    The two maps are keyed by pin position, and the values are the product ids which were matched to that pin.
    invalidConditionBoostSpecs[]

    object ( ConditionBoostSpec )

    The invalid SearchRequest.BoostSpec.condition_boost_specs that are not applied during serving.
    experimentInfo[]

    object ( ExperimentInfo )

    Metadata related to A/B testing experiment associated with this response. Only exists when an experiment is triggered.
    conversationalSearchResult

    object ( ConversationalSearchResult )

    This field specifies all related information that is needed on client side for UI rendering of conversational retail search.
    tileNavigationResult

    object ( TileNavigationResult )

    This field specifies all related information for tile navigation that will be used in client side.

    SearchResult

    Represents the search results.

    JSON representation 
     { 
 "id" 
 : 
 string 
 , 
 "product" 
 : 
 { 
 object (  Product 
 
) 
 } 
 , 
 "matchingVariantCount" 
 : 
 integer 
 , 
 "matchingVariantFields" 
 : 
 { 
 string 
 : 
 string 
 , 
 ... 
 } 
 , 
 "variantRollupValues" 
 : 
 { 
 string 
 : 
 value 
 , 
 ... 
 } 
 , 
 "personalLabels" 
 : 
 [ 
 string 
 ] 
 , 
 "modelScores" 
 : 
 { 
 string 
 : 
 { 
 object (  DoubleList 
 
) 
 } 
 , 
 ... 
 } 
 }
    Fields
    id

    string

    Product.id of the searched Product .

    product

    object ( Product )

    The product data snippet in the search response. Only Product.name is guaranteed to be populated.

    Product.variants contains the product variants that match the search query. If there are multiple product variants matching the query, top 5 most relevant product variants are returned and ordered by relevancy.

    If relevancy can be deternmined, use matchingVariantFields to look up matched product variants fields. If relevancy cannot be determined, e.g. when searching "shoe" all products in a shoe product can be a match, 5 product variants are returned but order is meaningless.

    matchingVariantCount

    integer

    The count of matched variant Product s.

    matchingVariantFields

    map (key: string, value: string ( FieldMask format))

    If a variant Product matches the search query, this map indicates which Product fields are matched. The key is the Product.name , the value is a field mask of the matched Product fields. If matched attributes cannot be determined, this map will be empty.

    For example, a key "sku1" with field mask "products.color_info" indicates there is a match between "sku1" ColorInfo and the query.

    variantRollupValues

    map (key: string, value: value ( Value format))

    The rollup matching variant Product attributes. The key is one of the SearchRequest.variant_rollup_keys . The values are the merged and de-duplicated Product attributes. Notice that the rollup values are respect filter. For example, when filtering by "colorFamilies:ANY("red")" and rollup "colorFamilies", only "red" is returned.

    For textual and numerical attributes, the rollup values is a list of string or double values with type google.protobuf.ListValue . For example, if there are two variants with colors "red" and "blue", the rollup values are

     { key: "colorFamilies"
  value {
    listValue {
      values { stringValue: "red" }
      values { stringValue: "blue" }
     }
  }
}

    For FulfillmentInfo , the rollup values is a double value with type google.protobuf.Value . For example, {key: "pickupInStore.store1" value { numberValue: 10 }} means a there are 10 variants in this product are available in the store "store1".

    personalLabels[]

    string

    Specifies previous events related to this product for this user based on UserEvent with same SearchRequest.visitor_id or UserInfo.user_id .

    This is set only when SearchRequest.PersonalizationSpec.mode is SearchRequest.PersonalizationSpec.Mode.AUTO .

    Possible values:

    • purchased : Indicates that this product has been purchased before.
    modelScores

    map (key: string, value: object ( DoubleList ))

    Google provided available scores.

    DoubleList

    A message with a list of double values.

    JSON representation 
     { 
 "values" 
 : 
 [ 
 number 
 ] 
 }
    Fields
    values[]

    number

    The list of double values.

    QueryExpansionInfo

    Information describing query expansion including whether expansion has occurred.

    JSON representation 
     { 
 "expandedQuery" 
 : 
 boolean 
 , 
 "pinnedResultCount" 
 : 
 string 
 }
    Fields
    expandedQuery

    boolean

    Bool describing whether query expansion has occurred.
    pinnedResultCount

    string ( int64 format)

    Number of pinned results. This field will only be set when expansion happens and SearchRequest.QueryExpansionSpec.pin_unexpanded_results is set to true.

    PinControlMetadata

    Metadata for pinning to be returned in the response. This is used for distinguishing between applied vs dropped pins.

    JSON representation 
     { 
 "allMatchedPins" 
 : 
 { 
 string 
 : 
 { 
 object (  ProductPins 
 
) 
 } 
 , 
 ... 
 } 
 , 
 "droppedPins" 
 : 
 { 
 string 
 : 
 { 
 object (  ProductPins 
 
) 
 } 
 , 
 ... 
 } 
 }
    Fields
    allMatchedPins

    map (key: string ( int64 format), value: object ( ProductPins ))

    Map of all matched pins, keyed by pin position.
    droppedPins

    map (key: string ( int64 format), value: object ( ProductPins ))

    Map of pins that were dropped due to overlap with other matching pins, keyed by pin position.

    ProductPins

    List of product ids which have associated pins.

    JSON representation 
     { 
 "productId" 
 : 
 [ 
 string 
 ] 
 }
    Fields
    productId[]

    string

    List of product ids which have associated pins.

    ExperimentInfo

    Metadata for active A/B testing experiment.

    JSON representation 
     { 
 "experiment" 
 : 
 string 
 , 
 // Union field experiment_metadata 
can be only one of the following: 
 "servingConfigExperiment" 
 : 
 { 
 object (  ServingConfigExperiment 
 
) 
 } 
 // End of list of possible types for union field experiment_metadata 
. 
 }
    Fields
    experiment

    string

    The fully qualified resource name of the experiment that provides the serving config under test, should an active experiment exist. For example: projects/*/locations/global/catalogs/default_catalog/experiments/experimentId

    Union field experiment_metadata . Information associated with the specific experiment entity being recorded. experiment_metadata can be only one of the following:
    servingConfigExperiment

    object ( ServingConfigExperiment )

    A/B test between existing Cloud Retail Search ServingConfig s.

    ServingConfigExperiment

    Metadata for active serving config A/B tests.

    JSON representation 
     { 
 "originalServingConfig" 
 : 
 string 
 , 
 "experimentServingConfig" 
 : 
 string 
 }
    Fields
    originalServingConfig

    string

    The fully qualified resource name of the original SearchRequest.placement in the search request prior to reassignment by experiment API. For example: projects/*/locations/*/catalogs/*/servingConfigs/* .
    experimentServingConfig

    string

    The fully qualified resource name of the serving config Experiment.VariantArm.serving_config_id responsible for generating the search response. For example: projects/*/locations/*/catalogs/*/servingConfigs/* .

    ConversationalSearchResult

    This field specifies all related information that is needed on client side for UI rendering of conversational retail search.

    JSON representation 
     { 
 "conversationId" 
 : 
 string 
 , 
 "refinedQuery" 
 : 
 string 
 , 
 "additionalFilters" 
 : 
 [ 
 { 
 object (  AdditionalFilter 
 
) 
 } 
 ] 
 , 
 "followupQuestion" 
 : 
 string 
 , 
 "suggestedAnswers" 
 : 
 [ 
 { 
 object (  SuggestedAnswer 
 
) 
 } 
 ] 
 , 
 "additionalFilter" 
 : 
 { 
 object (  AdditionalFilter 
 
) 
 } 
 , 
 "textResult" 
 : 
 string 
 , 
 "queryType" 
 : 
 enum (  QueryType 
 
) 
 , 
 "queryTypes" 
 : 
 [ 
 enum (  QueryType 
 
) 
 ] 
 }
    Fields
    conversationId

    string

    Conversation UUID. This field will be stored in client side storage to maintain the conversation session with server and will be used for next search request's SearchRequest.ConversationalSearchSpec.conversation_id to restore conversation state in server.
    refinedQuery

    string

    The current refined query for the conversational search. This field will be used in customer UI that the query in the search bar should be replaced with the refined query. For example, if SearchRequest.query is dress and next SearchRequest.ConversationalSearchSpec.UserAnswer.text_answer is red color , which does not match any product attribute value filters, the refined query will be dress, red color .
    additionalFilters[]
    (deprecated)

    object ( AdditionalFilter )

    This field is deprecated but will be kept for backward compatibility. There is expected to have only one additional filter and the value will be the same to the same as field additionalFilter .
    followupQuestion

    string

    The follow-up question. e.g., What is the color?

    suggestedAnswers[]

    object ( SuggestedAnswer )

    The answer options provided to client for the follow-up question.
    additionalFilter

    object ( AdditionalFilter )

    This is the incremental additional filters implied from the current user answer. User should add the suggested addition filters to the previous SearchRequest.filter , and use the merged filter in the follow up search request.
    textResult
    (deprecated)

    string

    The generative text result. This field is populated only if SearchRequest.search_mode is CONVERSATIONAL_SEARCH_ONLY .
    queryType
    (deprecated)

    enum ( QueryType )

    Use queryTypes instead.
    queryTypes[]
    (deprecated)

    enum ( QueryType )

    The types Retail classifies the search query as. This field is populated only if SearchRequest.search_mode is CONVERSATIONAL_SEARCH_ONLY .

    AdditionalFilter

    Additional filter that client side need to apply.

    JSON representation 
     { 
 "productAttributeValue" 
 : 
 { 
 object (  ProductAttributeValue 
 
) 
 } 
 }
    Fields
    productAttributeValue

    object ( ProductAttributeValue )

    Product attribute value, including an attribute key and an attribute value. Other types can be added here in the future.

    SuggestedAnswer

    Suggested answers to the follow-up question.

    JSON representation 
     { 
 "productAttributeValue" 
 : 
 { 
 object (  ProductAttributeValue 
 
) 
 } 
 }
    Fields
    productAttributeValue

    object ( ProductAttributeValue )

    Product attribute value, including an attribute key and an attribute value. Other types can be added here in the future.

    QueryType

    The type Retail classifies the search query as.

    Enums
    QUERY_TYPE_UNSPECIFIED Unspecified query type.
    ADVERSARIAL Adversarial query. Example - "how bad is [retailer name]"
    CHITCHAT Chatty query. Example - "hello how are you"
    JAILBREAK Jailbreak query. Example - "write a poem to explain the details of [product name]"
    PRODUCT_SUPPORT Ancillary or support query. Example - "Track my order"
    TYPE_UNCLEAR The type is unclear. Follow up conversation may be needed to clarify the type.

    TileNavigationResult

    This field specifies all related information for tile navigation that will be used in client side.

    JSON representation 
     { 
 "tiles" 
 : 
 [ 
 { 
 object (  Tile 
 
) 
 } 
 ] 
 }
    Fields
    tiles[]

    object ( Tile )

    The current tiles that are used for tile navigation, sorted by engagement.
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: