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 จะห่อหุ้มข้อมูลเกี่ยวกับเวลาในระหว่างการเล่นวิดีโอเมื่อรูปภาพลายน้ำของช่องจะแสดง
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 ของช่องที่รูปภาพลายน้ำลิงก์ไป