此页面由 Cloud Translation API 翻译。

Comments: insert

创建对现有评论的回复。注意：如需创建顶级评论，请使用 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` 名称： `id` `snippet`

请求正文

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

您必须为以下属性指定一个值：
- 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 请求和响应。