동영상에 좋아요 또는 싫어요 평가를 추가하거나 이러한 평가를 삭제합니다.
할당량 영향: 이 메서드를 호출하면 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 |
stringid 매개변수는 평가를 받거나 평가를 삭제하는 동영상의 YouTube 동영상 ID를 지정합니다. |
|
rating |
string기록할 평점을 지정합니다. 허용되는 값은 다음과 같습니다.
|
|
요청 본문
이 메소드를 호출할 때 요청 본문을 제공하지 마세요.
응답
성공하면 이 메서드는 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 요청 및 응답을 확인하세요.