หน้านี้จะแสดงการเปลี่ยนแปลงของ YouTube Live Streaming API และข้อมูลอัปเดตเกี่ยวกับเอกสารประกอบ ติดตามบันทึกการเปลี่ยนแปลงนี้
9 ตุลาคม 2023
เพื่อเป็นข้อมูลอ้างอิงเท่านั้น คุณดูรหัสสติกเกอร์ที่เกี่ยวข้องกับ Super Stickers ใดได้ในไฟล์ CSV นี้
อัปเดตคําจํากัดความของพร็อพเพอร์ตี้ snippet.superStickerDetails.superStickerMetadata.stickerId
ของทรัพยากร liveChatMessage
และพร็อพเพอร์ตี้ snippet.superStickerMetadata.stickerId
ของทรัพยากร superChatEvent
เพื่อแสดงข้อมูลนี้
15 กันยายน 2023
ตอนนี้ API รองรับการแทรกโฆษณาในการถ่ายทอดสดวิธีใหม่แล้ว นอกเหนือจาก liveCuepoints
ที่ให้คุณแทรกช่วงพักโฆษณาลงในการออกอากาศด้วยตนเองได้แล้ว ขณะนี้ YouTube ยังรองรับฟีเจอร์สำหรับแทรกช่วงพักโฆษณาตอนกลางโดยอัตโนมัติในการออกอากาศตามช่วงเวลาที่กำหนดไว้
หากเจ้าของการออกอากาศเปิดใช้โฆษณาอัตโนมัติ ก็จะดูลักษณะการทำงานของโฆษณาในด้านต่อไปนี้ได้
- ของช่วงระยะเวลาระหว่างช่วงพักโฆษณาตอนกลาง
- กลยุทธ์การกำหนดเวลาสำหรับจุดเริ่มโฆษณา คุณแทรกจุดเริ่มโฆษณาพร้อมกันสำหรับผู้ชมทั้งหมด หรือเวลาของจุดเริ่มโฆษณาอาจแตกต่างกันไปตามผู้ชมแต่ละราย กลยุทธ์หลังทำให้ YouTube กำหนดเวลาจุดเริ่มโฆษณาในอัตราที่เพิ่มขึ้นซึ่งทำให้ผู้ชมได้รับจุดเริ่มโฆษณาเมื่อมีสิทธิ์
- ช่วงเวลาที่ระบบไม่แสดงโฆษณาตอนกลาง สำหรับฟีเจอร์นี้ เจ้าของการออกอากาศได้ระบุว่าการแทรกโฆษณาตอนกลางจะหยุดชั่วคราวจนกว่าจะถึงเวลาที่กำหนดไว้
เอกสารประกอบนี้แสดงถึงการเปลี่ยนแปลงของ API ต่อไปนี้เพื่อรองรับฟีเจอร์นี้
- ขณะนี้ทรัพยากร
liveBroadcast
มีออบเจ็กต์monetizationDetails
แล้ว ช่องของออบเจ็กต์จะระบุว่ามีการเปิดใช้การแทรกโฆษณาอัตโนมัติสำหรับการออกอากาศหรือไม่ และระบุข้อมูลเพิ่มเติมสำหรับการกำหนดเวลาจุดเริ่มโฆษณา - พารามิเตอร์
part
ของเมธอดliveBroadcast.list
รองรับค่าmonetizationDetails
- คุณใช้เมธอด
update
เพื่อหยุดการแทรกโฆษณาตอนกลางชั่วคราวในระยะเวลาหนึ่งสำหรับการถ่ายทอดสดได้ นอกจากนี้ เอกสารยังระบุข้อผิดพลาดต่างๆ ที่อาจเกิดขึ้นเมื่ออัปเดตรายละเอียดการสร้างรายได้สำหรับการถ่ายทอดสด
1 สิงหาคม 2023
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เมธอด
liveBroadcasts.update
ไม่จำเป็นต้องระบุค่าในช่องเหล่านี้อีกต่อไปsnippet.title
status.privacyStatus
การละช่องเหล่านี้จากคำขอจะทำให้ช่องไม่เปลี่ยนแปลง
1 พฤศจิกายน 2022
-
เมธอด
liveBroadcasts.cuepoint
ใหม่นี้ช่วยให้เจ้าของช่องที่กำลังถ่ายทอดสดบน YouTube แทรกจุดเริ่มโฆษณาในการออกอากาศได้ ซึ่งจะทริกเกอร์ช่วงพักโฆษณาได้ วิธีนี้มาแทนที่เมธอดliveCuepoints.insert
ซึ่งเปิดให้เฉพาะพาร์ทเนอร์ด้านเนื้อหาของ YouTube แทรกจุดเริ่มโฆษณาในการถ่ายทอดสดได้คำแนะนำหลายรายการได้รับการอัปเดตเพื่อแสดงถึงความพร้อมให้บริการของวิธีการใหม่นี้
-
หมายเหตุ: ประกาศนี้เป็นประกาศการเลิกใช้งาน
เลิกใช้งานเมธอด
liveCuepoints.insert
แล้ว เราจะเลิกรองรับเมธอดliveCuepoints.insert
ในวันที่ 1 พฤษภาคม 2023 หรือหลังจากนั้น ผู้ใช้ API ควรอัปเดตแอปพลิเคชันให้เรียกใช้เมธอดliveBroadcasts.cuepoint
แทน -
นําเอกสารประกอบสําหรับเมธอด
liveBroadcasts.control
ออกแล้ว และได้มีการโพสต์ประกาศการเลิกใช้งานเมธอดดังกล่าวในเดือนกันยายน 2020
1 ตุลาคม 2022
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ไม่จำเป็นต้องระบุค่าในช่องเหล่านี้ของเมธอด
liveBroadcasts.update
อีกต่อไปcontentDetails.enableContentEncryption
contentDetails.enableDvr
contentDetails.enableEmbed
contentDetails.recordFromStart
contentDetails.startWithSlate
การละช่องเหล่านี้จากคำขอจะทำให้ช่องไม่เปลี่ยนแปลง
-
นําเอกสารสําหรับช่อง
liveBroadcast
ที่เลิกใช้แล้วออก:contentDetails.enableContentEncryption
contentDetails.startWithSlate
1 เมษายน 2022
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ขณะนี้พร็อพเพอร์ตี้
snippet.type
รองรับค่าใหม่ 2 ค่า ดังนี้membershipGiftingEvent
giftMembershipReceivedEvent
-
พร็อพเพอร์ตี้
snippet.membershipGiftingDetails
ใหม่ของทรัพยากรliveChatMessage
และพร็อพเพอร์ตี้ย่อยมีข้อมูลเกี่ยวกับกิจกรรมการซื้อแพ็กเกจสมาชิกแบบของขวัญ ในทํานองเดียวกัน พร็อพเพอร์ตี้snippet.giftMembershipReceivedDetails
ใหม่และผู้เผยแพร่โฆษณาย่อยก็มีข้อมูลเกี่ยวกับกิจกรรม "ได้รับแพ็กเกจสมาชิกแบบของขวัญ"
15 กันยายน 2021
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ขณะนี้พร็อพเพอร์ตี้
snippet.type
รองรับค่าใหม่ 2 ค่า ดังนี้newSponsorEvent
memberMilestoneChatEvent
-
พร็อพเพอร์ตี้
snippet.memberMilestoneChatDetails
ใหม่ของทรัพยากรliveChatMessage
และพร็อพเพอร์ตี้ย่อยมีข้อมูลเกี่ยวกับเหตุการณ์ข้อความแชทสุดพิเศษสำหรับสมาชิก ในทํานองเดียวกัน พร็อพเพอร์ตี้snippet.newSponsorDetails
ใหม่และพร็อพเพอร์ตี้ย่อยจะมีข้อมูลเกี่ยวกับเหตุการณ์ New Sponsor
1 ธันวาคม 2020
เมธอด liveBroadcasts.transition
ของ API รองรับข้อผิดพลาด 403
(Forbidden
) ใหม่ ซึ่งบ่งชี้ว่าผู้ใช้ส่งคำขอมากเกินไปภายในกรอบเวลาที่กำหนด สาเหตุของข้อผิดพลาดคือ userRequestsExceedRateLimit
21 กันยายน 2020
-
มีการอัปเดตคำจำกัดความของพร็อพเพอร์ตี้
status.madeForKids
ของทรัพยากรliveBroadcast
เพื่อชี้แจงว่าพร็อพเพอร์ตี้เป็นแบบอ่านอย่างเดียว แต่ไม่ได้แสดงถึงการเปลี่ยนแปลงฟังก์ชันของ APIหากต้องการกำหนดให้การถ่ายทอดสดมีเด็กเป็นกลุ่มเป้าหมาย ให้ตั้งค่าพร็อพเพอร์ตี้
status.selfDeclaredMadeForKids
เป็นtrue
เมื่อเรียกใช้เมธอดliveBroadcasts.insert
เพื่อสร้างการออกอากาศ -
หมายเหตุ: การเปลี่ยนแปลงนี้รวมถึงประกาศการเลิกใช้งานและการอัปเดตประกาศการเลิกใช้งานก่อนหน้านี้
เราจะเลิกใช้งานเมธอด
liveBroadcasts.control
ในวันที่ 1 ตุลาคม 2020 หรือหลังจากนั้น หลังจากวันที่ดังกล่าว การเรียกทั้งหมดสำหรับเมธอดนี้จะส่งคืนข้อผิดพลาดต้องห้าม (403) และเมธอดจะถูกนำออกโดยสมบูรณ์ในภายหลัง ลูกค้ายังคงใช้แถบสเลทของตัวเองได้โดยการเพิ่มโฆษณาซ้อนทับลงในวิดีโอที่ส่งไปยังเซิร์ฟเวอร์การส่งผ่านข้อมูลของ YouTubeวันที่เลิกใช้งานสำหรับประกาศการเลิกใช้งานที่ประกาศไว้ในวันที่ 16 เมษายน 2020 ซึ่งเดิมกำหนดไว้เป็นวันที่ 1 กันยายน 2020 ได้เลื่อนออกไป และตอนนี้จะมีผลในวันที่ 1 ตุลาคม 2020 หรือหลังจากนั้น ดังนั้นฟีเจอร์ที่รวมอยู่ในประกาศการเลิกใช้งานและเมธอด
liveBroadcasts.control
จะเลิกใช้งานพร้อมกัน
17 กรกฎาคม 2020
หมายเหตุ: อีเมลฉบับนี้เป็นข้อมูลอัปเดตเกี่ยวกับประกาศการเลิกใช้งานก่อนหน้านี้
ช่อง cdn.format
ของทรัพยากร liveStream
ซึ่งเลิกใช้งานแล้วในเดือนเมษายน 2016 จะไม่ได้รับการสนับสนุนตั้งแต่วันที่ 17 สิงหาคม 2020 เป็นต้นไป คำขอที่ยังใช้ช่องนั้นอยู่จะดำเนินการไม่สำเร็จนับตั้งแต่วันที่ดังกล่าว
หากโค้ดยังคงใช้ช่อง cdn.format
อยู่ จะต้องมีการอัปเดตโค้ดเพื่อระบุอัตราเฟรมและความละเอียดแยกกัน โดยใช้พร็อพเพอร์ตี้ cdn.frameRate
และ cdn.resolution
6 กรกฎาคม 2020
เราได้ปรับปรุงคำแนะนำการส่งเนื้อหา YouTube แบบสดผ่าน HLS โดยมีการเปลี่ยนแปลงบางอย่างดังนี้
- ระบบได้อัปเดตระยะเวลาที่แนะนำสำหรับกลุ่มสื่อเป็น 1-4 วินาที
- ส่วนใหม่จะอธิบายวิธีรับ URL การส่งผ่านข้อมูล HLS จาก YouTube Creator Studio
-
ย้ายวิธีการจัดรูปแบบค่าพารามิเตอร์
file
ไปที่ส่วนกรอกข้อมูล URL การส่งผ่านข้อมูล HLS ใหม่แล้ว คุณสามารถใช้วิธีการเหล่านี้โดยไม่คำนึงว่าจะได้รับ URL การส่งผ่านข้อมูล HLS จาก YouTube API หรือ YouTube Creator Studio
นอกจากนี้ การเปรียบเทียบโปรโตคอลการส่งผ่านข้อมูลใหม่ยังมีโปรโตคอลการส่งผ่านข้อมูลที่ YouTube รองรับ ตัวแปลงรหัสที่รองรับสำหรับแต่ละโปรโตคอล และข้อมูลเพิ่มเติมเกี่ยวกับกรณีการใช้งานที่เหมาะสมสำหรับแต่ละโปรโตคอล
16 เมษายน 2020
การอัปเดตนี้มีพร็อพเพอร์ตี้ใหม่และประกาศการเลิกใช้งาน ดังนี้
-
ตอนนี้ทรัพยากร
liveBroadcast
รองรับพร็อพเพอร์ตี้contentDetails.enableAutoStop
แล้ว พร็อพเพอร์ตี้จะระบุว่าควรหยุดการออกอากาศโดยอัตโนมัติประมาณ 1 นาทีหลังจากที่เจ้าของช่องหยุดสตรีมวิดีโอในสตรีมวิดีโอที่เชื่อมโยงหรือไม่เอกสารชีวิตของการออกอากาศได้รับการอัปเดตให้อธิบายว่ากระบวนการแบบทีละขั้นตอนในการสร้างและจัดการกิจกรรมสดของ YouTube จะเปลี่ยนแปลงไปอย่างไร หากคุณตั้งค่าพร็อพเพอร์ตี้
contentDetails.enableAutoStart
หรือcontentDetails.enableAutoStop
เป็นtrue
-
หมายเหตุ: ประกาศนี้เป็นประกาศการเลิกใช้งาน การเปลี่ยนแปลงเหล่านี้จะมีผลในวันที่ 1 กันยายน 2020 เป็นต้นไป ด้านล่างนี้เป็นวันที่ที่การเปลี่ยนแปลงมีผล
การอัปเดตนี้อธิบายถึงการเปลี่ยนแปลงที่อาจส่งผลเสีย โดยจะมีผลต่อแอปพลิเคชันไคลเอ็นต์ API ที่ใช้ทรัพยากร
liveStream
และliveBroadcast
เริ่มต้นของช่องเพื่อสตรีมเนื้อหาสดบน YouTube กล่าวอย่างเจาะจงคือ รหัสการเผยแพร่และรหัสสตรีมที่เชื่อมโยงกับการออกอากาศและสตรีมแบบถาวรจะไม่ทำงานอีกต่อไปเพื่อเริ่มการออกอากาศใหม่ใบสมัครของคุณจะได้รับผลกระทบในกรณีต่อไปนี้
- โดยจะตรวจสอบค่าของพร็อพเพอร์ตี้
isDefaultBroadcast
ของทรัพยากรliveBroadcast
ระบบจะไม่แสดงพร็อพเพอร์ตี้นี้หลังจากวันที่เลิกใช้งาน - โดยจะตรวจสอบค่าของพร็อพเพอร์ตี้
isDefaultStream
ของทรัพยากรliveStream
ระบบจะไม่แสดงพร็อพเพอร์ตี้นี้หลังจากวันที่เลิกใช้งาน - โดยจะเรียกเมธอด
liveBroadcasts.list
และตั้งค่าพารามิเตอร์broadcastType
เป็นpersistent
หรือall
เราจะเลิกใช้งานพารามิเตอร์นี้ในฐานะส่วนหนึ่งของการเปลี่ยนแปลงเหล่านี้ จากวันที่เลิกใช้งาน- หากค่าพารามิเตอร์
broadcastType
คือpersistent
เมธอดliveBroadcasts.list
จะไม่แสดงผลลัพธ์ใดๆ - หากค่าพารามิเตอร์
broadcastType
คือall
เมธอดliveBroadcasts.list
จะไม่แสดงการส่งข้อมูลเตือนภัยถาวรซึ่งมีอยู่ก่อนเวลาดังกล่าว
- หากค่าพารามิเตอร์
โปรดทราบว่าในช่วง 2-3 ปีที่ผ่านมา YouTube ได้สร้างสตรีมเริ่มต้นโดยอัตโนมัติและการออกอากาศเริ่มต้นสำหรับช่องเมื่อช่องนั้นเปิดใช้สตรีมมิงแบบสดแล้ว สตรีมเริ่มต้นมีอยู่อย่างไม่มีกำหนด ไม่มีเวลาเริ่มต้นหรือสิ้นสุดเชื่อมโยงอยู่ และลบไม่ได้ ในทำนองเดียวกัน การแพร่ภาพเริ่มต้นถือว่าเผยแพร่ตลอดเวลา อินสแตนซ์นี้มีอยู่ตลอดเวลาและไม่เกี่ยวข้องกับเหตุการณ์ใดเหตุการณ์หนึ่ง
ณ วันที่เลิกใช้งาน
- YouTube จะไม่สร้างสตรีมและการออกอากาศเริ่มต้นอีกต่อไป ไคลเอ็นต์ API ต้องสามารถสร้างและจัดการทรัพยากร
liveBroadcast
และliveStream
รวมถึงเชื่อมโยงทรัพยากรเหล่านั้นเข้าด้วยกันได้ แทนที่จะใช้ทรัพยากรเริ่มต้น - หากการออกอากาศเริ่มต้นและสตรีมเริ่มต้นของช่องกำลังถ่ายทอดสดอยู่ ซึ่งหมายความว่าช่องกำลังใช้ช่องออกอากาศเหล่านั้นสำหรับการถ่ายทอดสด ณ เวลาที่การเลิกใช้งานมีผล การออกอากาศที่ดำเนินอยู่จะไม่ได้รับผลกระทบ แต่หลังจากสิ้นสุดการออกอากาศ ช่องจะใช้การออกอากาศเริ่มต้นและสตรีมเริ่มต้นอีกครั้งไม่ได้
- หากการออกอากาศเริ่มต้นและสตรีมเริ่มต้นของช่องไม่ได้ถ่ายทอดสดอยู่ YouTube จะไม่สนใจความพยายามที่จะใช้ทรัพยากรเหล่านั้นในการออกอากาศวิดีโอหลังจากที่การเลิกใช้งานมีผลบังคับใช้
หากแอปพลิเคชันของคุณได้รับผลกระทบ โปรดดูเอกสารต่อไปนี้ ซึ่งจะช่วยคุณอัปเดตแอปพลิเคชันให้ยังคงทำงานได้ตามที่คาดไว้หลังจากการเปลี่ยนแปลงนี้
- คำแนะนำในการย้ายข้อมูลใหม่พยายามอธิบายขั้นตอนที่นักพัฒนาซอฟต์แวร์อาจต้องจัดการในไคลเอ็นต์ API ที่ใช้การออกอากาศและสตรีมเริ่มต้นอยู่
- คำแนะนำชีวิตของการออกอากาศจะอธิบายกระบวนการแบบทีละขั้นตอนซึ่งอธิบายวิธีสร้างและจัดการการถ่ายทอดสดบน YouTube แต่ละขั้นตอนจะอธิบายการเรียก API หรือสิ่งอื่นๆ ที่คุณต้องทำเพื่อให้การดำเนินการบางอย่างเสร็จสมบูรณ์ และแอปพลิเคชันของคุณจะต้องทำตามกระบวนการดังกล่าวเมื่อ YouTube หยุดรองรับสตรีมและการออกอากาศเริ่มต้น
- โดยจะตรวจสอบค่าของพร็อพเพอร์ตี้
31 มีนาคม 2020
หมายเหตุ: ประกาศนี้เป็นประกาศการเลิกใช้งาน
ทรัพยากร sponsor
และเมธอด sponsors.list
เลิกใช้งานแล้วและแทนที่ด้วยทรัพยากร member
และเมธอด members.list
ระบบจะไม่รองรับเมธอด sponsors.list
อีกต่อไปตั้งแต่วันที่ 30 กันยายน 2020
ไคลเอ็นต์ API ควรอัปเดตการเรียกเมธอด sponsors.list
ให้ใช้เมธอด members.list
แทน โปรดดูประวัติการแก้ไข API ข้อมูลของ YouTube เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรใหม่
11 มีนาคม 2020
มีการอัปเดตส่วนปลายทางการส่งผ่านข้อมูลของคู่มือการส่งเนื้อหา YouTube แบบสดผ่าน HLS เพื่ออธิบายกระบวนการที่โปรแกรมเปลี่ยนไฟล์ควรใช้ในการกรอกค่าพารามิเตอร์ file=
เมื่อสร้าง URL การส่งผ่านข้อมูลหลักและสำรอง
4 กุมภาพันธ์ 2020
คู่มือการส่งเนื้อหา YouTube แบบสดผ่าน HLS ได้รับการอัปเดตเพื่อให้เข้าใจว่าคำขอ DELETE
เป็นตัวเลือกที่ไม่บังคับและปลายทาง HLS ของ YouTube จะไม่สนใจคำขอ YouTube แนะนำว่าลูกค้าไม่ควรส่งคำขอDELETE
เนื่องจากเหตุผลด้านประสิทธิภาพ
10 มกราคม 2020
ปัจจุบัน API รองรับความสามารถในการระบุเนื้อหาที่มีเด็กเป็นกลุ่มเป้าหมาย ซึ่ง YouTube เรียกว่า "สร้างมาเพื่อเด็ก" ดูข้อมูลเพิ่มเติมเกี่ยวกับเนื้อหาที่ "สร้างมาเพื่อเด็ก" ในศูนย์ช่วยเหลือของ YouTube
-
แหล่งข้อมูล
liveBroadcast
รองรับพร็อพเพอร์ตี้ใหม่ 2 รายการเพื่อให้ครีเอเตอร์เนื้อหาและผู้ชมระบุเนื้อหาที่ "สร้างมาเพื่อเด็ก" ได้ ดังนี้-
พร็อพเพอร์ตี้
selfDeclaredMadeForKids
ช่วยให้ครีเอเตอร์เนื้อหาระบุว่าการถ่ายทอดสดมีเด็กเป็นกลุ่มเป้าหมายหรือไม่ พร็อพเพอร์ตี้นี้ตั้งค่าได้เมื่อสร้างการออกอากาศผ่านเมธอดliveBroadcasts.insert
โปรดทราบว่าพร็อพเพอร์ตี้นี้จะรวมอยู่ในการตอบกลับ API ที่มีทรัพยากรliveBroadcast
เท่านั้น หากเจ้าของช่องให้สิทธิ์คำขอ API -
พร็อพเพอร์ตี้
madeForKids
ช่วยให้ผู้ใช้ API เรียกดูสถานะ "สร้างมาเพื่อเด็ก" ของการออกอากาศได้ เช่น สถานะอาจกำหนดตามค่าของพร็อพเพอร์ตี้selfDeclaredMadeForKids
ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดผู้ชมสำหรับช่อง วิดีโอ หรือการออกอากาศได้ที่ศูนย์ช่วยเหลือของ YouTube
-
พร็อพเพอร์ตี้
-
ใน YouTube Data API ทรัพยากร
channel
ยังรองรับพร็อพเพอร์ตี้selfDeclaredMadeForKids
และmadeForKids
ใหม่ด้วย
เราได้ปรับปรุงข้อกำหนดในการให้บริการและนโยบายสำหรับนักพัฒนาซอฟต์แวร์ API ของ YouTube ด้วย โปรดดูข้อมูลเพิ่มเติมที่ข้อกำหนดในการให้บริการของบริการ YouTube API - ประวัติการแก้ไข การเปลี่ยนแปลงข้อกำหนดในการให้บริการและนโยบายสำหรับนักพัฒนาแอปของ YouTube API จะมีผลในวันที่ 10 มกราคม 2020 ตามเวลาแปซิฟิก
20 สิงหาคม 2019
เราได้ปรับปรุงส่วนข้อกำหนดของคำแนะนำการส่งเนื้อหา YouTube แบบสดผ่าน HLS โดยมีการเปลี่ยนแปลง 2 ประการดังนี้
- วิธีนี้อธิบายว่าแนวทางปฏิบัติแนะนำคือการใส่ทั้งส่วนที่ตอบรับและกลุ่มเด่นไว้ในเพลย์ลิสต์สื่อแต่ละรายการ ซึ่งจะทำให้มีโอกาสน้อยลงที่จะข้ามกลุ่มหากเพลย์ลิสต์สื่อหายไปในฝั่งเซิร์ฟเวอร์ เช่น คุณอาจรวมกลุ่มที่รับทราบแล้วได้สูงสุด 2 กลุ่มที่แล้วและส่วนที่โดดเด่นสูงสุด 5 กลุ่มในเพลย์ลิสต์สื่อแต่ละรายการ
- ปัจจุบันข้อกำหนดให้ส่งเพลย์ลิสต์สื่อสำหรับกลุ่มสื่อทุกกลุ่ม ซึ่งจะช่วยให้เซิร์ฟเวอร์กู้คืนได้อย่างรวดเร็วหากเพลย์ลิสต์สื่อสูญหาย แนวทางปฏิบัตินี้เคยแสดงเป็นคำแนะนำ
28 มิถุนายน 2019
YouTube รองรับการส่งผ่านข้อมูล HLS แล้ว ดังนั้น พร็อพเพอร์ตี้ ingestionType
ของทรัพยากร liveStream
จึงรองรับค่าใหม่ hls
เพื่อระบุสตรีมที่นำเข้าไปยัง YouTube โดยใช้ HLS
คู่มือการส่งเนื้อหา YouTube แบบสดผ่าน HLS มีหลักเกณฑ์ในการใช้ HLS เพื่อสตรีมเนื้อหาสดจากโปรแกรมเปลี่ยนไฟล์ไปยัง YouTube คู่มือนี้มีจุดประสงค์เพื่อช่วยให้ผู้ให้บริการโปรแกรมเปลี่ยนไฟล์เพิ่มการรองรับการนำส่ง HLS ลงในผลิตภัณฑ์ของตน
4 เมษายน 2019
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เราได้อัปเดตเอกสารอ้างอิง API ให้อธิบาย Use Case ที่พบบ่อยของเมธอดแต่ละวิธีได้ดียิ่งขึ้น และเพื่อแสดงตัวอย่างโค้ดแบบไดนามิกและมีคุณภาพสูงผ่านวิดเจ็ต API Explorer ดูตัวอย่างในเอกสารประกอบของเมธอด
liveBroadcasts.list
ขณะนี้มีองค์ประกอบใหม่ 2 อย่างบนหน้าเว็บที่อธิบายถึงเมธอด API ดังนี้-
วิดเจ็ต API Explorer ช่วยให้คุณสามารถเลือกขอบเขตการให้สิทธิ์ ป้อนตัวอย่างพารามิเตอร์และค่าพร็อพเพอร์ตี้ แล้วส่งคำขอ API จริงและดูการตอบกลับ API ตามจริง นอกจากนี้ วิดเจ็ตยังมีมุมมองแบบเต็มหน้าจอที่แสดงตัวอย่างโค้ดที่สมบูรณ์ ซึ่งจะอัปเดตแบบไดนามิกเพื่อใช้ขอบเขตและค่าที่คุณป้อน
-
ส่วน Use Case ที่พบบ่อย จะอธิบาย Use Case ที่พบบ่อย 1 รายการขึ้นไปสำหรับวิธีที่อธิบายในหน้า เช่น คุณอาจเรียกใช้เมธอด
liveBroadcasts.list
เพื่อดึงข้อมูลเกี่ยวกับการออกอากาศที่เฉพาะเจาะจง หรือเพื่อดึงข้อมูลเกี่ยวกับการออกอากาศของผู้ใช้ปัจจุบันคุณสามารถใช้ลิงก์ในส่วนนั้นเพื่อเติมข้อมูลตัวอย่างค่าลงใน API Explorer สำหรับกรณีการใช้งานของคุณ หรือเปิด API Explorer ของ API แบบเต็มหน้าจอด้วยค่าเหล่านั้นที่ป้อนข้อมูลแล้ว การเปลี่ยนแปลงเหล่านี้มีจุดมุ่งหมายเพื่อทำให้คุณดูตัวอย่างโค้ดที่เกี่ยวข้องโดยตรงกับกรณีการใช้งานที่คุณพยายามจะติดตั้งในแอปพลิเคชันของคุณเองได้ง่ายขึ้น
ปัจจุบันตัวอย่างโค้ดได้รับการสนับสนุนสำหรับ Java, JavaScript, PHP, Python และ Curl
-
-
หน้าตัวอย่างโค้ดยังมี UI ใหม่ที่นำเสนอฟีเจอร์เดียวกันทั้งหมดดังที่อธิบายไว้ข้างต้น เครื่องมือนี้จะช่วยให้คุณสำรวจกรณีการใช้งานสำหรับวิธีการต่างๆ โหลดค่าลงใน API Explorer และเปิด API Explorer แบบเต็มหน้าจอเพื่อรับตัวอย่างโค้ดใน Java, JavaScript, PHP และ Python
พร้อมกับการเปลี่ยนแปลงนี้ หน้าเว็บที่ก่อนหน้านี้เคยแสดงตัวอย่างโค้ดที่พร้อมใช้งานสำหรับ Java, PHP และ Python ได้ถูกนำออกไปแล้ว
25 กุมภาพันธ์ 2019
เราได้อัปเดตเอกสารประกอบของทรัพยากร liveChatMessage
และ superChatEvent
เพื่อแสดงให้เห็นว่าขณะนี้แหล่งข้อมูลทั้งสองมีข้อมูลเกี่ยวกับ Super Stickers แล้ว Super Stickers คือข้อความ Super Chat ประเภทหนึ่งที่แสดงรูปภาพ แฟนๆ ซื้อข้อความ Super Stickers ในระหว่างที่สตรีมแบบสดบน YouTube เช่นเดียวกับ Super Chat อื่นๆ
- ในทรัพยากร
liveChatMessage
ระบบได้ตั้งค่าพร็อพเพอร์ตี้snippet.type
เป็นsuperStickerEvent
เพื่อระบุว่าทรัพยากรมีข้อมูลเกี่ยวกับ Super Stickers ในกรณีดังกล่าว ทรัพยากรจะมีออบเจ็กต์snippet.superStickerDetails
ด้วย ซึ่งมีข้อมูลเพิ่มเติมเกี่ยวกับ Super Stickers - ในทรัพยากร
superChatEvent
บูลีนsnippet.isSuperStickerEvent
จะระบุว่าข้อความ Super Chat นั้นเป็น Super Stickers ด้วยหรือไม่ หากเป็นเช่นนั้น ออบเจ็กต์snippet.superStickerMetadata
จะมีรายละเอียดเพิ่มเติมเกี่ยวกับ Super Stickers
5 เมษายน 2018
เราได้อัปเดตคำอธิบายของเมธอด superChatEvents.list
เพื่อแสดงถึงข้อเท็จจริงที่ว่าการตอบกลับของ API ไม่มี fanFundingEvents
อีกต่อไป ซึ่งเลิกใช้งานแล้วในช่วงต้นปี 2017
3 เมษายน 2017
เพิ่มตัวอย่างโค้ด Java ใหม่ที่แสดงวิธีแสดงรายการ แทรก และลบข้อความแชทสด ตัวอย่างเรียกใช้เมธอดต่อไปนี้:
13 กุมภาพันธ์ 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตทรัพยากรและเมธอดที่มีอยู่
-
อัปเดตเมธอด
liveCuepoints.insert
แล้วเพื่อแสดงข้อเท็จจริงที่ว่าปัจจุบันจำเป็นต้องใช้พารามิเตอร์onBehalfOfContentOwner
นอกจากนี้ รายละเอียดของเมธอดยังได้รับการอัปเดตด้วย โปรดทราบว่าการเรียกไปยังวิธีการนั้นต้องได้รับอนุญาตจากบัญชีที่เชื่อมโยงกับเจ้าของเนื้อหา YouTube
-
9 กุมภาพันธ์ 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตทรัพยากรและเมธอดที่มีอยู่
-
พารามิเตอร์
hl
ใหม่ของเมธอดsuperChatEvents.list
ช่วยให้คุณระบุได้ว่าค่าพร็อพเพอร์ตี้snippet.displayString
ควรมีการจัดรูปแบบตามแบบแผนของภาษาใดภาษาหนึ่ง คําจํากัดความของพร็อพเพอร์ตี้ดังกล่าวได้รับการอัปเดตให้สอดคล้องกันด้วยค่าพารามิเตอร์ต้องเป็นรหัสภาษาที่รวมอยู่ในรายการซึ่งแสดงผลโดยเมธอด
i18nLanguages.list
ค่าเริ่มต้นคือen
ซึ่งหมายความว่าการทำงานเริ่มต้นคือการจัดรูปแบบสตริงที่แสดงเช่นเดียวกับที่ใช้ในภาษาอังกฤษ ตัวอย่างเช่น โดยค่าเริ่มต้น สตริงจะมีรูปแบบเป็น$1.00
ไม่ใช่$1,00
-
1 กุมภาพันธ์ 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
แหล่งข้อมูลและวิธีการใหม่ๆ
-
ทรัพยากร
superChatEvent
ใหม่แสดงถึงข้อความ Super Chat ที่แฟนๆ ซื้อระหว่างสตรีมแบบสดบน YouTube Super Chat จะโดดเด่นกว่าข้อความอื่นๆ ในแชทสดของ YouTube ใน 2 รูปแบบต่อไปนี้- Super Chat จะไฮไลต์ด้วยสี
- Super Chat จะตรึงไว้ในทิกเกอร์ในระยะเวลาหนึ่ง
สีของ Super Chat ระยะเวลาที่จะตรึงไว้ในทิกเกอร์ และความยาวสูงสุดของข้อความจะกำหนดโดยยอดรวมการซื้อ ศูนย์ช่วยเหลือของ YouTube มีข้อมูลเพิ่มเติมเกี่ยวกับ Super Chat
API รองรับวิธีการแสดงรายการเหตุการณ์ Super Chat สำหรับสตรีมแบบสดของช่องในช่วง 30 วันที่ผ่านมา วิธีนี้จะส่งคืนข้อมูลเกี่ยวกับกิจกรรมการให้เงินสนับสนุนของแฟนๆ (
fanFundingEvents
) จากสตรีมแบบสดครั้งล่าสุดของช่องด้วย
-
-
การอัปเดตทรัพยากรและเมธอดที่มีอยู่
-
ขณะนี้พร็อพเพอร์ตี้
snippet.type
รองรับค่าsuperChatEvent
ซึ่งบ่งชี้ว่าทรัพยากรนั้นอธิบาย Super Chatนอกจากนี้ พร็อพเพอร์ตี้
snippet.superChatDetails
ใหม่ของทรัพยากรliveChatMessage
และพร็อพเพอร์ตี้ย่อยยังมีข้อมูลเกี่ยวกับเหตุการณ์ Super Chat อีกด้วย -
พร็อพเพอร์ตี้
cdn.resolution
ของทรัพยากรliveStream
รองรับค่า2160p
แล้ว
-
-
ข้อผิดพลาดใหม่และข้อผิดพลาดที่อัปเดต
-
API รองรับข้อผิดพลาดใหม่ต่อไปนี้
รายละเอียดข้อผิดพลาด liveBroadcasts.insert
liveBroadcasts.update
เมธอด liveBroadcasts.insert
และliveBroadcasts.update
จะแสดงผลข้อผิดพลาด400
(Bad Request
) เพื่อระบุว่าทรัพยากรliveBroadcast
ที่แทรกหรืออัปเดตมีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้contentDetails.enableEmbed
หรือพร็อพเพอร์ตี้contentDetails.projection
สาเหตุของข้อผิดพลาดใหม่ 2 รายการคือinvalidEmbedSetting
และinvalidProjection
ตามลำดับ
-
12 มกราคม 2017
หมายเหตุ: ประกาศนี้เป็นประกาศการเลิกใช้งาน
ร่วมกับการเปิดตัวฟีเจอร์ใหม่ Super Chat นั้น YouTube ได้ยกเลิกฟีเจอร์การให้เงินสนับสนุนของแฟนๆ และ API การให้เงินสนับสนุนของแฟนๆ จะปิดใช้งานในวันที่ 28 กุมภาพันธ์ 2017 ณ วันที่ดังกล่าว
- เมธอด
liveChatMessages.list
จะไม่แสดงข้อความที่มีsnippet.type
เป็นfanFundingEvent
อีกต่อไป ในทำนองเดียวกัน ทรัพยากรliveChatMessage
รายการจะไม่มีออบเจ็กต์snippet.fanFundingEventDetails
อีกต่อไป - เมธอด
fanFundingEvents.list
จะไม่แสดงข้อมูลอีกต่อไป
11 สิงหาคม 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ข้อกำหนดในการให้บริการของบริการ API ของ YouTube ที่เผยแพร่ใหม่ ("ข้อกำหนดฉบับปรับปรุง") ที่กล่าวถึงรายละเอียดในบล็อกวิศวกรรมและนักพัฒนาซอฟต์แวร์ของ YouTube จะให้ข้อมูลอัปเดตมากมายสำหรับข้อกำหนดในการให้บริการปัจจุบัน นอกจากข้อกำหนดฉบับปรับปรุงซึ่งจะมีผลบังคับใช้ในวันที่ 10 กุมภาพันธ์ 2017 แล้ว การปรับปรุงนี้ยังมีเอกสารสนับสนุนอีกหลายฉบับเพื่อช่วยอธิบายนโยบายที่นักพัฒนาแอปต้องปฏิบัติตาม
คุณสามารถดูเอกสารใหม่ทั้งชุดได้ในประวัติการแก้ไขสำหรับข้อกำหนดที่ปรับปรุง นอกจากนี้ การเปลี่ยนแปลงข้อกำหนดที่ปรับปรุงในอนาคตหรือเอกสารสนับสนุนดังกล่าวจะมีการอธิบายไว้ในประวัติการแก้ไขดังกล่าวด้วย คุณติดตามการเปลี่ยนแปลงข้อมูลในฟีด RSS ในประวัติการแก้ไขได้จากลิงก์ในเอกสารนั้น
20 พฤษภาคม 2016
ตอนนี้ YouTube รองรับการส่งผ่านข้อมูล DASH แล้ว ดังนั้น พร็อพเพอร์ตี้ ingestionType
ของทรัพยากร liveStream
จึงรองรับค่าใหม่ dash
เพื่อระบุสตรีมที่นำเข้าไปยัง YouTube โดยใช้ DASH
คู่มือการส่งเนื้อหา YouTube แบบสดผ่าน DASH ใหม่มีหลักเกณฑ์ในการใช้รูปแบบการส่ง DASH เพื่อสตรีมข้อมูลสดบน YouTube จากโปรแกรมเปลี่ยนไฟล์ มีไว้เพื่อช่วยให้ผู้ให้บริการโปรแกรมเปลี่ยนไฟล์เพิ่มการรองรับการนำส่ง DASH ไปยังผลิตภัณฑ์ของตน
18 เมษายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตทรัพยากรและเมธอดที่มีอยู่
- การอัปเดตทรัพยากร
liveStream
รายการ-
ตอนนี้ YouTube รองรับการสตรีมที่มีความละเอียด 1440p ที่ 30 หรือ 60 เฟรมต่อวินาทีแล้ว
นอกจากนี้ ทรัพยากร
liveStream
ยังมีพร็อพเพอร์ตี้ใหม่สำหรับการระบุอัตราเฟรมและความละเอียดของข้อมูลวิดีโอขาเข้าด้วยพร็อพเพอร์ตี้ cdn.frameRate
อัตราเฟรมของข้อมูลวิดีโอขาเข้า ค่าที่ถูกต้องคือ 30fps
และ60fps
cdn.resolution
ความละเอียดของข้อมูลวิดีโอขาเข้า ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือ 1440p
,1080p
,720p
,480p
,360p
และ240p
-
ตามการแนะนำพร็อพเพอร์ตี้
cdn.frameRate
และcdn.resolution
ของทรัพยากรliveStream
ตอนนี้cdn.format
ของทรัพยากรได้เลิกใช้งานแล้ว พร็อพเพอร์ตี้cdn.format
ระบุความละเอียดและอัตราเฟรมเป็นค่าเดียวเราขอแนะนําให้คุณเปลี่ยนไปใช้ช่องที่รองรับใหม่ ในระหว่างนี้
cdn.format
จะทำงานต่อไป นอกจากนี้ คำขอให้แทรกสตรีมแบบสดจะประสบความสำเร็จในตอนนี้ ตราบใดที่คุณระบุค่าสำหรับพร็อพเพอร์ตี้cdn.format
หรือพร็อพเพอร์ตี้cdn.frameRate
และcdn.resolution
หากคุณระบุค่าสำหรับพร็อพเพอร์ตี้ทั้ง 3 รายการ API อาจแสดงข้อผิดพลาดหากค่าไม่สอดคล้องกันโปรดทราบว่าแม้พร็อพเพอร์ตี้
cdn.format
จะเลิกใช้งานแล้ว แต่ตอนนี้รองรับค่าใหม่ 2 ค่า ได้แก่1440p
และ1440p_hfr
เพื่อให้สะท้อนการรองรับสตรีมแบบ 1440p ที่ 30 หรือ 60 เฟรมต่อวินาทีของ API ได้
-
- การอัปเดตทรัพยากร
liveBroadcast
รายการ-
ทรัพยากร
liveBroadcast
มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้พร็อพเพอร์ตี้ contentDetails.boundStreamLastUpdateTimeMs
วันที่และเวลาที่สตรีมแบบสดที่อ้างอิงโดยพร็อพเพอร์ตี้ contentDetails.boundStreamId
ของการออกอากาศได้รับการอัปเดตครั้งล่าสุดcontentDetails.projection
รูปแบบการฉายภาพของการออกอากาศ ค่าเริ่มต้นของพร็อพเพอร์ตี้คือ rectangular
ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้คือ360
และrectangular
-
คำจำกัดความของพร็อพเพอร์ตี้
statistics.totalChatCount
ของทรัพยากรliveBroadcast
ได้รับการอัปเดตเพื่อให้ค่าพร็อพเพอร์ตี้ปรากฏต่อเมื่อการออกอากาศมีข้อความแชทอย่างน้อย 1 รายการ
-
- การอัปเดตทรัพยากร
liveChatMessage
รายการ-
พร็อพเพอร์ตี้
snippet.type
รองรับค่าใหม่ 2 ค่า ได้แก่messageDeletedEvent
และuserBannedEvent
ซึ่งสอดคล้องกับพร็อพเพอร์ตี้ใหม่ที่อธิบายไว้ในหัวข้อย่อยต่อไปนี้ คําจํากัดความของพร็อพเพอร์ตี้snippet.authorChannelId
ยังได้รับการอัปเดตด้วยเพื่ออธิบายสิ่งที่ค่าพร็อพเพอร์ตี้ระบุสําหรับข้อความประเภทใหม่เหล่านี้ -
ทรัพยากร
liveChatMessage
มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้พร็อพเพอร์ตี้ snippet.messageDeletedDetails
ออบเจ็กต์นี้มีข้อมูลเกี่ยวกับข้อความที่ผู้ดูแลแชทลบ ออบเจ็กต์จะปรากฏก็ต่อเมื่อค่าพร็อพเพอร์ตี้ snippet.type
คือmessageDeletedEvent
snippet.userBannedDetails
ออบเจ็กต์นี้มีข้อมูลเกี่ยวกับผู้ใช้ที่ถูกแบนไม่ให้เข้าร่วมแชท ออบเจ็กต์ดังกล่าวยังมีข้อมูลเกี่ยวกับการแบนด้วย เช่น การแบนจะเป็นแบบถาวรหรือชั่วคราว หากการแบนเกิดขึ้นชั่วคราว พร็อพเพอร์ตี้ของออบเจ็กต์รายการใดรายการหนึ่งจะระบุระยะเวลาของการแบน
ออบเจ็กต์นี้จะปรากฏต่อเมื่อค่าพร็อพเพอร์ตี้snippet.type
คือuserBannedEvent
-
- การอัปเดตทรัพยากร
-
ข้อผิดพลาดใหม่และข้อผิดพลาดที่อัปเดต
-
API รองรับข้อผิดพลาดใหม่ต่อไปนี้
รายละเอียดข้อผิดพลาด liveBroadcasts.bind
เมธอด liveBroadcasts.bind
จะแสดงข้อผิดพลาด403
(Forbidden
) เพื่อระบุว่าผู้ใช้ส่งคำขอมากเกินไปภายในกรอบเวลาที่กำหนด สาเหตุของข้อผิดพลาดคือuserRequestsExceedRateLimit
เมธอดliveBroadcasts.insert
และliveBroadcasts.update
รองรับข้อผิดพลาดเดียวกันอยู่แล้วliveStreams.insert
เมธอด liveStreams.insert
รองรับข้อผิดพลาด400
(Bad Request
) ใหม่ 4 รายการที่ระบุค่าพร็อพเพอร์ตี้ที่ไม่ถูกต้องในทรัพยากรliveStream
ที่คำขอพยายามแทรก รายการต่อไปนี้ระบุสาเหตุของข้อผิดพลาดและพร็อพเพอร์ตี้ที่เกี่ยวข้อง
invalidFormat
:cdn.format
invalidFrameRate
:cdn.frameRate
invalidIngestionType
:cdn.ingestionType
invalidResolution
:cdn.resolution
liveStreams.insert
เมธอด liveStreams.insert
รองรับข้อผิดพลาด400
(Bad Request
) ใหม่ 2 รายการ แต่ละรายการจะระบุว่าค่าที่จำเป็นไม่มีในทรัพยากรliveStream
ที่คำขอพยายามแทรก รายการต่อไปนี้ระบุสาเหตุของข้อผิดพลาดและพร็อพเพอร์ตี้ที่เกี่ยวข้อง
frameRateRequired
:cdn.frameRate
resolutionRequired
:cdn.resolution
liveStream
คุณต้องระบุค่าสำหรับพร็อพเพอร์ตี้cdn.format
หรือสำหรับพร็อพเพอร์ตี้cdn.frameRate
และcdn.resolution
- API จะแสดงข้อผิดพลาด
formatRequired
หากคุณไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ใดๆ ใน 3 รายการดังกล่าว - API จะแสดงข้อผิดพลาด
frameRateRequired
หากคุณระบุค่าสําหรับcdn.resolution
แต่ไม่ใช่cdn.frameRate
- API จะแสดงข้อผิดพลาด
resolutionRequired
หากคุณระบุค่าสําหรับcdn.frameRate
แต่ไม่ใช่cdn.resolution
liveStreams.update
เมธอด liveStreams.update
จะแสดงข้อผิดพลาด403
(Forbidden
) หากคำขอพยายามแก้ไขค่าของพร็อพเพอร์ตี้ที่เปลี่ยนแปลงไม่ได้ต่อไปนี้cdn.format
cdn.frameRate
cdn.ingestionType
cdn.resolution
reason
ในการตอบกลับข้อผิดพลาดคือliveStreamModificationNotAllowed
-
18 ธันวาคม 2015
กฎหมายของสหภาพยุโรป (EU) กำหนดว่าต้องมีการเปิดเผยข้อมูลบางอย่างต่อผู้ใช้ปลายทางในสหภาพยุโรปและได้รับการยินยอมจากผู้ใช้ดังกล่าว ดังนั้น สำหรับผู้ใช้ปลายทางในสหภาพยุโรป คุณต้องปฏิบัติตามนโยบายความยินยอมของผู้ใช้ EU เราได้เพิ่มประกาศข้อกำหนดนี้ไว้ในข้อกำหนดในการให้บริการ YouTube API
17 ธันวาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
แหล่งข้อมูลและวิธีการใหม่ๆ
-
API รองรับทรัพยากรใหม่ๆ หลายรายการเพื่อรองรับฟังก์ชันการแชทสำหรับการถ่ายทอดสด YouTube รองรับฟังก์ชันแชทสดระหว่างการถ่ายทอดสด ทรัพยากรเหล่านี้และวิธีการของทรัพยากรเหล่านี้รองรับการเรียกข้อความแชท รวมถึงฟังก์ชันการดูแลระบบสำหรับแชท
แหล่งข้อมูล liveChatMessage
ทรัพยากรนี้จะแสดงข้อความในแชทสดของ YouTube YouTube สนับสนุนข้อความหลายประเภท รวมถึง SMS และกิจกรรมการให้เงินสนับสนุนของแฟนๆ ข้อความบางประเภทจะระบุเฟสที่เฉพาะเจาะจงของแชท เช่น การเริ่มต้นของช่วงเวลาสำหรับผู้สนับสนุนเท่านั้นหรือช่วงสิ้นสุดการแชท API รองรับเมธอดในการแสดง แทรก และลบข้อความแชทสด liveChatModerators
ทรัพยากรนี้ระบุผู้ดูแลแชท ผู้ดูแลสามารถทำงานด้านการดูแลระบบบางอย่าง เช่น แบนผู้ใช้จากแชทหรือนำข้อความออก API รองรับเมธอดในการแสดง แทรก และลบผู้ดูแลแชทสด liveChatBans
ทรัพยากรนี้ระบุผู้ใช้ที่ถูกแบนไม่ให้โพสต์ข้อความไปยังแชทสดรายการใดรายการหนึ่ง การแบนอาจเป็นได้ทั้งชั่วคราวหรือถาวร API รองรับเมธอดในการแทรกและลบการแบนแชทสด fanFundingEvents
ทรัพยากรนี้แสดงถึงกิจกรรมการให้เงินสนับสนุนของแฟนๆ ในช่อง YouTube การให้เงินสนับสนุนของแฟนๆ เป็นช่องทางให้ผู้ชมสามารถสนับสนุนครีเอเตอร์ YouTube ตามความสมัครใจด้วยการสนับสนุนทางการเงินแบบครั้งเดียว
เมธอดfanFundingEvents.list
ของ API จะแสดงรายการกิจกรรมการให้เงินสนับสนุนของแฟนๆ ของช่อง กิจกรรมการให้เงินสนับสนุนของแฟนๆ ที่เริ่มต้นผ่านแชทสดระหว่างการถ่ายทอดสดที่เป็นของช่องจะทริกเกอร์ข้อความfanFundingEvent
ไปยังแชทสดของการถ่ายทอดสดด้วย
ดูข้อมูลเพิ่มเติมเกี่ยวกับการให้เงินสนับสนุนของแฟนๆ ได้ในศูนย์ช่วยเหลือของ YouTubesponsors
แหล่งข้อมูล sponsor
ระบุผู้สนับสนุนของช่อง YouTube ผู้สนับสนุนจ่ายค่าธรรมเนียมรายเดือนให้กับช่อง ป้ายจะปรากฏข้างข้อความของผู้สนับสนุนในแชทสดของช่อง นอกจากนี้ ผู้สนับสนุนยังเข้าร่วมแชทสดสำหรับผู้สนับสนุนช่องโดยเฉพาะได้ด้วยหากมี
เมธอดsponsors.list
ของ API จะระบุผู้สนับสนุนของช่อง เมื่อผู้ใช้ลงชื่อสมัครใช้เพื่อสนับสนุนช่องระหว่างการถ่ายทอดสดที่เป็นของช่องนั้น API จะเพิ่มข้อความnewSponsorEvent
ลงในแชทสดของการออกอากาศดังกล่าวด้วย
ดูข้อมูลเพิ่มเติมเกี่ยวกับการสนับสนุนในศูนย์ช่วยเหลือของ YouTube
-
-
การอัปเดตทรัพยากรและเมธอดที่มีอยู่
-
ทรัพยากร
liveBroadcast
มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้พร็อพเพอร์ตี้ snippet.liveChatId
รหัสสำหรับแชทสดของ YouTube ของการออกอากาศ เมื่อใช้รหัส คุณจะใช้เมธอดของทรัพยากร liveChatMessage
เพื่อเรียกข้อมูล แทรก หรือลบข้อความแชทได้ คุณยังสามารถเพิ่มหรือนำผู้ดูแลแชทออก แบนผู้ใช้ไม่ให้เข้าร่วมแชทสด หรือยกเลิกการแบนที่มีอยู่ได้contentDetails.closedCaptionsType
หมายเหตุ: พร็อพเพอร์ตี้นี้มาแทนที่พร็อพเพอร์ตี้ contentDetails.enableClosedCaptions
พร็อพเพอร์ตี้นี้จะระบุว่าเปิดใช้คำบรรยายสำหรับการออกอากาศหรือไม่ และหากเปิดอยู่ คุณจะให้คำบรรยายประเภทใดดังนี้closedCaptionsDisabled
: คำบรรยายถูกปิดใช้สำหรับการถ่ายทอดสดclosedCaptionsHttpPost
: คุณจะส่งคำบรรยายไปยัง URL การส่งผ่านข้อมูลที่เชื่อมโยงกับสตรีมแบบสดผ่านทาง HTTP POSTclosedCaptionsEmbedded
: คำบรรยายจะเข้ารหัสในสตรีมวิดีโอโดยใช้รูปแบบ EIA-608 และ/หรือ CEA-708
contentDetails.enableClosedCaptions
พร็อพเพอร์ตี้นี้เลิกใช้งานแล้วตั้งแต่วันที่ 17 ธันวาคม 2015 โปรดใช้พร็อพเพอร์ตี้ contentDetails.closedCaptionsType
แทน สำหรับไคลเอ็นต์ API ที่ใช้คุณสมบัตินี้อยู่แล้ว:- การตั้งค่าพร็อพเพอร์ตี้เป็น
true
เทียบเท่ากับการตั้งค่าพร็อพเพอร์ตี้contentDetails.closedCaptionsType
เป็นclosedCaptionsHttpPost
- การตั้งค่าพร็อพเพอร์ตี้เป็น
false
เทียบเท่ากับการตั้งค่าพร็อพเพอร์ตี้contentDetails.closedCaptionsType
เป็นclosedCaptionsDisabled
-
พารามิเตอร์
broadcastType
ใหม่ของเมธอดliveBroadcasts.list
ช่วยให้คุณกรองการตอบสนองของ API เพื่อรวมการเผยแพร่เหตุการณ์ การออกอากาศถาวร หรือการออกอากาศทั้งหมดการออกอากาศอย่างถาวรเป็นการออกอากาศที่มีอยู่เสมอและไม่ได้เชื่อมโยงกับกิจกรรมใดกิจกรรมหนึ่ง กล่าวอย่างเจาะจงคือ การออกอากาศเริ่มต้นของช่องเป็นการออกอากาศแบบถาวรและเข้าถึงได้ผ่านหน้าแดชบอร์ดการถ่ายทอดสดใน YouTube Creator Studio การออกอากาศอื่นๆ ของช่องเป็นการออกอากาศกิจกรรม
-
-
ช่อง
status.healthStatus.configurationIssues[].type
ของทรัพยากรliveStream
จะรายงานข้อผิดพลาดสถานะประสิทธิภาพใหม่ต่อไปนี้ข้อผิดพลาด audioTooManyChannels
เสียงมีช่องมากกว่า 2 ช่อง แต่รองรับเพียงช่องเดียว (โมโน) หรือ 2 (สเตอริโอ) เท่านั้น โปรดแก้ไขจำนวนช่องเสียงให้ถูกต้อง frameRateHigh
อัตราเฟรมปัจจุบันสูงเกินไป โปรดตั้งค่าอัตราเฟรมเป็น FPS หรือน้อยกว่า%(framerate)s
-
แก้ไขวันที่เผยแพร่เอกสารก่อนหน้าแล้ว
-
ข้อผิดพลาดใหม่และข้อผิดพลาดที่อัปเดต
-
นอกจากข้อผิดพลาดที่กำหนดไว้สำหรับทรัพยากรใหม่ที่ระบุไว้ข้างต้น API ยังรองรับข้อผิดพลาดใหม่ต่อไปนี้ด้วย
รายละเอียดข้อผิดพลาด liveBroadcasts.update
รหัสตอบกลับ HTTP forbidden (403)
เหตุผล closedCaptionsTypeModificationNotAllowed
คำอธิบาย ค่า contentDetails.closedCaptionsType
จะแก้ไขได้เฉพาะเมื่อการออกอากาศอยู่ในสถานะcreated
หรือready
liveBroadcasts.update
รหัสตอบกลับ HTTP invalidValue (400)
เหตุผล invalidEnableClosedCaptions
คำอธิบาย ในแหล่งข้อมูล LiveBroadcast ค่าของพร็อพเพอร์ตี้ contentDetails.enableClosedCaptions
ไม่สามารถใช้ร่วมกับค่าของการตั้งค่าcontentDetails.closedCaptionType
แก้ไขทรัพยากรให้รวมเฉพาะพร็อพเพอร์ตี้ 1 ใน 2 รายการ แล้วส่งคำขออีกครั้ง
-
19 สิงหาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
แหล่งข้อมูลและวิธีการใหม่ๆ
-
หมายเหตุ: เอกสารสำหรับทรัพยากร
liveChat
และวิธีการของทรัพยากรเป็นความลับและจะแสดงแก่พาร์ทเนอร์ YouTube บางรายเท่านั้นทรัพยากร
liveChat
ใหม่มีความคิดเห็นที่โพสต์ระหว่างการถ่ายทอดสดบน YouTube API รองรับวิธีการสำหรับทรัพยากรนี้ 2 วิธีดังนี้วิธีการ liveChats.list
แสดงข้อความแชทสดสำหรับการออกอากาศ liveChats.insert
สร้างข้อความแชทใหม่ จะเรียกดูและโพสต์ข้อความแชทสดได้ในขณะที่ถ่ายทอดสดเท่านั้น
-
-
การอัปเดตทรัพยากรและเมธอดที่มีอยู่
-
ทรัพยากร
liveStream
มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้พร็อพเพอร์ตี้ snippet.isDefaultStream
ระบุว่าสตรีมนี้เป็นสตรีมเริ่มต้นสำหรับช่องหรือไม่ สตรีมเริ่มต้นของช่องจะมีอยู่อย่างไม่จำกัด ไม่มีเวลาเริ่มต้นหรือสิ้นสุดเชื่อมโยงอยู่ และไม่สามารถลบได้ ดูคำจำกัดความของพร็อพเพอร์ตี้สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของสตรีมเริ่มต้น status.healthStatus
ออบเจ็กต์นี้มีข้อมูลที่สามารถใช้ระบุ วินิจฉัย และแก้ปัญหาสตรีมมิง ออบเจ็กต์ดังกล่าวมีพร็อพเพอร์ตี้ย่อยหลายรายการเพื่อช่วยประเมินประสิทธิภาพของสตรีมวิดีโอสด
โดยเฉพาะอย่างยิ่ง ออบเจ็กต์status.healthStatus.configurationIssues[]
จะแสดงปัญหาที่ส่งผลกระทบต่อสตรีมวิดีโอ เอกสารใหม่ชื่อปัญหาการกำหนดค่าสำหรับทรัพยากร LiveStream จะแสดงปัญหาทั้งหมดที่ API รายงานcontentDetails.isReusable
ระบุว่าสตรีมใช้ซ้ำได้หรือไม่ ซึ่งหมายความว่าจะเชื่อมโยงกับการออกอากาศหลายรายการได้ เป็นเรื่องปกติที่ผู้ออกอากาศจะใช้สตรีมเดียวกันซ้ำสำหรับการออกอากาศหลายรายการ หากการออกอากาศเหล่านั้นเกิดขึ้นในเวลาต่างกัน -
ทรัพยากร
liveBroadcast
มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้พร็อพเพอร์ตี้ snippet.isDefaultBroadcast
ระบุว่าการออกอากาศนี้เป็นการออกอากาศเริ่มต้นสำหรับช่องหรือไม่ เมื่อเปิดใช้สตรีมมิงแบบสดสำหรับช่อง YouTube แล้ว YouTube จะสร้างสตรีมเริ่มต้นและการออกอากาศเริ่มต้นสำหรับช่อง สตรีมจะกำหนดวิธีที่เจ้าของช่องส่งวิดีโอสดไปยัง YouTube และการออกอากาศเป็นวิธีที่ผู้ชมจะเห็นสตรีมเริ่มต้น ดูคำจำกัดความของพร็อพเพอร์ตี้สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของการกระจายข้อมูลเริ่มต้น contentDetails.enableLowLatency
ระบุว่าการออกอากาศนี้ควรเข้ารหัสสำหรับสตรีมมิงที่มีเวลาในการตอบสนองต่ำหรือไม่ สตรีมที่มีเวลาในการตอบสนองต่ำสามารถลดระยะเวลาที่ต้องใช้ในการแสดงวิดีโอแก่ผู้ใช้ที่รับชม แต่ก็อาจส่งผลกระทบต่อความละเอียดของผู้ชมสตรีมได้ด้วยเช่นกัน statistics.totalChatCount
จำนวนข้อความแชทสดทั้งหมดที่เชื่อมโยงกับการออกอากาศ ระบบจะแสดงพร็อพเพอร์ตี้และค่าของพร็อพเพอร์ตี้หากผู้ใช้เห็นการออกอากาศและเปิดใช้ฟีเจอร์แชทสด โปรดทราบว่าคุณสมบัตินี้จะไม่ระบุค่าหลังจากที่การออกอากาศสิ้นสุดลง ดังนั้นพร็อพเพอร์ตี้นี้จะไม่แสดงจำนวนข้อความแชทของวิดีโอที่เก็บถาวรของการถ่ายทอดสดที่เสร็จสมบูรณ์
-
-
ข้อผิดพลาดใหม่และข้อผิดพลาดที่อัปเดต
-
นอกจากข้อผิดพลาดที่กำหนดไว้สำหรับทรัพยากร
liveChat
ใหม่แล้ว API ยังรองรับข้อผิดพลาดใหม่ต่อไปนี้ด้วยรายละเอียดข้อผิดพลาด liveStreams.update
รหัสตอบกลับ HTTP forbidden (403)
เหตุผล liveStreamModificationNotAllowed
คำอธิบาย API ไม่อนุญาตให้คุณเปลี่ยนสตรีมที่ใช้ซ้ำได้ให้เป็น "ไม่สามารถใช้ซ้ำได้" หรือในทางกลับกัน ดูข้อมูลเพิ่มเติมได้ที่ทำความเข้าใจการออกอากาศและสตรีม
-
21 พฤษภาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ขณะนี้ YouTube สนับสนุนการสตรีมวิดีโอสดที่ 60 เฟรมต่อวินาที (FPS) ซึ่งหมายความว่าเล่นวิดีโอได้อย่างราบรื่นมากขึ้นสำหรับการเล่นเกมและวิดีโออื่นๆ ที่ใช้ความเร็ว เมื่อเริ่มสตรีมแบบสดบน YouTube ที่ 60 FPS แล้ว YouTube จะให้บริการสตรีมที่ 30 FPS ในอุปกรณ์ที่ยังไม่สามารถดูอัตราเฟรมสูงได้ด้วย
พร็อพเพอร์ตี้
cdn.format
ของทรัพยากรliveStream
รองรับค่าใหม่ 2 ค่าสำหรับฟีเจอร์นี้ ได้แก่720p_hfr
และ1080p_hfr
ดูข้อมูลเพิ่มเติมเกี่ยวกับฟีเจอร์นี้ได้ที่บล็อกของ YouTube Creators
21 สิงหาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
อัปเดตคำจำกัดความของพารามิเตอร์
walltime
ของเมธอดliveBroadcasts.control
เพื่อให้ค่าพร็อพเพอร์ตี้ระบุในรูปแบบ ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ
) -
ปัจจุบัน API รองรับข้อผิดพลาดต่อไปนี้
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย insufficientPermissions
liveStreamingNotEnabled
เมธอดทั้งหมดสำหรับทรัพยากร liveBroadcast
และliveStream
จะแสดงข้อผิดพลาดนี้ หากผู้ใช้ที่ให้สิทธิ์คำขอ API ไม่ได้เปิดใช้สตรีมวิดีโอสดบน YouTube คุณอาจดูรายละเอียดที่อธิบายสาเหตุที่ผู้ใช้สตรีมวิดีโอสดไม่ได้ในการตั้งค่าช่องของผู้ใช้ที่ https://www.youtube.com/featuresrateLimitExceeded
userRequestsExceedRateLimit
ทั้งเมธอด liveBroadcasts.insert
และliveStreams.insert
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าผู้ใช้ส่งคำขอจำนวนมากเกินไปภายในกรอบเวลาที่กำหนด
2 พฤษภาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
อัปเดตคำอธิบายของทรัพยากร
liveStream
และเมธอดliveBroadcasts.bind
เพื่อให้ทราบว่าการออกอากาศเชื่อมโยงกับสตรีมวิดีโอได้เพียงรายการเดียว แต่สตรีมวิดีโอเชื่อมโยงกับการออกอากาศได้มากกว่า 1 รายการ การเปลี่ยนแปลงนี้เป็นเพียงการแก้ไขเอกสารประกอบเท่านั้น ฟังก์ชันการทำงานของ API ที่เกี่ยวข้องไม่มีการเปลี่ยนแปลง -
พร็อพเพอร์ตี้
contentDetails.monitorStream.enableMonitorStream
ของทรัพยากรliveBroadcast
ได้รับการอัปเดตให้อธิบายว่าหากค่าของพร็อพเพอร์ตี้คือtrue
คุณต้องเปลี่ยนการออกอากาศเป็นสถานะtesting
ก่อนที่จะเปลี่ยนสถานะเป็นlive
ได้ (หากค่าของคุณสมบัติคือfalse
การออกอากาศจะมีระยะtesting
ไม่ได้ คุณจึงเปลี่ยนการออกอากาศไปยังสถานะlive
ได้โดยตรง -
อัปเดตพร็อพเพอร์ตี้
settings.offsetTimeMs
ของทรัพยากรliveCuepoint
แล้ว โปรดทราบว่าคุณไม่ควรระบุค่าสำหรับพร็อพเพอร์ตี้หากการออกอากาศไม่มีสตรีมการตรวจสอบ -
ตอนนี้เมธอดทั้งหมดสำหรับทรัพยากร
liveBroadcast
และliveStream
รองรับพารามิเตอร์onBehalfOfContentOwner
และonBehalfOfContentOwnerChannel
แล้ว พารามิเตอร์เหล่านี้ช่วยให้คุณใช้ข้อมูลเข้าสู่ระบบการให้สิทธิ์เดียวกันเพื่อส่งคำขอ API สำหรับช่องต่างๆ ที่เชื่อมโยงกับเจ้าของเนื้อหารายเดียวกันได้ -
เอกสารของเมธอด
liveCuepoints.insert
ได้รับการอัปเดตแล้ว โปรดทราบว่าคุณสามารถตั้งค่าสำหรับพร็อพเพอร์ตี้settings.walltime
เมื่อเรียกใช้เมธอดนั้นได้ -
ตอนนี้เอกสารประกอบเกี่ยวกับข้อผิดพลาดจะระบุรหัสการตอบกลับ HTTP สำหรับข้อผิดพลาดแต่ละประเภท
-
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย insufficientPermissions
livePermissionBlocked
เมธอด liveBroadcasts.insert
,liveBroadcasts.transition
และliveStreams.insert
จะแสดงข้อผิดพลาดนี้ หากผู้ใช้ที่ให้สิทธิ์คำขอไม่สามารถสตรีมวิดีโอสดบน YouTube ได้ คุณอาจดูรายละเอียดที่อธิบายสาเหตุที่ผู้ใช้สตรีมวิดีโอสดไม่ได้ในการตั้งค่าช่องของผู้ใช้ที่ https://www.youtube.com/features -
ระบบได้อัปเดตข้อผิดพลาด
invalidScheduledStartTime
ของเมธอดliveBroadcasts.insert
เพื่อชี้แจงว่าเวลาเริ่มต้นที่กำหนดไว้ต้องใกล้เคียงกับวันที่ปัจจุบันจนสามารถกำหนดเวลาออกอากาศได้อย่างน่าเชื่อถือ ณ เวลานั้น
13 ธันวาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พร็อพเพอร์ตี้
status.recordingStatus
ใหม่ของทรัพยากรliveBroadcast
ระบุสถานะปัจจุบันของการออกอากาศ -
พร็อพเพอร์ตี้
contentDetails.enableClosedCaptions
ใหม่ของทรัพยากรliveBroadcast
ระบุว่าสามารถนำเข้าคำบรรยายสำหรับการออกอากาศได้หรือไม่ คุณตั้งค่าคุณสมบัตินี้ได้เมื่อแทรกหรืออัปเดตการออกอากาศ แต่จะอัปเดตไม่ได้เมื่อการออกอากาศอยู่ในสถานะtesting
หรือlive
หากคุณตั้งค่าพร็อพเพอร์ตี้นี้เป็นtrue
ทรัพยากรliveStream
ที่ผูกกับการออกอากาศจะระบุ URL การส่งผ่านข้อมูลที่จะใช้สำหรับคำบรรยายของการออกอากาศ -
ตอนนี้พร็อพเพอร์ตี้
snippet.scheduledEndTime
ของทรัพยากรliveBroadcast
รองรับการออกอากาศที่มีกำหนดการที่จะดำเนินการต่ออย่างไม่มีกำหนดแล้ว การเปลี่ยนแปลงนี้ทำให้ไม่จำเป็นต้องใช้พร็อพเพอร์ตี้ในคำขอliveBroadcasts.insert
และliveBroadcasts.update
อีกต่อไป
หากเรียกข้อมูลทรัพยากรliveBroadcast
ที่ไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้นี้ การออกอากาศจะมีกำหนดเวลาดำเนินการต่ออย่างไม่มีกำหนด ในทำนองเดียวกัน หากคุณเรียกใช้เมธอดliveBroadcasts.insert
หรือliveBroadcasts.update
และไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้นี้ ระบบจะกำหนดเวลาการออกอากาศให้ดำเนินต่อไปอย่างไม่มีกำหนด -
พร็อพเพอร์ตี้
contentDetails.recordFromStart
ของทรัพยากรliveBroadcast
ซึ่งมีค่าเริ่มต้นเป็นtrue
อยู่แล้ว สามารถตั้งค่าเป็นfalse
ได้ก็ต่อเมื่อช่องออกอากาศได้รับอนุญาตให้ปิดใช้การบันทึกสำหรับการถ่ายทอดสดหากช่องไม่มีสิทธิ์ปิดใช้การบันทึก และคุณพยายามแทรกการออกอากาศด้วยการตั้งค่าพร็อพเพอร์ตี้
recordFromStart
เป็นfalse
API จะแสดงข้อผิดพลาดForbidden
นอกจากนี้ หากช่องของคุณไม่มีสิทธิ์ดังกล่าวและคุณพยายามอัปเดตการออกอากาศเพื่อตั้งค่าพร็อพเพอร์ตี้recordFromStart
เป็นfalse
API จะแสดงข้อผิดพลาดmodificationNotAllowed
-
ทรัพยากร
liveBroadcast
ไม่มีพร็อพเพอร์ตี้enableArchive
อีกต่อไป ซึ่งมีการกล่าวถึงในคำอธิบายของพร็อพเพอร์ตี้contentDetails.enableDvr
และcontentDetails.enableEmbed
แล้ว -
รายการค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้
status.lifeCycleStatus
ของทรัพยากรliveBroadcast
อัปเดตให้รวมคำอธิบายของแต่ละสถานะ -
พร็อพเพอร์ตี้
settings.walltime
ใหม่ของทรัพยากรliveCuepoint
ระบุวันที่และเวลาที่ควรแทรกจุดเริ่มโฆษณา API จะแสดงข้อผิดพลาดหากคำขอพยายามแทรกจุดเริ่มโฆษณาที่ระบุค่าสำหรับพร็อพเพอร์ตี้นี้และพร็อพเพอร์ตี้settings.offsetTimeMs
-
ออบเจ็กต์
contentDetails
ใหม่ในทรัพยากรliveStream
มีข้อมูลเกี่ยวกับสตรีม ปัจจุบันพร็อพเพอร์ตี้เดียวของออบเจ็กต์คือcontentDetails.closedCaptionsIngestionUrl
ซึ่งระบุ URL การส่งผ่านข้อมูลสำหรับคำบรรยายที่เชื่อมโยงกับสตรีมวิดีโอ -
รายการค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้
status.streamStatus
ของทรัพยากรliveStream
อัปเดตให้รวมคำอธิบายของแต่ละสถานะ -
พารามิเตอร์
walltime
ใหม่ของเมธอดliveBroadcasts.control
ช่วยให้คุณระบุวันที่และเวลาที่จะมีการเปลี่ยนแปลงแถบสเลทได้ API จะแสดงข้อผิดพลาดหากคำขอระบุค่าสำหรับพารามิเตอร์นี้และพารามิเตอร์offsetTimeMs
-
ในการตอบกลับคำขอของ API
liveBroadcasts.list
ค่าของพร็อพเพอร์ตี้kind
ได้เปลี่ยนจากyoutube#liveBroadcastList
เป็นyoutube#liveBroadcastListResponse
-
ในการตอบกลับคำขอของ API
liveStreams.list
ค่าของพร็อพเพอร์ตี้kind
ได้เปลี่ยนจากyoutube#liveStreamList
เป็นyoutube#liveStreamListResponse
-
เลิกใช้งานพร็อพเพอร์ตี้
eventId
จากทั้งliveBroadcastListResponse
และliveStreamListResponse
แล้ว -
API รองรับข้อผิดพลาดใหม่ต่อไปนี้
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย invalidValue
conflictingTimeFields
เมธอด liveBroadcasts.control
จะแสดงผลข้อผิดพลาดนี้หากคำขอของคุณระบุค่าสำหรับพารามิเตอร์offsetTimeMs
และwalltime
คำขอสามารถข้ามพารามิเตอร์ทั้งสองรายการหรือระบุค่าสำหรับพารามิเตอร์ตัวใดตัวหนึ่งจาก 2 ตัวได้invalidValue
invalidWalltime
เมธอด liveBroadcasts.control
จะแสดงผลข้อผิดพลาดนี้ หากค่าของพารามิเตอร์walltime
ไม่ถูกต้องforbidden
enableClosedCaptionsModificationNotAllowed
เมธอด liveBroadcasts.update
จะแสดงข้อผิดพลาดนี้หากคุณพยายามอัปเดตค่าcontentDetails.enableClosedCaptions
และสถานะของการออกอากาศไม่ใช่created
หรือready
invalidValue
conflictingTimeFields
เมธอด liveCuepoints.insert
จะแสดงผลข้อผิดพลาดนี้หากคำขอของคุณระบุค่าสำหรับพร็อพเพอร์ตี้settings.offsetTimeMs
และsettings.walltime
คำขอสามารถข้ามพร็อพเพอร์ตี้ทั้งสองรายการหรือระบุค่าสำหรับพร็อพเพอร์ตี้รายการใดรายการหนึ่งนอกจากนี้ เมธอด
liveStreams.update
จะไม่รองรับข้อผิดพลาดcdnRequired
ที่คล้ายกับข้อผิดพลาดที่เมธอดliveStreams.insert
รองรับอีกต่อไป
10 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
YouTube ไม่ได้ระบุฟีเจอร์และบริการ API แบบทดลองอีกต่อไป แต่ตอนนี้เราจะระบุรายการ YouTube API ที่อยู่ภายใต้นโยบายการเลิกใช้งานแทน
2 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เมธอด
liveBroadcasts.control
ใหม่ช่วยให้คุณสามารถสลับการตั้งค่าการแสดงผลสำหรับแถบสเลทที่แสดงในสตรีมการออกอากาศสำหรับการออกอากาศที่กำลังดำเนินการอยู่ หากสตรีมการออกอากาศล่าช้า คุณยังสามารถใช้วิธีนี้เพื่อระบุการชดเชยเวลาเมื่อมีการเปลี่ยนแปลงแถบสเลทที่ขอ -
คำจำกัดความของพร็อพเพอร์ตี้ต่อไปนี้ได้รับการอัปเดตเพื่ออธิบายว่าต้องตั้งค่าพร็อพเพอร์ตี้หากคุณอัปเดตส่วน
contentDetails
ของทรัพยากรliveBroadcast
-
status.streamStatus
ของทรัพยากรliveStream
ไม่รองรับค่าdeleted
เป็นสถานะสตรีมที่เป็นไปได้อีกต่อไป -
ข้อมูลที่ API แสดงข้อความแสดงข้อผิดพลาดจํานวนมากได้รับการแก้ไขเพื่ออธิบายสาเหตุที่เกิดข้อผิดพลาดบางอย่างได้ดีขึ้น นอกจากนี้ API ยังรองรับข้อผิดพลาดใหม่หลายรายการด้วย
27 มีนาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พร็อพเพอร์ตี้ต่อไปนี้มีการเปลี่ยนแปลงในทรัพยากร
liveBroadcast
- เปลี่ยนชื่อพร็อพเพอร์ตี้
startWithSlateCuepoint
เป็นstartWithSlate
แล้ว - เปลี่ยนชื่อพร็อพเพอร์ตี้
enableArchive
เป็นrecordFromStart
แล้ว - เราเลิกใช้งานออบเจ็กต์
slateSettings
และนำออกจากเอกสารประกอบแล้ว นำข้อความแสดงข้อผิดพลาดที่เกี่ยวข้องกับออบเจ็กต์slateSettings
หรือพร็อพเพอร์ตี้ของออบเจ็กต์ดังกล่าวออกด้วย สุดท้ายเรานำส่วน "การแสดงแถบสเลท" ของคู่มือเริ่มต้นใช้งานออกแล้ว
- เปลี่ยนชื่อพร็อพเพอร์ตี้
-
API ไม่รองรับความสามารถในการแทรกแถบสเลทในสตรีมโดยใช้เมธอด
liveCuepoints.insert
อีกต่อไป เอกสารต่อไปนี้ได้รับการอัปเดตเพื่อแสดงถึงการเปลี่ยนแปลงนี้:-
หน้าดัชนี คู่มือเริ่มต้นใช้งาน และบทแนะนำวงจรชีวิตของการออกอากาศไม่ได้กล่าวถึงฟังก์ชันนี้อีกต่อไป
-
พร็อพเพอร์ตี้
settings.cueType
ของทรัพยากรliveCuepoint
ไม่รองรับslate
เป็นค่าพร็อพเพอร์ตี้อีกต่อไป (ค่าเดียวที่รองรับคือad
-
พร็อพเพอร์ตี้
settings.eventState
ของทรัพยากรliveCuepoint
เลิกใช้งานแล้วและนำออกจากเอกสารประกอบแล้ว
-
18 มีนาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ข้อความแสดงข้อผิดพลาดทั้งหมดของ API ได้รับการอัปเดตให้อธิบายข้อผิดพลาดที่อาจเกิดขึ้นได้ชัดเจนยิ่งขึ้น และเสนอคำแนะนำเกี่ยวกับวิธีแก้ไขหากทำได้
-
ตอนนี้ API อาจแสดงข้อผิดพลาดใหม่หลายรายการ รายการด้านล่างระบุข้อผิดพลาดและเมธอด API ที่อาจแสดงข้อผิดพลาดนั้น
liveBroadcasts.insert
– เวลาสิ้นสุดที่กำหนดไว้ของการออกอากาศต้องอยู่หลังเวลาเริ่มต้นที่กำหนดไว้liveBroadcasts.insert
– การออกอากาศระบุสถานะความเป็นส่วนตัวที่ไม่ถูกต้องliveBroadcasts.update
– ทรัพยากรไม่มีหรือไม่ได้ตั้งค่าสำหรับพร็อพเพอร์ตี้contentDetails.enableArchive
liveBroadcasts.update
– ทรัพยากรไม่มีหรือไม่ได้ตั้งค่าสำหรับพร็อพเพอร์ตี้contentDetails.enableContentEncryption
liveBroadcasts.update
– ทรัพยากรไม่มีหรือไม่ได้ตั้งค่าสำหรับพร็อพเพอร์ตี้contentDetails.enableDvr
liveStreams.insert
– ชื่อตัวอย่างข้อมูลต้องมีความยาวระหว่าง 1 ถึง 128 อักขระliveStreams.update
– ทรัพยากรไม่มีหรือไม่ได้ตั้งค่าสำหรับพร็อพเพอร์ตี้snippet.title
-
เราได้อัปเดตเอกสารประกอบเกี่ยวกับทรัพยากร
liveStream
เพื่อแสดงให้เห็นว่าระบบไม่รองรับวิธีการส่งผ่านข้อมูลแบบมัลติแคสต์และ WebM ตามที่ระบุไว้ก่อนหน้านี้ รายการรูปแบบสำหรับพร็อพเพอร์ตี้cdn.format
ได้รับการอัปเดตแล้ว และออบเจ็กต์cdn.multicastIngestionInfo
และพร็อพเพอร์ตี้ย่อยได้ถูกนำออกจากเอกสารประกอบของทรัพยากรแล้ว นอกจากนี้ ยังมีการนำhttp
ออกจากรายการค่าcdn.ingestionType
ที่รองรับด้วย