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

หน้านี้จะแสดงการเปลี่ยนแปลงของ YouTube Live Streaming 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 ใหม่และพร็อพเพอร์ตี้ย่อยจะมีข้อมูลเกี่ยวกับเหตุการณ์ "ได้รับการเป็นสมาชิกเป็นของขวัญ"

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 หลังจากวันที่ดังกล่าว การเรียกใช้เมธอดนี้จะแสดงข้อผิดพลาด Forbidden (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 ได้รับการอัปเดตโดยมีการเปลี่ยนแปลงบางอย่าง ดังนี้

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

16 เมษายน 2020

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

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

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

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

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

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

    • โดยจะตรวจสอบค่าของพร็อพเพอร์ตี้ liveBroadcast ของisDefaultBroadcastแหล่งข้อมูล และจะไม่มีการส่งคืนพร็อพเพอร์ตี้นี้หลังจากวันที่เลิกใช้งาน
    • ซึ่งจะตรวจสอบค่าของพร็อพเพอร์ตี้ 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 ใหม่ด้วย

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

20 สิงหาคม 2019

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

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

28 มิถุนายน 2019

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

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

4 เมษายน 2019

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

  • เอกสารอ้างอิง API ได้รับการอัปเดตเพื่ออธิบายกรณีการใช้งานทั่วไปของวิธีการแต่ละรายการได้ดียิ่งขึ้น รวมถึงแสดงตัวอย่างโค้ดคุณภาพสูงแบบไดนามิกผ่านวิดเจ็ตเครื่องมือสํารวจ API ดูตัวอย่างได้ในเอกสารประกอบของเมธอด 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 Chat อื่นๆ ข้อความ Super Stickers คือข้อความที่แฟนๆ ซื้อระหว่างสตรีมแบบสดของ YouTube

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

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

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

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

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

12 มกราคม 2017

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

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

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

11 สิงหาคม 2016

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

  • ข้อกำหนดในการให้บริการของบริการ YouTube API ที่เผยแพร่ใหม่ ("ข้อกำหนดที่อัปเดต") ซึ่งมีการอธิบายอย่างละเอียดในบล็อกวิศวกรและนักพัฒนาซอฟต์แวร์ของ 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.format ของทรัพยากร liveStream ตามการเปิดตัวพร็อพเพอร์ตี้ cdn.frameRate และ cdn.resolution ของทรัพยากรดังกล่าว พร็อพเพอร์ตี้ cdn.format ระบุความละเอียดและอัตราเฟรมเป็นค่าเดียว

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

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

    • การอัปเดตทรัพยากร 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 ที่คำขอพยายามแทรก รายการต่อไปนี้ระบุสาเหตุของข้อผิดพลาดและพร็อพเพอร์ตี้ที่เกี่ยวข้อง
      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 สําหรับผู้ใช้ปลายทางในสหภาพยุโรป เราได้เพิ่มประกาศเกี่ยวกับข้อกำหนดนี้ไว้ในข้อกำหนดในการให้บริการของ 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

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

  • ค่าของพร็อพเพอร์ตี้ kind ในคำตอบของ API สำหรับคำขอ liveBroadcasts.list ได้เปลี่ยนจาก 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 ที่รองรับด้วย