- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- Pruébala
Sondea los elementos no reservados de la cola de indexación y marca un conjunto como reservado, comenzando por los elementos que tienen la marca de tiempo más antigua de la ItemStatus
de mayor prioridad. El orden de prioridad es el siguiente:
La reserva de elementos garantiza que el sondeo de otros subprocesos no pueda crear conjuntos superpuestos.
Después de controlar los elementos reservados, el cliente debe volver a colocar los elementos sin reservar mediante una llamada a index,
o a través de una llamada a push
con el tipo REQUEUE.
.
Los elementos estarán disponibles automáticamente (sin reservar) después de 4 horas, incluso si no se llama a ningún método de actualización o envío.
Esta API requiere una cuenta de administrador o de servicio para ejecutarse. La cuenta de servicio utilizada es la que está incluida en la lista blanca de la fuente de datos correspondiente.
Solicitud HTTP
POST https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*}/items:poll
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
name |
El nombre de la fuente de datos para sondear los elementos. Formato: fuentes de datos/{sourceId} |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "connectorName": string, "statusCodes": [ enum ( |
Campos | |
---|---|
connectorName |
El nombre del conector que realiza esta llamada. Formato: fuentes de datos/{sourceId}/conectores/{ID} |
statusCodes[] |
Limita los elementos consultados a los que tengan estos estados. |
limit |
Cantidad máxima de artículos que se devolverán. El valor máximo es 100 y el valor predeterminado es 20. |
queue |
Nombre de la cola desde la que se recuperarán los elementos. Si no se especifica, items.poll se recuperará de la cola "default". La longitud máxima es de 100 caracteres. |
debugOptions |
Opciones de depuración comunes. |
Cuerpo de la respuesta
Si el proceso es satisfactorio, el cuerpo de la respuesta contiene datos con la siguiente estructura:
Representación JSON |
---|
{
"items": [
{
object ( |
Campos | |
---|---|
items[] |
Conjunto de elementos de la cola disponibles para que el conector los procese. Estos elementos tienen el siguiente subconjunto de campos propagado: |
Alcances de la autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
Para obtener más información, consulta la guía de autorización.