Comments: update

修改评论。

对配额的影响:调用此方法会产生 50 个单元的配额费用

常见使用场景

请求

HTTP 请求

PUT https://www.googleapis.com/youtube/v3/comments

授权

此请求需要获得以下至少一个范围的授权(详细了解身份验证和授权)。

范围
https://www.googleapis.com/auth/youtube.force-ssl

参数

下表列出了此查询支持的参数。列出的所有参数都是查询参数。

参数
必需参数
part string
part 参数用于标识 API 响应将包含的属性。您必须至少在参数值中包含 snippet 部分,因为该部分包含 API 请求可以更新的所有属性。

以下列表包含您可以包含在参数值中的 part 名称:
  • id
  • snippet

请求正文

在请求正文中提供评论资源。 针对该资源:

  • 您可以为以下属性设置值:

    • snippet.textOriginal

响应

如果成功,此方法将在响应正文中返回评论资源

错误

下表列出了 API 在响应对此方法的调用时可能会返回的错误消息。如需了解详情,请参阅错误消息文档。

错误类型 错误详情 说明
badRequest (400) commentTextTooLong 要更新的 comment 资源的 snippet.textOriginal 属性中包含的字符过多。
badRequest (400) invalidCommentMetadata 请求元数据无效。
badRequest (400) operationNotSupported 只能更新基于 Google+ 的评论。
badRequest (400) processingFailure API 服务器未能成功处理请求。虽然这可能是暂时性错误,但通常表示请求的输入无效。检查请求正文中 comment 资源的结构,确保其有效。
forbidden (403) forbidden 由于权限不足,无法更新评论。请求可能未获得适当授权。
forbidden (403) ineligibleAccount 用于授权 API 请求的 YouTube 账号必须与用户的 Google 账号合并,才能更新评论或评论会话。
notFound (404) commentNotFound 找不到指定的评论。检查请求正文中 id 属性的值,确保其正确无误。