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