获取关联评论
您可以使用本接口获取关联评论。
若评论类型为COMMENT，返回该评论及其所有回复。若评论类型为REPLY，返回该回复及原评论。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径|/v1.2/comment/reference/|/v1.3/comment/reference/|
|请求参数类型|advertiser_id: number<br>comment_id: number<br>original_comment_id: number|advertiser_id: string<br>comment_id: string<br>original_comment_id: string|
|返回参数名称|list<br>is_top|comments<br>is_pinned|
|返回参数类型|comment_id: number|comment_id: string|
|返回参数名称和类型|item_id: number |tiktok_item_id: string|
|新增返回参数|/|user_id`|
## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/comment/reference/
**方法** GET
**Header**
```xtable
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|advertiser_id {必填}|string| 广告主 ID。 |
|comment_id {必填}|string| 评论 ID。 |
|comment_type {必填}|string| 评论类型。<br><br>枚举值：原始评论 `COMMENT`，回复评论 `REPLY`。 |
|original_comment_id |string| 原始评论 ID。评论类型为 `REPLY` 时需要填写。 |
|page_size |number| 分页大小。<br><br>默认值：10。<br><br>取值范围：1-1000。|
|page |number| 当前页数。<br><br>默认值：1。<br><br>取值范围：≥ 1。|
示例
(code curl http)
curl --get -H "Access-Token:xxx" \
--data-urlencode "advertiser_id=ADVERTISER_ID" \
--data-urlencode "comment_id=COMMENT_ID" \
--data-urlencode "page_size=PAGE_SIZE" \
--data-urlencode "original_comment_id=COMMENTAL_COMMENT_ID" \
--data-urlencode "comment_type=comment_type" \
--data-urlencode "page=PAGE" \
https://business-api.tiktok.com/open_api/v1.3/comment/reference/
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data|object|返回数据。|
#|comments|object[]| 评论列表。 |
##|comment_id |string| 评论 ID 。|
##|content |string| 评论内容。 |
##|comment_type |string| 评论类型。枚举值：原始评论 `COMMENT`，回复评论 `REPLY`。 |
##|comment_status |string| 评论状态。枚举值: 隐藏 `HIDDEN`，公开 `PUBLIC`。 |
##|hit_blockedword |boolean| 是否命中屏蔽词。 |
##|create_time |string| 评论创建时间。 |
##|user_name |string| 评论者名称。 |
##| user_id | string | 发表评论的 TikTok 用户的 ID。<br> <br>示例： `"6123456789123456789"`。 |
##|user_avatar_url |string| 评论者头像链接。 |
##|tiktok_item_id|string|TikTok 视频 ID。|
##|identity_id |string|认证身份ID，当使用Spark Ads(`tiktok_item_id`)时必填。如果您不使用Spark Ads，我们仍然强烈建议传入 `ideneity_id` 和 `identity_type` (`CUSTOMIZED_USER`类型)，以便更好地管理广告信息。|
##|identity_type |string|认证身份类型，当使用Spark Ads(`tiktok_item_id`)时必填。枚举值： `CUSTOMIZED_USER` (自定义用户）， `TT_USER` (TikTok用户）。关于认证身份的更多信息，请访问[认证身份](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097)。|
##|is_pinned|boolean| 评论是否置顶。|
##|can_delete|boolean|评论是否可删除。|
##|is_auth_ttba|boolean|用户是否已关联 TikTok 企业号。|
##|is_auth_comment_manage_scope|boolean|用户是否有评论管理权限。|
##|reply_user_info|object| 原评论作者信息。只适用于对已有评论的回复。如果本评论为一级评论，则本字段返回空。|
#|page_info |object| 分页信息。 |
##|page |number| 当前页数。 |
##|page_size |number| 分页大小。|
##|total_number |number| 总数。 |
##|total_page |number| 总页数。 |
|request_id |string|请求的日志id，唯一标识一个请求。 |
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {}
}
(/code);