LiveChatBans: delete

특정 사용자가 실시간 채팅에 참여할 수 없도록 차단하여 해당 사용자가 채팅에 다시 참여할 수 있도록 합니다. 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 string
id 매개변수는 삭제할 채팅 차단을 식별합니다. 이 값은 차단과 채팅을 모두 고유하게 식별합니다.

요청 본문

이 메소드를 호출할 때 요청 본문을 제공하지 마세요.

대답

성공하면 이 메서드가 HTTP 204 No Content 상태 코드를 반환합니다.

오류

다음 표에서는 이 메서드 호출에 대한 응답으로 API가 반환할 수 있는 오류 메시지를 보여줍니다. 자세한 내용은 오류 메시지를 참고하세요.

오류 유형 오류 세부정보 설명
forbidden (403) forbidden 지정된 차단을 삭제할 수 없습니다. 이 오류는 한 운영자가 다른 운영자에 대한 차단을 해제하려는 시도를 승인한 경우 발생할 수 있습니다.
forbidden (403) insufficientPermissions 지정된 차단을 삭제하는 데 필요한 권한이 없습니다.
invalidValue (400) invalidLiveChatBanId id 매개변수가 잘못된 값을 지정합니다.
notFound (404) liveChatBanNotFound 지정된 차단을 찾을 수 없습니다.

사용해 보기

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