LiveChatBans

liveChatBan 리소스는 참여가 차단된 YouTube 사용자와 YouTube 실시간 채팅을 식별합니다.

방법

API는 liveChatBans 리소스에 다음 메서드를 지원합니다.

삽입
특정 사용자가 실시간 채팅에 참여하지 못하도록 차단합니다. 차단과 연결된 실시간 채팅의 채널 소유자나 운영자가 API 요청을 승인해야 합니다. 지금 사용해보기
delete
특정 사용자가 실시간 채팅에 참여할 수 없도록 차단 해제하여 사용자가 채팅에 다시 참여할 수 있도록 합니다. 차단과 연결된 실시간 채팅의 채널 소유자나 운영자가 API 요청을 승인해야 합니다. 지금 사용해보기

리소스 표현

다음 JSON 구조는 liveChatBans 리소스의 형식을 보여줍니다.

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

속성

다음 표는 이 리소스에 표시되는 속성을 정의합니다.

속성
kind string
API 리소스의 유형을 식별합니다. 값은 youtube#liveChatBan입니다.
etag etag
이 리소스의 Etag입니다.
id string
금지를 고유하게 식별하기 위해 YouTube에서 할당하는 ID입니다.
snippet object
snippet 객체는 차단된 사용자를 식별하며 차단에 대한 세부정보를 포함합니다.
snippet.liveChatId string
차단이 적용되는 실시간 채팅입니다. 브로드캐스트와 연결된 실시간 채팅 ID는 liveBroadcast 리소스의 snippet.liveChatId 속성에 반환됩니다.
snippet.type string
차단 유형입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • permanent
  • temporary
snippet.banDurationSeconds unsigned long
차단 기간 차단 유형이 temporary인 경우에만 이 속성 값을 설정하세요. 기본값은 300 (5분)입니다.
snippet.bannedUserDetails object
이 객체에는 차단된 사용자를 식별하는 정보가 포함됩니다.
snippet.bannedUserDetails.channelId string
차단된 사용자의 YouTube 채널 ID입니다.