← 返回目录
📁 API Reference › Ad Review

获取广告组审核信息

您可以使用本接口获取广告组审核信息。

广告创建成功后，会进入到广告审核阶段。审核通过后的广告，才会正式开始进行投放。但是由于广告创建过程中的一些操作，比如版位选择不对，定向有问题等，可能会导致广告被拒审。您可以根据广告组拒审的理由、建议来及时调整您的广告组。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{18%}|v1.2{32%}|v1.3{50%}| |---|---|---| |接口路径| /v1.2/adgroup/review_info/| /v1.3/adgroup/review_info/| |请求参数类型|advertiser_id: number <br>adgroup_ids: number[]|advertiser_id: string<br>adgroup_ids: string[]| |新增请求参数|/|lang: string| |返回参数名称|is_pass(位于ad_review_map下)<br>is_pass(位于ad_group_review_map下) <br>has_rejected_ad|is_approved(位于ad_review_map下)<br>is_approved(位于ad_group_review_map下)<br>contains_rejected_ads| |返回参数类型|reject_info: object|reject_info: object[] | |返回参数名称和类型|id(位于ad_review_map下): number <br>id(位于ad_group_review_map下): number<br>reasons(位于ad_group_review_map下): string[]|ad_id(位于ad_review_map下): string <br>adgroup_id(位于ad_group_review_map下): string<br>reject_info(位于ad_group_review_map下): object[]| |新增返回参数|/|suggestion（位于对象ad_group_review_map下的reject_info)<br>reasons(位于对象ad_group_review_map下的reject_info)<br>forbidden_ages(位于对象ad_group_review_map下的reject_info中)<br>forbidden_locations(位于对象ad_group_review_map下的reject_info中)<br>forbidden_placements(位于对象ad_group_review_map下的reject_info中)<br>content_info（位于对象ad_group_review_map下的reject_info中)<br>image_content(位于对象ad_group_review_map下的content_info中)<br>image_id(位于对象ad_group_review_map下的image_content中)<br>video_content(位于对象ad_group_review_map下的content_info中)<br>video_id(位于对象ad_group_review_map下的video_content中)<br>text_content(位于对象ad_group_review_map下的content_info中)<br>content_type(位于对象ad_group_review_map下的content_info中)<br>carousel_music_content（位于对象ad_review_map下的content_info中）<br>music_id（位于对象ad_review_map下的content_info中）<br>carousel_music_content（位于对象ad_group_review_map下的content_info中）<br>music_id（位于对象ad_group_review_map下的content_info`中）|


## 请求

**地址**  https://business-api.tiktok.com/open_api/v1.3/adgroup/review_info/

**方法** GET

**Header**

```xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|

参数

|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string|广告主ID。 |
|adgroup_ids {必填}|string[]|广告组ID列表，目前最多支持传入20个广告组ID。|
|lang |string|语言。|

示例

(code curl http)
curl --get -H "Access-Token:xxx" \
--data-urlencode "advertiser_id={{ADVERTISER_ID}}" \
--data-urlencode "adgroup_ids=[\"ADGROUP_IDS\"]" \
https://business-api.tiktok.com/open_api/v1.3/adgroup/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|广告层级审核信息的二维字典，第一维key为`adgroup_id`，第二维key为`ad_id`。|
##|ad_id |string|广告 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：对于部分拒审或全部拒审的 Smart+ 广告组（`ad_group_review_map` 中的 `review_status` 为 `PART_AVAILABLE` 或 `UNAVAILABLE`），`ad_review_map` 中的 `ad_id` 并非实际的广告 ID，不可将其传入 [/ad/review_info/](1740559669226498.html) 用来获取广告层级的审核结果。您应将 `ad_id` 视作代表 Smart+ 推广系列中的一个素材。若想了解审核失败的详情，请查看 [/adgroup/review_info/](1740554277061634.html) 接口返回的 `ad_review_map`中的 `reject_info`，随后使用 [/campaign/spc/update/](1767334250066945.html) 更新 Smart+ 推广系列。|
##|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。   |
#|ad_group_review_map |object|广告组层级的审核信息字典，第一维key为`adgroup_id`。|
##|adgroup_id |number|广告组ID。|
##|is_approved |boolean|广告组是否审核通过。|
##|review_status |string|广告组审核状态。<br>枚举值：<ul><li>`ALL_AVAILABLE`：广告组审核已完成，该广告组内所有广告均可用于投放。</li><li>`PART_AVAILABLE`：广告组审核已完成，该广告组内部分广告可用于投放。</li><li>`UNAVAILABLE`：广告组审核已完成，该广告组内所有广告均不可用于投放。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：对于部分拒审或全部拒审的 Smart+ 广告组（`ad_group_review_map` 中的 `review_status` 为 `PART_AVAILABLE` 或 `UNAVAILABLE`），`ad_review_map` 中的 `ad_id` 并非实际的广告 ID，不可将其传入 [/ad/review_info/](1740559669226498.html) 用来获取广告层级的审核结果。您应将 `ad_id` 视作代表 Smart+ 推广系列中的一个素材。若想了解审核失败的详情，请查看 [/adgroup/review_info/](1740554277061634.html) 接口返回的 `ad_review_map`中的 `reject_info`，随后使用 [/campaign/spc/update/](1767334250066945.html) 更新 Smart+ 推广系列。|
##|appeal_status|string|广告组申诉状态。<br><br>枚举值参阅[枚举值-广告组审核申诉状态](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-广告组审核申诉状态)。<br><br>若想申诉未通过审核的广告组，可调用[/adgroup/appeal/](https://ads.tiktok.com/marketing_api/docs?id=1740571821728770)，随后本字段的值将显示为`APPEALING`（申诉中）。|
##|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>：仅当广告组未通过审核时，本字段才会显示实际审核的时间。<br>广告最后一次审核时间(UTC+0)，格式：`YYYY-MM-DD HH:MM:SS`。<br>示例：`2023-01-01 00:00:00`。|
##|contain_rejected_ads |boolean|是否存在被拒审的广告。|
##|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": "202102281027040101151761561F00ACF2",
    "data": {
        "ad_review_map": {
            "1673546290713654": {
                "1673546290714646": {
                    "reject_info": [
                        {
                            "content_info": {
                                "text_content": null,
                                "content_type": "MODE_VIDEO",
                                "image_content": {
                                    "image_id": "tos-maliva-p-0000/0ba31ad4244c48d3a61e42ea3f91649e"
                                },
                                "video_content": {
                                    "video_id": "v09033240000bj0mavbl96b18ntte85g",

                                }
                            },
                            "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. "
                            ],
                            "forbidden_locations": [
                                "RU"
                            ],
                        }
                    ],
                    "is_pass": true,
                    "last_audit_time": 1596023135,
                    "forbidden_placements": [
                        "PLACEMENT_HELO",
                        "PLACEMENT_TIKTOK",
                        "PLACEMENT_TOPBUZZ"
                    ],
                    "id": 1673546290714646,
                    "review_status": "PART_AVAILABLE",
                    "appeal_status": null,
                    "forbidden_locations": [
                        "RU"
                    ],
                    "forbidden_operation_systems": [
                        "IOS"
                    ],
                    "forbidden_ages": [
                        "AGE_13_17",
                        "AGE_18_24",
                        "AGE_25_34",
                        "AGE_35_44",
                        "AGE_45_54",
                        "AGE_55_100"
                    ]
                }
            }
        },
        "ad_group_review_map": {
            "1673546290713654": {
                "reasons": [
                    "some reason"
                ],
                "has_rejected_ad": true,
                "is_pass": true,
                "forbidden_placements": [
                    "PLACEMENT_TOPBUZZ",
                    "PLACEMENT_HELO",
                    "PLACEMENT_TIKTOK"
                ],
                "id": 1673546290713654,
                "review_status": "PART_AVAILABLE",
                "appeal_status": "NOT_APPEALED",
                "forbidden_locations": [
                    "RU"
                ],
                "forbidden_operation_systems": [
                    "IPHONE"
                ],
                "forbidden_ages": [
                    "AGE_35_44",
                    "AGE_45_54",
                    "AGE_55_100",
                    "AGE_13_17",
                    "AGE_18_24",
                    "AGE_25_34"
                ]
            }
        }
    }
}

(/code);
← 获取广告审核信息提出申诉 →

内容来源：TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了？
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →