Watermarks

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

तरीके

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

सेट करें
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 ऑब्जेक्ट में, वीडियो चलाने के दौरान उस समय की जानकारी होती है जब चैनल की वॉटरमार्क इमेज दिखेगी.
timing.type string
यह टाइमिंग का वह तरीका है जिससे यह तय होता है कि वीडियो चलाने के दौरान, वाटरमार्क वाली इमेज कब दिखेगी. अगर वैल्यू offsetFromStart है, तो offsetMs फ़ील्ड, वीडियो की शुरुआत से ऑफ़सेट दिखाता है. अगर वैल्यू offsetFromEnd है, तो offsetMs फ़ील्ड, वीडियो के आखिर से ऑफ़सेट दिखाता है.
timing.offsetMs unsigned long
यह समय ऑफ़सेट है. इसे मिलीसेकंड में तय किया जाता है. इससे यह तय होता है कि वीडियो चलाने के दौरान, प्रमोट किया गया आइटम कब दिखेगा. type प्रॉपर्टी की वैल्यू से यह तय होता है कि ऑफ़सेट को वीडियो की शुरुआत से मापा जाए या आखिर से.
timing.durationMs unsigned long
यह वॉटरमार्क इमेज के दिखने की समयावधि होती है. इसकी वैल्यू मिलीसेकंड में होती है.
position object
position ऑब्जेक्ट में, वीडियो में उस जगह की जानकारी होती है जहां वॉटरमार्क वाली इमेज दिखेगी.
position.type string
वीडियो प्लेयर में प्रमोट किए गए आइटम को दिखाने का तरीका.

इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
  • कोना
position.cornerPosition string
प्रमोशन वाला आइटम, प्लेयर के जिस कोने में दिखेगा. यह आइटम हमेशा प्लेयर के सबसे ऊपर दाएं कोने में दिखता है.

इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
  • topRight
imageUrl string
चैनल के वॉटरमार्क की इमेज का यूआरएल. YouTube इस यूआरएल को जनरेट करेगा और watermark.set अनुरोध के जवाब के तौर पर, एपीआई में इसे दिखाएगा.
imageBytes bytes
वॉटरमार्क वाली इमेज का साइज़, बाइट में.
targetChannelId string
यह उस चैनल का YouTube चैनल आईडी होता है जिससे वॉटरमार्क इमेज लिंक होती है.