Videos: rate

동영상에 좋아요 또는 싫어요 평가를 추가하거나 이러한 평가를 삭제합니다.

할당량 영향: 이 메서드를 호출하면 50단위의 할당량 비용이 적용됩니다.

참고: 동영상의 공식적인 좋아요/싫어요 수에는 영향을 미치지 않습니다.

일반적인 사용 사례

요청

HTTP 요청

POST https://www.googleapis.com/youtube/v3/videos/rate

승인

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

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

매개변수

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

매개변수
필수 매개변수
id string
id 매개변수는 평가를 받거나 평가를 삭제하는 동영상의 YouTube 동영상 ID를 지정합니다.
rating string
기록할 평점을 지정합니다.

허용되는 값은 다음과 같습니다.
  • dislike – 인증된 사용자가 동영상을 싫어한다고 기록합니다.
  • like – 인증된 사용자가 동영상을 좋아했다고 기록합니다.
  • none – 인증된 사용자가 동영상에 이전에 설정한 평점을 삭제합니다.

요청 본문

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

응답

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

오류

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

오류 유형 오류 세부정보 설명
badRequest (400) emailNotVerified 사용자는 평가하기 전에 이메일 주소를 확인해야 합니다.
badRequest (400) invalidRating 요청에 rating 매개변수에 예상치 못한 값이 포함되어 있습니다.
badRequest (400) videoPurchaseRequired 대여 동영상은 대여한 사용자만 평가할 수 있습니다.
forbidden (403) forbidden 평가하려는 동영상을 평가할 수 없습니다. 요청이 제대로 인증되지 않았을 수 있습니다.
forbidden (403) videoRatingDisabled 평가하려는 동영상 소유자가 해당 동영상에 대한 평가를 사용 중지했습니다.
notFound (404) videoNotFound 평가하려는 동영상을 찾을 수 없습니다. 요청의 id 매개변수 값이 올바른지 확인하세요.

사용해 보기

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