LiveCuepoints

ทรัพยากร liveCuepoint และเมธอด liveCuepoints.insert เลิกใช้งานแล้วและแทนที่ด้วยเมธอด liveBroadcasts.cuepoint

ทรัพยากร liveCuepoint จะแทรกจุดเริ่มในสตรีมสตรีมวิดีโอซึ่งอาจทริกเกอร์ช่วงพักโฆษณา

หมายเหตุ: จริงๆ แล้วคําสั่ง API นี้เป็นส่วนหนึ่งของ API สําหรับ Content ID ของ YouTube และมีข้อกําหนดการให้สิทธิ์ที่แตกต่างจากคําขอจัดการทรัพยากร liveBroadcast และ liveStream

วิธีการ

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

แทรก
แทรกจุดกึ่งกลางในการถ่ายทอดสด ขณะนี้คําขอที่อนุญาตวิธีนี้ต้องได้รับอนุญาตจากบัญชีที่เชื่อมโยงกับเจ้าของเนื้อหา YouTube ลองใช้เลย

การนําเสนอแหล่งข้อมูล

โครงสร้าง 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
ประเภทของจุดเริ่ม ดูคําอธิบายจุดเริ่มประเภทต่างๆ ในคู่มือการเริ่มต้นใช้งาน นอกจากนี้ โปรดดูเอกสารอายุการใช้งานของการออกอากาศสําหรับแนวทางปฏิบัติแนะนําเกี่ยวกับการแทรกจุดเริ่มโฆษณาระหว่างการออกอากาศ

ค่าที่ถูกต้องของพร็อพเพอร์ตี้นี้มีดังนี้
  • ad
settings.durationSecs unsigned integer
ระยะเวลาของจุดเริ่มเป็นวินาที คุณต้องระบุค่านี้หาก cueType คือ ad และจะไม่มีผล