Watermarks

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

เมธอด

API รองรับวิธีการต่อไปนี้สำหรับทรัพยากร watermarks

ตั้งค่า

อัปโหลดรูปภาพลายน้ำไปยัง YouTube และตั้งค่าสำหรับช่อง

unset

ลบรูปภาพลายน้ำของช่อง ลองใช้เลย

การแสดงทรัพยากร

โครงสร้าง 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 จะห่อหุ้มข้อมูลเกี่ยวกับเวลาในระหว่างการเล่นวิดีโอเมื่อรูปภาพลายน้ำของช่องจะแสดง ต้องระบุออบเจ็กต์นี้เมื่อเรียกใช้ watermarks.set
timing.type	string วิธีการกำหนดเวลาที่กำหนดเวลาแสดงรูปภาพลายน้ำระหว่างการเล่นวิดีโอ ต้องระบุพร็อพเพอร์ตี้นี้เมื่อเรียกใช้ watermarks.set. ค่าที่ถูกต้องมีดังนี้ offsetFromStart: ฟิลด์ offsetMs แสดงออฟเซ็ตจากจุดเริ่มต้นของวิดีโอ offsetFromEnd: ฟิลด์ offsetMs แสดงออฟเซ็ตจากท้ายวิดีโอ
timing.offsetMs	unsigned long ออฟเซ็ตเวลาที่ระบุเป็นมิลลิวินาที ซึ่งกำหนดเวลาที่รายการที่โปรโมตจะปรากฏในระหว่างการเล่นวิดีโอ ต้องระบุพร็อพเพอร์ตี้นี้เมื่อเรียกใช้ watermarks.set เมื่อ type เป็น offsetFromEnd offsetMs ต้องมีค่าอย่างน้อย 1000 มิลลิวินาที
timing.durationMs	unsigned long ระยะเวลาเป็นมิลลิวินาทีที่ควรแสดงรูปภาพลายน้ำ พร็อพเพอร์ตี้นี้ไม่บังคับ หากระบุ ระยะเวลาขั้นต่ำคือ 1000 มิลลิวินาที เมื่อ type เป็น offsetFromEnd durationMs ต้องไม่เกิน offsetMs
position	object เลิกใช้งานแล้ว: YouTube จะไม่สนใจและเลิกใช้งานออบเจ็กต์ position ลายน้ำจะแสดงที่มุมขวาบนของวิดีโอเพลเยอร์เสมอ
imageUrl	string URL ของรูปภาพลายน้ำของช่อง YouTube จะสร้าง URL นี้และส่งกลับในการตอบกลับ API สำหรับคำขอ watermark.set
imageBytes	bytes ขนาดของรูปภาพลายน้ำในหน่วยไบต์
targetChannelId	string รหัสช่อง YouTube ของช่องที่รูปภาพลายน้ำลิงก์ไป