This preview documentation is deprecated as of October 27, 2023. For GA documentation, go to the Vertex AI Search documentation.
Changes in GA:
Name:Discovery for Media is renamed to Vertex AI Search for media. Vertex AI Search includes media recommendations and media search.
Google Cloud Console page: Use the Agent Builder page in the console. The Discovery Engine console page is deprecated.
API reference: Continue to use the discoveryengine.googleapis.com service. The API remains the same but the documentation has moved. Go to the up-to-date, GA version of the Discovery Engine API reference in the Vertex AI Search documentation.
Required. The parent data store resource name for which the completion is performed, such as projects/*/locations/global/collections/default_collection/dataStores/default_data_store.
Query parameters
Parameters
query
string
Required. The typeahead input used to fetch suggestions. Maximum length is 128 characters.
queryModel
string
Selects data model of query suggestions for serving. Currently supported values:
document - Using suggestions generated from user-imported documents.
search-history - Using suggestions generated from the past history of SearchService.Search API calls. Do not use it when there is no traffic for Search API.
user-event - Using suggestions generated from user-imported search events.
document-completable - Using suggestions taken directly from user-imported document fields marked as completable.
Default values:
document is the default model for regular dataStores.
search-history is the default model for site search dataStores.
userPseudoId
string
A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website.
This field should NOT have a fixed value such as unknown_visitor.
The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.
includeTailSuggestions
boolean
Indicates if tail suggestions should be returned if there are no suggestions that match the full query. Even if set to true, if there are suggestions that match the full query, those are returned and no tail suggestions are returned.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-02-13 UTC."],[[["This endpoint facilitates query completion suggestions via an HTTP `GET` request to a specified data store, which uses gRPC Transcoding syntax."],["The request requires a `dataStore` path parameter to identify the data store for which completion is being performed, and a `query` query parameter containing the typeahead input, with maximum 128 characters."],["Several models are available to generate suggestions, selectable via the `queryModel` parameter, such as document-based, search history-based, user event-based, and document-completable models, each with its own application."],["A `userPseudoId` query parameter is required for tracking visitors, which must be consistent with the user pseudo IDs in user event and search request data."],["Successful requests result in a `CompleteQueryResponse`, and the request requires the `discoveryengine.dataStores.completeQuery` IAM permission and `https://www.googleapis.com/auth/cloud-platform` OAuth scope."]]],[]]