Method: media.upload

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

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

  1. अपलोड सेशन शुरू करने और UploadItemRef को फिर से पाने के लिए, आइटम के नाम के साथ indexing.datasources.items.upload को कॉल करें.
  2. कॉन्टेंट अपलोड करने के लिए, media.upload को स्ट्रीमिंग अनुरोध के तौर पर कॉल करें. इसके लिए, पहले चरण में UploadItemRef से जुड़े संसाधन के नाम का ही इस्तेमाल करें.
  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

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