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 का इस्तेमाल करें.