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

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

12 ตุลาคม 2569

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

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

18 สิงหาคม 2569

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

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

17 สิงหาคม 2026

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

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

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 ต่อไปนี้เพื่อรองรับฟีเจอร์นี้

• ออบเจ็กต์ monetizationDetails ของทรัพยากร liveBroadcast มีช่องสำหรับการเปิดใช้โฆษณาตอนกลางและการกำหนดค่าโฆษณาอัตโนมัติ
• คุณสามารถใช้เมธอด 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

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

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

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

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

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

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

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

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

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

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

• ในทรัพยากร liveChatMessage ตอนนี้พร็อพเพอร์ตี้ snippet.type ได้รับการตั้งค่าเป็น superStickerEvent เพื่อระบุว่าทรัพยากรมีข้อมูลเกี่ยวกับ Super Stickers ในกรณีนี้ ทรัพยากรจะมีออบเจ็กต์ snippet.superStickerDetails ด้วย ซึ่งมีข้อมูลเพิ่มเติมเกี่ยวกับ Super 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

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

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

  • พารามิเตอร์ 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

    นอกจากนี้ พร็อพเพอร์ตี้ snippet.superChatDetails ใหม่ของทรัพยากร liveChatMessage และพร็อพเพอร์ตี้ย่อยยังมีข้อมูลเกี่ยวกับกิจกรรม Super Chat ด้วย

  • พร็อพเพอร์ตี้ cdn.resolution ของทรัพยากร liveStream รองรับค่า 2160p แล้ว

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

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

    รายละเอียดข้อผิดพลาด
    liveBroadcasts.insert, liveBroadcasts.update	เมธอด liveBroadcasts.insert และ liveBroadcasts.update จะแสดงข้อผิดพลาด 400 (Bad Request) เพื่อระบุว่าทรัพยากร liveBroadcast ที่แทรกหรืออัปเดตมีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้ contentDetails.enableEmbed หรือพร็อพเพอร์ตี้ contentDetails.projection สาเหตุของข้อผิดพลาดใหม่ 2 รายการคือ invalidEmbedSetting และ invalidProjection ตามลำดับ

12 มกราคม 2017

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

YouTube ได้เลิกใช้งานฟีเจอร์การให้เงินสนับสนุนของแฟนๆ ร่วมกับการเปิดตัวฟีเจอร์ Super Chat ใหม่ และจะปิดใช้ Fan Funding API ในวันที่ 28 กุมภาพันธ์ 2017 สิ่งที่จะเกิดขึ้นตั้งแต่วันที่ดังกล่าว

• เมธอด liveChatMessages.list จะไม่แสดงผลข้อความที่มี snippet.type เป็น fanFundingEvent อีกต่อไป ในทำนองเดียวกัน ทรัพยากร liveChatMessage จะไม่มีออบเจ็กต์ snippet.fanFundingEventDetails อีกต่อไป
• เมธอด fanFundingEvents.list จะไม่แสดงข้อมูลอีกต่อไป

11 สิงหาคม 2016

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

• ข้อกำหนดในการให้บริการของบริการ API ของ YouTube ที่เผยแพร่ใหม่ ("ข้อกำหนดที่ปรับปรุงแล้ว") ซึ่งมีการพูดถึงอย่างละเอียดในบล็อกด้านวิศวกรรมและนักพัฒนาซอฟต์แวร์ของ YouTube มีการปรับปรุงข้อกำหนดในการให้บริการปัจจุบันหลายรายการ นอกเหนือจากข้อกำหนดฉบับปรับปรุงซึ่งจะมีผลบังคับใช้ตั้งแต่วันที่ 10 กุมภาพันธ์ 2017 แล้ว การปรับปรุงครั้งนี้ยังมีเอกสารสนับสนุนหลายฉบับเพื่อช่วยอธิบายถึงนโยบายที่นักพัฒนาแอปต้องปฏิบัติตาม

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

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 เราได้เพิ่มประกาศเกี่ยวกับข้อกำหนดนี้ในข้อกำหนดในการให้บริการ API ของ YouTube

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

  • พารามิเตอร์ 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 ที่ 60 FPS แล้ว YouTube จะทำให้ไลฟ์สดพร้อมใช้งานที่ 30 FPS บนอุปกรณ์ที่ยังไม่รองรับการรับชมที่อัตราเฟรมสูงด้วย

  พร็อพเพอร์ตี้ 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 ที่รองรับด้วย