หน้านี้ได้รับการแปลโดย Cloud Translation API

ข้อมูลอ้างอิงของ API

เอกสารอ้างอิง API นี้อธิบายวิธีตั้งเวลาการถ่ายทอดสดและวิดีโอสตรีมบน YouTube โดยใช้ YouTube Live Streaming API

ประเภททรัพยากร

LiveBroadcasts

liveBroadcast ทรัพยากรแสดงถึงกิจกรรมที่จะสตรีมผ่านวิดีโอสดบน YouTube

ดูข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ได้ที่การแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ	คำขอ HTTP	คำอธิบาย
URI ที่เกี่ยวข้องกับ `https://www.googleapis.com/youtube/v3`
`bind`	`POST /liveBroadcasts/bind`	เชื่อมโยงการออกอากาศบน YouTube กับสตรีม หรือยกเลิกการเชื่อมโยงที่มีอยู่ระหว่างการออกอากาศกับสตรีม การออกอากาศจะเชื่อมโยงกับสตรีมวิดีโอได้เพียง 1 รายการเท่านั้น แต่สตรีมวิดีโออาจเชื่อมโยงกับการออกอากาศได้มากกว่า 1 รายการ
`delete`	`DELETE /liveBroadcasts`	ลบการออกอากาศ
`insert`	`POST /liveBroadcasts`	สร้างการออกอากาศ
`list`	`GET /liveBroadcasts`	แสดงรายการการออกอากาศบน YouTube ที่ตรงกับพารามิเตอร์คำขอ API
`transition`	`POST /liveBroadcasts/transition`	เปลี่ยนสถานะของการถ่ายทอดสดบน YouTube และเริ่มกระบวนการใดๆ ที่เชื่อมโยงกับสถานะใหม่ ตัวอย่างเช่น เมื่อคุณเปลี่ยนสถานะการออกอากาศเป็น `testing` YouTube จะเริ่มส่งวิดีโอไปยังสตรีมการตรวจสอบของการออกอากาศนั้น ก่อนเรียกใช้เมธอดนี้ คุณควรยืนยันว่าค่าของพร็อพเพอร์ตี้ `status.streamStatus` สำหรับสตรีมที่เชื่อมโยงกับการออกอากาศของคุณคือ `active`
`update`	`PUT /liveBroadcasts`	อัปเดตการออกอากาศ เช่น คุณอาจแก้ไขการตั้งค่าการออกอากาศที่กำหนดไว้ในออบเจ็กต์ `contentDetails` ของทรัพยากร `liveBroadcast`
`cuepoint`	`POST /liveBroadcasts/cuepoint`	แทรกคิวพอยต์ลงในการถ่ายทอดสด Cuepoint อาจทริกเกอร์ช่วงพักโฆษณา

LiveChatBans

liveChatBan ทรัพยากรจะระบุผู้ใช้ YouTube และแชทสดบน YouTube ที่ผู้ใช้ถูกแบนไม่ให้เข้าร่วม

วิธีการ	คำขอ HTTP	คำอธิบาย
URI ที่เกี่ยวข้องกับ `https://www.googleapis.com/youtube/v3`
`delete`	`DELETE /liveChat/bans`	ยกเลิกการแบนที่ป้องกันไม่ให้ผู้ใช้บางรายมีส่วนร่วมในแชทสด ซึ่งจะทำให้ผู้ใช้กลับมาเข้าร่วมแชทได้ คำขอ API ต้องได้รับอนุญาตจากเจ้าของช่องหรือผู้ดูแลแชทสดที่เชื่อมโยงกับการแบน
`insert`	`POST /liveChat/bans`	แบนผู้ใช้ที่เฉพาะเจาะจงไม่ให้เข้าร่วมแชทสด คำขอ API ต้องได้รับอนุญาตจากเจ้าของช่องหรือผู้ดูแลแชทสดที่เชื่อมโยงกับการแบน

LiveChatMessages

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

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

วิธีการ	คำขอ HTTP	คำอธิบาย
URI ที่เกี่ยวข้องกับ `https://www.googleapis.com/youtube/v3`
`delete`	`DELETE /liveChat/messages`	ลบข้อความแชท คำขอ API ต้องได้รับอนุญาตจากเจ้าของช่องหรือผู้ดูแลแชทสดที่เชื่อมโยงกับการแบน
`insert`	`POST /liveChat/messages`	เพิ่มข้อความลงในแชทสด
`list`	`GET /liveChat/messages`	แสดงรายการข้อความแชทสดของแชทที่เฉพาะเจาะจง
`streamList`	เปิดใช้การเชื่อมต่อการสตรีมฝั่งเซิร์ฟเวอร์เพื่อรับข้อความแชทสดสำหรับแชทที่เฉพาะเจาะจงโดยมีความหน่วงต่ำ

LiveChatModerators

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

วิธีการ	คำขอ HTTP	คำอธิบาย
URI ที่เกี่ยวข้องกับ `https://www.googleapis.com/youtube/v3`
`delete`	`DELETE /liveChat/moderators`	นำผู้ดูแลแชทออก คำขอต้องได้รับอนุญาตจากเจ้าของช่องที่ออกอากาศสด
`insert`	`POST /liveChat/moderators`	เพิ่มผู้ดูแลใหม่สำหรับแชท คำขอต้องได้รับอนุญาตจากเจ้าของช่องที่ออกอากาศสด
`list`	`GET /liveChat/moderators`	แสดงรายชื่อผู้ดูแลแชทสด คำขอต้องได้รับอนุญาตจากเจ้าของช่องที่ออกอากาศสด

LiveStreams

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

วิธีการ	คำขอ HTTP	คำอธิบาย
URI ที่เกี่ยวข้องกับ `https://www.googleapis.com/youtube/v3`
`delete`	`DELETE /liveStreams`	ลบวิดีโอสตรีม
`insert`	`POST /liveStreams`	สร้างวิดีโอสตรีม สตรีมช่วยให้คุณส่งวิดีโอไปยัง YouTube ซึ่งจะออกอากาศวิดีโอไปยังผู้ชมได้
`list`	`GET /liveStreams`	แสดงรายการวิดีโอสตรีมที่ตรงกับพารามิเตอร์คำขอ API
`update`	`PUT /liveStreams`	อัปเดตสตรีมวิดีโอ หากอัปเดตพร็อพเพอร์ตี้ที่ต้องการเปลี่ยนแปลงไม่ได้ คุณจะต้องสร้างสตรีมใหม่ด้วยการตั้งค่าที่เหมาะสม

SuperChatEvents

superChatEvent ทรัพยากรแสดงข้อความ Super Chat ที่แฟนๆ ซื้อในระหว่างไลฟ์สดบน YouTube ในแชทสดของ YouTube Super Chat จะแตกต่างจากข้อความอื่นๆ ใน 2 ลักษณะดังนี้

Super Chat จะไฮไลต์ด้วยสี
Super Chat จะตรึงอยู่ในทิกเกอร์เป็นระยะเวลาหนึ่ง

สีของ Super Chat, ระยะเวลาการตรึง Super Chat ในทิกเกอร์ และความยาวสูงสุดของข้อความจะขึ้นอยู่กับจำนวนเงินที่ซื้อ ดูข้อมูลเพิ่มเติมเกี่ยวกับ Super Chat ได้ที่ศูนย์ช่วยเหลือของ YouTube

วิธีการ	คำขอ HTTP	คำอธิบาย
URI ที่เกี่ยวข้องกับ `https://www.googleapis.com/youtube/v3`
`list`	`GET /superChatEvents`	แสดงรายการเหตุการณ์ Super Chat จากไลฟ์สดของช่องในช่วง 30 วันที่ผ่านมา