API สตรีมมิงแบบสดของ YouTube - ประวัติการแก้ไข

หน้านี้แสดงการเปลี่ยนแปลงของ YouTube Live Streaming API และการอัปเดตเอกสารประกอบ ติดตามบันทึกการเปลี่ยนแปลงนี้

14 กรกฎาคม 2025

คำอธิบายของเมธอด liveChatMessages.streamList ได้รับการอัปเดตเพื่อให้คำแนะนำเกี่ยวกับการใช้งาน StreamList API

9 ตุลาคม 2023

คุณสามารถดูว่ารหัสสติกเกอร์ใดที่เกี่ยวข้องกับ Super Stickers ใดได้ในไฟล์ CSV นี้เพื่อใช้อ้างอิงเท่านั้น เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้ snippet.superStickerDetails.superStickerMetadata.stickerId ของทรัพยากร liveChatMessage และพร็อพเพอร์ตี้ snippet.superStickerMetadata.stickerId superChatEvent ของทรัพยากร 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

• liveChatMessageพร็อพเพอร์ตี้ snippet.membershipGiftingDetails ใหม่ของทรัพยากรและองค์ประกอบย่อยจะมีข้อมูลเกี่ยวกับกิจกรรมการให้ของขวัญการเป็นสมาชิก ในทำนองเดียวกัน พร็อพเพอร์ตี้ snippet.giftMembershipReceivedDetails ใหม่และพร็อพเพอร์ตี้ย่อยจะมีข้อมูลเกี่ยวกับเหตุการณ์การเป็นสมาชิกแบบของขวัญที่ได้รับ

15 กันยายน 2021

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• ตอนนี้พร็อพเพอร์ตี้ snippet.type รองรับค่าใหม่ 2 ค่าแล้ว

  • newSponsorEvent
  • memberMilestoneChatEvent

• พร็อพเพอร์ตี้ liveChatMessage snippet.memberMilestoneChatDetails ใหม่ของทรัพยากรและรายการย่อยจะมีข้อมูลเกี่ยวกับเหตุการณ์ข้อความแชทสุดพิเศษสำหรับสมาชิก ในทำนองเดียวกัน พร็อพเพอร์ตี้ snippet.newSponsorDetails ใหม่และองค์ประกอบย่อยจะมีข้อมูลเกี่ยวกับกิจกรรม "ผู้สนับสนุนใหม่"

1 ธันวาคม 2020

เมธอด liveBroadcasts.transition ของ API รองรับข้อผิดพลาดใหม่ 403 (Forbidden) ซึ่งบ่งชี้ว่าผู้ใช้ ส่งคำขอมากเกินไปภายในกรอบเวลาที่กำหนด สาเหตุของข้อผิดพลาดคือ userRequestsExceedRateLimit

21 กันยายน 2020

• เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้ status.madeForKids ของทรัพยากร liveBroadcast เพื่อชี้แจงว่าพร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว การดำเนินการนี้ไม่ได้แสดงถึง การเปลี่ยนแปลงฟังก์ชันการทำงานของ API

  หากต้องการระบุว่าการถ่ายทอดสดเป็นประเภทที่เหมาะสมกับเด็ก ให้ตั้งค่าพร็อพเพอร์ตี้ status.selfDeclaredMadeForKids เป็น true เมื่อเรียกใช้เมธอด liveBroadcasts.insert เพื่อสร้างการถ่ายทอดสด

• หมายเหตุ: การเปลี่ยนแปลงนี้รวมถึงประกาศการเลิกใช้งานและการอัปเดต ประกาศการเลิกใช้งานก่อนหน้านี้

  เราจะเลิกใช้งานเมธอด liveBroadcasts.control ตั้งแต่วันที่ 1 ตุลาคม 2020 เป็นต้นไป หลังจากวันที่ดังกล่าว การเรียกใช้เมธอดนี้ทั้งหมดจะแสดงข้อผิดพลาด Forbidden (403) และเราจะนำเมธอดนี้ออกในภายหลัง ลูกค้ายังคงใช้การสเลตของตนเองได้โดยการเพิ่มภาพซ้อนทับลงในวิดีโอที่ส่งไปยัง เซิร์ฟเวอร์การส่งผ่านข้อมูลของ YouTube

  เราได้เลื่อนวันที่เลิกใช้งานประกาศการเลิกใช้งาน ที่ประกาศเมื่อวันที่ 16 เมษายน 2020 ซึ่งเดิมกำหนดไว้เป็นวันที่ 1 กันยายน 2020 ออกไปเป็นตั้งแต่วันที่ 1 ตุลาคม 2020 เป็นต้นไป ดังนั้น ฟีเจอร์ที่รวมอยู่ในการประกาศการเลิกใช้งานนั้นและวิธีการ liveBroadcasts.control จะถูกเลิกใช้งานพร้อมกัน

17 กรกฎาคม 2020

หมายเหตุ: นี่เป็นการอัปเดตประกาศการเลิกใช้งานก่อนหน้านี้

เราจะไม่รองรับฟิลด์ cdn.format ของทรัพยากร liveStream อีกต่อไป ตั้งแต่วันที่ 17 สิงหาคม 2020 เป็นต้นไป ซึ่งเราได้เลิกใช้งานฟิลด์นี้ไปแล้วในเดือนเมษายน 2016 คำขอที่ยังใช้ฟิลด์ดังกล่าวจะล้มเหลวตั้งแต่วันที่ดังกล่าว

หากโค้ดยังใช้ฟิลด์ 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 โดยเฉพาะอย่างยิ่ง รหัสการออกอากาศ และรหัสสตรีมที่เชื่อมโยงกับการออกอากาศ และสตรีมแบบถาวรจะไม่สามารถใช้เพื่อเริ่มการออกอากาศใหม่ได้อีกต่อไป

  การสมัครของคุณจะได้รับผลกระทบหากมีกรณีใดกรณีหนึ่งต่อไปนี้

  • โดยจะตรวจสอบค่าของพร็อพเพอร์ตี้ liveBroadcast isDefaultBroadcast ของทรัพยากร ระบบจะไม่แสดงพร็อพเพอร์ตี้นี้หลังจากวันที่เลิกใช้งาน
  • โดยจะตรวจสอบค่าของพร็อพเพอร์ตี้ liveStream isDefaultStream ของทรัพยากร ระบบจะไม่แสดงพร็อพเพอร์ตี้นี้หลังจากวันที่เลิกใช้งาน
  • โดยจะเรียกใช้เมธอด liveBroadcasts.list และตั้งค่าพารามิเตอร์ broadcastType เป็น persistent หรือ all พารามิเตอร์นี้จะ เลิกใช้งานเป็นส่วนหนึ่งของการเปลี่ยนแปลงเหล่านี้ ตั้งแต่วันที่เลิกใช้งาน
    • หากค่าพารามิเตอร์ broadcastType เป็น persistent เมธอด liveBroadcasts.list จะไม่แสดงผลลัพธ์ใดๆ
    • หากค่าพารามิเตอร์ broadcastType เป็น all วิธีการ liveBroadcasts.list จะไม่แสดงผลการออกอากาศแบบถาวรที่ มีอยู่ก่อนเวลานั้น

  ที่ผ่านมา 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 แทน โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับแหล่งข้อมูลใหม่ได้ใน ประวัติการแก้ไข YouTube Data API

11 มีนาคม 2020

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

นอกจากนี้ เรายังได้ปรับปรุงข้อกำหนดในการให้บริการของบริการ YouTube API และนโยบายสำหรับนักพัฒนาซอฟต์แวร์ด้วย โปรดดูข้อมูลเพิ่มเติมที่ข้อกำหนดในการให้บริการของ API ของ YouTube - ประวัติการแก้ไข การเปลี่ยนแปลงข้อกำหนดในการให้บริการของบริการ 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 เพื่ออธิบายกรณีการใช้งานทั่วไปของแต่ละเมธอดให้ดียิ่งขึ้น และเพื่อจัดหาตัวอย่างโค้ดแบบไดนามิกคุณภาพสูงผ่านวิดเจ็ต API Explorer ดูตัวอย่างได้ในเอกสารประกอบของเมธอด liveBroadcasts.list ตอนนี้หน้าเว็บที่อธิบายเมธอด API มีองค์ประกอบใหม่ 2 อย่าง ดังนี้

  • วิดเจ็ตตัวสำรวจ API ช่วยให้คุณเลือกขอบเขตการให้สิทธิ์ ป้อนค่าพารามิเตอร์และพร็อพเพอร์ตี้ตัวอย่าง จากนั้นส่งคำขอ API จริงและดูการตอบกลับ API จริงได้ วิดเจ็ตยังมีมุมมองแบบเต็มหน้าจอที่แสดงตัวอย่างโค้ดที่สมบูรณ์ ซึ่งจะอัปเดตแบบไดนามิกเพื่อใช้ขอบเขตและค่าที่คุณป้อน

  • ส่วนUse Case ทั่วไปจะอธิบาย Use Case ทั่วไปอย่างน้อย 1 รายการสำหรับเมธอดที่อธิบายไว้ในหน้าเว็บ เช่น คุณเรียกใช้เมธอด liveBroadcasts.list เพื่อดึงข้อมูลเกี่ยวกับการออกอากาศที่เฉพาะเจาะจง หรือดึงข้อมูลเกี่ยวกับการออกอากาศของผู้ใช้ปัจจุบันได้

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

  ปัจจุบันตัวอย่างโค้ดรองรับ Java, JavaScript, PHP, Python และ curl

• หน้าตัวอย่างโค้ดยังมี UI ใหม่ที่มีฟีเจอร์ทั้งหมดเหมือนกับที่อธิบายไว้ข้างต้น เครื่องมือนี้ช่วยให้คุณสำรวจกรณีการใช้งานสำหรับวิธีการต่างๆ โหลดค่าลงใน API Explorer และเปิด API Explorer แบบเต็มหน้าจอเพื่อดูตัวอย่างโค้ดใน Java, JavaScript, PHP และ Python ได้

  การเปลี่ยนแปลงนี้ส่งผลให้ระบบได้นำหน้าเว็บที่แสดงตัวอย่างโค้ดที่พร้อมใช้งานสำหรับ Java, PHP และ Python ออกไปแล้ว

25 กุมภาพันธ์ 2019

เราได้อัปเดตเอกสารประกอบของแหล่งข้อมูล liveChatMessage และ superChatEvent เพื่อให้สอดคล้องกับข้อเท็จจริงที่ว่าตอนนี้แหล่งข้อมูลทั้ง 2 รายการสามารถมีข้อมูลเกี่ยวกับ Super Stickers ได้แล้ว Super Stickers เป็นข้อความ Super Chat ประเภทหนึ่งที่แสดงรูปภาพ ข้อความ Super Stickers จะซื้อโดยแฟนๆ ในระหว่างไลฟ์สดบน YouTube เช่นเดียวกับ Super Chat อื่นๆ

• ในliveChatMessageทรัพยากร ตอนนี้ระบบได้ตั้งค่าพร็อพเพอร์ตี้ snippet.type เป็น superStickerEvent เพื่อระบุว่าทรัพยากรมีข้อมูลเกี่ยวกับ Super Sticker ในกรณีดังกล่าว ทรัพยากรจะมีออบเจ็กต์ snippet.superStickerDetails ซึ่งมีข้อมูลเพิ่มเติมเกี่ยวกับ Super Sticker ด้วย
• ในทรัพยากร superChatEvent บูลีน snippet.isSuperStickerEvent จะระบุว่าข้อความ Super Chat เป็น Super Stickers ด้วยหรือไม่ หากเป็นเช่นนั้น snippet.superStickerMetadata ออบเจ็กต์จะมีรายละเอียดเพิ่มเติมเกี่ยวกับ Super Stickers

5 เมษายน 2018

คำอธิบายของเมธอด superChatEvents.list ได้รับการอัปเดตเพื่อให้สอดคล้องกับข้อเท็จจริงที่ว่าการตอบกลับของ API ไม่มี fanFundingEvents อีกต่อไป ซึ่งเลิกใช้งานไปเมื่อต้นปี 2017

3 เมษายน 2017

เราได้เพิ่มตัวอย่างโค้ด Java ใหม่ที่แสดงวิธีแสดง แทรก และลบข้อความแชทสด ตัวอย่างจะเรียกใช้เมธอดต่อไปนี้

• liveBroadcasts.list
• liveChatMessages.list
• liveChatMessages.insert
• liveChatMessages.delete

13 กุมภาพันธ์ 2017

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

  • เราได้อัปเดตเมธอด liveCuepoints.insert เพื่อให้สอดคล้องกับข้อกำหนดปัจจุบันที่ต้องใช้พารามิเตอร์ onBehalfOfContentOwner นอกจากนี้ เรายังได้อัปเดตคำอธิบายของเมธอดเพื่อระบุว่าการเรียกเมธอดนั้นต้องได้รับอนุญาตจากบัญชีที่เชื่อมโยงกับเจ้าของเนื้อหา YouTube

9 กุมภาพันธ์ 2017

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

  • superChatEvents.list พารามิเตอร์ hl ใหม่ของเมธอดช่วยให้คุณระบุได้ว่าควรจัดรูปแบบค่าพร็อพเพอร์ตี้ snippet.displayString ตามรูปแบบของภาษาใดภาษาหนึ่ง และเราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้นั้นด้วย

    ค่าพารามิเตอร์ต้องเป็นรหัสภาษาที่รวมอยู่ในรายการที่เมธอด i18nLanguages.list แสดงผล ค่าเริ่มต้นคือ en ซึ่งหมายความว่าลักษณะการทำงานเริ่มต้นคือการจัดรูปแบบสตริงที่แสดงตามที่จะใช้ในภาษาอังกฤษ เช่น โดยค่าเริ่มต้น ระบบจะจัดรูปแบบสตริงเป็น $1.00 แทนที่จะเป็น $1,00

1 กุมภาพันธ์ 2017

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• แหล่งข้อมูลและวิธีการใหม่ๆ

  • superChatEvent แหล่งข้อมูลใหม่นี้แสดงข้อความ Super Chat ที่แฟนๆ ซื้อในระหว่างไลฟ์สดบน YouTube ในแชทสดของ YouTube Super Chat จะแตกต่างจากข้อความอื่นๆ ใน 2 ลักษณะดังนี้

    • Super Chat จะไฮไลต์ด้วยสี
    • 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

หมายเหตุ: นี่คือประกาศการเลิกใช้งาน

YouTube ได้เลิกใช้งานฟีเจอร์การให้เงินสนับสนุนของแฟนๆ พร้อมกับเปิดตัวฟีเจอร์ Super Chat ใหม่ และจะปิด 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 ของ API ที่ 30 หรือ 60 เฟรมต่อวินาที

  • 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 รองรับข้อผิดพลาดใหม่ 4 รายการ 400 (Bad Request) ที่ระบุค่าพร็อพเพอร์ตี้ที่ไม่ถูกต้องในทรัพยากร 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 และต้องได้รับความยินยอมจากผู้ใช้ปลายทางใน EU ดังนั้น คุณต้องปฏิบัติตามนโยบายความยินยอมของผู้ใช้ EU สำหรับผู้ใช้ปลายทางในสหภาพยุโรป เราได้เพิ่มประกาศเกี่ยวกับข้อกำหนดนี้ในข้อกำหนดในการให้บริการของ YouTube API

17 ธันวาคม 2015

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• แหล่งข้อมูลและวิธีการใหม่ๆ

  • API รองรับทรัพยากรใหม่หลายรายการเพื่อรองรับฟังก์ชันแชทสำหรับการถ่ายทอดสด YouTube รองรับฟังก์ชันแชทสดระหว่างการถ่ายทอดสดที่ใช้งานอยู่ และแหล่งข้อมูลเหล่านี้รวมถึงวิธีการของแหล่งข้อมูลรองรับการดึงข้อความแชท ตลอดจนฟังก์ชันการดูแลระบบสำหรับแชท

    แหล่งข้อมูล
    liveChatMessage	ทรัพยากรนี้แสดงข้อความในแชทสดของ YouTube YouTube รองรับข้อความหลายประเภท รวมถึงข้อความและกิจกรรมการให้เงินสนับสนุนของแฟนๆ ข้อความบางประเภทจะระบุช่วงใดช่วงหนึ่งของการแชท เช่น ช่วงเริ่มต้นของโหมดเฉพาะสมาชิกหรือช่วงสิ้นสุดของการแชท API รองรับเมธอดในการแสดงรายการ แทรก และลบข้อความแชทสด
    liveChatModerators	ทรัพยากรนี้ระบุผู้ดูแลแชท ผู้ดูแลสามารถใช้ฟังก์ชันการดูแลระบบบางอย่างได้ เช่น แบนผู้ใช้จากแชทหรือนำข้อความออก API รองรับวิธีการแสดงรายการ แทรก และลบผู้ดูแลแชทสด
    liveChatBans	ทรัพยากรนี้ระบุผู้ใช้ที่ถูกแบนไม่ให้โพสต์ข้อความในแชทสดที่เฉพาะเจาะจง การแบนอาจเป็นแบบชั่วคราวหรือถาวรก็ได้ API รองรับวิธีการแทรกและลบการแบนแชทสด
    fanFundingEvents	ทรัพยากรนี้แสดงถึงกิจกรรมการให้เงินสนับสนุนของแฟนๆ ในช่อง YouTube การให้เงินสนับสนุนของแฟนๆ เป็นช่องทางให้ผู้ชมสนับสนุนครีเอเตอร์ YouTube โดยสมัครใจด้วยการสนับสนุนทางการเงินแบบครั้งเดียว เมธอด fanFundingEvents.list ของ API แสดงรายการกิจกรรมการให้เงินสนับสนุนของช่อง กิจกรรมการให้เงินสนับสนุนของแฟนๆ ที่เริ่มผ่านแชทสดระหว่างการออกอากาศสดของช่องจะทริกเกอร์fanFundingEventข้อความไปยังแชทสดของการออกอากาศด้วย ดูข้อมูลเพิ่มเติมเกี่ยวกับการให้เงินสนับสนุนของแฟนๆ ได้ในศูนย์ช่วยเหลือของ YouTube
    sponsors	sponsor ระบุผู้สนับสนุนช่อง YouTube สปอนเซอร์จะชำระค่าธรรมเนียมรายเดือนให้ช่อง ป้ายจะปรากฏข้างข้อความของผู้สนับสนุนในแชทสดของช่อง และผู้สนับสนุนยังเข้าร่วมแชทสดสำหรับผู้สนับสนุนของช่องเท่านั้นได้ด้วย หากมีการจัดขึ้น เมธอด sponsors.list ของ API จะแสดงรายชื่อสปอนเซอร์ของช่อง เมื่อผู้ใช้ลงชื่อสมัครใช้เพื่อเป็นสปอนเซอร์ให้ช่องในระหว่างการถ่ายทอดสดของช่องนั้น API จะเพิ่มข้อความnewSponsorEventลงในแชทสดของการถ่ายทอดสดด้วย ดูข้อมูลเพิ่มเติมเกี่ยวกับการเป็นสปอนเซอร์ได้ในศูนย์ช่วยเหลือของ YouTube

• การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

  • แหล่งข้อมูล liveBroadcast มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้

    พร็อพเพอร์ตี้
    snippet.liveChatId	รหัสสำหรับแชทสดบน YouTube ของการออกอากาศ รหัสนี้ช่วยให้คุณใช้วิธีการของทรัพยากร liveChatMessage เพื่อดึงข้อมูล แทรก หรือลบข้อความแชทได้ นอกจากนี้ คุณยังเพิ่มหรือนำผู้ดูแลแชทออก แบนผู้ใช้ไม่ให้เข้าร่วมแชทสด หรือยกเลิกการแบนที่มีอยู่ได้ด้วย
    contentDetails.closedCaptionsType	หมายเหตุ: พร็อพเพอร์ตี้นี้แทนที่พร็อพเพอร์ตี้ contentDetails.enableClosedCaptions พร็อพเพอร์ตี้นี้จะระบุว่ามีการเปิดใช้คำบรรยายแทนเสียงสำหรับการออกอากาศหรือไม่ และหากเปิดใช้ คุณจะระบุคำบรรยายแทนเสียงประเภทใด closedCaptionsDisabled: ระบบปิดใช้คำบรรยายแทนเสียงสำหรับการถ่ายทอดสด closedCaptionsHttpPost: คุณจะส่งคำบรรยายแทนเสียงผ่าน HTTP POST ไปยังURL การส่งผ่านข้อมูลที่เชื่อมโยงกับไลฟ์สด closedCaptionsEmbedded: ระบบจะเข้ารหัสคำบรรยายแทนเสียงในสตรีมวิดีโอโดยใช้รูปแบบ EIA-608 และ/หรือ CEA-708
    contentDetails.enableClosedCaptions	เราเลิกใช้งานพร็อพเพอร์ตี้นี้แล้วตั้งแต่วันที่ 17 ธันวาคม 2015 ให้ใช้พร็อพเพอร์ตี้ contentDetails.closedCaptionsType แทน สำหรับไคลเอ็นต์ API ที่ใช้พร็อพเพอร์ตี้นี้อยู่แล้ว การตั้งค่าพร็อพเพอร์ตี้เป็น true จะเหมือนกับการตั้งค่าพร็อพเพอร์ตี้ contentDetails.closedCaptionsType เป็น closedCaptionsHttpPost การตั้งค่าพร็อพเพอร์ตี้เป็น false จะเหมือนกับการตั้งค่าพร็อพเพอร์ตี้ contentDetails.closedCaptionsType เป็น closedCaptionsDisabled

  • liveBroadcasts.list พารามิเตอร์ broadcastType ใหม่ของเมธอดช่วยให้คุณกรองการตอบกลับของ API เพื่อรวมการออกอากาศกิจกรรม การออกอากาศแบบต่อเนื่อง หรือการออกอากาศทั้งหมดได้

    การออกอากาศแบบถาวรคือการออกอากาศที่เกิดขึ้นเสมอและไม่ได้เชื่อมโยงกับเหตุการณ์ใดเหตุการณ์หนึ่ง โดยเฉพาะอย่างยิ่ง การออกอากาศเริ่มต้นของช่องคือการออกอากาศแบบต่อเนื่อง และเข้าถึงได้ผ่านแดชบอร์ดการถ่ายทอดสดใน YouTube Creator Studio การออกอากาศอื่นๆ ของช่องเป็นการออกอากาศกิจกรรม

• ฟิลด์ status.healthStatus.configurationIssues[].type ของliveStreamทรัพยากรจะรายงานข้อผิดพลาดเกี่ยวกับสถานะความสมบูรณ์ใหม่ต่อไปนี้

  ข้อผิดพลาด
  audioTooManyChannels	เสียงมีช่องมากกว่า 2 ช่อง รองรับเฉพาะเสียงแบบ 1 (โมโน) หรือ 2 (สเตอริโอ) ช่องเท่านั้น โปรดระบุจำนวนช่องสัญญาณเสียงให้ถูกต้อง
  frameRateHigh	อัตราเฟรมปัจจุบันสูงเกินไป โปรดตั้งค่าอัตราเฟรมเป็น %(framerate)s FPS หรือน้อยกว่า

• แก้ไขวันที่เผยแพร่การอัปเดตเอกสารประกอบครั้งก่อน

• ข้อผิดพลาดใหม่และที่อัปเดต

  • นอกเหนือจากข้อผิดพลาดที่กำหนดไว้สำหรับแหล่งข้อมูลใหม่ที่ระบุไว้ข้างต้นแล้ว API ยังรองรับข้อผิดพลาดใหม่ต่อไปนี้ด้วย

    รายละเอียดข้อผิดพลาด
    liveBroadcasts.update	รหัสการตอบกลับ HTTP forbidden (403) เหตุผล closedCaptionsTypeModificationNotAllowed คำอธิบาย จะแก้ไขค่า contentDetails.closedCaptionsType ได้เมื่อการออกอากาศอยู่ในสถานะcreatedหรือreadyเท่านั้น
    liveBroadcasts.update	รหัสการตอบกลับ HTTP invalidValue (400) เหตุผล invalidEnableClosedCaptions คำอธิบาย ในทรัพยากร liveBroadcast ค่าของพร็อพเพอร์ตี้ contentDetails.enableClosedCaptions ไม่เข้ากันกับค่าของการตั้งค่า contentDetails.closedCaptionType แก้ไขทรัพยากรให้มีพร็อพเพอร์ตี้เพียงรายการเดียวจาก 2 รายการ แล้วส่งคำขออีกครั้ง

19 สิงหาคม 2015

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• แหล่งข้อมูลและวิธีการใหม่ๆ

  • หมายเหตุ: เอกสารประกอบสำหรับทรัพยากร liveChat และวิธีการของทรัพยากรดังกล่าวเป็นความลับและจะแสดงต่อพาร์ทเนอร์ YouTube บางรายเท่านั้น

    liveChat ทรัพยากรใหม่นี้มีข้อความที่โพสต์ระหว่างการออกอากาศสดบน YouTube API รองรับ 2 วิธีสำหรับทรัพยากรนี้

    เมธอด
    liveChats.list	แสดงรายการข้อความแชทสดสำหรับการออกอากาศ
    liveChats.insert	สร้างข้อความแชทใหม่

    คุณจะดึงและโพสต์ข้อความแชทสดได้ในขณะที่การออกอากาศกำลังดำเนินอยู่เท่านั้น

• การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

  • แหล่งข้อมูล liveStream มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้

    พร็อพเพอร์ตี้
    snippet.isDefaultStream	ระบุว่าสตรีมนี้เป็นสตรีมเริ่มต้นของช่องหรือไม่ สตรีมเริ่มต้นของช่องจะอยู่ตลอดไป ไม่มีเวลาเริ่มต้นหรือสิ้นสุดที่เชื่อมโยง และลบไม่ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของสตรีมเริ่มต้นได้ที่คำจำกัดความของพร็อพเพอร์ตี้
    status.healthStatus	ออบเจ็กต์นี้มีข้อมูลที่ใช้ระบุ วินิจฉัย และแก้ไขปัญหาการสตรีมได้ ออบเจ็กต์นี้มีพร็อพเพอร์ตี้ย่อยหลายรายการที่จะช่วยให้คุณประเมินสถานะของไลฟ์วิดีโอสตรีมได้ โดยเฉพาะอย่างยิ่ง ออบเจ็กต์ status.healthStatus.configurationIssues[] จะแสดงปัญหาที่ส่งผลต่อวิดีโอสตรีม เอกสารใหม่ชื่อปัญหาการกำหนดค่าสำหรับทรัพยากรการถ่ายทอดสดแสดงปัญหาทั้งหมดที่ 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 ที่ 60fps YouTube จะทำให้ไลฟ์สดพร้อมใช้งานที่ 30fps บนอุปกรณ์ที่ยังไม่พร้อมใช้งานการดูที่อัตราเฟรมสูง

  พร็อพเพอร์ตี้ cdn.format ของทรัพยากร liveStream รองรับค่าใหม่ 2 ค่าสำหรับฟีเจอร์นี้ ได้แก่ 720p_hfr และ 1080p_hfr

  ดูข้อมูลเพิ่มเติมเกี่ยวกับฟีเจอร์นี้ได้ที่บล็อกของครีเอเตอร์ YouTube

21 สิงหาคม 2014

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• คำจำกัดความของพารามิเตอร์ walltime ของเมธอด liveBroadcasts.control ได้รับการอัปเดตเพื่อระบุว่าค่าพร็อพเพอร์ตี้ระบุไว้ในรูปแบบ ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ)

• ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว

  ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
  insufficientPermissions	liveStreamingNotEnabled	เมธอดทั้งหมดสำหรับทรัพยากร liveBroadcast และ liveStream จะแสดงข้อผิดพลาดนี้หากผู้ใช้ที่ให้สิทธิ์คำขอ API ไม่ได้เปิดใช้สิทธิ์ในการสตรีมวิดีโอสดบน YouTube รายละเอียดที่อธิบายสาเหตุที่ผู้ใช้สตรีมวิดีโอสดไม่ได้อาจอยู่ในส่วนการตั้งค่าช่องของผู้ใช้ที่ https://www.youtube.com/features
  rateLimitExceeded	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 คำขอจะละเว้นทั้ง 2 พร็อพเพอร์ตี้หรือระบุค่าสำหรับพร็อพเพอร์ตี้ใดพร็อพเพอร์ตี้หนึ่งก็ได้

  นอกจากนี้ เมธอด liveStreams.update ยังไม่รองรับข้อผิดพลาด cdnRequired ที่คล้ายกับที่เมธอด liveStreams.insert รองรับอีกด้วย

10 พฤษภาคม 2013

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• YouTube จะไม่ระบุฟีเจอร์และบริการ API ที่เป็นเวอร์ชันทดลองอีกต่อไป ตอนนี้เราจึงมีรายการ API ของ YouTube ที่อยู่ภายใต้นโยบายการเลิกใช้งานแทน

2 พฤษภาคม 2013

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• liveBroadcasts.control วิธีใหม่นี้ช่วยให้คุณสลับการตั้งค่าการแสดงผลสำหรับสเลทที่แสดงในสตรีมการออกอากาศสำหรับการออกอากาศที่กำลังดำเนินอยู่ได้ หากสตรีมการออกอากาศล่าช้า คุณยังใช้วิธีนี้เพื่อระบุออฟเซ็ตเวลาเมื่อจะมีการเปลี่ยนแปลงสเลทที่ขอได้ด้วย

• เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้ต่อไปนี้เพื่ออธิบายว่าต้องตั้งค่าพร็อพเพอร์ตี้หากคุณอัปเดตส่วน contentDetails ของทรัพยากร liveBroadcast

  • contentDetails.monitorStream.enableMonitorStream
  • contentDetails.monitorStream.broadcastStreamDelayMs
  • contentDetails.enableDvr
  • contentDetails.enableContentEncryption
  • contentDetails.enableEmbed
  • contentDetails.recordFromStart
  • contentDetails.startWithSlate

• 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 ที่รองรับด้วย