ทรัพยากร liveCuepoint
และเมธอด liveCuepoints.insert
เลิกใช้งานแล้วและแทนที่ด้วยเมธอด liveBroadcasts.cuepoint
ทรัพยากร liveCuepoint
จะแทรกจุดเริ่มในสตรีมสตรีมวิดีโอซึ่งอาจทริกเกอร์ช่วงพักโฆษณา
หมายเหตุ: จริงๆ แล้วคําสั่ง API นี้เป็นส่วนหนึ่งของ API สําหรับ Content ID ของ YouTube และมีข้อกําหนดการให้สิทธิ์ที่แตกต่างจากคําขอจัดการทรัพยากร liveBroadcast
และ liveStream
วิธีการ
API รองรับวิธีต่อไปนี้สําหรับทรัพยากร liveCuepoints
รายการ
การนําเสนอแหล่งข้อมูล
โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบทรัพยากร liveCuepoints
{ "id": string, "kind": "youtubePartner#liveCuepoint", "broadcastId": string, "settings": { "offsetTimeMs": long, "walltime": datetime, "cueType": string, "durationSecs": unsigned integer } }
พร็อพเพอร์ตี้
ตารางต่อไปนี้กําหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้
พร็อพเพอร์ตี้ | |
---|---|
id |
string ค่าที่ YouTube กําหนดเพื่อระบุจุดเริ่มโฆษณาที่ไม่ซ้ํากัน |
kind |
string ประเภทของทรัพยากร API สําหรับทรัพยากร liveCuepoint รายการ ค่าคือ youtubePartner#liveCuepoint |
broadcastId |
string รหัสที่ YouTube กําหนดเพื่อระบุการออกอากาศที่ไม่ซ้ํากันซึ่งแทรกจุดเริ่มโฆษณา |
settings |
object ออบเจ็กต์ settings จะกําหนดการตั้งค่าจุดเริ่มโฆษณา |
settings.offsetTimeMs |
long ค่านี้จะระบุช่วงเวลาในวิดีโอเมื่อผู้ชมควรเห็นโฆษณาหรือแถบสเลทในสตรีม ค่าของพร็อพเพอร์ตี้จะระบุการชดเชยเวลาในหน่วยมิลลิวินาทีนับจากจุดเริ่มต้นของสตรีมการตรวจสอบ แม้จะวัดเป็นหน่วยมิลลิวินาที แต่ค่านั้นเป็นค่าประมาณและ YouTube จะแทรกจุดเริ่มโฆษณาให้ใกล้กับเวลาดังกล่าวมากที่สุด คุณไม่ควรระบุค่าสําหรับพารามิเตอร์นี้หากการออกอากาศไม่มีสตรีมการตรวจสอบ ค่าเริ่มต้นของพร็อพเพอร์ตี้นี้คือ 0 ซึ่งบ่งชี้ว่าควรแทรกจุดเริ่มโฆษณาโดยเร็วที่สุด หากสตรีมการออกอากาศไม่มีความล่าช้า 0 เป็นค่าเดียวที่ใช้ได้ อย่างไรก็ตาม หากสตรีมการออกอากาศล่าช้า ค่าพร็อพเพอร์ตี้จะระบุเวลาที่ควรแทรกจุดเริ่มโฆษณาได้ โปรดดูรายละเอียดเพิ่มเติมในคู่มือเริ่มต้นใช้งานหมายเหตุ: หากการออกอากาศมีระยะการทดสอบ ระบบจะวัดออฟเซ็ตนับตั้งแต่เวลาที่เริ่มการทดสอบ |
settings.walltime |
datetime ค่านี้ระบุเวลาของนาฬิกาที่ควรแทรกจุดเริ่มโฆษณา ค่านี้ระบุในรูปแบบ ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ )API จะแสดงข้อผิดพลาดหากคําขอพยายามแทรกจุดเริ่มที่ระบุค่าของพร็อพเพอร์ตี้นี้และสําหรับพร็อพเพอร์ตี้ settings.offsetTimeMs |
settings.cueType |
string ประเภทของจุดเริ่ม ดูคําอธิบายจุดเริ่มประเภทต่างๆ ในคู่มือการเริ่มต้นใช้งาน นอกจากนี้ โปรดดูเอกสารอายุการใช้งานของการออกอากาศสําหรับแนวทางปฏิบัติแนะนําเกี่ยวกับการแทรกจุดเริ่มโฆษณาระหว่างการออกอากาศ ค่าที่ถูกต้องของพร็อพเพอร์ตี้นี้มีดังนี้
|
settings.durationSecs |
unsigned integer ระยะเวลาของจุดเริ่มเป็นวินาที คุณต้องระบุค่านี้หาก cueType คือ ad และจะไม่มีผล |