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