Melakukan polling untuk item yang belum direservasi dari antrean pengindeksan dan menandai set sebagai dicadangkan, dimulai dari 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 set yang tumpang tindih.
Setelah menangani item yang dicadangkan, klien harus mengembalikan item ke status tidak direservasi, baik dengan memanggil index,
maupun memanggil push
dengan jenis REQUEUE.
Item otomatis tersedia (tidak direservasi) setelah 4 jam meskipun tidak ada metode update atau push yang dipanggil.
API ini memerlukan admin atau akun layanan agar dapat dijalankan. 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: sumber data/{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: sumber data/{sourceId}/konektor/{ID} |
statusCodes[] |
Batasi item yang diperiksa ke item yang memiliki status ini. |
limit |
Jumlah item maksimum yang akan ditampilkan. Nilai maksimum adalah 100 dan nilai defaultnya adalah 20. |
queue |
Nama antrean tempat item akan diambil. Jika tidak ditentukan, items.poll akan mengambil dari 'default' antrean. 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 subset kolom berikut yang telah diisi: |
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.