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