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 trực tiếp và phát trực tuyến 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 tuyến qua video 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ương thức trình bày tài nguyên và danh sách thuộc tính.

Phương thức Yêu cầu HTTP Mô tả
URI tương ứng với 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á mối 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 sự kiện phát sóng chỉ có thể liên kết với một luồng video, mặc dù một luồng video có thể liên kết với nhiều sự kiện phát sóng.
delete DELETE /liveBroadcasts Xoá thông báo truyền tin.
insert POST /liveBroadcasts Tạo một thông báo truyền tin.
list GET /liveBroadcasts Trả về danh sách các sự kiện phát trực tiếp trên YouTube khớ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 sự kiện phát 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 sự kiện phát trực tiếp sang testing, YouTube sẽ bắt đầu truyền video đến luồng giám sát của sự kiện phát trực tiếp đó. 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 thông báo truyền tin là active.
update PUT /liveBroadcasts Cập nhật thông báo truyền tin. Ví dụ: bạn có thể sửa đổi chế độ cài đặt thông báo 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 tín hiệu vào sự kiện phát trực tiếp. Điểm tín hiệ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ương thức trình bày tài nguyên và danh sách thuộc tính.

Phương thức Yêu cầu HTTP Mô tả
URI tương ứng với 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ể đóng góp vào 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. 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 cuộc 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 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ề 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 sự kiện phát trực tiếp và có sẵn trong khi sự kiện phát 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 hoạt động nữa đối với sự kiện đó.)

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

Phương thức Yêu cầu HTTP Mô tả
URI tương ứng với 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ê 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 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 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ương thức trình bày tài nguyên và danh sách thuộc tính.

Phương thức Yêu cầu HTTP Mô tả
URI tương ứng với 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 này phải được chủ sở hữu kênh của sự kiện phát trực tiếp cho phép.
insert POST /liveChat/moderators Thêm người kiểm duyệt mới cho cuộc trò chuyện. Yêu cầu này phải được chủ sở hữu kênh của sự kiện phát trực tiếp cho phép.
list GET /liveChat/moderators Liệt kê người kiểm duyệt cuộc trò chuyện trực tiếp. Yêu cầu này phải được chủ sở hữu kênh của sự kiện phát 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 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ương thức trình bày tài nguyên và danh sách thuộc tính.

Phương thức Yêu cầu HTTP Mô tả
URI tương ứng với https://www.googleapis.com/youtube/v3
delete DELETE /liveStreams Xoá luồng video.
insert POST /liveStreams Tạo luồng video. Luồng này cho phép bạn gửi video đến YouTube để YouTube có thể phát video đó cho khán giả của bạn.
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 luồng video. Nếu không thể cập nhật các thuộc tính mà bạn muốn thay đổi, thì bạn cần tạo một luồng mới với chế độ cài đặt thích hợp.

SuperChatEvents

Tài nguyên superChatEvent đại diện cho một tin nhắn Super Chat mà người hâm mộ đã mua trong 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 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ột màu.
  • 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 tin nhắn tối đa đều do số tiền mua quyết định. 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ương thức biểu thị tài nguyên và danh sách thuộc tính.

Phương thức Yêu cầu HTTP Mô tả
URI tương ứng với 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. Các tính năng Tài trợ của người hâm mộ là một cách để người hâm mộ hỗ trợ nhà sáng tạo trên YouTube về mặt tài chính. Sự kiện Tài trợ của người hâm mộ xảy ra khi người dùng thanh toán một lần một cách tự nguyện cho một kênh. Hãy 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ương thức trình bày tài nguyên và danh sách thuộc tính.

Phương thức Yêu cầu HTTP Mô tả
URI tương ứng với 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 tín hiệ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 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ương thức trình bày tài nguyên và danh sách thuộc tính.

Phương thức Yêu cầu HTTP Mô tả
URI tương ứng với https://www.googleapis.com/
insert POST /liveCuepoints Chèn điểm tín hiệu vào sự kiện phát 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 đượ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 hỗ trợ tài chính định kỳ (chẳng hạn như phí thuê bao hoặc phí thành viên) cho nhà sáng tạo và nhận 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ương thức trình bày tài nguyên và danh sách thuộc tính.

Phương thức Yêu cầu HTTP Mô tả
URI tương ứng với https://www.googleapis.com/youtube/v3
list GET /sponsors Liệt kê các nhà tài trợ của một kênh. Yêu cầu API phải được chủ sở hữu kênh cho phép.