创建对自有视频评论的回复

您可以使用本接口为自有TikTok 账号所发布原生视频的现有评论创建回复。

注意
- 为了防止回复被系统标记为垃圾回复并因此隐藏，需避免在短时间内发布大量内容高度相似的回复。如果回复被标记为垃圾回复，您将不会收到 comment_action 为 set_to_public 的 comment.update webhook 事件通知。 - 评论 webhook 事件 comment.update 使您能够在自有 TikTok 账号下的任一公开视频下收到新评论回复的五分钟内收到通知。若想订阅评论 webhook ，请查看订阅评论更新事件。

v1.2与v1.3版本对比

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

|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径|/v1.2/business/comments/replies/create/|/v1.3/business/comment/reply/create/|
|新增请求参数| / |`reply_image_url`<br>`image_uri`<br>`image_width`<br>`image_height`|
|新增返回参数| / |`unique_identifier`<br>`image_url`|

请求

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

方法 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`字段值传给本字段。|
|video_id {必填}|string| Body|自有 TikTok 视频的唯一标识符。可通过[/business/video/list/](https://ads.tiktok.com/marketing_api/docs?id=1762228421622786) 接口的<code>item_id</code>字段获取。|
|comment_id {必填}|string| Body|自有 TikTok 视频评论的唯一标识符，用于创建对应回复。可通过[/business/comment/list/](https://ads.tiktok.com/marketing_api/docs?id=1760232109619202) 接口的<code>comment_id</code>字段获取评论 ID。|
| reply_image_url | string | Body |用作回复的图片的 URL。<br><br>用作回复的自定义图片的可公开访问 HTTP(s) URL。<br><br>图片限制：<ul><li>最高分辨率：1080 x 1920 px 或 1920 x 1080 px。</li><li>最低分辨率：360 x 360 px。</li><li>文件大小：不超过 20 MB。</li><li>文件类型：JPG、JPEG、WebP 或 PNG。</li></ul><br><br><strong>示例</strong>：https://tiktok.com/tiktok-images/image.jpg<br><br><p><span style="color:darkred"><b>注意</b></span>：传入已手动或自动验证所有权的 URL。若想手动验证 URL 资源的所有权，请按照管理 URL 资源中所述的步骤操作。</p>|
| text {+条件必填} | string | Body | 必须传入 `text` 或 `image_uri`。<br><br>评论回复的文本内容。<br><br>长度限制：1,200 个字符（UTF-8 编码）。<br><br><strong>示例</strong>：“这是一条评论 #comment 🙂”。|
| image_uri {+条件必填} |string| Body | 必须传入 `text` 或 `image_uri`。<br><br>用作回复的图片的 URI。<br><br>若想获取图片 URI，需先调用 [/business/comment/image/upload/](1856212334897154.html) 接口。<br><br><strong>示例</strong>：`54ccb875ae0c4368b94037d03a95b633`|
| image_width {+条件必填} | integer | Body | 当传入 `image_uri` 时，此为必填字段。<br><br>图片的宽度。<br><br>若想获取图片宽度，需先调用 [/business/comment/image/upload/](1856212334897154.html) 接口。|
| image_height {+条件必填} | integer | Body | 当传入 `image_uri` 时，此为必填字段。<br><br>图片的高度。<br><br>若想获取图片高度，需先调用 [/business/comment/image/upload/](1856212334897154.html) 接口。<br><br><p><span style="color:darkred"><b>注意</b></span>：此值来自 [/business/comment/image/upload/](1856212334897154.html) 接口的返回结果。</p>|

示例

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/business/comment/reply/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "business_id" : "{{business_id}}",
    "video_id": "{{video_id}}",
    "comment_id" : "{{comment_id}}",
    "text": "{{text}}"
}'
(/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 | 返回数据。 |
#|comment_id | string | 新建回复的唯一标识符。<br><br><strong>示例</strong>：6990565363377392901 |
#|parent_comment_id | string | 回复的评论的唯一标识符。<br><br><strong>示例</strong>：6990565363377392901 |
#|video_id | string | 回复对应的自有视频的唯一标识符。<br><br><strong>示例</strong>：6990565363377392901 |
#|user_id{-即将废弃}| string | 发表回复的用户在开发者应用和 TikTok 账户范围内的唯一标识符。  <br><br><strong>示例</strong>：ce9b7be629b0447af777a0ad945783f61b7f790982b49fbda04a23b4722eaffe<br><br><p><span style="color:darkred"><b>注意</b></span>：本字段将在下个 API 版本中废弃。推荐您使用 `unique_identifier` 识别 TikTok 用户，因为该用户标识符在多个 API 之间保持一致。 |
#| unique_identifier | string | 发表评论或评论回复的用户的全球统一标识符。该标识符在多个 API 之间保持一致，方便集成和参数的互相参照。<br><br><b>示例</b>：+ABc1D2/E0fGhijklMNOrD34vDW/zDiZUNRH5Jyahue6OcA7b8ZpwnqXV9u1Uh+k|
#|create_time | string | 回复发表的日期和时间，UTC 时区，采用 Unix/Epoch 格式。<br><br><strong>示例</strong>：1627617835 |
#|text|string|评论的文本内容。<br><br>当用户的回复内容是文本而不是图片时返回。<br><br><strong>示例</strong>：“这是一条评论 #comment 🙂”|
#|image_url|string|评论中图片的 URL。<br><br>当评论为图片时返回。<br><br>此 URL 不会过期。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "video_id": "{{video_id}}",
        "parent_comment_id": "{{parent_comment_id}}",
        "comment_id": "{{comment_id}}",
        "create_time": "1701334608",
        "text": "{{text}}",
        "user_id": "{{user_id}}",
        "unique_identifier": "{{unique_identifier}}"
    }
}
(/code)