Watermarks

watermark रिसॉर्स, किसी इमेज की पहचान करता है. यह इमेज, किसी चैनल के वीडियो के प्लेबैक के दौरान दिखती है. आपके पास यह तय करने का विकल्प भी होता है कि इमेज को किस टारगेट चैनल से लिंक करना है. साथ ही, यह भी तय किया जा सकता है कि वीडियो चलाने के दौरान वॉटरमार्क कब दिखे और कितनी देर तक दिखे.

तरीके

एपीआई, watermarks संसाधनों के लिए इन तरीकों का इस्तेमाल करता है:

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

संसाधन का रेप्रज़ेंटेशन

यहां दिए गए JSON स्ट्रक्चर में, watermarks रिसॉर्स का फ़ॉर्मैट दिखाया गया है:

{
  "timing": {
    "type": string,
    "offsetMs": unsigned long,
    "durationMs": unsigned long
  },
  "position": {
    "type": string,
    "cornerPosition": string
  },
  "imageUrl": string,
  "imageBytes": bytes,
  "targetChannelId": string
}

प्रॉपर्टी

यहां दी गई टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:

प्रॉपर्टी
timing object
timing ऑब्जेक्ट में, वीडियो चलाने के दौरान उस समय के बारे में जानकारी होती है जब चैनल की वॉटरमार्क इमेज दिखेगी. watermarks.set को कॉल करते समय, इस ऑब्जेक्ट की ज़रूरत होती है.
timing.type string
यह टाइमिंग का वह तरीका है जिससे यह तय होता है कि वीडियो चलाने के दौरान वाटरमार्क वाली इमेज कब दिखेगी. watermarks.set को कॉल करते समय, इस प्रॉपर्टी को शामिल करना ज़रूरी है.

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