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

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

9 กรกฎาคม 2025

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

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

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

1 มิถุนายน 2026

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

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

26 มีนาคม 2026

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

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

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

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

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

15 กันยายน 2021

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

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

    • newSponsorEvent
    • memberMilestoneChatEvent

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

1 ธันวาคม 2020

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

21 กันยายน 2020

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

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

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

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

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

17 กรกฎาคม 2020

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

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

หากโค้ดยังใช้ฟิลด์ cdn.format คุณต้องอัปเดตเพื่อระบุ อัตราเฟรมและความละเอียดแยกกันโดยใช้พร็อพเพอร์ตี้ cdn.frameRate และ cdn.resolution

6 กรกฎาคม 2020

เราได้อัปเดตคู่มือการส่งเนื้อหา YouTube แบบสดผ่าน HLS โดยมีการเปลี่ยนแปลงบางอย่างดังนี้

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

16 เมษายน 2020

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

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

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

  • หมายเหตุ: นี่คือประกาศการเลิกใช้งาน การเปลี่ยนแปลงเหล่านี้จะมีผลตั้งแต่วันที่ 1 กันยายน 2020 เป็นต้นไป วันที่จริงที่การเปลี่ยนแปลงจะมีผลจะเรียกว่าวันที่เลิกใช้งาน ตามที่ระบุไว้ด้านล่าง

    การอัปเดตนี้อธิบายการเปลี่ยนแปลงที่อาจส่งผลกับส่วนอื่นในระบบ การเปลี่ยนแปลงนี้จะส่งผลต่อแอปพลิเคชันไคลเอ็นต์ API ที่ใช้แหล่งข้อมูล liveStream และ liveBroadcast เริ่มต้นของช่องเพื่อสตรีมเนื้อหาแบบสดบน YouTube โดยเฉพาะอย่างยิ่ง รหัสการออกอากาศ และรหัสสตรีมที่เชื่อมโยงกับการออกอากาศและสตรีมแบบถาวร จะไม่สามารถใช้เพื่อเริ่มการออกอากาศใหม่ได้อีกต่อไป

    แอปพลิเคชันของคุณจะได้รับผลกระทบหากเป็นไปตามเงื่อนไขใดๆ ต่อไปนี้

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

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

    ตั้งแต่วันที่เลิกใช้งาน

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

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

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

31 มีนาคม 2020

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

sponsor แหล่งข้อมูลและ sponsors.list วิธีการถูก เลิกใช้งานแล้วและแทนที่ด้วยmember แหล่งข้อมูลและmembers.list วิธีการ

ระบบจะไม่รองรับวิธีการ sponsors.list อีกต่อไปตั้งแต่วันที่ 30 กันยายน 2020 เป็นต้นไป ไคลเอ็นต์ API ควรปรับปรุงการเรียกเมธอด sponsors.list เพื่อใช้เมธอด members.list แทน โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับแหล่งข้อมูลใหม่ได้ที่ ประวัติการแก้ไข YouTube Data API

11 มีนาคม 2020

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

4 กุมภาพันธ์ 2020

เราได้อัปเดตคำแนะนำการส่งเนื้อหา YouTube แบบสดผ่าน HLS เพื่อระบุว่าคำขอ DELETE เป็นตัวเลือก และปลายทาง HLS ของ YouTube จะไม่สนใจคำขอเหล่านั้น YouTube ขอแนะนำให้ไคลเอ็นต์อย่าส่งคำขอ DELETE เพื่อเหตุผลด้านประสิทธิภาพ

10 มกราคม 2020

ตอนนี้ API รองรับความสามารถในการระบุเนื้อหาที่มีเด็กเป็นกลุ่มเป้าหมาย ซึ่ง YouTube เรียกว่า "สร้างมาเพื่อเด็ก" แล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับ เนื้อหาที่ "สร้างมาเพื่อเด็ก" ในศูนย์ช่วยเหลือของ YouTube

  • liveBroadcast แหล่งข้อมูล รองรับพร็อพเพอร์ตี้ใหม่ 2 รายการเพื่อให้ผู้สร้างเนื้อหาและผู้ชมระบุเนื้อหาที่ "สร้างมาเพื่อ เด็ก" ได้
    • selfDeclaredMadeForKids พร็อพเพอร์ตี้ช่วยให้ครีเอเตอร์ระบุได้ว่าการออกอากาศสดเป็นเนื้อหาที่มีเด็กเป็นกลุ่มเป้าหมายหรือไม่ ตั้งค่าพร็อพเพอร์ตี้นี้ได้เมื่อ สร้างการออกอากาศผ่านเมธอด liveBroadcasts.insert โปรดทราบว่าพร็อพเพอร์ตี้นี้จะรวมอยู่ในคำตอบของ API ที่มีliveBroadcastก็ต่อเมื่อเจ้าของช่องอนุญาต คำขอ API
    • พร็อพเพอร์ตี้ madeForKids ช่วยให้ผู้ใช้ API ทุกคนดึงสถานะ "สร้างมาเพื่อเด็ก" ของการออกอากาศได้ ตัวอย่างเช่น สถานะอาจกำหนดตามค่าของพร็อพเพอร์ตี้ selfDeclaredMadeForKids ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดผู้ชมสำหรับช่อง วิดีโอ หรือการออกอากาศได้ที่ ศูนย์ช่วยเหลือของ YouTube
  • ใน YouTube Data API แหล่งข้อมูล channel ยังรองรับพร็อพเพอร์ตี้ selfDeclaredMadeForKids และ madeForKids ใหม่ด้วย

นอกจากนี้ เรายังได้ปรับปรุงข้อกำหนดในการให้บริการของบริการ API ของ YouTube และนโยบายสำหรับนักพัฒนาซอฟต์แวร์ด้วย โปรดดูข้อมูลเพิ่มเติมที่ข้อกำหนดในการให้บริการสำหรับบริการ API ของ YouTube - ประวัติการแก้ไข การเปลี่ยนแปลงข้อกำหนดในการให้บริการของบริการ YouTube API และ นโยบายสำหรับนักพัฒนาซอฟต์แวร์จะมีผลในวันที่ 10 มกราคม 2020 ตามเวลาแปซิฟิก

20 สิงหาคม 2019

ส่วนข้อกำหนดของคำแนะนำการส่งเนื้อหา YouTube แบบสดผ่าน HLS ได้รับการอัปเดตโดยมีการเปลี่ยนแปลง 2 อย่างดังนี้

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

28 มิถุนายน 2019

ตอนนี้ YouTube รองรับการส่งผ่านข้อมูล HLS แล้ว ดังนั้น พร็อพเพอร์ตี้ ingestionType ของทรัพยากร liveStream จึงรองรับค่าใหม่ hls เพื่อระบุสตรีมที่ส่งไปยัง YouTube โดยใช้ HLS

คู่มือการส่งเนื้อหา YouTube แบบสดผ่าน HLS ฉบับใหม่นี้มีหลักเกณฑ์สำหรับการใช้ HLS เพื่อสตรีมเนื้อหาแบบสดไปยัง YouTube จากโปรแกรมเปลี่ยนไฟล์ คู่มือนี้มีจุดมุ่งหมายเพื่อช่วยให้ผู้ให้บริการโปรแกรมเปลี่ยนไฟล์เพิ่มการรองรับการนำส่ง HLS ลงในผลิตภัณฑ์ของตน

4 เมษายน 2019

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

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

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

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

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

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

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

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

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

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

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

5 เมษายน 2018

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

3 เมษายน 2017

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

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, ระยะเวลาการตรึง 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 การปรับปรุงนี้ยังรวมถึงเอกสารประกอบหลายฉบับที่จะช่วยอธิบายนโยบายที่นักพัฒนาแอปต้องปฏิบัติตาม

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

20 พฤษภาคม 2016

ขณะนี้ YouTube รองรับการส่งผ่านข้อมูล DASH แล้ว ดังนั้น พร็อพเพอร์ตี้ ingestionType ของทรัพยากร liveStream จึงรองรับค่าใหม่ dash เพื่อระบุสตรีมที่ส่งไปยัง YouTube โดยใช้ DASH

คู่มือการส่งเนื้อหา YouTube แบบสดผ่าน DASH ใหม่นี้มีหลักเกณฑ์สำหรับการใช้รูปแบบการส่ง DASH เพื่อสตรีมข้อมูลแบบสดบน YouTube จากโปรแกรมเปลี่ยนไฟล์ โดยมีวัตถุประสงค์เพื่อช่วยให้ผู้ให้บริการเข้ารหัสเพิ่มการรองรับการนำส่ง DASH ลงในผลิตภัณฑ์ของตน

18 เมษายน 2016

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

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

    • liveStream การอัปเดตทรัพยากร

      • ตอนนี้ YouTube รองรับไลฟ์สดที่มีความละเอียด 1440p ที่ 30 หรือ 60 เฟรมต่อวินาทีแล้ว

        นอกจากนี้ liveStream ยังมีพร็อพเพอร์ตี้ใหม่สำหรับระบุอัตราเฟรมและความละเอียดของข้อมูลวิดีโอขาเข้าด้วย

        พร็อพเพอร์ตี้
        cdn.frameRate อัตราเฟรมของข้อมูลวิดีโอขาเข้า ค่าที่ใช้ได้คือ 30fps และ 60fps
        cdn.resolution ความละเอียดของข้อมูลวิดีโอขาเข้า ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือ 1440p, 1080p, 720p, 480p, 360p และ 240p

      • ตามการเปิดตัวพร็อพเพอร์ตี้ cdn.frameRate และ cdn.resolution ของทรัพยากร liveStream เราได้เลิกใช้งาน cdn.format ของทรัพยากรแล้ว พร็อพเพอร์ตี้ cdn.format ระบุความละเอียดและอัตราเฟรมในค่าเดียว

        เราขอแนะนำให้คุณเปลี่ยนไปใช้ฟิลด์ที่รองรับใหม่ ในระหว่างนี้ cdn.format จะยังคงทำงานต่อไป นอกจากนี้ คำขอแทรกไลฟ์สดยังคงสำเร็จตราบใดที่คุณระบุค่าสำหรับพร็อพเพอร์ตี้ cdn.format หรือพร็อพเพอร์ตี้ cdn.frameRate และ cdn.resolution หากคุณระบุค่าสำหรับพร็อพเพอร์ตี้ทั้ง 3 รายการ API อาจแสดงข้อผิดพลาดหากค่าไม่ตรงกัน

        โปรดทราบว่าแม้ว่าพร็อพเพอร์ตี้ cdn.format จะเลิกใช้งานแล้ว แต่ตอนนี้พร็อพเพอร์ตี้นี้รองรับค่าใหม่ 2 ค่า ได้แก่ 1440p และ 1440p_hfr เพื่อแสดงการรองรับสตรีม 1440p ของ API ที่ 30 หรือ 60 เฟรมต่อวินาที

    • liveBroadcast การอัปเดตทรัพยากร

      • ทรัพยากร liveBroadcast มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้

        พร็อพเพอร์ตี้
        contentDetails.boundStreamLastUpdateTimeMs วันที่และเวลาที่อัปเดตไลฟ์สดที่อ้างอิงโดยพร็อพเพอร์ตี้ contentDetails.boundStreamId ของการออกอากาศครั้งล่าสุด
        contentDetails.projection รูปแบบการคาดการณ์ของการออกอากาศ ค่าเริ่มต้นของพร็อพเพอร์ตี้คือ rectangular ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้คือ 360 และ rectangular

      • เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้ statistics.totalChatCount ของliveBroadcastทรัพยากรเพื่อระบุว่าค่าพร็อพเพอร์ตี้จะแสดงก็ต่อเมื่อการออกอากาศมีข้อความแชทอย่างน้อย 1 รายการ

    • liveChatMessage การอัปเดตทรัพยากร

      • พร็อพเพอร์ตี้ snippet.type รองรับค่าใหม่ 2 ค่า ได้แก่ messageDeletedEvent และ userBannedEvent ซึ่งสอดคล้องกับพร็อพเพอร์ตี้ใหม่ที่อธิบายไว้ในหัวข้อย่อยต่อไปนี้ นอกจากนี้ เรายังอัปเดตคำจำกัดความของพร็อพเพอร์ตี้ snippet.authorChannelId เพื่ออธิบายว่าค่าพร็อพเพอร์ตี้ระบุอะไรสำหรับข้อความประเภทใหม่เหล่านี้

      • ทรัพยากร liveChatMessage มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้

        พร็อพเพอร์ตี้
        snippet.messageDeletedDetails ออบเจ็กต์นี้มีข้อมูลเกี่ยวกับข้อความที่ผู้ดูแลแชทลบ ออบเจ็กต์จะแสดงก็ต่อเมื่อค่าพร็อพเพอร์ตี้ snippet.type เป็น messageDeletedEvent
        snippet.userBannedDetails ออบเจ็กต์นี้มีข้อมูลเกี่ยวกับผู้ใช้ที่ถูกแบนไม่ให้เข้าร่วมแชท ออบเจ็กต์ยังมีข้อมูลเกี่ยวกับการแบนด้วย เช่น การแบนถาวรหรือชั่วคราว หากเป็นการแบนชั่วคราว พร็อพเพอร์ตี้อย่างใดอย่างหนึ่งของออบเจ็กต์จะระบุระยะเวลาของการแบน

        ออบเจ็กต์นี้จะแสดงก็ต่อเมื่อค่าพร็อพเพอร์ตี้ snippet.type เป็น userBannedEvent เท่านั้น

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

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

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

      เมธอด liveBroadcasts.insert และ liveBroadcasts.update รองรับข้อผิดพลาดเดียวกันอยู่แล้ว
      liveStreams.insert เมธอด liveStreams.insert รองรับข้อผิดพลาดใหม่ 4 รายการ 400 (Bad Request) ที่ระบุค่าพร็อพเพอร์ตี้ที่ไม่ถูกต้องในทรัพยากร liveStream ที่คำขอพยายามแทรก รายการต่อไปนี้ระบุสาเหตุของข้อผิดพลาดและพร็อพเพอร์ตี้ที่เชื่อมโยงกับข้อผิดพลาดเหล่านั้น
      liveStreams.insert เมธอด liveStreams.insert รองรับข้อผิดพลาด 400 (Bad Request) ใหม่ 2 รายการ ซึ่งแต่ละรายการระบุว่าไม่มีค่าที่จำเป็นในทรัพยากร liveStream ที่คำขอพยายามแทรก รายการต่อไปนี้ระบุสาเหตุของข้อผิดพลาดและพร็อพเพอร์ตี้ที่เชื่อมโยงกับข้อผิดพลาดเหล่านั้น
      กล่าวคือ เมื่อแทรกทรัพยากร 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) หากคำขอพยายามแก้ไขค่าของพร็อพเพอร์ตี้ที่ไม่เปลี่ยนแปลงต่อไปนี้ reason ในการตอบกลับที่มีข้อผิดพลาดคือ liveStreamModificationNotAllowed

18 ธันวาคม 2015

กฎหมายของสหภาพยุโรป (EU) กำหนดให้ต้องแสดงการเปิดเผยข้อมูลบางอย่างแก่ผู้ใช้ปลายทางใน EU และต้องได้รับความยินยอมจากผู้ใช้ปลายทางใน EU ดังนั้น คุณต้องปฏิบัติตามนโยบายความยินยอมของผู้ใช้ EU สำหรับผู้ใช้ปลายทางในสหภาพยุโรป เราได้เพิ่มประกาศเกี่ยวกับข้อกำหนดนี้ในข้อกำหนดในการให้บริการของ YouTube API

17 ธันวาคม 2015

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

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

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

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

      เมธอด fanFundingEvents.list ของ API แสดงรายการเหตุการณ์การให้เงินสนับสนุนของช่อง กิจกรรมการให้เงินสนับสนุนของแฟนๆ ที่เริ่มผ่านแชทสดระหว่างการออกอากาศสดของช่องจะทริกเกอร์ข้อความfanFundingEventในแชทสดของการออกอากาศด้วย

      ดูข้อมูลเพิ่มเติมเกี่ยวกับการสนับสนุนจากแฟนๆ ได้ในศูนย์ช่วยเหลือของ YouTube
      sponsors sponsor ทรัพยากรจะระบุสปอนเซอร์ของช่อง YouTube ผู้สนับสนุนจะชำระค่าธรรมเนียมรายเดือนให้กับช่อง ป้ายจะปรากฏข้างข้อความของผู้สนับสนุนในแชทสดของช่อง และผู้สนับสนุนยังเข้าร่วมแชทสดสำหรับผู้สนับสนุนของช่องเท่านั้นได้ด้วย หากมีการจัดแชทสดดังกล่าว

      เมธอด sponsors.list ของ API แสดงรายชื่อสปอนเซอร์ของช่อง เมื่อผู้ใช้ลงชื่อสมัครใช้เพื่อเป็นสปอนเซอร์ให้ช่องในระหว่างการถ่ายทอดสดของช่องนั้น API จะเพิ่มnewSponsorEventข้อความลงในแชทสดของการถ่ายทอดสดด้วย

      ดูข้อมูลเพิ่มเติมเกี่ยวกับการเป็นสปอนเซอร์ได้ในศูนย์ช่วยเหลือของ YouTube

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

    • ทรัพยากร liveBroadcast มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้

      พร็อพเพอร์ตี้
      snippet.liveChatId รหัสสำหรับแชทสดของ YouTube ของการออกอากาศ รหัสนี้ช่วยให้คุณใช้วิธีการของทรัพยากร liveChatMessage เพื่อดึงข้อมูล แทรก หรือลบข้อความแชทได้ นอกจากนี้ คุณยังเพิ่มหรือนำผู้ดูแลแชทออก แบนผู้ใช้ไม่ให้เข้าร่วมแชทสด หรือยกเลิกการแบนที่มีอยู่ได้ด้วย
      contentDetails.closedCaptionsType หมายเหตุ: พร็อพเพอร์ตี้นี้แทนที่พร็อพเพอร์ตี้ contentDetails.enableClosedCaptions

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

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

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

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

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

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

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

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

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

19 สิงหาคม 2015

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

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

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

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

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

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

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

    • ทรัพยากร liveStream มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้

      พร็อพเพอร์ตี้
      snippet.isDefaultStream ระบุว่าสตรีมนี้เป็นสตรีมเริ่มต้นของช่องหรือไม่ สตรีมเริ่มต้นของช่องจะอยู่ตลอดไป ไม่มีเวลาเริ่มต้นหรือเวลาสิ้นสุดที่เชื่อมโยง และลบไม่ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของสตรีมเริ่มต้นได้ที่คำจำกัดความของพร็อพเพอร์ตี้
      status.healthStatus ออบเจ็กต์นี้มีข้อมูลที่ใช้ระบุ วินิจฉัย และแก้ไขปัญหาการสตรีมได้ ออบเจ็กต์นี้มีพร็อพเพอร์ตี้ย่อยหลายรายการที่จะช่วยคุณประเมินสถานะของวิดีโอไลฟ์สด

      โดยเฉพาะอย่างยิ่ง ออบเจ็กต์ status.healthStatus.configurationIssues[] จะแสดงปัญหาที่ส่งผลต่อวิดีโอไลฟ์สด เอกสารใหม่ Configuration Issues for LiveStream Resources แสดงปัญหาทั้งหมดที่ API รายงาน
      contentDetails.isReusable ระบุว่าสตรีมนำกลับมาใช้ซ้ำได้หรือไม่ ซึ่งหมายความว่าสตรีมสามารถเชื่อมโยงกับการออกอากาศหลายรายการได้ โดยทั่วไปแล้ว ผู้แพร่ภาพจะนำสตรีมเดียวกันมาใช้ซ้ำสำหรับการออกอากาศหลายรายการที่แตกต่างกัน หากการออกอากาศเหล่านั้นเกิดขึ้นในเวลาที่ต่างกัน

    • ทรัพยากร liveBroadcast มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้

      พร็อพเพอร์ตี้
      snippet.isDefaultBroadcast ระบุว่าการออกอากาศนี้เป็นการออกอากาศเริ่มต้นของช่องหรือไม่ เมื่อเปิดใช้การไลฟ์สดสำหรับช่อง YouTube แล้ว YouTube จะสร้างไลฟ์สดเริ่มต้นและการออกอากาศเริ่มต้นสำหรับช่อง สตรีมจะกำหนดวิธีที่เจ้าของช่องส่งวิดีโอสดไปยัง YouTube ส่วนการออกอากาศจะกำหนดวิธีที่ผู้ชมสามารถดูสตรีมเริ่มต้นได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของการออกอากาศเริ่มต้นได้ที่คำจำกัดความของพร็อพเพอร์ตี้
      contentDetails.enableLowLatency ระบุว่าควรเข้ารหัสการออกอากาศนี้สำหรับการสตรีมที่มีเวลาในการตอบสนองต่ำหรือไม่ สตรีมที่มีเวลาในการตอบสนองต่ำจะช่วยลดระยะเวลาที่ผู้ใช้จะเห็นวิดีโอขณะรับชมการออกอากาศได้ แต่ก็อาจส่งผลต่อความละเอียดสำหรับผู้ชมสตรีมด้วย
      statistics.totalChatCount จำนวนข้อความแชทสดทั้งหมดที่เชื่อมโยงกับการออกอากาศ พร็อพเพอร์ตี้และค่าของพร็อพเพอร์ตี้จะปรากฏหากผู้ใช้มองเห็นการออกอากาศและเปิดใช้ฟีเจอร์แชทสด โปรดทราบว่าพร็อพเพอร์ตี้นี้จะไม่ระบุค่าหลังจากสิ้นสุดการออกอากาศ ดังนั้น พร็อพเพอร์ตี้นี้จะไม่ระบุจำนวนข้อความแชทสำหรับวิดีโอที่เก็บถาวรของไลฟ์สดที่ออกอากาศจบแล้ว

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

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

      รายละเอียดข้อผิดพลาด
      liveStreams.update
      รหัสการตอบกลับ HTTPforbidden (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

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

2 พฤษภาคม 2013

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

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

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

  • status.streamStatus ของทรัพยากร liveStream ไม่รองรับค่า deleted เป็นสถานะสตรีมที่เป็นไปได้อีกต่อไป

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

27 มีนาคม 2013

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

  • พร็อพเพอร์ตี้ต่อไปนี้มีการเปลี่ยนแปลงในทรัพยากร liveBroadcast

    • เปลี่ยนชื่อพร็อพเพอร์ตี้ startWithSlateCuepoint เป็น startWithSlate แล้ว
    • เปลี่ยนชื่อพร็อพเพอร์ตี้ enableArchive เป็น recordFromStart แล้ว
    • เลิกใช้งานออบเจ็กต์ slateSettings แล้วและนำออกจากเอกสารประกอบ นอกจากนี้ เรายังได้นำข้อความแสดงข้อผิดพลาดที่เกี่ยวข้องกับออบเจ็กต์ slateSettings หรือพร็อพเพอร์ตี้ของออบเจ็กต์ออกด้วย สุดท้ายนี้ เราได้นำส่วน "การแสดงสเลท" ในคู่มือการเริ่มต้นใช้งานออกแล้ว

  • API ไม่รองรับความสามารถในการแทรกสเลตในสตรีมโดยใช้เมธอด liveCuepoints.insert อีกต่อไป เอกสารต่อไปนี้ได้รับการอัปเดตเพื่อแสดงถึงการเปลี่ยนแปลงนี้:

    • หน้าดัชนี คู่มือเริ่มต้นใช้งาน และบทแนะนำวงจรการออกอากาศจะไม่กล่าวถึงฟังก์ชันนี้อีกต่อไป

    • พร็อพเพอร์ตี้ settings.cueType ของทรัพยากร liveCuepoint ไม่รองรับ slate เป็นค่าพร็อพเพอร์ตี้อีกต่อไป (ค่าที่รองรับมีเพียง ad

    • เลิกใช้งานพร็อพเพอร์ตี้ settings.eventState ของทรัพยากร liveCuepoint แล้วและนำออกจากเอกสารประกอบแล้ว

18 มีนาคม 2013

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

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

  • ตอนนี้ API อาจแสดงข้อผิดพลาดใหม่ๆ หลายรายการ รายการด้านล่างระบุข้อผิดพลาดและเมธอด API ที่อาจแสดงข้อผิดพลาดนั้น

    • liveBroadcasts.insert - เวลาสิ้นสุดที่กำหนดเวลาไว้ของการออกอากาศต้องอยู่หลังเวลาเริ่มต้นที่กำหนดเวลาไว้
    • liveBroadcasts.insert - การออกอากาศระบุสถานะความเป็นส่วนตัวที่ไม่ถูกต้อง
    • liveBroadcasts.update - ทรัพยากรไม่มีหรือไม่ได้ตั้งค่าสำหรับพร็อพเพอร์ตี้ contentDetails.enableArchive
    • liveBroadcasts.update - ทรัพยากรไม่มีหรือไม่ได้ตั้งค่าสำหรับพร็อพเพอร์ตี้ contentDetails.enableContentEncryption
    • liveBroadcasts.update - ทรัพยากรไม่มีหรือไม่ได้ตั้งค่าสำหรับพร็อพเพอร์ตี้ contentDetails.enableDvr
    • liveStreams.insert - ชื่อข้อมูลโค้ดต้องมีความยาวระหว่าง 1 ถึง 128 อักขระ
    • liveStreams.update - ทรัพยากรไม่มีหรือไม่ได้ตั้งค่าสำหรับพร็อพเพอร์ตี้ snippet.title

  • liveStreamเอกสารประกอบเกี่ยวกับทรัพยากรได้รับการอัปเดตเพื่อแสดงให้เห็นว่าการส่งผ่านข้อมูลแบบมัลติแคสต์และ WebM ไม่ใช่วิธีการส่งผ่านข้อมูลที่รองรับตามที่ระบุไว้ก่อนหน้านี้ เราได้อัปเดตรายการรูปแบบสำหรับพร็อพเพอร์ตี้ cdn.format ตามนั้นแล้ว และได้นำออบเจ็กต์ cdn.multicastIngestionInfo และพร็อพเพอร์ตี้ย่อยออกจากเอกสารประกอบของทรัพยากร นอกจากนี้ ระบบยังได้นำ http ออกจากรายการค่า cdn.ingestionType ที่รองรับแล้วด้วย