此页面由 Cloud Translation API 翻译。

Videos: rate

为视频添加“顶”或“踩”评分，或者移除视频的评分。

配额影响：调用此方法将会产生 50 个单元的配额费用。

注意：这不会影响视频的官方“顶”/“踩”次数。

常见使用场景

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 请求和响应。