Method: indexing.datasources.items.poll

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

ERROR

MODIFIED

NEW_ITEM

ACCEPTED

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

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

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

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

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

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

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

पाथ के पैरामीटर

पैरामीटर
name

string

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

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

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

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

string

यह कॉल करने वाले कनेक्टर का नाम.

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

enum (ItemStatus.Code)

इन स्थितियों वाले एक ही आइटम पर पोल किए गए आइटम सीमित करें.
limit

integer

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

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

string

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

object (DebugOptions)

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "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

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