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

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

12 มกราคม 2026

ตอนนี้ API รองรับการเปิดใช้โฆษณาตอนกลางและการแทรกโฆษณาตอนกลางอัตโนมัติสำหรับการออกอากาศสดแล้ว

เจ้าของการออกอากาศเลือกเปิดใช้โฆษณาตอนกลางสำหรับการออกอากาศได้ตราบใดที่การออกอากาศนั้น มีสิทธิ์ใช้โฆษณาตอนกลาง นอกจากนี้ เจ้าของยังปิดใช้โฆษณากลางรายการสำหรับการออกอากาศได้ทุกเมื่อ

หากเปิดใช้การออกอากาศสำหรับโฆษณาตอนกลาง เจ้าของการออกอากาศจะเลือกเปิดใช้การแทรกโฆษณาตอนกลางอัตโนมัติได้ นอกจากนี้ ครีเอเตอร์ยังปิดโฆษณาอัตโนมัติสำหรับการออกอากาศได้ทุกเมื่อ

เมื่อเจ้าของการออกอากาศเปิดใช้โฆษณาอัตโนมัติ เจ้าของจะเลือกตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้ได้

• ให้ YouTube เพิ่มประสิทธิภาพการแทรกโฆษณาตอนกลาง ตัวเลือกนี้รองรับ 3 โหมด ได้แก่
• ต่ำ: โอกาสในการสร้างรายได้ต่ำกว่า แต่ขัดจังหวะประสบการณ์การรับชมของผู้ชมน้อยกว่า
• ปานกลาง: มีโอกาสในการสร้างรายได้ปานกลาง และผู้ชมได้รับประสบการณ์การรับชมแบบสมดุล
• สูง: โอกาสในการสร้างรายได้สูงกว่า แต่ขัดจังหวะประสบการณ์การรับชมของผู้ชมมากกว่า
• กำหนดค่ากลยุทธ์และช่วงเวลาสำหรับการแทรกโฆษณาตอนกลางด้วยตนเอง ในกรณีนี้ เจ้าของต้องตั้งค่าพารามิเตอร์ 2 รายการ ได้แก่
1. กลยุทธ์การตั้งเวลาสำหรับเครื่องหมายคิวโฆษณา คุณสามารถแทรกคิวพอยต์พร้อมกันสำหรับผู้ชมทุกคน หรือจะให้เวลาของคิวพอยต์แตกต่างกันไปในแต่ละผู้ชมก็ได้ กลยุทธ์หลัง ช่วยให้ YouTube สามารถกำหนดเวลาเครื่องหมายคิวได้ในอัตราที่เพิ่มขึ้น ซึ่งช่วยให้ผู้ชมได้รับ เครื่องหมายคิวเมื่อมีสิทธิ์
2. ระยะเวลาของช่วงเวลาระหว่างช่วงพักโฆษณาตอนกลาง

เอกสารประกอบจะแสดงการเปลี่ยนแปลง API ต่อไปนี้เพื่อรองรับฟีเจอร์นี้

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

14 กรกฎาคม 2025

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

9 ตุลาคม 2023

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

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 หรือหลังจากนั้น หลังจากวันที่ดังกล่าว การเรียกใช้เมธอดนี้ทั้งหมดจะแสดงข้อผิดพลาดที่ถูกปฏิเสธ (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 การส่งผ่านข้อมูลหลักและสำรอง

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 และนโยบายสำหรับนักพัฒนาซอฟต์แวร์ด้วย โปรดดูข้อมูลเพิ่มเติมที่ข้อกำหนดในการให้บริการของ 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

    นอกจากนี้ liveChatMessageพร็อพเพอร์ตี้ snippet.superChatDetails ใหม่ของทรัพยากรและองค์ประกอบย่อยยังมีข้อมูลเกี่ยวกับกิจกรรม 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 ใหม่ และจะปิดใช้ Fan Funding 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[] จะแสดงปัญหาที่ส่งผลต่อวิดีโอสตรีม เอกสารใหม่ Configuration Issues for LiveStream Resources แสดงปัญหาทั้งหมดที่ 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 ที่รองรับด้วย