Method: indexing.datasources.items.poll

Dizine ekleme kuyruğundaki ayrılmamış öğeleri sorar ve en yüksek önceliğe sahip ItemStatus öğesinden başlayarak bir grubu ayrılmış olarak işaretler. Öncelik sırası şu şekildedir:

ERROR

MODIFIED

NEW_ITEM

ACCEPTED

Öğeleri ayırmak, diğer mesaj dizilerinden alınan anketlerin çakışık kümeler oluşturmasını önler.

İstemci, ayrılmış öğeleri işledikten sonra index,'ü veya push'u REQUEUE. türüyle çağırarak öğeleri ayrılmamış duruma geri koymalıdır.

Güncelleme veya push yöntemi çağrılmamış olsa bile öğeler 4 saat sonra otomatik olarak kullanılabilir hale gelir (ayrılmamış).

Bu API'nin çalıştırılması için bir yönetici veya hizmet hesabı gerekir. Kullanılan hizmet hesabı, ilgili veri kaynağında beyaz listeye eklenen hesaptır.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Öğelerin ankete tabi tutulacağı veri kaynağının adı. Biçim: datasources/{sourceId}

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "connectorName": string,
  "statusCodes": [
    enum (ItemStatus.Code)
  ],
  "limit": integer,
  "queue": string,
  "debugOptions": {
    object (DebugOptions)
  }
}
Alanlar
connectorName

string

Bu çağrıyı yapan bağlayıcının adı.

Biçim: datasources/{sourceId}/connectors/{ID}
statusCodes[]

enum (ItemStatus.Code)

Ankete dahil edilecek öğeleri bu duruma sahip öğelerle sınırlayın.
limit

integer

Döndürülecek maksimum öğe sayısı.

Maksimum değer 100, varsayılan değer ise 20'dir.
queue

string

Öğelerin alınacağı sıra adı. Belirtilmemişse items.poll, "varsayılan" kuyruktan öğe getirir. Maksimum uzunluk 100 karakterdir.
debugOptions

object (DebugOptions)

Sık kullanılan hata ayıklama seçenekleri.

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "items": [
    {
      object (Item)
    }
  ]
}
Alanlar
items[]

object (Item)

Konnektörün işleyebileceği, sıradaki öğe grubu.

Bu öğelerde aşağıdaki alan alt kümesi doldurulur:

version

metadata.hash

structuredData.hash

content.hash

payload

status

queue

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.