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