管理自有 TikTok 视频上的评论
本文介绍了管理自有 TikTok 视频上的评论的具体步骤。
介绍
管理 TikTok 账户上的评论对于打造正向的社群体验、促进互动、收集反馈以及保持良好的在线形象至关重要。
您可以使用账号 API 高效地对评论进行审核、回复和分析,提升您管理 TikTok 账户和与观众互动的能力。
前提条件
- 您已经拥有TikTok API for Business的使用权限。详见快速入门 - 具体步骤 。
- 若要管理自有 TikTok 视频上的评论,您需要获取相关的权限。参阅API参考了解使用相关接口(包括“步骤”部分列出的接口)所需的权限;参阅更新应用权限范围了解如何设置权限。
- 您拥有一个已发布到您的 TikTok 账户的自有视频。若您尚未拥有类似视频,且希望将一个公开视频发布到您的 TikTok 账户,可以使用/business/video/publish/接口。
- 您已遵循了授权和获取访问令牌中的步骤获取了 TikTok 账号访问令牌以及 TikTok 账号对应的应用唯一 ID。
使用案例和必填参数概览
下表列出了管理自有 TikTok 视频上的评论的使用案例、相关接口和对应的必填参数:
| 使用案例 | 需使用的接口 | 必填参数 | ||||
|---|---|---|---|---|---|---|
business_id |
video_id |
comment_id |
text |
action |
||
| 新建评论 | /business/comment/create/ | ✅ |
✅ | ✅ | ||
| 回复评论 | /business/comment/reply/create/ | |||||
| 点赞评论 | /business/comment/like/ |
✅ | ✅ | ✅ | ||
| 取消点赞评论 | /business/comment/like/ | ✅ | ✅ | ✅ | ||
| 隐藏评论 | /business/comment/hide/ | ✅ | ✅ | ✅ | ✅ | |
| 取消隐藏评论 | /business/comment/hide/ | ✅ | ✅ | ✅ | ✅ | |
| 删除评论 | /business/comment/delete/ | ✅ | ✅ | |||
| 检索所有第一层级评论 | /business/comment/list/ |
✅ | ✅ | |||
| 检索所有第一层级评论及对应的评论回复 | ||||||
| 通过 ID 检索特定评论或评论回复 | ✅ | ✅ | ✅ | |||
| 在同一请求中通过 ID 检索特定评论及对应的评论回复 | ||||||
| 检索单个评论的所有回复 | /business/comment/reply/list/ | ✅ |
✅ | ✅ | ||
| 通过 webhook 订阅评论更新 | / | |||||
步骤
1. 获取自有 TikTok 视频的 ID
使用/business/video/list/接口,通过返回的item_id字段获取自有 TikTok 视频的 ID。
2. 管理自有 TikTok 视频上的评论
您可以根据您的业务需求管理自有 TikTok 视频上的评论。
下表列出了账号评论相关接口中的常用参数,以及如何设置这些参数。若想了解账号评论相关接口中必填参数,请查看上文的“使用案例和必填参数概览”小节。
| 常用请求参数 {20%} | 如何设置该参数{80%} |
|---|---|
| `business_id` | <ul><li>传入从[ /tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1738084387220481#item-link-获取访问令牌2.0)的返回中获取的`open_id`字段值(推荐)</li><li>或传入从[/oauth2/creator_token/?business=tt_user](https://business-api.tiktok.com/portal/docs?id=1738084387220481#item-link-获取访问令牌1.0) (<span style="color:red">即将废弃</span>)的返回中获取的`creator_id`字段值</li></ul> |
| `video_id` | 传入从<a href="#item-link-1. 获取自有 TikTok 视频的 ID">步骤1. 获取自有 TikTok 视频的 ID</a>中得到的`item_id`字段值 |
| `comment_id` | 传入从[/business/comment/list/](1760232109619202.html)的返回中获取的`comment_id`字段值 |
管理评论的常见用例如下:
新建评论
回复评论
使用 /business/comment/reply/create/。
点赞评论
使用 /business/comment/like/。将action设置为LIKE。
取消点赞评论
使用 /business/comment/like/。将action设置为UNLIKE。
隐藏评论
使用 /business/comment/hide/。将action设置为HIDE。
取消隐藏评论
使用 /business/comment/hide/。将action设置为UNHIDE。
删除评论
检索评论
根据您的业务需求,您可以选择以下四种组合之一:
| 场景{40%} | 如何设置<code>comment_ids</code>{30%} | 如何设置<code>include_replies</code>{30%}|
|---|---|---|
| 检索所有第一层级评论 | 不传入 | 不传入 |
| 检索所有第一层级评论及对应的评论回复 | 不传入 | 传入 |
| 通过 ID 检索特定评论或评论回复 | 传入 | 不传入 |
| 通过 ID 检索特定评论及对应的评论回复 | 传入 | 传入 |
检索单个评论的所有回复
使用/business/comment/reply/list/。
通过 Webhook 订阅评论更新
评论 Webhook 事件 comment.update 使您能够在自有 TikTok 账号下的任一公开视频下收到新评论或评论回复,或原有评论或评论回复被删除,或原有评论或评论回复可见设置发生修改的五分钟内收到通知。
若想订阅评论 Webhook ,可使用 Webhook API 接口 /business/webhook/update/ 并将 event_type 设置为 COMMENT。