Method: projects.locations.collections.dataStores.completeQuery

Completa la entrada del usuario especificada con sugerencias de palabras clave.

Solicitud HTTP

GET https://discoveryengine.googleapis.com/v1beta/{dataStore=projects/*/locations/*/collections/*/dataStores/*}:completeQuery

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
dataStore

string

Obligatorio. Es el nombre del recurso de almacén de datos superior para el que se realiza la finalización, como projects/*/locations/global/collections/default_collection/dataStores/default_data_store.

Parámetros de consulta

Parámetros
query

string

Obligatorio. Es la entrada de escritura anticipada que se usa para recuperar sugerencias. La longitud máxima es de 128 caracteres.
queryModel

string

Especifica el modelo de datos de autocompletado. Esto anula cualquier modelo especificado en la sección Configuración > Autocompletar de la consola de Cloud. Actualmente, se admiten los siguientes valores:

  • document - Usa sugerencias generadas a partir de documentos importados por el usuario.
  • search-history - Usa sugerencias generadas a partir del historial pasado de llamadas a la API de SearchService.Search. No lo uses cuando no haya tráfico para la API de Search.
  • user-event - Usa sugerencias generadas a partir de eventos de búsqueda importados por el usuario.
  • document-completable - Usa sugerencias tomadas directamente de los campos de documentos importados por el usuario marcados como completables.

Valores predeterminados:

  • document es el modelo predeterminado para los dataStores regulares.
  • search-history es el modelo predeterminado para los dataStores de búsqueda en sitios.
userPseudoId

string

Es opcional. Es un identificador único para hacer un seguimiento de los visitantes. Por ejemplo, esto se podría implementar con una cookie HTTP, que debería poder identificar de forma única a un visitante en un solo dispositivo. Este identificador único no debería cambiar si el visitante accede o sale del sitio web.

Este campo NO debe tener un valor fijo, como unknown_visitor.

Debe ser el mismo identificador que UserEvent.user_pseudo_id y SearchRequest.user_pseudo_id.

El campo debe ser una cadena codificada en UTF-8 con un límite de longitud de 128 caracteres. De lo contrario, se muestra un error INVALID_ARGUMENT.
includeTailSuggestions

boolean

Indica si se deben mostrar sugerencias de cola si no hay sugerencias que coincidan con la consulta completa. Incluso si se establece en verdadero, si hay sugerencias que coinciden con la consulta completa, se muestran esas y no se muestran sugerencias de cola.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de CompleteQueryResponse.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso dataStore:

  • discoveryengine.dataStores.completeQuery

Para obtener más información, consulta la documentación de IAM.