创建新的顶级评论。如需向现有评论添加回复,请改用 comments.insert
方法。
对配额的影响:调用此方法会产生 50 个单元的配额费用。
常见使用场景
请求
HTTP 请求
POST https://www.googleapis.com/youtube/v3/commentThreads
授权
此请求需要获得以下至少一个范围的授权(详细了解身份验证和授权)。
范围 |
---|
https:/ |
参数
下表列出了此查询支持的参数。列出的所有参数都是查询参数。
参数 | ||
---|---|---|
必需参数 | ||
part |
string part 参数用于标识 API 响应将包含的属性。将参数值设为 snippet 。snippet 部分的配额费用为 2 个单位。以下列表包含您可以添加到参数值中的 part 名称:
|
请求正文
在请求正文中提供 commentThread 资源。
对于该资源,您必须为以下属性指定一个值:
snippet.channelId
snippet.videoId
snippet.topLevelComment.snippet.textOriginal
响应
如果成功,此方法将在响应正文中返回 commentThread 资源。
错误
下表列出了 API 在响应对此方法的调用时可能会返回的错误消息。如需了解详情,请参阅错误消息文档。
错误类型 | 错误详情 | 说明 |
---|---|---|
badRequest (400) |
channelOrVideoIdMissing |
每个评论会话都必须与一个视频相关联。确保资源指定了 snippet.channelId 和 snippet.videoId 属性的值。对视频的评论会显示在视频的观看页面上。 |
badRequest (400) |
commentTextRequired |
要插入的 comment 资源必须为 snippet.topLevelComment.snippet.textOriginal 属性指定一个值。评论不能为空。 |
badRequest (400) |
commentTextTooLong |
要插入的 comment 资源的 snippet.topLevelComment.snippet.textOriginal 属性包含的字符过多。 |
badRequest (400) |
invalidCommentThreadMetadata |
请求元数据无效。 |
badRequest (400) |
processingFailure |
API 服务器未能成功处理请求。虽然这可能是暂时性错误,但通常表示请求的输入无效。检查请求正文中 commentThread 资源的结构,确保其有效。 |
forbidden (403) |
forbidden |
权限不足,无法创建评论会话。请求可能未获得适当授权。 |
forbidden (403) |
ineligibleAccount |
用于授权 API 请求的 YouTube 账号必须与用户的 Google 账号合并,才能插入评论或评论会话。 |
notFound (404) |
channelNotFound |
找不到指定的渠道。检查 snippet.channelId 属性的值,确保其正确无误。 |
notFound (404) |
videoNotFound |
找不到指定的视频。检查 snippet.videoId 属性的值,确保其正确无误。 |