为自有视频创建新评论

您可以使用本接口为自有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/create/|/v1.3/business/comment/create/|
|新增请求参数| / |`image_uri`<br> `image_width`<br> `image_height`
|新增返回参数|/|`unique_identifier`<br>`image_url`|

请求

地址 https://business-api.tiktok.com/open_api/v1.3/business/comment/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>字段获取。|
| 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/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "business_id":"{{business_id}}",
    "video_id":"{{video_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 |
#|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 | 评论发表的日期和时间，采用 Unix/Epoch 格式。<br><br><strong>示例</strong>：1627617835 |
#|text | string | 评论的文本内容。<br><br><strong>示例</strong>："This is a comment #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": {
        "unique_identifier": "{{unique_identifier}}",
        "comment_id": "{{comment_id}}",
        "text": "{{text}}",
        "video_id": "{{video_id}}",
        "create_time": "1717489600",
        "user_id": "{{user_id}}"
    }
}
(/code)