- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Esegue il polling degli elementi non prenotati dalla coda di indicizzazione e contrassegna un insieme come prenotato, a partire dagli elementi con il timestamp meno recente dalla priorità più alta (ItemStatus
). L'ordine di priorità è il seguente:
La prenotazione di elementi garantisce che il polling da altri thread non possa creare insiemi che si sovrappongono.
Dopo aver gestito gli elementi prenotati, il client deve riportare gli elementi allo stato non prenotato, chiamando index,
o chiamando push
con il tipo REQUEUE.
Gli elementi diventano automaticamente disponibili (non prenotati) dopo quattro ore, anche se non viene richiamato alcun metodo di aggiornamento o push.
L'esecuzione di questa API richiede un account amministratore o di servizio. L'account di servizio utilizzato è quello autorizzato nell'origine dati corrispondente.
Richiesta HTTP
POST https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*}/items:poll
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
name |
Il nome dell'origine dati per il polling degli elementi. Formato: origini dati/{sourceId} |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "connectorName": string, "statusCodes": [ enum ( |
Campi | |
---|---|
connectorName |
Il nome del connettore che effettua la chiamata. Formato: origini dati/{sourceId}/connectors/{ID} |
statusCodes[] |
Limita gli elementi sottoposti a polling a quelli con questi stati. |
limit |
Numero massimo di articoli da restituire. Il valore massimo è 100 e il valore predefinito è 20. |
queue |
Nome della coda da cui recuperare gli elementi. Se non specificato, items.poll verrà recuperato dalla coda "default". La lunghezza massima è di 100 caratteri. |
debugOptions |
Opzioni di debug comuni. |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"items": [
{
object ( |
Campi | |
---|---|
items[] |
Insieme di elementi dalla coda disponibili per l'elaborazione da parte del connettore. Per questi elementi viene compilato il seguente sottoinsieme di campi: |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
Per ulteriori informazioni, consulta la Guida alle autorizzazioni.