Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

CommentThreads: insert

创建新的顶级评论。如需向现有评论添加回复，请改用 comments.insert 方法。

配额影响：调用此方法的配额费用为 50 个单位。

常见应用场景

POST https://www.googleapis.com/youtube/v3/commentThreads

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

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

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

参数
必需参数
`part`	`string` `part` 参数用于标识 API 响应将包含的属性。将参数值设置为 `snippet`。`snippet` 部分的配额费用为 2 个单位。以下列表包含您可以包含在参数值中的 `part` 名称： `id` `replies` `snippet`

在请求正文中提供 commentThread 资源。

对于该资源，您必须为以下属性指定值：

如果成功，此方法会在响应正文中返回 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` 属性的值，确保其正确无误。

使用 APIs Explorer 调用此 API，查看 API 请求和响应。