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

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

12 ตุลาคม 2026

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

• เราได้แก้ไขพร็อพเพอร์ตี้ snippet.giftEventDetails ของทรัพยากร liveChatMessage เป็น snippet.giftDetails เพื่อให้แสดงถึงการตอบกลับจาก API ได้อย่างถูกต้อง

18 สิงหาคม 2569

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

• เราได้อัปเดตเอกสารประกอบสำหรับเมธอด liveBroadcasts.update เพื่อรวมข้อผิดพลาดใหม่ที่เกี่ยวข้องกับการสร้างรายได้ ได้แก่ preconditionFailed (412) (เหตุผล: videoNotEligibleForAdsMonetization) และ backendError (503) (เหตุผล: backendError)

17 สิงหาคม 2026

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

• พร็อพเพอร์ตี้ใหม่ของliveBroadcastแหล่งข้อมูลsnippet.categoryIdช่วยให้คุณตั้งค่า อัปเดต และดึงข้อมูลหมวดหมู่ของวิดีโอที่เชื่อมโยงกับการถ่ายทอดสดได้

20 กรกฎาคม 2026

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

• ตอนนี้คุณตั้งค่าพร็อพเพอร์ตี้ monetizationDetails.cuepointSchedule.pauseAdsUntil เป็นวันที่และเวลาในอดีตหรือค่าว่างเพื่อยกเลิกการหยุดโฆษณาชั่วคราวได้แล้ว

9 กรกฎาคม 2569

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

• ตอนนี้เอกสารประกอบสำหรับ liveChatBans.insert ระบุว่าพร็อพเพอร์ตี้ snippet.type ต้องเป็น permanent หรือ temporary

  เอกสารประกอบสำหรับ liveChatMessage.insert แสดงให้เห็นอย่างถูกต้องว่า questionText เป็นพร็อพเพอร์ตี้โดยตรงของ metadata และ options เป็นอาร์เรย์ของออบเจ็กต์ ซึ่งแต่ละออบเจ็กต์มีช่อง optionText

1 มิถุนายน 2026

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

• พร็อพเพอร์ตี้ contentDetails.availabilityConfig ของทรัพยากร liveBroadcast ช่วยให้คุณระบุข้อจำกัดทางภูมิศาสตร์สำหรับการถ่ายทอดสด เพื่อให้คุณจัดการความพร้อมให้บริการระดับภูมิภาคสำหรับงานกิจกรรมได้

26 มีนาคม 2026

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

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

• พร็อพเพอร์ตี้ snippet.giftEventDetails ใหม่ของทรัพยากร liveChatMessage และพร็อพเพอร์ตี้ย่อยมีข้อมูลเกี่ยวกับกิจกรรมของขวัญ

12 มกราคม 2026

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

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

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

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

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

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

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

14 กรกฎาคม 2025

คำอธิบายของเมธอด liveChatMessages.streamList ได้รับการอัปเดตเพื่อให้คำแนะนำเกี่ยวกับการใช้งาน streamList 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 ใหม่และพร็อพเพอร์ตี้ย่อยจะมีข้อมูลเกี่ยวกับเหตุการณ์ Gift Membership Received

15 กันยายน 2021

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

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

  • newSponsorEvent
  • memberMilestoneChatEvent

• พร็อพเพอร์ตี้ snippet.memberMilestoneChatDetails ใหม่ของทรัพยากร liveChatMessage และพร็อพเพอร์ตี้ย่อยมีข้อมูลเกี่ยวกับเหตุการณ์ข้อความแชทสุดพิเศษสำหรับสมาชิก ในทำนองเดียวกัน พร็อพเพอร์ตี้ 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 จาก API ของ YouTube หรือ YouTube Creator Studio

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

16 เมษายน 2020

การอัปเดตนี้รวมถึงพร็อพเพอร์ตี้ใหม่และประกาศการเลิกใช้งานดังนี้

• ขณะนี้ทรัพยากร liveBroadcast รองรับพร็อพเพอร์ตี้ contentDetails.enableAutoStop แล้ว พร็อพเพอร์ตี้นี้ระบุว่าการออกอากาศควรหยุดโดยอัตโนมัติประมาณ 1 นาทีหลังจากที่เจ้าของช่องหยุดสตรีมวิดีโอในสตรีมวิดีโอที่เชื่อมโยงหรือไม่

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

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

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

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

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

• หน้าตัวอย่างโค้ดยังมี UI ใหม่ที่มีฟีเจอร์ทั้งหมดเหมือนกับที่อธิบายไว้ข้างต้น คุณสามารถใช้เครื่องมือดังกล่าวเพื่อสำรวจ Use Case สำหรับวิธีการต่างๆ, โหลดค่าลงในโปรแกรมสำรวจ API และเปิดโปรแกรมสำรวจ API แบบเต็มหน้าจอเพื่อดูตัวอย่างโค้ดใน 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 Stickers ในกรณีดังกล่าว ทรัพยากรจะมีออบเจ็กต์ snippet.superStickerDetails ซึ่งมีข้อมูลเพิ่มเติมเกี่ยวกับ Super Stickers ด้วย
• ในทรัพยากร superChatEvent บูลีน snippet.isSuperStickerEvent จะระบุว่าข้อความ Super Chat เป็น Super Stickers ด้วยหรือไม่ หากเป็นเช่นนั้น snippet.superStickerMetadata ออบเจ็กต์จะมีรายละเอียดเพิ่มเติมเกี่ยวกับ Super Sticker

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

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

• การอัปเดตทรัพยากรและเมธอดที่มีอยู่

  • พารามิเตอร์ hl ใหม่ของเมธอด superChatEvents.list ช่วยให้คุณระบุได้ว่าค่าพร็อพเพอร์ตี้ 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, ระยะเวลาที่ปักหมุดไว้ในแถบแสดงข้อความ และความยาวสูงสุดของข้อความจะขึ้นอยู่กับยอดรวมการซื้อ ศูนย์ช่วยเหลือของ YouTube มีข้อมูลเพิ่มเติมเกี่ยวกับ Super Chat

    API รองรับวิธีการแสดงเหตุการณ์ Super Chat สำหรับไลฟ์สดของช่องในช่วง 30 วันที่ผ่านมา นอกจากนี้ เมธอดดังกล่าวยังแสดงข้อมูลเกี่ยวกับกิจกรรมการให้เงินสนับสนุนของแฟนๆ (fanFundingEvents) จากไลฟ์สดล่าสุดของช่องด้วย

• การอัปเดตทรัพยากรและเมธอดที่มีอยู่

  • ตอนนี้พร็อพเพอร์ตี้ snippet.type รองรับค่า superChatEvent ซึ่งระบุว่าทรัพยากรอธิบาย Super Chat

    นอกจากนี้ พร็อพเพอร์ตี้ใหม่ของliveChatMessagesnippet.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 เพื่อแสดงให้เห็นว่า API รองรับสตรีม 1440p ที่ 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 รองรับข้อผิดพลาด 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 และต้องได้รับความยินยอมจากผู้ใช้ปลายทางเหล่านั้น ดังนั้น สำหรับผู้ใช้ปลายทางในสหภาพยุโรป คุณต้องปฏิบัติตามนโยบายความยินยอมของผู้ใช้ 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 Live ของการออกอากาศ เมื่อมีรหัสนี้ คุณจะใช้เมธอดของทรัพยากร 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

  • พารามิเตอร์ broadcastType ใหม่ของเมธอด liveBroadcasts.list ช่วยให้คุณกรองการตอบกลับจาก 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 ที่รองรับด้วย