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

Comments: setModerationStatus

设置一条或多条评论的管理状态。API 请求必须获得与评论关联的频道或视频的所有者的授权。

配额影响：调用此方法会消耗 50 个配额单位。

常见应用场景

POST https://www.googleapis.com/youtube/v3/comments/setModerationStatus

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

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

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

参数
必需参数
`id`	`string` `id` 参数用于指定一个逗号分隔列表，其中包含最多 50 个 ID，用于标识您要更新管理状态的评论。
`moderationStatus`	`string` 标识指定评论的新管理状态。可接受的值包括： `heldForReview` \- 将评论标记为等待管理员审核。 `published` \- 清除评论以供公开显示。您无法将被拒评论的管理状态更改为 `published`。 `rejected` \- 拒绝评论，因为评论不适合显示。此操作还会有效地隐藏对被拒评论的所有回复。如需从您的频道或视频中移除其他用户撰写的评论，请将其管理状态设置为 `rejected`。`comments.delete` 方法只能由评论的原始作者使用。
可选参数
`banAuthor`	`boolean` 借助 `banAuthor` 参数，您可以指明您希望自动拒绝评论作者撰写的任何其他评论。将参数值设置为 `true` 即可禁止该作者。仅当 `moderationStatus` 参数也设置为 `rejected` 时，此参数才有效。

调用此方法时，请勿提供请求正文。

如果成功，此方法会返回 HTTP 204 响应代码 (No Content)。

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

错误类型	错误详情	说明
`badRequest (400)`	`banWithoutReject`	只有当 `moderationStatus` 参数值为 `rejected` 时，才能使用 `banAuthor` 参数。
`badRequest (400)`	`operationNotSupported`	并非基于 Google+ 的评论仅提供有限的管理功能。
`badRequest (400)`	`processingFailure`	API 服务器未能成功处理请求。虽然这可能是暂时性错误，但通常表示请求的输入无效。尝试管理已被原始评论者删除的评论时，也会返回此错误。
`forbidden (403)`	`forbidden`	由于权限不足，无法设置一条或多条评论的管理状态。该请求可能未获授权。尝试管理已删除或无效的评论 ID 时，也会返回此错误。
`notFound (404)`	`commentNotFound`	找不到请求尝试更新的一条或多条评论。检查请求的 `id` 参数的值，确保其正确无误。

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