Method: indexing.datasources.items.poll

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:

ERROR

MODIFIED

NEW_ITEM

ACCEPTED

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

string

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

string

Nama konektor yang melakukan panggilan ini.

Format: sumber data/{sourceId}/konektor/{ID}

statusCodes[]

enum (ItemStatus.Code)

Batasi item yang diperiksa ke item yang memiliki status ini.

limit

integer

Jumlah item maksimum yang akan ditampilkan.

Nilai maksimum adalah 100 dan nilai defaultnya adalah 20.

queue

string

Nama antrean tempat item akan diambil. Jika tidak ditentukan, items.poll akan mengambil dari 'default' antrean. Panjang maksimum 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 oleh konektor.

Item ini memiliki subset kolom berikut yang telah diisi:

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 informasi selengkapnya, lihat Panduan otorisasi.