LiveChatBans

Tài nguyên liveChatBan xác định người dùng YouTube và cuộc trò chuyện trực tiếp trên YouTube mà người dùng bị cấm tham gia.

Phương pháp

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

chèn
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 của cuộc trò chuyện trực tiếp liên kết với lệnh cấm đó phê duyệt. Thử ngay.
xóa
Xóa 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, do đó 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 của cuộc trò chuyện trực tiếp liên kết với lệnh cấm đó phê duyệt. Thử ngay.

Biểu diễn 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 mà YouTube gán để xác định 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 á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 được trả về trong tài sản 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 tài sản này là:
  • permanent
  • temporary
snippet.banDurationSeconds unsigned long
Thời gian cấm. Chỉ đặt mộ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.