Liệt kê người kiểm duyệt của một cuộc trò chuyện qua Live. Yêu cầu phải được chủ sở hữu kênh của Trò chuyện trong sự kiện phát 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
Thông số
Bảng sau đây liệt kê các tham số mà truy vấn này hỗ trợ. Tất cả các tham số được liệt kê đều là tham số truy vấn.
| Thông số | ||
|---|---|---|
| Tham số bắt buộc | ||
liveChatId |
stringTham số liveChatId chỉ định Trò chuyện trong sự kiện phát trực tiếp trên YouTube mà API sẽ trả về người kiểm duyệt. Mã Trò chuyện trong sự kiện phát trực tiếp liên kết với một sự kiện phát sóng được trả về trong thuộc tính snippet.liveChatId của tài nguyên liveBroadcast. |
|
part |
stringTham số part chỉ định các phần tài nguyên liveChatModerator mà phản hồi của API sẽ bao gồm. Giá trị được hỗ trợ là id và snippet. |
|
| Thông số tuỳ chọn | ||
maxResults |
unsigned integerTham số maxResults chỉ định số lượng tối đa các mục sẽ được trả về trong tập kết quả. Giá trị được chấp nhận là từ 0 đến 50. Giá trị mặc định là 5. |
|
pageToken |
stringTham số pageToken xác định một trang cụ thể trong tập kết quả cần được trả về. Trong phản hồi của API, các thuộc tính nextPageToken và prevPageToken xác định các trang khác có thể được 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 |
stringXác định loại tài nguyên của API. Giá trị sẽ là youtube#liveChatModeratorListResponse. |
etag |
etagEtag của tài nguyên này. |
prevPageToken |
stringMã thông báo có thể dùng làm giá trị của tham số pageToken để truy xuất trang trước trong tập kết quả. |
nextPageToken |
stringMã thông báo có thể dùng làm giá trị của tham số pageToken để truy xuất trang tiếp theo trong tập kết quả. |
pageInfo |
objectĐối tượng pageInfo đóng gói thông tin phân trang cho tập kết quả. |
pageInfo.totalResults |
integerTổng số kết quả trong tập kết quả. |
pageInfo.resultsPerPage |
integerSố lượng kết quả có trong phản hồi của API. |
items[] |
listDanh sách người kiểm duyệt phù hợp với tiêu chí của yêu cầu. |
Lỗi
API này 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ử!
Sử dụng APIs Explorer để gọi API này và xem Yêu cầu API cũng như phản hồi của API.