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 ของช่องที่รูปภาพลายน้ําลิงก์ไป