Comments: setModerationStatus

하나 이상의 댓글의 검토 상태를 설정합니다. API 요청은 댓글과 연결된 채널 또는 동영상의 소유자가 승인해야 합니다.

할당량 영향: 이 메서드에 대한 호출의 할당량 비용은 50단위입니다.

일반적인 사용 사례

요청

HTTP 요청

POST https://www.googleapis.com/youtube/v3/comments/setModerationStatus

승인

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

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

매개변수

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

매개변수
필수 매개변수
id string
id 매개변수는 검토 상태를 업데이트할 댓글을 식별하는 ID를 쉼표로 구분된 목록으로 지정합니다.
moderationStatus string
지정된 댓글의 새로운 검토 상태를 식별합니다.

허용되는 값은 다음과 같습니다.
  • heldForReview – 댓글을 운영자의 검토 대기 중으로 표시합니다.
  • published – 공개 디스플레이의 댓글을 지웁니다.
  • rejected – 댓글을 표시하기에 적합하지 않은 댓글인 경우 거부합니다. 이 작업을 수행하면 거부된 댓글에 대한 모든 답글도 효과적으로 숨겨집니다.

    참고: 현재 API는 거부된 댓글을 나열하거나 찾는 방법을 제공하지 않습니다. 하지만 ID를 알고 있는 경우 거부된 댓글의 검토 상태를 변경할 수 있습니다. 거부된 댓글의 검토 상태를 변경하면 댓글 답글도 다시 검색 가능합니다.
선택적 매개변수
banAuthor boolean
banAuthor 매개변수를 사용하면 댓글 작성자가 쓴 추가 댓글을 자동으로 거부하도록 지정할 수 있습니다. 작성자를 차단하려면 매개변수 값을 true로 설정하세요.

참고: 이 매개변수는 moderationStatus 매개변수도 rejected로 설정된 경우에만 유효합니다.

요청 본문

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

응답

성공하는 경우 이 메서드는 HTTP 204 응답 코드(No Content)를 반환합니다.

오류

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

오류 유형 오류 세부정보 설명
badRequest (400) banWithoutReject banAuthor 매개변수는 moderationStatus 매개변수 값이 rejected인 경우에만 사용할 수 있습니다.
badRequest (400) operationNotSupported Google+를 기반으로 하지 않는 댓글에는 제한된 운영 기능만 제공됩니다.
badRequest (400) processingFailure API 서버에서 요청을 처리하지 못했습니다. 일시적인 오류일 수도 있지만 일반적으로 요청의 입력이 유효하지 않음을 나타냅니다.
forbidden (403) forbidden 권한이 부족하여 하나 이상의 댓글의 검토 상태를 설정할 수 없습니다. 요청이 제대로 인증되지 않았을 수 있습니다.
notFound (404) commentNotFound 요청에서 업데이트하려는 하나 이상의 댓글을 찾을 수 없습니다. 요청의 id 매개변수 값이 올바른지 확인하세요.

사용해 보기

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