Watermarks

ทรัพยากร watermark ระบุรูปภาพที่แสดงระหว่างการเล่นวิดีโอของช่องที่ระบุ นอกจากนี้ คุณยังสามารถระบุแชแนลเป้าหมายที่ภาพจะลิงก์ไป รวมถึงรายละเอียดการกำหนดเวลาที่กำหนดว่าลายน้ำจะปรากฏระหว่างเล่นวิดีโอเมื่อใดและระยะเวลาที่จะแสดง

วิธีการ

API รองรับเมธอดต่อไปนี้สำหรับทรัพยากร 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 URL สำหรับรูปภาพลายน้ำของช่อง YouTube จะสร้าง URL นี้และส่งคืนใน API การตอบกลับคำขอ watermark.set
imageBytes	bytes ขนาดของรูปภาพลายน้ำในหน่วยไบต์
targetChannelId	string รหัสช่อง YouTube ของช่องที่ลิงก์รูปภาพลายน้ำ