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.

Phương thức

API này hỗ trợ các phương thức sau cho tài nguyên liveChatBans:

chèn
Ngăn 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. Thử ngay.
xóa
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. Thử ngay.

Biểu thị tài nguyên

Cấu trúc JSON sau đây cho thấy định dạng của tài nguyên liveChatBans:

{
  "kind": "youtube#liveChatBan",
  "etag": etag,
  "id": string,
  "snippet": {
    "liveChatId": string,
    "type": string,
    "banDurationSeconds": unsigned long,
    "bannedUserDetails": {
      "channelId": string
    }
  }
}

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#liveChatBan.
etag etag
Etag của tài nguyên này.
id string
Mã nhận dạng do YouTube chỉ định để xác định riêng biệt lệnh cấm.
snippet object
Đối tượng snippet xác định người dùng bị cấm và chứa thông tin chi tiết về lệnh cấm.
snippet.liveChatId string
Cuộc trò chuyện trực tiếp bị áp dụng lệnh cấm. Mã cuộc trò chuyện trực tiếp liên kết với một thông báo truyền tin sẽ được trả về trong thuộc tính snippet.liveChatId của tài nguyên liveBroadcast.
snippet.type string
Loại lệnh cấm.

Các giá trị hợp lệ cho thuộc tính này là:
  • permanent
  • temporary
snippet.banDurationSeconds unsigned long
Thời gian bị cấm. Chỉ đặt giá trị cho thuộc tính này nếu loại lệnh cấm là temporary. Giá trị mặc định là 300 (5 phút).
snippet.bannedUserDetails object
Đối tượng này chứa thông tin nhận dạng người dùng bị cấm.
snippet.bannedUserDetails.channelId string
Mã nhận dạng kênh YouTube của người dùng bị cấm.