Method: media.upload

इंडेक्स करने के लिए मीडिया अपलोड करता है.

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

  1. अपलोड सेशन शुरू करने और UploadItemRef को वापस पाने के लिए, आइटम के नाम के साथ indexing.datasources.items.upload को कॉल करें.
  2. पहले चरण में UploadItemRef से मिले संसाधन के नाम का इस्तेमाल करके, कॉन्टेंट को स्ट्रीमिंग के अनुरोध के तौर पर अपलोड करने के लिए, media.upload को कॉल करें.
  3. आइटम को इंडेक्स करने के लिए, indexing.datasources.items.index को कॉल करें. पहले चरण में दिए गए UploadItemRef से, ItemContent को पॉप्युलेट करें.

ज़्यादा जानकारी के लिए, REST API का इस्तेमाल करके कॉन्टेंट कनेक्टर बनाना लेख पढ़ें.

ध्यान दें: इस एपीआई को चलाने के लिए, सेवा खाते की ज़रूरत होती है.

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

  • मीडिया अपलोड करने के अनुरोधों के लिए, अपलोड यूआरआई:
    POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}
  • सिर्फ़ मेटाडेटा के अनुरोधों के लिए मेटाडेटा यूआरआई:
    POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}

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

पाथ पैरामीटर

पैरामीटर
resourceName

string

डाउनलोड किए जा रहे मीडिया का नाम. ReadRequest.resource_name देखें.

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

अनुरोध के मुख्य भाग में Media का उदाहरण है.

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

मीडिया संसाधन.

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

JSON के काेड में दिखाना 
{
  "resourceName": string
}
फ़ील्ड
resourceName

string

मीडिया रिसॉर्स का नाम.

अनुमति के दायरे

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

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

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