获取可用的内容排除类别
您可以使用本接口获取类别排除或行业敏感内容控制类型，避免其出现在您的广告附近。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/tool/content_exclusion/get/
方法 GET
Header
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string| 广告主ID。 |
|objective_type {必填}|string|推广目标。目前仅支持 `REACH`, `VIDEO_VIEWS` 和 `ENGAGEMENT`.|
|brand_safety_type|string|品牌安全类型。默认值： `NO_BRAND_SAFETY`. 枚举值：<ul><li>`NO_BRAND_SAFETY`: 不使用任何品牌安全解决方案，即使用<b>全部库存</b>。您的广告可能会在某些包含成人主题的内容周围展示。</li><li>`EXPANDED_INVENTORY`：使用TikTok的品牌安全解决方案，即使用<b>扩展库存</b>。您的广告将不会出现在不当内容或包含成人主题的内容后面。在下个API版本中`EXPANDED_INVENTORY`将替代`NO_BRAND_SAFETY`，并成为默认的品牌安全选项。<br><b><span style="color: darkred">注意</span></b> `EXPANDED_INVENTORY`目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。</li><li>`STANDARD_INVENTORY`: 使用TikTok的品牌安全解决方案中的<b>标准库存</b>。您的广告将展示在适合大多数品牌的内容周围。</li><li>`LIMITED_INVENTORY`: 使用TikTok的品牌安全解决方案中的<b>有限库存</b>。您的广告将展示在不包含成人主题的内容周围。<br><p><span style="color:darkred"><b>注意</b></span>: <li>若您想获取行业敏感内容控制类型ID，您仅可以使用`STANDARD_INVENTORY`或`LIMITED_INVENTORY`。</li><li>若您不在行业敏感内容控制的白名单，返回中的`vertical_sensitivity_list`将为null。</li>|
示例
(code curl http)
curl --location 'https://business-api.tiktok.com/open_api/v1.3/tool/content_exclusion/get/?advertiser_id={{advertiser_id}}&objective_type=VIDEO_VIEWS' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
(/code)
返回
|字段|类型|描述|
|---|---|---|
|code |number|返回码。完整返回码列表及描述，可见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|message |string|返回信息。更多信息可见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|request_id |string|请求的日志ID，唯一标识一个请求。 |
|data |object|返回数据。 |
#|excluded_category_list|object[]|内容排除类别列表。|
##|category_id|string|类别ID。|
##|category_name|string| 类别名称。|
##|supported_regions|string[]|类别支持的国家或地区代码。|
##|description|string|类别描述。|
##|category_type|string|类别种类。对于`excluded_category_list`，将返回`CATEGORY_TYPE_EXCLUSION`（内容排除类别）。 |
#|vertical_sensitivity_list|object[]|包含敏感内容的行业敏感内容控制类型。 |
##|category_id|string|类别ID。|
##|category_name|string|类别名称。|
##|supported_regions|string[]|支持某类别的国家或地区代码。|
##|description|string|类别描述。|
##|category_type|string|类别种类。对于`vertical_sensitivity_list`，将返回`CATEGORY_TYPE_VERTICAL`（行业敏感内容控制类别）。 |
示例
(code curl http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"excluded_category_list": [
{
"description": "YouthContentDescriptionKey",
"category_type": "CATEGORY_TYPE_EXCLUSION",
"supported_regions": [
"US",
"GB",
"AU",
"CA"
],
"category_id": "200",
"category_name": "Youth content"
},
{
"description": "CombatSportsDescriptionKey",
"category_type": "CATEGORY_TYPE_EXCLUSION",
"supported_regions": [
"US",
"GB",
"AU",
"CA"
],
"category_id": "201",
"category_name": "Combat sports"
},
{
"description": "ViolentVideoGamesDescriptionKey",
"category_type": "CATEGORY_TYPE_EXCLUSION",
"supported_regions": [
"US",
"GB",
"AU",
"CA"
],
"category_id": "202",
"category_name": "Violent video games"
},
{
"description": "GamblingDescriptionKey",
"category_type": "CATEGORY_TYPE_EXCLUSION",
"supported_regions": [
"US",
"GB",
"AU",
"CA"
],
"category_id": "203",
"category_name": "Gambling and lotteries"
}
],
"vertical_sensitivity_list": []
}
}
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"excluded_category_list": [
{
"category_type": "CATEGORY_TYPE_EXCLUSION",
"category_id": "200",
"category_name": "Youth content",
"description": "YouthContentDescriptionKey",
"supported_regions": [
"US",
"GB",
"AU",
"CA"
]
},
{
"category_type": "CATEGORY_TYPE_EXCLUSION",
"category_id": "201",
"category_name": "Combat sports",
"description": "CombatSportsDescriptionKey",
"supported_regions": [
"US",
"GB",
"AU",
"CA"
]
},
{
"category_type": "CATEGORY_TYPE_EXCLUSION",
"category_id": "202",
"category_name": "Violent video games",
"description": "ViolentVideoGamesDescriptionKey",
"supported_regions": [
"US",
"GB",
"AU",
"CA"
]
},
{
"category_type": "CATEGORY_TYPE_EXCLUSION",
"category_id": "203",
"category_name": "Gambling and lotteries",
"description": "GamblingDescriptionKey",
"supported_regions": [
"US",
"GB",
"AU",
"CA"
]
}
],
"vertical_sensitivity_list": [
{
"category_type": "CATEGORY_TYPE_VERTICAL",
"category_id": "1000",
"category_name": "Beauty",
"description": "This will exclude any content that TikTok deems as controversial or negative beauty-related patterns which may impact your campaign performance.",
"supported_regions": [
"US",
"GB",
"AU",
"CA"
]
},
{
"category_type": "CATEGORY_TYPE_VERTICAL",
"category_id": "1001",
"category_name": "Food",
"description": "This will exclude any content that TikTok deems as unhealthy food behaviors, body shaming, or graphic food content which may impact your campaign performance.",
"supported_regions": [
"US",
"GB",
"AU",
"CA"
]
},
{
"category_type": "CATEGORY_TYPE_VERTICAL",
"category_id": "1002",
"category_name": "Pets",
"description": "This will exclude any content that TikTok deems as unfair treatment to animals or pets, such as sensitive issues like animal testing, animal products used in fashion or pet illness, or demise-related content which may impact your campaign performance.",
"supported_regions": [
"US",
"GB",
"AU",
"CA"
]
}
]
}
}
(/code)