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

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

अनुरोध के मुख्य हिस्से में watermark संसाधन दें. इस संसाधन में ये प्रॉपर्टी शामिल हैं:

  • timing (object, ज़रूरी है): इसमें वॉटरमार्क दिखने का समय शामिल होता है.
    • timing.type (string, ज़रूरी है): इसे offsetFromStart या offsetFromEnd पर सेट करें.
    • timing.offsetMs (unsigned long, ज़रूरी है): मिलीसेकंड में शुरुआती ऑफ़सेट. अगर type की वैल्यू offsetFromEnd है, तो कम से कम 1000 मि॰से॰ होनी चाहिए.
    • timing.durationMs (unsigned long, ज़रूरी नहीं): मिलीसेकंड में दिखने की अवधि (कम से कम 1000 मि॰से॰). अगर type offsetFromEnd है, तो offsetMs से ज़्यादा नहीं होना चाहिए.
  • targetChannelId (string, ज़रूरी नहीं): यह उस YouTube चैनल का चैनल आईडी होता है जिससे वॉटरमार्क लिंक होता है. अगर इसे शामिल नहीं किया जाता है, तो channelId से पहचाने गए चैनल के लिंक शामिल किए जाते हैं.
  • position (object, अब इस्तेमाल में नहीं है): YouTube इसे अनदेखा करता है. वॉटरमार्क हमेशा सबसे ऊपर दाएं कोने में रखे जाते हैं.

जवाब

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

गड़बड़ियां

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

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

इसे आज़माएं!

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