Comments: setModerationStatus

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

对配额的影响:调用此方法会产生 50 个单元的配额费用

常见使用场景

请求

HTTP 请求

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

授权

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

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

参数

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

参数
必需参数
id string
id 参数指定一个逗号分隔的 ID 列表,用于标识您要更新审核状态的评论。
moderationStatus string
指明指定评论的新审核状态。

可接受的值为:
  • heldForReview - 将评论标记为等待管理员审核。
  • published - 清除要公开显示的评论。
  • rejected - 因为评论不适合显示,而拒绝该评论。此操作还能有效地隐藏对遭拒评论的所有回复。
可选参数
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 由于权限不足,无法设置一条或多条评论的审核状态。请求可能未获适当授权。
notFound (404) commentNotFound 找不到该请求尝试更新的一条或多条评论。请检查请求的 id 参数的值,确保其正确无误。

试试看!

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