Method: indexing.datasources.items.poll

इंडेक्स करने की सूची में शामिल, बुक नहीं किए गए आइटम के लिए पोल, बुक किए गए सेट के तौर पर मार्क किया जाता है. इसमें सबसे ज़्यादा प्राथमिकता वाले ItemStatus वाले सबसे पुराने टाइमस्टैंप वाले आइटम से शुरू करते हुए मार्क किया जाता है. प्राथमिकता क्रम इस तरह है:

ERROR

MODIFIED

NEW_ITEM

ACCEPTED

आइटम को रिज़र्व करने से यह पक्का होता है कि दूसरे थ्रेड से होने वाली पोलिंग से ओवरलैप होने वाले सेट नहीं बन सकते.

रिज़र्व किए गए आइटम को हैंडल करने के बाद, क्लाइंट को आइटम वापस गैर-बुक किए गए स्थिति में रखने चाहिए. इसके लिए, उसे index, को कॉल करना होगा या REQUEUE. टाइप के साथ push को कॉल करना होगा

आइटम 4 घंटे बाद अपने-आप उपलब्ध (गैर-आरक्षित) हो जाते हैं, भले ही कोई अपडेट या पुश विधि कॉल न की गई हो.

इस एपीआई को चलाने के लिए, एडमिन या सेवा खाता होना ज़रूरी है. इस्तेमाल किया गया सेवा खाता, उससे जुड़े डेटा सोर्स की अनुमति वाली सूची में शामिल है.

एचटीटीपी अनुरोध

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
name

string

पोल आइटम के लिए डेटा सोर्स का नाम. फ़ॉर्मैट: datasources/{sourceId}

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "connectorName": string,
  "statusCodes": [
    enum (ItemStatus.Code)
  ],
  "limit": integer,
  "queue": string,
  "debugOptions": {
    object (DebugOptions)
  }
}
फ़ील्ड
connectorName

string

इस कॉल को करने वाले कनेक्टर का नाम.

फ़ॉर्मैट: datasources/{sourceId}/कनेक्टर/{ID}
statusCodes[]

enum (ItemStatus.Code)

पोल में शामिल आइटम को सिर्फ़ इन स्थितियों वाले आइटम तक सीमित करें.
limit

integer

लौटाने के लिए आइटम की ज़्यादा से ज़्यादा संख्या.

ज़्यादा से ज़्यादा वैल्यू 100 और डिफ़ॉल्ट वैल्यू 20 है.
queue

string

सूची का वह नाम जिससे आइटम फ़ेच किए जा रहे हैं. अगर इसके बारे में जानकारी नहीं दी जाती है, तो item.poll को 'डिफ़ॉल्ट' से फ़ेच किया जाएगा सूची. ज़्यादा से ज़्यादा 100 वर्ण हाेने चाहिए.
debugOptions

object (DebugOptions)

डीबग करने के सामान्य विकल्प.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "items": [
    {
      object (Item)
    }
  ]
}
फ़ील्ड
items[]

object (Item)

कनेक्टर को प्रोसेस करने के लिए, सूची में मौजूद आइटम का सेट.

इन आइटम में अपने-आप भरे हुए फ़ील्ड के ये सबसेट होते हैं:

version

metadata.hash

structuredData.hash

content.hash

payload

status

queue

अनुमति पाने के लिंक

इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

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

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.