- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- इसे आज़माएं!
इंडेक्स करने की सूची में से, सेव नहीं किए गए आइटम के लिए पोल और एक सेट को 'रिज़र्व' के तौर पर मार्क किया जाता है. इसकी शुरुआत सबसे ज़्यादा प्राथमिकता वाले आइटम से सबसे पुराने टाइमस्टैंप वाले आइटम से होती है ItemStatus
. प्राथमिकता का क्रम इस तरह है:
आइटम को रिज़र्व करने से, यह पक्का होता है कि दूसरी थ्रेड से पोल करने से ओवरलैप होने वाले सेट नहीं बन सकते.
रिज़र्व किए गए आइटम को मैनेज करने के बाद, क्लाइंट को आइटम वापस असुरक्षित स्थिति में रखने चाहिए. इसके लिए, क्लाइंट को index,
को कॉल करना होगा या REQUEUE.
टाइप वाले push
को कॉल करना होगा
आइटम चार घंटे के बाद अपने-आप उपलब्ध हो जाते हैं (जो रिज़र्व नहीं होते). भले ही, कोई अपडेट या पुश तरीका लागू न किया गया हो.
इस एपीआई को लागू करने के लिए, एडमिन या सेवा खाते की ज़रूरत होती है. इस्तेमाल किया गया सेवा खाता, संबंधित डेटा सोर्स में व्हाइटलिस्ट में शामिल एक खाता है.
एचटीटीपी अनुरोध
POST https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*}/items:poll
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
name |
पोल आइटम के लिए डेटा सोर्स का नाम. फ़ॉर्मैट: datasources/{sourceId} |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "connectorName": string, "statusCodes": [ enum ( |
फ़ील्ड | |
---|---|
connectorName |
यह कॉल करने वाले कनेक्टर का नाम. फ़ॉर्मैट: datasources/{sourceId}/connectors/{ID} |
statusCodes[] |
इन स्थितियों वाले एक ही आइटम पर पोल किए गए आइटम सीमित करें. |
limit |
लौटाए जाने वाले आइटम की ज़्यादा से ज़्यादा संख्या. ज़्यादा से ज़्यादा वैल्यू 100 और डिफ़ॉल्ट वैल्यू 20 है. |
queue |
आइटम फ़ेच करने के लिए सूची का नाम. अगर इसकी जानकारी नहीं दी गई है, तो items.poll को 'डिफ़ॉल्ट' सूची से फ़ेच किया जाएगा. ज़्यादा से ज़्यादा 100 वर्ण हाेने चाहिए. |
debugOptions |
डीबग करने के सामान्य विकल्प. |
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"items": [
{
object ( |
फ़ील्ड | |
---|---|
items[] |
प्रोसेस करने के लिए, सूची में मौजूद आइटम का सेट कनेक्टर के लिए उपलब्ध है. इन आइटम में, फ़ील्ड के ये सबसेट अपने-आप भरे हुए हैं: |
अनुमति पाने के लिंक
इनमें से कोई एक OAuth स्कोप ज़रूरी है:
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.