删除自有视频的评论

您可以使用本接口删除自有 TikTok 账号所发布原生视频的自有评论。

注意

其他用户的评论不能被删除，只能通过/business/comments/hide/接口进行隐藏。
评论 webhook 事件 comment.update 使您能够在自有 TikTok 账号下的任一公开视频下原有评论或评论回复被删除的五分钟内收到通知。若想订阅评论 webhook ，请查看订阅评论更新事件。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。

|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径| /v1.2/business/comments/delete/| /v1.3/business/comment/delete/|

请求

地址 https://business-api.tiktok.com/open_api/v1.3/business/comment/delete/

方法 POST

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|经 TikTok 创作者授权的访问令牌。<br>若想获取访问令牌，需使用[/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1738084387220481#item-link-获取访问令牌)接口。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。|

参数

请将下列参数作为查询字符串进行传递。

|字段{25%}|类型{10%}|参数位置{10%}|描述{55%}|
|--- |--- |--- |--- |
|business_id {必填}| string |Body| TikTok 账户的应用唯一识别ID。<br>您需将[/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1738084387220481#item-link-获取访问令牌)接口返回的`open_id`字段值传给本字段。|
|comment_id {必填}|string| Body|自有 TikTok 视频<strong>自有</strong>评论的唯一标识符，删除的对象。可通过[/business/comment/list/](https://ads.tiktok.com/marketing_api/docs?id=1760232109619202) 接口的<code>comment_id</code>字段获取所列的各个评论的 ID。|

示例

(code curl http)
curl -L -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/comment/delete/' \
-H 'Content-Type: application/json' \
-H 'Access-Token: 1234a16d2e08c3f17d1984a1be07d00406p3LIAF7vEpxliox8GRpCINv70x' \
--data-raw '{
  "business_id": "b3d2f73d-4b8c-47fb-85c3-cd571287754b",
  "comment_id": "b3d2f73d-4b8c-47fb-85c3-cd571287754b"
}' 
(/code)

Header

这些header很重要，可用于记录问题报告和故障排查信息。下表列出了部分返回的header。

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| Date | string | 收到返回时的(GMT)日期和时间 。 <br><strong>示例</strong>：Fri, 13 Aug 2021 08:04:42 GMT |
| X-Tt-Logid | string | 接口请求的唯一标识符。|

Body

|字段{30%}|类型{15%}|描述{55%}|
|-|-|-|
| request_id | string | 接口请求的唯一标识符。<br><br>请记录此字段，用于所有接口请求。此字段对于问题报告和故障排查十分重要。 |
| code | integer | 返回码。完整返回码列表及描述，可查看[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message| string | 返回信息。更多信息可查看[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
| data | object | 返回数据。<br>操作成功时返回空对象：`{}`。 |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
  "code": 0,
  "message": "Ok",
  "request_id": "20210817034316010245031056097316BA",
  "data": {}
}
(/code)