Watermarks: set

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

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

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

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

अनुरोध

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

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

अनुमति

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

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

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

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

जवाब

अगर यह तरीका काम करता है, तो यह एचटीटीपी 204 रिस्पॉन्स कोड (No Content) दिखाता है.

गड़बड़ियां

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

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

इसे आज़माएं!

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