Watermarks: set

YouTube पर वॉटरमार्क इमेज अपलोड करता है और उसे चैनल के लिए सेट करता है.

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

  • फ़ाइल का ज़्यादा से ज़्यादा साइज़: 10 एमबी
  • स्वीकार किए जाने वाले मीडिया एमआईएमई टाइप: image/jpeg, image/png, application/octet-stream

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

अनुरोध

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

POST https://www.googleapis.com/upload/youtube/v3/watermarks/set

अनुमति देना

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति की ज़रूरत है. पुष्टि करने और अनुमति देने के बारे में ज़्यादा जानने के लिए, OAuth 2.0 का ऑथराइज़ेशन लागू करना लेख पढ़ें.

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

पैरामीटर

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

पैरामीटर
ज़रूरी पैरामीटर
channelId string
channelId पैरामीटर, उस YouTube चैनल आईडी की जानकारी देता है जिसके लिए वॉटरमार्क दिया जा रहा है.
ज़रूरी नहीं पैरामीटर
onBehalfOfContentOwner string
ध्यान दें: यह पैरामीटर सिर्फ़ YouTube कॉन्टेंट पार्टनर के लिए है.

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

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

अनुरोध के मुख्य हिस्से में watermark संसाधन दें.

जवाब

अगर अनुरोध पूरा हो जाता है, तो यह तरीका एचटीटीपी 204 No Content स्टेटस कोड दिखाता है.

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
badRequest (400) imageFormatUnsupported आपने जो इमेज दी है वह काम नहीं करती.
badRequest (400) imageTooTall आपने जो इमेज दी है वह बहुत लंबी है.
badRequest (400) imageTooWide आपने जो इमेज दी है वह बहुत चौड़ी है.
badRequest (400) mediaBodyRequired अनुरोध में इमेज का कॉन्टेंट शामिल नहीं है.
forbidden (403) forbidden चुने गए चैनल के लिए, वॉटरमार्क सेट नहीं किया जा सकता. ऐसा हो सकता है कि अनुरोध को सही तरीके से अनुमति न मिली हो या channelId पैरामीटर को अमान्य वैल्यू पर सेट किया गया हो.

इसे आज़माएं!

इस एपीआई को कॉल करने और एपीआई का अनुरोध और रिस्पॉन्स देखने के लिए, APIs Explorer का इस्तेमाल करें.