Melakukan polling untuk item yang tidak direservasi dari antrean pengindeksan dan menandai kumpulan sebagai dicadangkan, dimulai dengan item yang memiliki stempel waktu terlama dari prioritas tertinggi ItemStatus
. Urutan prioritasnya adalah sebagai berikut:
Melakukan reservasi item memastikan bahwa polling dari thread lain tidak dapat membuat kumpulan yang tumpang-tindih.
Setelah menangani item yang dicadangkan, klien harus mengembalikan item ke status tidak dicadangkan, baik dengan memanggil index,
maupun dengan memanggil push
dengan jenis REQUEUE.
Item akan otomatis tersedia (tidak direservasi) setelah 4 jam meskipun tidak ada update atau metode push yang dipanggil.
API ini memerlukan admin atau akun layanan agar dapat 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 |
Nama Sumber Data untuk item polling. Format: datasources/{sourceId} |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "connectorName": string, "statusCodes": [ enum ( |
Kolom | |
---|---|
connectorName |
Nama konektor yang melakukan panggilan ini. Format: datasources/{sourceId}/connectors/{ID} |
statusCodes[] |
Batasi item yang disurvei pada item dengan status berikut. |
limit |
Jumlah item maksimum untuk ditampilkan. Nilai maksimum adalah 100 dan nilai defaultnya adalah 20. |
queue |
Nama antrean untuk mengambil item. Jika tidak ditentukan, items.poll akan mengambil dari antrean 'default'. Panjang maksimum adalah 100 karakter. |
debugOptions |
Opsi debug umum. |
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"items": [
{
object ( |
Kolom | |
---|---|
items[] |
Kumpulan item dari antrean yang tersedia untuk diproses oleh konektor. Item ini memiliki subkumpulan kolom yang terisi berikut: |
Cakupan Otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
Untuk informasi selengkapnya, lihat Panduan otorisasi.