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 के कॉन्टेंट के मालिक से लिंक होना चाहिए.

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

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

जवाब

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

गड़बड़ियां

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

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

इसे आज़माएं!

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