Method: indexing.datasources.items.poll

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:

ERROR

MODIFIED

NEW_ITEM

ACCEPTED

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

string

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 (ItemStatus.Code)
  ],
  "limit": integer,
  "queue": string,
  "debugOptions": {
    object (DebugOptions)
  }
}
Pola
connectorName

string

Nazwa oprogramowania sprzęgającego tworzącego to wywołanie.

Format: źródła danych/{sourceId}/łączniki/{ID}

statusCodes[]

enum (ItemStatus.Code)

Ogranicz ankietowane elementy do elementów o określonym stanie.

limit

integer

Maksymalna liczba produktów do zwrotu.

Maksymalna wartość to 100, a wartość domyślna to 20.

queue

string

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

object (DebugOptions)

Typowe opcje debugowania.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "items": [
    {
      object (Item)
    }
  ]
}
Pola
items[]

object (Item)

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:

version

metadata.hash

structuredData.hash

content.hash

payload

status

queue

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.