Sonduje o niezarezerwowane elementy z kolejki indeksowania i oznacza zestaw jako zarezerwowany, zaczynając od elementów o najstarszej sygnaturze czasowej o najwyższym priorytecie (ItemStatus
). Oto kolejność priorytetów:
Zarezerwowanie elementów spowoduje, że odpytania z innych wątków nie będą mogły tworzyć pokrywających się zestawów.
Po obsłudze zarezerwowanych produktów klient powinien przywrócić je do stanu niezarezerwowanych, wywołując metodę index,
lub wywołując push
typu REQUEUE.
.
Elementy stają się automatycznie dostępne (niezarezerwowane) po 4 godzinach, nawet jeśli nie zostanie wywołana żadna metoda aktualizacji ani przekazywania.
Ten interfejs API wymaga do działania konta administratora lub konta usługi. Używane konto usługi jest kontem umieszczonym na białej liście w odpowiednim źródle danych.
Żądanie HTTP
POST https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*}/items:poll
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
name |
Nazwa źródła danych na potrzeby sondowania elementów. Format: źródła danych/{sourceId} |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "connectorName": string, "statusCodes": [ enum ( |
Pola | |
---|---|
connectorName |
Nazwa oprogramowania sprzęgającego tworzącego to wywołanie. Format: źródła danych/{sourceId}/łączniki/{ID} |
statusCodes[] |
Ogranicz ankietowane elementy do elementów o określonym stanie. |
limit |
Maksymalna liczba produktów do zwrotu. Maksymalna wartość to 100, a wartość domyślna to 20. |
queue |
Nazwa kolejki pobierania elementów. Jeśli nie określono inaczej, ankieta items.poll zostanie pobrana z wartości domyślnej. kolejkę. Maksymalna długość to 100 znaków. |
debugOptions |
Typowe opcje debugowania. |
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"items": [
{
object ( |
Pola | |
---|---|
items[] |
Zestaw elementów z kolejki dostępnych do przetworzenia przez oprogramowanie sprzęgające. W przypadku tych produktów wypełniony jest następujący podzbiór pól: |
Zakresy autoryzacji
Wymaga jednego z tych zakresów protokołu OAuth:
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
Więcej informacji znajdziesz w przewodniku na temat autoryzacji.