LiveChatBans

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

메서드

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

insert
특정 사용자가 실시간 채팅에 참여하지 못하도록 차단합니다. API 요청은 채널 소유자 또는 차단과 관련된 실시간 채팅의 운영자가 승인해야 합니다. 지금 사용해보기
삭제
특정 사용자가 실시간 채팅에 참여하지 못하도록 하는 차단을 삭제하여 사용자가 채팅에 다시 참여할 수 있도록 합니다. 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입니다.