获取升级版 Smart+ 广告的审核信息
调用此接口可获取升级版 Smart+ 广告（包括其中的创意素材）的审核结果。
广告在投放前需先通过审核。若未通过，原因可能包括广告位或定向选择不当等。可依据被拒原因和相关建议，调用 /smart_plus/ad/update/ 接口对广告进行相应修改。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/smart_plus/ad/review_info/
方法 GET
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|advertiser_id {必填}|string|广告主 ID。|
|smart_plus_ad_ids {必填}|string[]|广告 ID 列表。<br><br>最大数量：100。<br><br>若想获取广告 ID，需使用 [/smart_plus/ad/get/](1843317378982914.html) 接口。|
|lang|string|`reject_info` 对象数组中返回的 `reasons`、`suggestion` 和 `specification` 的语言代码。<br><br>枚举值参见<a href="#item-link-lang的值列表 "> `lang`的值列表</a>。<br><br>默认值：`en`。|
|extra_info_setting|object|其他设置。|
#|include_reject_info|boolean|是否包含被拒原因。<br><br>支持的值：`true`、`false`。<br><br>默认值：`false`。|
#|include_violation_frame|boolean|是否包含已标记为违规的视频帧。<br><br>支持的值：`true`、`false`。<br><br>默认值：`false`。<br><br><p><span style="color:darkred"><b>注意</b></span>：仅当 `include_reject_info` 为 `true` 时，才可设此字段为 `true`。|
lang的值列表
下表概括了 lang 的枚举值。
|语言代码 (<code>lang</code>){30%}|语言{70%}|
|---|---|
|`ar`|阿拉伯语|
|`cs-CZ`|捷克语|
|`de`|德语|
|`en`|英语|
|`es`|西班牙语|
|`fr`|法语|
|`id`|印尼语|
|`it`|意大利语|
|`ja`|日语|
|`ko`|韩语|
|`ms`|马来语|
|`pl-PL`|波兰语|
|`pt-BR`|葡萄牙语（巴西）|
|`ru`|俄语|
|`sv-SE`|瑞典语|
|`th`|泰语|
|`tr`|土耳其语|
|`vi`|越南语|
|`zh`|简体中文|
示例
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/ad/review_info/?advertiser_id={{advertiser_id}}&smart_plus_ad_ids=["{{smart_plus_ad_ids}}"]&extra_info_setting={"include_reject_info": true, "include_violation_frame": true}' \
--header 'Access-Token: {{Access-Token}}'
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code|number|返回码。完整返回码列表及描述参见[附录 - 返回码](1737172488964097.html)。|
|message|string|返回信息。更多信息参见[附录 - 返回码](1737172488964097.html)。|
|request_id|string|请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|
#|smart_plus_ad_review_infos|object[]|广告审核结果详情。|
##|smart_plus_ad_id|string|广告 ID。|
##|review_status|string|广告审核状态。<br><br>枚举值：<ul><li>`ALL_AVAILABLE`：广告已完成审核，可以投放到所有指定的定向国家/地区。</li><li>`PART_AVAILABLE`：广告已完成审核，只能投放到部分指定的定向国家/地区。</li><li>`UNAVAILABLE`：广告已完成审核，不能投放。</li></ul>|
##|passed_locations|string[]|通过审核的定向地区。<br><br>枚举值参见[附录 - 地区代码](1737585867307010.html)。|
##|appeal_status|string|广告申诉状态。<br><br>枚举值：<ul><li>`NOT_APPEALED`：申诉未提交。</li><li>`APPEALING`：申诉正在处理中。</li><li>`APPEAL_SUCCESSFUL`：申诉成功。</li><li>`APPEAL_FAILED`：申诉失败。</li><li>`APPEAL_DONE`：申诉已经过再次审核。要确认申诉是成功还是失败，查看 `review_status` 值。</li></ul>|
##|appeal_reject_reasons|string[]|申诉被拒的原因。|
##|reject_info|object[]|审核未通过详情。|
###|reasons|string[]|广告未通过审核的原因。|
###|suggestion|string|审核建议。|
###|forbidden_ages|string[]|未通过审核的年龄组。<br><br>枚举值参见[枚举值 - 年龄组](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-受众年龄区间)。|
###|forbidden_locations|string[]|未通过审核的定向地区的代码。<br><br>枚举值参见[附录 - 地区代码](1737585867307010.html)。|
###|forbidden_placements|string[]|未通过审核的广告位。<br><br>枚举值参见[枚举值 - 广告位](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-版位)。|
###|content_info|object|被拒内容详情。|
####|content_type|string|内容类型。<br><br>枚举值：<ul><li>`ModeString`：字符串。</li><li>`ModeImage`：图片。</li><li>`ModeVideo`：视频。</li><li>`ModeMusic`：轮播中将使用的音乐。</li><li>`LandingPage`：落地页。</li><li>`ModeCollection`：系列收藏。</li><li>`ModePhotoPost:` TikTok 照片帖子。</li></ul>|
####|text_content|string|被拒的文案。|
####|image_content|object|被拒的图片内容。|
#####|image_id|string|图片的 ID。|
####|video_content|object|被拒的视频内容。|
#####|video_id|string|视频的 ID。|
####|carousel_music_info|object|轮播中被拒的音乐内容。|
#####|music_id|string|音乐的 ID。|
###|violation_frames|object[]|仅当请求中的 `include_violation_frame` 设置为 `true` 时才会返回。<br><br>已标记为违规的视频帧详情。|
####|type|string|帧的类型。|
####|video_id|string|视频 ID。|
####|web_url_list|string[]|标记为违规的图片 URL 或落地页 URL 列表。|
####|violation_frame_material_type|string|帧中被视为违规项的创意素材的类型。<br><br>枚举值：<ul><li>`DOWNLOAD URL`：下载 URL。</li><li>`EXTERNAL_URL`：落地页 URL。</li><li>`INSTANT_PAGE`：TikTok 即时体验页面。</li><li>`LEAD_GENERATION`：即时表单。</li><li>`OPEN_URL`：深度链接。</li><li>`VIDEO`：视频。</li><li>`UNSET`：其他。</li></ul>|
###|specification|string|自动生成的被拒原因摘要。|
###|video_violation_frames|object[]|标记为违规的图片详情。|
####|web_url|string|发生违规的具体帧的图片 URL。|
####|hover_periods|string[]|悬停图片中发生违规的时间段列表。|
####|thumbnail_periods|string[]|视频封面中发生违规的时间段列表。|
#|material_review_infos|object[]|关于创意素材审核结果的信息。|
##|ad_material_id|string|某个创意被用于广告时生成的、与该广告相对应的素材 ID。<br><br>该 ID 不同于创意素材上传至广告账号的创意素材库时获得的创意 ID。<br><br><font color="darkred"><b>注意</b></font>：对于轮播素材，此 ID 标识轮播中的某一张图片，而来自 [/smart_plus/ad/get/](1843317378982914.html) 的 `ad_material_id` 则标识整个轮播素材。|
##|smart_plus_ad_id|string|广告 ID。|
##|review_status|string|创意素材审核状态。<br><br>枚举值：<ul><li>`ALL_AVAILABLE`：创意素材已完成审核，可以投放到所有指定的定向国家/地区。</li><li>`PART_AVAILABLE`：创意素材已完成审核，只能投放到部分指定的定向国家/地区。</li><li>`UNAVAILABLE`：创意素材已完成审核，不能投放。</li></ul>|
##|passed_locations|string[]|通过审核的定向地区。<br><br>枚举值参见[附录 - 地区代码](1737585867307010.html)。|
##|reject_info|object[]|审核未通过详情。|
###|reasons|string[]|广告未通过审核的原因。|
###|suggestion|string|审核建议。|
###|forbidden_ages|string[]|未通过审核的年龄组。<br><br>枚举值参见[枚举值 - 年龄组](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-受众年龄区间)。|
###|forbidden_locations|string[]|未通过审核的定向地区的代码。<br><br>枚举值参见[附录 - 地区代码](1737585867307010.html)。|
###|forbidden_placements|string[]|未通过审核的广告位。<br><br>枚举值参见[枚举值 - 广告位](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-版位)。|
###|content_info|object|被拒内容详情。|
####|content_type|string|内容类型。<br><br>枚举值：<ul><li>`ModeString`：字符串。</li><li>`ModeImage`：图片。</li><li>`ModeVideo`：视频。</li><li>`ModeMusic`：轮播中将使用的音乐。</li><li>`LandingPage`：落地页。</li><li>`ModeCollection`：系列收藏。</li><li>`ModePhotoPost:` TikTok 照片帖子。</li></ul>|
####|text_content|string|被拒的文案。|
####|image_content|object|被拒的图片内容。|
#####|image_id|string|图片的 ID。|
####|video_content|object|被拒的视频内容。|
#####|video_id|string|视频的 ID。|
####|carousel_music_info|object|轮播中被拒的音乐内容。|
#####|music_id|string|音乐的 ID。|
###|violation_frames|object[]|仅当请求中的 `include_violation_frame` 设置为 `true` 时才会返回。<br><br>已标记为违规的视频帧详情。|
####|type|string|帧的类型。|
####|video_id|string|视频 ID。|
####|web_url_list|string[]|标记为违规的图片 URL 或落地页 URL 列表。|
####|violation_frame_material_type|string|帧中被视为违规项的创意素材的类型。<br><br>枚举值：<ul><li>`DOWNLOAD URL`：下载 URL。</li><li>`EXTERNAL_URL`：落地页 URL。</li><li>`INSTANT_PAGE`：TikTok 即时体验页面。</li><li>`LEAD_GENERATION`：即时表单。</li><li>`OPEN_URL`：深度链接。</li><li>`VIDEO`：视频。</li><li>`UNSET`：其他。</li></ul>|
###|specification|string|自动生成的被拒原因摘要。|
###|video_violation_frames|object[]|标记为违规的图片详情。|
####|web_url|string|发生违规的具体帧的图片 URL。|
####|hover_periods|string[]|悬停图片中发生违规的时间段列表。|
####|thumbnail_periods|string[]|视频封面中发生违规的时间段列表。|
示例
(code Success-Response http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"material_review_infos": [
{
"ad_material_id": "{{ad_material_id}}",
"passed_locations": null,
"reject_info": null,
"review_status": "ALL_AVAILABLE",
"smart_plus_ad_id": "{{smart_plus_ad_id}}"
},
{
"ad_material_id": "{{ad_material_id}}",
"passed_locations": null,
"reject_info": null,
"review_status": "ALL_AVAILABLE",
"smart_plus_ad_id": "{{smart_plus_ad_id}}"
}
],
"smart_plus_ad_review_infos": [
{
"appeal_reject_reasons": null,
"appeal_status": "NOT_APPEALED",
"passed_locations": null,
"reject_info": [],
"review_status": "ALL_AVAILABLE",
"smart_plus_ad_id": "{{smart_plus_ad_id}}"
}
]
}
}
(/code)