LiveChatBans: insert

특정 사용자가 실시간 채팅에 참여할 수 없도록 차단합니다. API 요청은 차단과 관련된 실시간 채팅의 채널 소유자 또는 운영자가 승인해야 합니다.

일반적인 사용 사례

요청

HTTP 요청

POST https://www.googleapis.com/youtube/v3/liveChat/bans

승인

이 요청에는 다음 범위 중 최소 하나를 사용하여 인증이 필요합니다. (인증 및 승인에 대해 자세히 알아보기)

범위
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

매개변수

다음 표에는 이 쿼리가 지원하는 매개변수가 나와 있습니다. 나열된 모든 매개변수는 쿼리 매개변수입니다.

매개변수
필수 매개변수
part string
이 연산에서 part 매개변수는 두 가지 용도로 사용됩니다. 쓰기 작업에서 설정하는 속성과 API 응답이 반환하는 속성을 식별합니다. 매개변수 값을 snippet로 설정합니다.

요청 본문

요청 본문에 liveChatBan 리소스를 제공합니다. 해당 리소스의 경우:

  • 다음 속성에 값을 지정해야 합니다.

    • snippet.liveChatId
    • snippet.type
    • snippet.bannedUserDetails.channelId

  • 다음 속성에 값을 설정할 수 있습니다.

    • snippet.banDurationSeconds

응답

요청이 성공하면 이 메서드는 응답 본문에 liveChatBan 리소스를 반환합니다.

오류

다음 표에서는 이 메서드에 대한 호출에 대한 응답으로 API가 반환할 수 있는 오류 메시지를 확인합니다. 자세한 내용은 오류 메시지 설명서를 참조하세요.

오류 유형 오류 세부정보 설명
forbidden (403) insufficientPermissions 지정된 실시간 채팅에서 사용자를 차단하는 데 필요한 권한이 없습니다.
forbidden (403) liveChatBanInsertionNotAllowed 지정된 차단을 만들 수 없습니다. 이 오류는 요청에서 채팅 소유자나 다른 운영자를 차단하려 할 때 발생할 수 있습니다.
invalidValue (400) invalidChannelId 지정된 채널 ID를 찾을 수 없습니다.
invalidValue (400) invalidLiveChatId 요청에 지정된 snippet.liveChatId 값이 잘못되었습니다. 연결된 liveBroadcast 리소스를 확인하여 값이 올바른지 확인합니다.
notFound (404) liveChatNotFound 지정한 실시간 채팅을 찾을 수 없습니다. 연결된 liveBroadcast 리소스를 확인하여 snippet.liveChatId 속성을 올바른 값으로 설정했는지 확인합니다.
notFound (404) liveChatUserNotFound 차단하려는 실시간 채팅 사용자를 찾을 수 없습니다.
required (400) bannedUserChannelIdRequired 요청 본문에 제출된 liveChatBan 리소스는 snippet.bannedUserDetails.channelId 속성 값을 지정해야 합니다.
required (400) liveChatIdRequired 요청 본문에 제출된 liveChatBan 리소스는 snippet.liveChatId 속성 값을 지정해야 합니다.

사용해 보기

APIs Explorer를 사용하여 이 API를 호출하고 API 요청 및 응답을 확인하세요.