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 trò chuyện trực tiếp cho phép.
Các trường hợp sử dụng phổ biến
Yêu cầu
Yêu cầu HTTP
GET https://www.googleapis.com/youtube/v3/liveChat/moderators
Tham số
Bảng sau đây liệt kê các tham số mà truy vấn này hỗ trợ. Tất cả tham số được liệt kê đều là tham số truy vấn.
Tham số | ||
---|---|---|
Tham số bắt buộc | ||
liveChatId |
string Tham số liveChatId chỉ định cuộc trò chuyện trực tiếp trên YouTube mà API sẽ trả về người kiểm duyệt. Mã cuộc trò chuyện trực tiếp liên kết với một chương trình phát sóng được trả về trong thuộc tính snippet.liveChatId của tài nguyên liveBroadcast . |
|
part |
string Tham số part chỉ định các phần tài nguyên liveChatModerator sẽ bao gồm phản hồi API. Các giá trị được hỗ trợ là id và snippet . |
|
Thông số không bắt buộc | ||
maxResults |
unsigned integer Tham số maxResults chỉ định số lượng mục tối đa cần được trả về trong tập hợp kết quả. Các giá trị được chấp nhận là từ 0 đến 50 (bao gồm cả hai giá trị này). Giá trị mặc định là 5 . |
|
pageToken |
string Tham số pageToken xác định một trang cụ thể trong nhóm kết quả sẽ được trả về. Trong một phản hồi API, thuộc tính nextPageToken và prevPageToken xác định những trang khác có thể truy xuất. |
Nội dung yêu cầu
Đừng cung cấp nội dung yêu cầu khi gọi phương thức này.
Phản hồi
Nếu thành công, phương thức này sẽ trả về nội dung phản hồi có cấu trúc như sau:
{ "kind": "youtube#liveChatModeratorListResponse", "etag": etag, "prevPageToken": string, "nextPageToken": string, "pageInfo": { "totalResults": integer, "resultsPerPage": integer }, "items": [ liveChatModerator Resource ] }
Thuộc tính
Bảng sau đây xác định các thuộc tính xuất hiện trong tài nguyên này:
Thuộc tính | |
---|---|
kind |
string Xác định loại tài nguyên API. Giá trị sẽ là youtube#liveChatModeratorListResponse . |
etag |
etag Thẻ Etag của tài nguyên này. |
prevPageToken |
string Mã thông báo có thể được dùng làm giá trị của tham số pageToken để truy xuất trang trước đó trong tập hợp kết quả. |
nextPageToken |
string Mã thông báo có thể được dùng làm giá trị của tham số pageToken để truy xuất trang tiếp theo trong tập hợp kết quả. |
pageInfo |
object Đối tượng pageInfo đóng gói thông tin phân trang cho tập hợp kết quả. |
pageInfo.totalResults |
integer Tổng số kết quả trong nhóm kết quả. |
pageInfo.resultsPerPage |
integer Số lượng kết quả có trong phản hồi của API. |
items[] |
list Danh sách người kiểm duyệt đáp ứng tiêu chí của yêu cầu. |
Lỗi
API không xác định bất kỳ thông báo lỗi nào dành riêng cho phương thức API này. Tuy nhiên, phương thức này vẫn có thể trả về các lỗi API chung được liệt kê trong tài liệu về thông báo lỗi.
Hãy dùng thử!
Dùng APIs Explorer để gọi API này cũng như xem yêu cầu và phản hồi của API.