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 ใหม่และพร็อพเพอร์ตี้ย่อยจะมีข้อมูลเกี่ยวกับเหตุการณ์ New Sponsor

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 ซึ่งเลิกใช้งานแล้วในเดือนเมษายน 2016 จะไม่ได้รับการสนับสนุนตั้งแต่วันที่ 17 สิงหาคม 2020 เป็นต้นไป คำขอที่ยังใช้ช่องนั้นอยู่จะดำเนินการไม่สำเร็จนับตั้งแต่วันที่ดังกล่าว

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

    ใบสมัครของคุณจะได้รับผลกระทบในกรณีต่อไปนี้

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

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

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

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

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

    ปัจจุบันตัวอย่างโค้ดได้รับการสนับสนุนสำหรับ Java, JavaScript, PHP, Python และ Curl

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

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

ร่วมกับการเปิดตัวฟีเจอร์ใหม่ Super Chat นั้น YouTube ได้ยกเลิกฟีเจอร์การให้เงินสนับสนุนของแฟนๆ และ 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 ที่ 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 สนับสนุนข้อความหลายประเภท รวมถึง SMS และกิจกรรมการให้เงินสนับสนุนของแฟนๆ ข้อความบางประเภทจะระบุเฟสที่เฉพาะเจาะจงของแชท เช่น การเริ่มต้นของช่วงเวลาสำหรับผู้สนับสนุนเท่านั้นหรือช่วงสิ้นสุดการแชท 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: คุณจะส่งคำบรรยายไปยัง URL การส่งผ่านข้อมูลที่เชื่อมโยงกับสตรีมแบบสดผ่านทาง HTTP POST
      • 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 ช่อง แต่รองรับเพียงช่องเดียว (โมโน) หรือ 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 แก้ไขทรัพยากรให้รวมเฉพาะพร็อพเพอร์ตี้ 1 ใน 2 รายการ แล้วส่งคำขออีกครั้ง

19 สิงหาคม 2015

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

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

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

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

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

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

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

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

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

      โดยเฉพาะอย่างยิ่ง ออบเจ็กต์ status.healthStatus.configurationIssues[] จะแสดงปัญหาที่ส่งผลกระทบต่อสตรีมวิดีโอ เอกสารใหม่ชื่อปัญหาการกำหนดค่าสำหรับทรัพยากร LiveStream จะแสดงปัญหาทั้งหมดที่ 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 Creators

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 คำขอสามารถข้ามพร็อพเพอร์ตี้ทั้งสองรายการหรือระบุค่าสำหรับพร็อพเพอร์ตี้รายการใดรายการหนึ่ง

    นอกจากนี้ เมธอด 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 ที่รองรับด้วย