Watermarks

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

तरीके

watermarks संसाधनों के लिए, एपीआई नीचे दिए गए तरीकों के साथ काम करता है:

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

संसाधन दिखाना

नीचे दी गई 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 चैनल आईडी जिससे वॉटरमार्क इमेज लिंक की गई है.