获取广告审核信息
您可以使用本接口获取广告审核信息。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{30%}|v1.3{40%}|
|---|---|---|
|接口路径| /v1.2/ad/review_info/| /v1.3/ad/review_info/|
|请求参数类型|advertiser_id: number <br>ad_ids: number[]|advertiser_id: string<br>ad_ids: string[]
|新增请求参数 |/|lang: string|
|返回参数名称|is_pass|is_approved|
|返回参数类型 |reject_info: object|reject_info: object[]|
|返回参数名称和类型|id: number |ad_id: string|
|新增返回参数|/|carousel_music_content<br>music_id`|
## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/ad/review_info/
**方法** GET
**Header**
```xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string|广告主ID |
|ad_ids {必填}|string[]|广告ID。最多可传100个|
|lang|string|语言|
示例
(code curl http)
curl --get -H "Access-Token:xxx" \
--data-urlencode "advertiser_id={{ADVERTISER_ID}}" \
--data-urlencode "ad_ids=[\"AD_IDS\"]" \
--data-urlencode "lang=[\"LANG\"]" \
https://business-api.tiktok.com/open_api/v1.3/ad/review_info/
(/code)
返回
|字段{30%}|类型{12%}|描述{58%}|
|---|---|---|
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)|
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)|
|data |object|返回数据 |
#|ad_review_map |object|广告层级审核信息。|
##|ad_id|string|广告 ID。|
##|is_approved |boolean|是否审核通过|
##|review_status |string|广告审核状态 <br>枚举值：<ul><li>`ALL_AVAILABLE`：广告审核已完成，该广告可用于投放。</li><li>`PART_AVAILABLE`：广告审核已完成，该广告仅可用于投放部分定向的国家。</li><li>`UNAVAILABLE`：广告审核已完成，该广告不可用于投放。</li></ul>|
##|appeal_status {-即将废弃}|string|申诉状态。<br><br><p><span style="color:darkred"><b>注意</b></span>：本字段的值始终为 null。|
##|forbidden_placements|string[]|未过审投放版位。<br>枚举值参见[枚举值-版位](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)|
##|forbidden_ages|string[]|未过审受众年龄区间。<br>枚举值参见[枚举值-受众年龄区间](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)|
##|forbidden_locations |string[]|未过审国家或地区定向。<br>枚举值参见[附录-地区代码](https://ads.tiktok.com/marketing_api/docs?id=1737585867307010) |
##|forbidden_operation_systems|string[]|未过审操作系统。<br>枚举值参见[枚举值-受众操作系统](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)|
##|last_audit_time|string|<p><span style="color:darkred"><b>注意</b></span>：本字段的值始终为 null。<br>广告最后一次审核时间。|
##|reject_info |object[]|审核拒绝的具体信息|
###|suggestion|string|审核建议|
###|reasons|string[]|审核拒绝理由，可能有多个|
###|forbidden_ages|string[]|未过审受众年龄区间。<br>枚举值参见[枚举值-受众年龄区间](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)|
###|forbidden_locations |string[]|未过审国家或地区定向。<br>枚举值参见[附录-地区代码](https://ads.tiktok.com/marketing_api/docs?id=1737585867307010) |
###|forbidden_placements|string[]|未过审投放版位。<br>枚举值参见[枚举值-版位](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)|
###|content_info|object|审核素材内容|
####|image_content|object|审核图片内容|
#####|image_id|string|审核图片ID|
####|video_content|object|审核视频内容|
#####|video_id|string|审核视频ID|
####|text_content|string|审核标题内容|
####|content_type|string|审核素材类型，<br>枚举值：`MODE_STRING`，`MODE_IMAGE`，`MODE_VIDEO`，`MODE_CAROUSEL_MUSIC`（轮播广告中的音乐）。|
####| carousel_music_content | object | 仅当 `content_type` 为 `MODE_CAROUSEL_MUSIC` 时返回。 <br>已审核的轮播广告中音乐的内容。 |
#####| music_id | string | 轮播广告中使用的音乐的ID。 |
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "LOG_ID",
"data": {
"ad_review_map": {
"AD_ID": {
"reject_info": [
{
"content_info": {
"text_content": null,
"content_type": "MODE_VIDEO",
"image_content": {
"image_id": "IMAGE_ID"
},
"video_content": {
"video_id": "VIDEO_ID",
}
},
],
"suggestion": "Please add background audio or modify the unclear audio. For more policy details, please check \" Ad Caption/Text, Image and Video\" in \"TikTok Advertising Policies - Ad Creatives\".",
"reasons": [
"The ad or video has no background audio or the background audio is incoherent/unclear. "
]
}
],
"is_approved": true,
"last_audit_time": 1596023135,
"forbidden_placements": [
"PLACEMENT_HELO",
"PLACEMENT_TIKTOK",
"PLACEMENT_TOPBUZZ"
],
"ad_id": AD_ID,
"review_status": "PART_AVAILABLE",
"appeal_status": null,
"forbidden_locations": [
"RU"
],
"forbidden_operation_systems": [
"IOS"
],
"forbidden_ages": [
]
}
}
}
}
(/code);