Method: indexing.datasources.items.poll

Melakukan polling untuk item yang belum dipesan dari antrean pengindeksan dan menandai kumpulan sebagai dipesan, dimulai dengan item yang memiliki stempel waktu terlama dari ItemStatus prioritas tertinggi. Urutan prioritasnya adalah sebagai berikut:

ERROR

MODIFIED

NEW_ITEM

ACCEPTED

Dengan memesan item, polling dari thread lain tidak dapat membuat set yang tumpang-tindih.

Setelah menangani item yang direservasi, klien harus mengembalikan item ke status yang tidak direservasi, baik dengan memanggil index, maupun dengan memanggil push dengan jenis REQUEUE.

Item akan otomatis tersedia (tidak direservasi) setelah 4 jam meskipun tidak ada metode update atau push yang dipanggil.

API ini memerlukan admin atau akun layanan untuk dieksekusi. Akun layanan yang digunakan adalah akun yang diizinkan di sumber data yang sesuai.

Permintaan HTTP

POST https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*}/items:poll

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Nama Sumber Data untuk melakukan polling item. Format: datasources/{sourceId}

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "connectorName": string,
  "statusCodes": [
    enum (ItemStatus.Code)
  ],
  "limit": integer,
  "queue": string,
  "debugOptions": {
    object (DebugOptions)
  }
}
Kolom
connectorName

string

Nama konektor yang melakukan panggilan ini.

Format: datasources/{sourceId}/connectors/{ID}
statusCodes[]

enum (ItemStatus.Code)

Batasi item yang di-polling ke item dengan status ini.
limit

integer

Jumlah maksimum item yang akan ditampilkan.

Nilai maksimumnya adalah 100 dan nilai defaultnya adalah 20.
queue

string

Nama antrean tempat mengambil item. Jika tidak ditentukan, items.poll akan mengambil dari antrean 'default'. Panjang maksimumnya adalah 100 karakter.
debugOptions

object (DebugOptions)

Opsi debug umum.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "items": [
    {
      object (Item)
    }
  ]
}
Kolom
items[]

object (Item)

Kumpulan item dari antrean yang tersedia untuk diproses konektor.

Item ini memiliki subset kolom berikut yang terisi:

version

metadata.hash

structuredData.hash

content.hash

payload

status

queue

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud_search.indexing
  • https://www.googleapis.com/auth/cloud_search

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.