Tài liệu tham khảo API

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

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 qua video trực tiếp.

Để biết thêm thông tin về tài nguyên này, hãy xem phần nội dung trình bày về tài nguyên và danh sách các tài sản.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/youtube/v3
bind POST /liveBroadcasts/bind Liên kết một sự kiện phát sóng trên YouTube với một sự kiện phát trực tiếp hoặc xoá liên kết hiện có giữa một sự kiện phát sóng và một sự kiện phát trực tiếp. 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á chương trình 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 tin truyền trên YouTube khớp với các tham số yêu cầu của 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 đổi 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 nội dung truyền phát 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 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 một điểm tín hiệu vào một chương trình phát sóng trực tiếp. Điểm dừng 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 trên YouTube và 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 nội dung trình bày về tài nguyên và danh sách các tài sản.

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

LiveChatMessages

Tài nguyên liveChatMessage đại diện cho một tin nhắn trò chuyện trong một cuộc trò chuyện trực tiếp trên YouTube. Tài nguyên có thể chứa thông tin chi tiết về một số loại tin nhắn, bao gồm cả tin nhắn văn bản mới đăng hoặc sự kiện tài trợ 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 buổi phát sóng trực tiếp và hoạt động 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 cho sự kiện đó nữa.)

Để biết thêm thông tin về tài nguyên này, hãy xem phần nội dung trình bày về tài nguyên và danh sách các tài sản.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/messages Xoá tin nhắn trò chuyện. Yêu cầu API phải được chủ sở hữu kênh hoặc người kiểm duyệt cuộc trò chuyện trực tiếp liên quan đến lệnh cấm đó uỷ quyền.
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ê các tin nhắn trò chuyện trực tiếp của một cuộc trò chuyện cụ thể.

LiveChatModerators

Tài nguyên liveChatModerator đại diện cho người kiểm duyệt cho mộ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 khỏi 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 nội dung trình bày về tài nguyên và danh sách các tài sản.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/moderators Xoá 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 cho 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 cung cấp nội dung sẽ được phát đến người dùng YouTube. Sau khi tạo, 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 nội dung trình bày về tài nguyên và danh sách các tài sản.

Phương thức Yêu cầu HTTP Nội dung 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 cho phép bạn gửi video của mình đến YouTube, sau đó YouTube có thể phát 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 các tài sản mà bạn muốn thay đổi, bạn cần tạo một luồng mới với các chế độ cài đặt phù hợp.

SuperChatEvents

Tài nguyên superChatEvent thể hiện tin nhắn Super Chat mà người hâm mộ mua trong một sự kiện phát trực tiếp trên YouTube. Trong luồng trò chuyện trực tiếp trên YouTube, Super Chat nổi bật so với các tin nhắn khác theo hai cách:

  • Super Chat được làm nổi bật bằng màu sắc.
  • Super Chat luôn được ghim ở đầu cuộc trò chuyện trong một khoảng thời gian nhất định.

Màu của Super Chat, khoảng thời gian ghim tin nhắn vào biểu ngữ và thời lượng tin nhắn tối đa đều được xác định bằng số tiền mua. Hãy truy cập vào 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 nội dung trình bày về tài nguyên và danh sách các tài sản.

Phương thức Yêu cầu HTTP Nội dung 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 từ sự kiện phát trực tiếp của một kênh trong 30 ngày trước.

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

FanFundingEvents

Tài nguyên fanFundingEvent đại diện cho sự kiện Tài trợ của người hâm mộ trên một kênh YouTube. Tài trợ của người hâm mộ là cách để hỗ trợ nhà sáng tạo trên YouTube bằng cách kiếm tiền. Sự kiện Tài trợ của người hâm mộ xảy ra khi một người dùng tự nguyện thanh toán cho một kênh. Xem Trung tâm trợ giúp của YouTube để tìm hiểu thêm về tính năng Tài trợ 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 nội dung trình bày về tài nguyên và danh sách các tài sản.

Phương thức Yêu cầu HTTP Nội dung 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. Yêu cầu API phải được chủ sở hữu kênh cho phép.

LiveCuepoints

Tài nguyên liveCuepoint bắt đầu một điểm 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 dừng thực ra là một phần của API YouTube Content ID 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 nội dung trình bày về tài nguyên và danh sách các tài sản.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/
insert POST /liveCuepoints Chèn một điểm tín hiệ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 sử dụng phương thức này phải do một tài khoản liên kết với một Chủ sở hữu nội dung trên YouTube cấp phép.

Người tài trợ

Tài nguyên sponsor đại diện cho nhà tài trợ cho một kênh YouTube. Nhà tài trợ cung cấp khoản hỗ trợ bằng tiền định kỳ, chẳng hạn như phí thuê bao hoặc phí thành viên, cho người 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ợ cho cuộc trò chuyện.

Để biết thêm thông tin về tài nguyên này, hãy xem phần nội dung trình bày về tài nguyên và danh sách các tài sản.

Phương thức Yêu cầu HTTP Nội dung 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ợ cho một kênh. Yêu cầu API phải được chủ sở hữu kênh cho phép.