Tài liệu tham khảo API

Tài liệu tham khảo về API này giải thích cách lên lịch phát sóng trực tiếp và phát video trực tuyến trên YouTube bằng YouTube Live Streaming API.

Loại tài nguyên

LiveBroadcasts

Tài nguyên liveBroadcast đại diện cho một sự kiện sẽ được phát trực tiếp trên YouTube.

Để biết thêm thông tin về tài nguyên này, hãy xem phần biểu thị tài nguyên và danh sách thuộc tính của tài nguyên.

Phương thức Yêu cầu HTTP Mô tả
URI liên quan đến https://www.googleapis.com/youtube/v3
bind POST /liveBroadcasts/bind Liên kết một chương trình phát sóng trên YouTube với một luồng phát hoặc xoá mối liên kết hiện có giữa một chương trình phát sóng và một luồng phát. Một chương trình phát sóng chỉ có thể được liên kết với một luồng video, mặc dù một luồng video có thể được liên kết với nhiều chương trình phát sóng.
delete DELETE /liveBroadcasts Xoá một bản phát sóng.
insert POST /liveBroadcasts Tạo một chương trình phát sóng.
list GET /liveBroadcasts Trả về danh sách các chương trình phát sóng trên YouTube phù hợp với các tham số yêu cầu API.
transition POST /liveBroadcasts/transition Thay đổi trạng thái của một chương trình phát sóng trực tiếp trên YouTube và bắt đầu mọi quy trình liên quan đến trạng thái mới. Ví dụ: khi bạn chuyển trạng thái của một chương trình phát sóng sang testing, YouTube sẽ bắt đầu truyền video đến luồng giám sát của chương trình phát sóng đó. Trước khi gọi phương thức này, bạn nên xác nhận rằng giá trị của thuộc tính status.streamStatus cho luồng được liên kết với chương trình phát sóng của bạn là active.
update PUT /liveBroadcasts Cập nhật một chương trình phát sóng. Ví dụ: bạn có thể sửa đổi các chế độ cài đặt truyền tin được xác định trong đối tượng contentDetails của tài nguyên liveBroadcast.
cuepoint POST /liveBroadcasts/cuepoint Chèn điểm đánh dấu vào một chương trình phát sóng trực tiếp. Điểm đánh dấu có thể kích hoạt một điểm chèn quảng cáo.

LiveChatBans

Tài nguyên liveChatBan xác định một người dùng YouTube và một cuộc trò chuyện trực tiếp trên YouTube mà người dùng đó bị cấm tham gia.

Để biết thêm thông tin về tài nguyên này, hãy xem phần biểu thị tài nguyên và danh sách thuộc tính của tài nguyên.

Phương thức Yêu cầu HTTP Mô tả
URI liên quan đến https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/bans Xoá lệnh cấm ngăn một người dùng cụ thể tham gia cuộc trò chuyện trực tiếp, nhờ đó cho phép người dùng đó tham gia lại cuộc trò chuyện. Chủ sở hữu kênh hoặc người kiểm duyệt của cuộc trò chuyện trực tiếp liên quan đến lệnh cấm phải uỷ quyền cho yêu cầu API.
insert POST /liveChat/bans Cấm một người dùng cụ thể tham gia cuộc trò chuyện trực tiếp. Chủ sở hữu kênh hoặc người kiểm duyệt của cuộc trò chuyện trực tiếp liên quan đến lệnh cấm phải uỷ quyền cho yêu cầu API.

LiveChatMessages

Tài nguyên liveChatMessage đại diện cho một tin nhắn trò chuyện trong cuộc trò chuyện trực tiếp trên YouTube. Tài nguyên này có thể chứa thông tin chi tiết về nhiều loại tin nhắn, bao gồm cả tin nhắn văn bản mới đăng hoặc sự kiện ủng hộ của người hâm mộ.

Tính năng trò chuyện trực tiếp được bật theo mặc định cho các chương trình phát sóng trực tiếp và hoạt động trong khi sự kiện trực tiếp đang diễn ra. (Sau khi sự kiện kết thúc, tính năng trò chuyện trực tiếp sẽ không còn hoạt động đối với sự kiện đó.)

Để biết thêm thông tin về tài nguyên này, hãy xem phần biểu thị tài nguyên và danh sách thuộc tính của tài nguyên.

Phương thức Yêu cầu HTTP Mô tả
URI liên quan đến https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/messages Xoá một tin nhắn trò chuyện. Chủ sở hữu kênh hoặc người kiểm duyệt của cuộc trò chuyện trực tiếp liên quan đến lệnh cấm phải uỷ quyền cho yêu cầu API.
insert POST /liveChat/messages Thêm tin nhắn vào cuộc trò chuyện trực tiếp.
list GET /liveChat/messages Liệt kê tin nhắn trò chuyện trực tiếp của một cuộc trò chuyện cụ thể.
streamList Cho phép kết nối truyền phát trực tiếp trên máy chủ để nhận tin nhắn trò chuyện trực tiếp cho một cuộc trò chuyện cụ thể với độ trễ thấp.

LiveChatModerators

Tài nguyên liveChatModerator đại diện cho một người kiểm duyệt cuộc trò chuyện trực tiếp trên YouTube. Người kiểm duyệt cuộc trò chuyện có thể cấm hoặc bỏ cấm người dùng tham gia cuộc trò chuyện, xoá tin nhắn và thực hiện các hành động quản trị khác đối với cuộc trò chuyện trực tiếp.

Để biết thêm thông tin về tài nguyên này, hãy xem phần biểu thị tài nguyên và danh sách thuộc tính của tài nguyên.

Phương thức Yêu cầu HTTP Mô tả
URI liên quan đến https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/moderators Xoá một người kiểm duyệt cuộc trò chuyện. Yêu cầu phải được chủ sở hữu kênh phát sóng trực tiếp cho phép.
insert POST /liveChat/moderators Thêm một người kiểm duyệt mới cho cuộc trò chuyện. Yêu cầu phải được chủ sở hữu kênh phát sóng trực tiếp cho phép.
list GET /liveChat/moderators Liệt kê người kiểm duyệt của một cuộc trò chuyện trực tiếp. Yêu cầu phải được chủ sở hữu kênh phát sóng trực tiếp cho phép.

LiveStreams

Tài nguyên liveStream chứa thông tin về luồng video mà bạn đang truyền đến YouTube. Luồng này cung cấp nội dung sẽ được phát sóng cho người dùng YouTube. Sau khi được tạo, một tài nguyên liveStream có thể được liên kết với một hoặc nhiều tài nguyên liveBroadcast.

Để biết thêm thông tin về tài nguyên này, hãy xem phần biểu thị tài nguyên và danh sách thuộc tính của tài nguyên.

Phương thức Yêu cầu HTTP Mô tả
URI liên quan đến https://www.googleapis.com/youtube/v3
delete DELETE /liveStreams Xoá một luồng video.
insert POST /liveStreams Tạo một luồng video. Luồng này cho phép bạn gửi video đến YouTube, sau đó YouTube có thể phát sóng video đó cho khán giả.
list GET /liveStreams Trả về danh sách các luồng video khớp với các tham số yêu cầu API.
update PUT /liveStreams Cập nhật một luồng video. Nếu không thể cập nhật những thuộc tính mà bạn muốn thay đổi, thì bạn cần tạo một luồng dữ liệu mới có chế độ cài đặt phù hợp.

SuperChatEvents

Tài nguyên superChatEvent đại diện cho một tin nhắn Super Chat do người hâm mộ mua trong một sự kiện phát trực tiếp trên YouTube. Trong cuộc trò chuyện trực tiếp trên YouTube, Super Chat nổi bật hơn các tin nhắn khác theo hai cách:

  • Super Chat được làm nổi bật bằng một màu sắc.
  • Super Chat được ghim vào biểu ngữ trong một khoảng thời gian định sẵn.

Màu sắc của Super Chat, khoảng thời gian Super Chat được ghim vào biểu ngữ và độ dài tối đa của tin nhắn đều được xác định theo số tiền mua. Hãy xem Trung tâm trợ giúp của YouTube để tìm hiểu thêm về Super Chat.

Để biết thêm thông tin về tài nguyên này, hãy xem phần biểu thị tài nguyên và danh sách thuộc tính của tài nguyên.

Phương thức Yêu cầu HTTP Mô tả
URI liên quan đến https://www.googleapis.com/youtube/v3
list GET /superChatEvents Liệt kê các sự kiện Super Chat trong các sự kiện phát trực tiếp của một kênh trong 30 ngày qua.

Các loại tài nguyên không dùng nữa

FanFundingEvents

Tài nguyên fanFundingEvent đại diện cho một sự kiện Tài trợ của người hâm mộ trên kênh YouTube. Tính năng Tài trợ của người hâm mộ là một cách để ủng hộ nhà sáng tạo trên YouTube bằng tiền. Sự kiện Ủng hộ người hâm mộ xảy ra khi người dùng thanh toán một lần cho một kênh theo ý muốn. Hãy truy cập Trung tâm trợ giúp của YouTube để tìm hiểu thêm về tính năng Ủng hộ của người hâm mộ.

Để biết thêm thông tin về tài nguyên này, hãy xem phần biểu thị tài nguyên và danh sách thuộc tính của tài nguyên.

Phương thức Yêu cầu HTTP Mô tả
URI liên quan đến https://www.googleapis.com/youtube/v3
list GET /fanFundingEvents Liệt kê các sự kiện tài trợ của người hâm mộ cho một kênh. Chủ sở hữu kênh phải cấp quyền cho yêu cầu API.

LiveCuepoints

Tài nguyên liveCuepoint sẽ bắt đầu một khoảng thời gian chèn quảng cáo trong luồng video phát sóng.

Lưu ý: Lệnh API để kiểm soát điểm đánh dấu thực sự là một phần của API Content ID của YouTube và có các yêu cầu uỷ quyền khác với các yêu cầu quản lý tài nguyên liveBroadcast và liveStream.

Để biết thêm thông tin về tài nguyên này, hãy xem phần biểu thị tài nguyên và danh sách thuộc tính của tài nguyên.

Phương thức Yêu cầu HTTP Mô tả
URI liên quan đến https://www.googleapis.com/
insert POST /liveCuepoints Chèn điểm đánh dấu vào một chương trình phát sóng trực tiếp. Hiện tại, các yêu cầu đối với phương thức này phải được một tài khoản liên kết với Chủ sở hữu nội dung trên YouTube uỷ quyền.

Người tài trợ

Tài nguyên sponsor đại diện cho một nhà tài trợ của kênh YouTube. Nhà tài trợ cung cấp khoản hỗ trợ tài chính định kỳ (như phí thành viên hoặc phí đăng ký) cho nhà sáng tạo và nhận được các lợi ích đặc biệt. Ví dụ: nhà tài trợ có thể trò chuyện khi nhà sáng tạo bật chế độ chỉ dành cho nhà tài trợ trong cuộc trò chuyện.

Để biết thêm thông tin về tài nguyên này, hãy xem phần biểu thị tài nguyên và danh sách thuộc tính của tài nguyên.

Phương thức Yêu cầu HTTP Mô tả
URI liên quan đến https://www.googleapis.com/youtube/v3
list GET /sponsors Liệt kê các nhà tài trợ của một kênh. Chủ sở hữu kênh phải cấp quyền cho yêu cầu API.