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 - 표시에 부적합한 댓글을 거부합니다. 이렇게 하면 거부된 댓글에 대한 모든 답글이 사실상 숨겨집니다.
선택적 매개변수
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 요청 및 응답을 확인합니다.