특정 사용자가 실시간 채팅에 참여할 수 없도록 차단하여 해당 사용자가 채팅에 다시 참여할 수 있도록 합니다. API 요청은 채널 소유자 또는 차단과 관련된 실시간 채팅 운영자의 승인을 받아야 합니다.
일반적인 사용 사례
요청
HTTP 요청
DELETE 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 |
매개변수
다음 표에는 이 쿼리가 지원하는 매개변수가 나와 있습니다. 나열된 모든 매개변수는 쿼리 매개변수입니다.
| 매개변수 | ||
|---|---|---|
| 필수 매개변수 | ||
id |
stringid 매개변수는 삭제할 채팅 차단을 식별합니다. 이 값은 차단과 채팅을 모두 고유하게 식별합니다. |
|
요청 본문
이 메소드를 호출할 때 요청 본문을 제공하지 마세요.
대답
성공하면 이 메서드가 HTTP 204 No Content 상태 코드를 반환합니다.
오류
다음 표에서는 이 메서드 호출에 대한 응답으로 API가 반환할 수 있는 오류 메시지를 보여줍니다. 자세한 내용은 오류 메시지를 참고하세요.
| 오류 유형 | 오류 세부정보 | 설명 |
|---|---|---|
forbidden (403) |
forbidden |
지정된 차단을 삭제할 수 없습니다. 이 오류는 한 운영자가 다른 운영자에 대한 차단을 해제하려는 시도를 승인한 경우 발생할 수 있습니다. |
forbidden (403) |
insufficientPermissions |
지정된 차단을 삭제하는 데 필요한 권한이 없습니다. |
invalidValue (400) |
invalidLiveChatBanId |
id 매개변수가 잘못된 값을 지정합니다. |
notFound (404) |
liveChatBanNotFound |
지정된 차단을 찾을 수 없습니다. |
사용해 보기
APIs Explorer를 사용하여 이 API를 호출하고 API 요청 및 응답을 확인합니다.