设置或更新广告账户的品牌安全中心设置

您可以使用本接口设置或更新广告账户的品牌安全中心设置。

品牌安全中心允许您定义默认的广告账户层级的第一方品牌安全设置，包括 TikTok 库存筛选和适用性控制措施，例如类别排除和行业敏感内容。

注意
目前，通过品牌安全 API 配置的设置将自动应用于新创建的 Smart+ 推广系列，但不会应用于使用 /campaign/create/ 新创建的普通推广系列。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/tiktok_inventory_filters/update/

方法 POST

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| advertiser_id {必填} | string | 广告主ID。 |
| cover_all_ad_objectives  {必填} | boolean | 是否将品牌安全设置（`brand_safety_type`、`category_exclusion_ids` 和 `vertical_sensitivity_id`）应用于所有推广目标。<br><br>支持的值: <ul><li>`true`：将品牌安全设置应用于所有目标，包括覆盖人数、视频播放量、社区互动、访问量、应用推广、线索收集、网站转化量和商品销量。</li><li>`false`：仅将品牌安全设置应用于覆盖人数、视频播放量和社区互动目标。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>: 本字段设置为 `true` 后，不允许更新为 `false`。</p> |
| brand_safety_type | string | 库存筛选等级。<br>所选等级将应用于“推荐”、“关注”、“个人资料页”和“搜索”推荐内容（广告会显示在要查看的搜索结果旁）的广告位。<br><br>枚举值: <ul><li>`EXPANDED_INVENTORY`：扩展库存。您的广告不会展示在明显不适当的内容前后，但可能会展示在成人主题内容前后。</li><li>`STANDARD_INVENTORY`：标准库存。您的广告将展示在适合大多数品牌的内容前后。</li><li>`LIMITED_INVENTORY`：有限库存。您的广告不会展示在包含成人主题的内容前后。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>: 若想更新品牌安全设置，您需同时传入 `brand_safety_type`、`category_exclusion_ids` 和 `vertical_sensitivity_id`。</p> |
| category_exclusion_ids | string[] | 仅当 `brand_safety_type` 为 `STANDARD_INVENTORY` 或 `LIMITED_INVENTORY` 时生效。<br><br>不希望在您的广告前后显示的内容排除类别 ID 列表。<br><br>若想获取内容排除类别 ID 列表，可使用 [/tool/content_exclusion/get/](1769738074686465.html) 并查看返回的 `excluded_category_list`。<br><br><p><span style="color:darkred"><b>注意</b></span>: 目前，商品销量暂不支持类别排除。</p> |
| vertical_sensitivity_id | string | 仅当 `brand_safety_type` 为 `STANDARD_INVENTORY` 或 `LIMITED_INVENTORY` 时生效。<br><br>不希望在您的广告前后显示的行业敏感内容类别的 ID。<br><br>若想获取行业敏感内容类别 ID 列表，可使用 [/tool/content_exclusion/get/](1769738074686465.html) 并查看返回的 `vertical_sensitivity_list`。<br><br><p><span style="color:darkred"><b>注意</b></span>: 目前，以下推广目标暂不支持行业敏感内容：访问量、应用推广、线索收集、网站转化量和商品销量。</p> |

示例

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/tiktok_inventory_filters/update/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "cover_all_ad_objectives": true,
    "brand_safety_type": "STANDARD_INVENTORY",
    "category_exclusion_ids": ["201"],
    "vertical_sensitivity_id": "1001"
}'
(/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)。 |
|request_id |string| 请求的日志 ID，唯一标识一个请求。 |
|data |object| 返回数据。 |
#| cover_all_ad_objectives | boolean | 是否将品牌安全设置（`brand_safety_type`、`category_exclusion_ids` 和 `vertical_sensitivity_id`）应用于所有推广目标。<br><br>支持的值: <ul><li>`true`：将品牌安全设置应用于所有目标，包括覆盖人数、视频播放量、社区互动、访问量、应用推广、线索收集、网站转化量和商品销量。</li><li>`false`：仅将品牌安全设置应用于覆盖人数、视频播放量和社区互动目标。</li></ul> |
#| brand_safety_type | string | 库存筛选等级。<br>所选等级将应用于“推荐”、“关注”、“个人资料页”和“搜索”推荐内容（广告会显示在要查看的搜索结果旁）的广告位。<br><br>枚举值: <ul><li>`EXPANDED_INVENTORY`：扩展库存。您的广告不会展示在明显不适当的内容前后，但可能会展示在成人主题内容前后。</li><li>`STANDARD_INVENTORY`：标准库存。您的广告将展示在适合大多数品牌的内容前后。</li><li>`LIMITED_INVENTORY`：有限库存。您的广告不会展示在包含成人主题的内容前后。</li></ul> |
#| category_exclusion_ids | string[] | 不希望在您的广告前后显示的内容排除类别 ID 列表。<br><br>若想根据类别 ID 获取内容排除类别的详细信息，可使用[/tool/content_exclusion/info/](1769738105333826.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>: 目前，商品销量暂不支持类别排除。</p> |
#| vertical_sensitivity_id | string | 不希望在您的广告前后显示的行业敏感内容类别的 ID。<br><br>若想根据类别 ID 获取行业敏感内容类别的详细信息，可使用[/tool/content_exclusion/info/](1769738105333826.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>: 目前，以下推广目标暂不支持行业敏感内容：访问量、应用推广、线索收集、网站转化量和商品销量。</p> |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "brand_safety_type": "STANDARD_INVENTORY",
        "category_exclusion_ids": [
            "201"
        ],
        "cover_all_ad_objectives": true,
        "vertical_sensitivity_id": "1001"
    }
}
(/code)