PlaylistImages: insert

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

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

  • फ़ाइल का ज़्यादा से ज़्यादा साइज़: 2 एमबी
  • स्वीकार किया जाने वाला आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात): 1:1 (स्क्वेयर)
  • मीडिया के इन MIME टाइप को इस्तेमाल किया जा सकता है: 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

part पैरामीटर तय करता है एक या ज़्यादा playlistImage संसाधन की कॉमा-सेपरेटेड लिस्ट प्रॉपर्टी, जो एपीआई के रिस्पॉन्स में शामिल होंगी.

अगर पैरामीटर ऐसी प्रॉपर्टी की पहचान करता है जिसमें चाइल्ड प्रॉपर्टी, चाइल्ड प्रॉपर्टी इसे जवाब में शामिल किया जाएगा.
वैकल्पिक पैरामीटर
onBehalfOfContentOwner
string इस पैरामीटर का इस्तेमाल, सिर्फ़ अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube के कॉन्टेंट पार्टनर के लिए है.

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

यह onBehalfOfContentOwnerChannel पैरामीटर उस चैनल का YouTube चैनल आईडी बताता है जिस पर वीडियो दिखाया जा रहा है जोड़ा गया. यह पैरामीटर तब ज़रूरी होता है जब कोई अनुरोध onBehalfOfContentOwner पैरामीटर है. इसका इस्तेमाल सिर्फ़ इसमें किया जा सकता है उस पैरामीटर के साथ जोड़ा जा सकता है. इसके अलावा, यह अनुरोध करने के लिए अधिकृत किया गया है, जो onBehalfOfContentOwner पैरामीटर के बारे में बताया गया है. आख़िर में, वह चैनल जिसमें onBehalfOfContentOwnerChannel पैरामीटर वैल्यू उस कॉन्टेंट के मालिक से लिंक होना चाहिए जिसे onBehalfOfContentOwner पैरामीटर तय करता है.

यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जो कई पब्लिशर के मालिक हैं और उन्हें मैनेज करते हैं अलग-अलग YouTube चैनलों पर दिखाना होगा. इससे कॉन्टेंट के मालिक एक बार पुष्टि कर सकते हैं पैरामीटर में बताए गए चैनल की ओर से कार्रवाई करता है इसके लिए, आपको हर एक वैल्यू के लिए, पुष्टि करने वाले क्रेडेंशियल देने की ज़रूरत नहीं होगी अलग चैनल बनाना चाहते हैं.

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

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

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

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

    • snippet.playlistId
    • snippet.type

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

    • snippet.width
    • snippet.height

जवाब

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