创建对现有评论的回复。注意:如需创建顶级注释,请使用 commentThreads.insert
方法。
配额影响:调用此方法的配额费用为 50 个单位。
常见使用场景
请求
HTTP 请求
POST https://www.googleapis.com/youtube/v3/comments
授权
此请求需要获得以下至少一个范围的授权(详细了解身份验证和授权)。
范围 |
---|
https://www.googleapis.com/auth/youtube.force-ssl |
参数
下表列出了此查询支持的参数。列出的所有参数都是查询参数。
参数 | ||
---|---|---|
必需参数 | ||
part |
string part 参数用于标识 API 响应将包含的属性。将参数值设为 snippet 。snippet 部分的配额费用为 2 个单位。以下列表包含您可以在参数值中包含的 part 名称:
|
请求正文
在请求正文中提供注释资源。对于相应资源:
-
您必须为以下属性指定值:
snippet.textOriginal
snippet.parentId
-
您可以为以下属性设置值:
snippet.textOriginal
响应
如果成功,此方法将在响应正文中返回评论资源。
错误
下表列出了该 API 为响应对此方法的调用可能返回的错误消息。如需了解详情,请参阅错误消息文档。
错误类型 | 错误详情 | 说明 |
---|---|---|
badRequest (400) |
commentTextRequired |
正在插入的 comment 资源必须指定 snippet.textOriginal 属性的值。评论不能为空。 |
badRequest (400) |
commentTextTooLong |
正在插入的 comment 资源的 snippet.textOriginal 属性中包含过多字符。 |
badRequest (400) |
invalidCustomEmoji |
正在插入的“comment ”资源包含无效的自定义表情符号。 |
badRequest (400) |
invalidCommentMetadata |
请求元数据无效。 |
badRequest (400) |
operationNotSupported |
该 API 用户无法插入评论来回复 snippet.parentId 属性标识的顶级评论。在 commentThread 资源中,snippet.canReply 属性用于指明当前查看者是否可以回复话题。 |
badRequest (400) |
parentCommentIsPrivate |
指定的父评论为不公开评论。此 API 不支持回复不公开评论。 |
badRequest (400) |
parentIdMissing |
要插入的评论必须关联到父评论。但是,API 请求正文中的 comment 资源没有为 snippet.parentId 属性指定值。 |
badRequest (400) |
processingFailure |
API 服务器未能成功处理请求。虽然这可能是暂时性错误,但通常表示请求的输入无效。请检查请求正文中 comment 资源的结构,以确保其有效。 |
forbidden (403) |
forbidden |
由于权限不足,无法创建评论。该请求可能未正确授权。 |
forbidden (403) |
ineligibleAccount |
用于授权 API 请求的 YouTube 帐号必须与用户的 Google 帐号合并,才能插入评论或评论会话。 |
notFound (404) |
parentCommentNotFound |
找不到指定的父级评论。请检查请求正文中 snippet.parentId 属性的值,确保其正确无误。 |
试试看!
使用 APIs Explorer 调用此 API,并查看 API 请求和响应。