PlaylistImages: insert

किसी प्लेलिस्ट में इमेज जोड़ता है.

यह तरीका, मीडिया अपलोड करने की सुविधा देता है. अपलोड की गई फ़ाइलें, इन शर्तों के मुताबिक होनी चाहिए:

• फ़ाइल का ज़्यादा से ज़्यादा साइज़: 50 एमबी
• स्वीकार किया गया आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात): 1:1 (स्क्वेयर)
• स्वीकार किए गए मीडिया एमआईएमई टाइप: image/jpeg, image/png

कोटे पर असर: इस तरीके को कॉल करने पर, कोटे की 50 यूनिट का खर्च आता है.

अनुरोध

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

POST https://www.googleapis.com/youtube/v3/playlistImages

अनुमति देना

इस अनुरोध के लिए, कम से कम इनमें से किसी एक स्कोप के साथ अनुमति की ज़रूरत होती है. (अनुमति और पुष्टि करने की प्रोसेस के बारे में ज़्यादा जानें).

दायरा
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

पैरामीटर

यहां दी गई टेबल में, उन पैरामीटर की सूची दी गई है जिन्हें इस क्वेरी में इस्तेमाल किया जा सकता है. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
part	string The part पैरामीटर, playlistImage संसाधन की एक या उससे ज़्यादा प्रॉपर्टी की कॉमा लगाकर अलग की गई लिस्ट तय करता है. ये प्रॉपर्टी, एपीआई से मिली जानकारी में शामिल होंगी. अगर पैरामीटर, ऐसी प्रॉपर्टी की पहचान करता है जिसमें चाइल्ड प्रॉपर्टी शामिल हैं, तो जवाब में चाइल्ड प्रॉपर्टी भी शामिल होंगी.
वैकल्पिक पैरामीटर
onBehalfOfContentOwner	string इस पैरामीटर का इस्तेमाल, सिर्फ़ अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर, सिर्फ़ YouTube के कॉन्टेंट पार्टनर के लिए है. onBehalfOfContentOwner पैरामीटर से पता चलता है कि अनुरोध की अनुमति के क्रेडेंशियल, YouTube सीएमएस के ऐसे उपयोगकर्ता की पहचान करते हैं जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम कर रहा है. यह पैरामीटर, YouTube के उन कॉन्टेंट पार्टनर के लिए है जो YouTube के कई अलग-अलग चैनलों के मालिक हैं और उन्हें मैनेज करते हैं. इससे, कॉन्टेंट के मालिक एक बार पुष्टि करके, अपने सभी वीडियो और चैनल के डेटा का ऐक्सेस पा सकते हैं. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने के क्रेडेंशियल देने की ज़रूरत नहीं होती. उपयोगकर्ता जिस CMS खाते से पुष्टि करता है वह, बताए गए YouTube के कॉन्टेंट के मालिक से लिंक होना चाहिए.
onBehalfOfContentOwnerChannel	string इस पैरामीटर का इस्तेमाल, सिर्फ़ सही तरीके से अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर, सिर्फ़ YouTube के कॉन्टेंट पार्टनर के लिए है. The onBehalfOfContentOwnerChannelपैरामीटर, उस चैनल का YouTube चैनल आईडी तय करता है जिसमें कोई वीडियो जोड़ा जा रहा है. यह पैरामीटर तब ज़रूरी होता है, जब किसी अनुरोध में onBehalfOfContentOwner पैरामीटर के लिए कोई वैल्यू तय की जाती है. इसका इस्तेमाल, सिर्फ़ उस पैरामीटर के साथ किया जा सकता है. इसके अलावा, अनुरोध को ऐसे CMS खाते का इस्तेमाल करके अनुमति देनी होगी जो उस कॉन्टेंट के मालिक से लिंक हो जिसे onBehalfOfContentOwner पैरामीटर तय करता है. आखिर में, onBehalfOfContentOwnerChannel पैरामीटर वैल्यू में तय किया गया चैनल, उस कॉन्टेंट के मालिक से लिंक होना चाहिए जिसे onBehalfOfContentOwner पैरामीटर तय करता है. यह पैरामीटर, YouTube के उन कॉन्टेंट पार्टनर के लिए है जो YouTube के कई अलग-अलग चैनलों के मालिक हैं और उन्हें मैनेज करते हैं. इससे, कॉन्टेंट के मालिक एक बार पुष्टि करके, पैरामीटर वैल्यू में तय किए गए चैनल की ओर से कार्रवाइयां कर सकते हैं. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने के क्रेडेंशियल देने की ज़रूरत नहीं होती.

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

अनुरोध के मुख्य हिस्से में, playlistImages संसाधन उपलब्ध कराएं.

उस संसाधन के लिए:

• आपको इन प्रॉपर्टी के लिए वैल्यू तय करनी होगी:

  • snippet.playlistId
  • snippet.type

• इन प्रॉपर्टी के लिए वैल्यू सेट की जा सकती हैं:

  • snippet.width
  • snippet.height

जवाब

अगर अनुरोध सही से काम करता है, तो यह तरीका जवाब के मुख्य हिस्से में, playlistImages संसाधन दिखाता है.