특정 사용자가 실시간 채팅에 참여하지 못하도록 차단합니다. API 요청은 채널 소유자 또는 차단과 관련된 실시간 채팅의 운영자가 승인해야 합니다.
일반적인 사용 사례
요청
HTTP 요청
POST https://www.googleapis.com/youtube/v3/liveChat/bans
승인
이 요청에는 다음 범위 중 하나 이상에 대한 승인이 필요합니다. 인증 및 승인에 대해 자세히 알아보려면 OAuth 2.0 인증 구현을 참고하세요.
| 범위 |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
매개변수
다음 표에는 이 쿼리가 지원하는 매개변수가 나와 있습니다. 나열된 모든 매개변수는 쿼리 매개변수입니다.
| 매개변수 | ||
|---|---|---|
| 필수 매개변수 | ||
part |
stringpart 매개변수는 이 작업에서 두 가지 용도로 사용됩니다. 쓰기 작업에서 설정할 속성과 API 응답에서 반환하는 속성을 식별합니다. 매개변수 값을 snippet로 설정합니다. |
|
요청 본문
요청 본문에 liveChatBan 리소스를 제공합니다. 해당 리소스의 경우:
-
다음 속성에 값을 지정해야 합니다.
snippet.liveChatIdsnippet.typesnippet.bannedUserDetails.channelId
-
다음 속성에 값을 설정할 수 있습니다.
snippet.banDurationSeconds
응답
이 메서드는 성공하면 응답 본문에 liveChatBan 리소스를 반환합니다.
오류
다음 표에는 이 메서드 호출에 대한 응답으로 API에서 반환할 수 있는 오류 메시지가 나와 있습니다. 자세한 내용은 YouTube Live Streaming 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 요청 및 응답을 확인합니다.