← 返回目录
📁 API Reference › Reach & Frequency

更新覆盖和频次广告组

此接口可用于更新覆盖和频次广告组。

v1.2 与 v1.3 接口对比

下表概述了 v1.2 接口与 v1.3 接口之间的差异。 ``xtable |变更{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/adgroup/rf/update/|/v1.3/adgroup/rf/update/| |请求参数名称|age<br>operation_system<br>connection_type<br>device_price<br>rf_buy_type<br>buy_impression<br>buy_reach<br>display_mode|age_groups<br>operating_systems<br>network_types<br>device_price_ranges<br>rf_purchased_type<br>purchased_impression<br>purchased_reach<br>delivery_mode| |请求参数类型|advertiser_id: number<br>adgroup_id: number<br>schedule_id: number |advertiser_id: string<br>adgroup_id: string<br>schedule_id: string| |请求参数名称和类型|is_share_disable: number<br>is_comment_disable: number<br>audience: number[]<br>excluded_audience: number[]<br>location: number[]<br>device_models: number[]<br>carriers_v2: number[]<br>interest_category_v2: number[]|share_disabled: boolean<br>comment_disabled: boolean<br>audience_ids: string[]<br>excluded_audience_ids: string[]<br>location_ids: string[]<br>device_model_ids: string[]<br>carrier_ids: string[]<br>interest_category_ids: string[]| |v1.3 中已弃用的请求参数| /|estimate_key<br>is_draft| |新增请求参数 |/|contextual_tag_ids<br>brand_safety_type<br>category_exclusion_ids| |v1.3 中已弃用的返回参数| /|need_audit| |返回参数| /|在 v1.3 中，现会返回广告实体的完整信息。如需了解详细信息，参见本页面的“返回”小节。| |新增返回参数 |/|contextual_tag_ids<br>category_exclusion_ids`|


## 请求

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

**方法** POST

**Header**

``` xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {必填}|string|请求信息类型<br data-tomark-pass>允许格式：`"application/json"`  |

参数

| 字段 | 类型 | 描述 |
| --- | --- | --- |
| advertiser_id {必填} | string | 广告主 ID |
| adgroup_id {必填} | string | 要修改的广告组 ID。广告组所属推广系列的 `objective_type` 必须为 `RF_REACH`。 |
|share_disabled|boolean|是否禁止将此广告组中的广告分享到第三方平台。|
| adgroup_name| string | 广告组的名称。不得超过 100 个字符或包含任何表情符号。 |
| comment_disabled | boolean | 是否禁止用户在 TikTok 上对你的广告发表评论。 |
|audience_ids | string[]|你希望定向的受众的 ID。对于要在覆盖和频次广告中定向或排除的受众，你必须在创建或更新受众时将 `audience_sub_type` 设置为 `REACH_FREQUENCY`。 <br><p><span style="color:darkred"><b>注意</b></span>：<br>不可在覆盖和频次广告中使用相似受众。否则系统将报错。 |
|excluded_audience_ids|string[]|你希望排除的受众 ID。对于要在覆盖和频次广告中定向或排除的受众，你必须在创建或更新受众时将 `audience_sub_type` 设置为 `REACH_FREQUENCY`。 <br><p><span style="color:darkred"><b>注意</b></span>：<br>不可在覆盖和频次广告中使用相似受众。否则系统将报错。 |
|age_groups| string[] | 受众年龄范围。<br><br>如果你的定向地域包含以色列或巴西，无法使用 `AGE_13_17`。<br><br>枚举值参见[附录 - 枚举值 - 受众年龄范围](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。<br><br>在某些情况下，不允许创建针对美国 13-17 岁年龄组受众 (`AGE_13_17`) 定向投放的广告组。如需了解更多信息，参见 [TikTok 广告的新年龄限制](1788755983247362.html)。<br>如果你使用不支持美国 13-17 岁年龄组受众的定向选项，且不传入 `age_groups` 字段或将其设置为 `[]`，系统将报错。你需要明确传入希望定向的具体年龄组，例如 `AGE_18_24`，以避免出错。   |
|gender| string | 定向性别。枚举值参见[附录 - 枚举值 - 受众性别](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。 |
|languages| string[] | 受众语言。<br data-tomark-pass>可用的值：参见[附录 - 枚举值 - 受众语言](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。 |
|location_ids| string[] |  定向地域的 ID。地域可为国家或地区层级、省/州层级、DMA（指定市场区域）或大都市区域层级，或城市层级。<br>地域定向仅支持单一国家或地区。 如果要定向多个地域，这些地域必须位于同一个国家或地区。<br>你可以在[覆盖和频次](https://ads.tiktok.com/marketing_api/docs?id=1738235311704065)中查看支持的国家和地区。   |
|is_hfss| boolean | 是否推广 HFSS 食品（高脂、高盐或高糖食品）。<span style="color:#f40909">请注意，禁止在欧洲市场面向未成年人推广 HFSS 食品。</span>  |
|operating_systems | string[] | 操作系统。参见[附录 - 枚举值 - 受众操作系统](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。 |
|network_types |string[]| 你希望定向的设备连接类型。默认值：`unlimited`。枚举值参见[枚举值 - 网络类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
|device_model_ids| string[]| 你希望定向的设备型号的 ID。目前仅支持品牌层级的型号 ID。如果传入此字段，不得传入 `device_price_ranges`。如需了解不同层级的设备型号 ID 的枚举值，参见[设备型号](https://ads.tiktok.com/marketing_api/docs?id=1737172880570369)。 <br><p><span style="color:darkred"><b>注意</b></span>：仅活跃设备（[/tool/device_model/](https://ads.tiktok.com/marketing_api/docs?id=1737172880570369) 接口的返回结果中 `is_active` = `True`）可用于创建广告组。|
|device_price_ranges |number[]|定向设备价格范围。10,000 表示 1,000 以上。数字必须为 50 的倍数。<br><b><span style="color: darkred">重要说明</span></b>：系统会在你设置的上限基础上再加 50，并将所得的新数值用作设备定向的实际上限。实际上限会在 TikTok 广告管理平台的广告组设置中显示。如果你设置的价格范围为 [0, 250]，系统实际上会按 [0, 300] 处理。|
|carrier_ids|string[]| 你希望定向的运营商。仅当运营商的 `in_use` 字段为 `true` 时，运营商才生效。运营商必须与你希望定向的 location(s) 保持一致。枚举值 (`carrier_id`) 参见[附录 - 运营商](https://ads.tiktok.com/marketing_api/docs?id=1737168013095938)。 |
|interest_category_ids |string[]|兴趣类别。如果传入兴趣，在投放期间将排除不符合该兴趣目标的用户。若想针对所有用户定向投放，无需传入此字段。使用 [/tool/target_recommend_tags/](https://ads.tiktok.com/marketing_api/docs?id=1736275204260866) 接口获取根据你的定向地区和行业推荐的兴趣类别列表。使用 [/tool/interest_category/](https://ads.tiktok.com/marketing_api/docs?id=1737174348712961) 接口获取兴趣类别的完整列表。|
| rf_purchased_type| string | 购买类型。允许的值： <ul><li>`FIXED_SHOW`：按固定展示量购买。</li><li>`FIXED_REACH`：按固定用户覆盖人数购买。</li><li>`FIXED_BUDGE`：按固定预算购买。</li></ul> |
|budget| float | 预算。请根据广告库存预估 API 返回的数据填写此数值。 |
|purchased_impression| number | 要购买的展示量，<b>单位：1,000</b>。请根据广告库存预估 API 返回的数据填写此数值。 |
|purchased_reach| number | 要购买的用户覆盖人数，<b>单位：1,000</b>。请根据库存预估结果填写此数值。 |
| schedule_start_time  | string | 排期开始时间 (UTC+0)，格式为  `YYYY-MM-DD HH:MM:SS`。<br><br>`schedule_start_time` 和 `schedule_end_time` 之间的间隔不得超过 90 天。<br><br>此字段的值必须采用 `YYYY-MM-DD HH:00:00`  格式，且时间应以广告投放市场所在的时区为准。<br>例如，如果位于 UTC-5 时区的广告主希望创建在 2023 年 11 月 1 日开始投放的覆盖和频次广告组，此字段必须设置为 `"2023-11-01 05:00:00"`。|
| schedule_end_time | string | 排期结束时间 (UTC+0)，格式为 `YYYY-MM-DD HH:MM:SS`。<br><br>`schedule_start_time` 和 `schedule_end_time` 之间的间隔不得超过 90 天。<br><br>此字段的值必须采用 `YYYY-MM-DD HH:59:59`  格式，且时间应以广告投放市场所在的时区为准。<br>例如，如果位于 UTC-5 时区的广告主希望创建在 2023 年 11 月 10 日结束投放的覆盖和频次广告组，此字段必须设置为 `"2023-11-10 04:59:59"`。|
| frequency | number | `frequency` 和 `frequency_schedule` 共同决定用户看到你的广告的频率（仅适用于采用 `REACH` 推广目标的广告）。<br>例如，`frequency` = 2 & `frequency_schedule` = 3 表示“每 3 天展示广告的次数不超过两次”。<br>应同时满足以下条件：<ul><li>1 ≤ `frequency` ≤ `frequency_schedule`。</li><li>1 ≤ `frequency_schedule` ≤ min (`schedule_end_time` - `schedule_start_time`, 30)。</li><li>频次上限由 `frequency` 和 `frequency_schedule` 共同决定，不得超过每天 4 次。</li></ul> |
| frequency_schedule | number | `frequency_schedule` 和 `frequency` 共同决定用户看到你的广告的频率（仅适用于采用 `REACH` 推广目标的广告）。如需了解更多信息，参见 `frequency` 字段。 |
|feed_type |string| 信息流类型选项。枚举值：`STANDARD_FEED`、`TOP_FEED`。`STANDARD_FEED` 指库存量大且 CPM 价格正常的信息流，`TOP_FEED` 指库存有限且 CPM 价格更高的信息流。 |
|delivery_mode |string|  用于排序和排定广告投放的策略。<br><br>枚举值：<ul><li>`STANDARD`：标准投放。你的广告将均匀投放，预计会获得大致相同的访问量。<ul><li>当 `optimization_goal` 为 `REACH` 且 `cpv_video_duration` 为 `SIX_SECONDS` 时，此值不适用于 6 秒完播率 (View+) 优化目标。</li></ul></li><li>`SCHEDULE`：按排期投放。设置投放每个广告的特定时间段。如果使用此值，需要同时传入对象数组 `schedules`。</li><li>`SEQUENCE`：按顺序投放。设置特定的广告投放顺序。如果使用此值，需要同时传入字段 `expected_orders`。</li><li>`VIEW_OPTIMIZE`：针对播放量优化投放。你的广告将按能最大限度提升完播率 (VTR) 的方式进行投放，系统会将更多展示量分配给预估 VTR 更高的广告。<ul><li>当 `optimization_goal` 为 `REACH` 且 `cpv_video_duration` 为 `SIX_SECONDS` 时，此值仅适用于 6 秒完播率 (View+) 优化目标。</li></ul></li><li>`OPTIMIZE`：经过优化的投放，旨在实现最佳广告效果。</li></ul>|
|schedule_infos |object[]| 广告投放信息。  <br><br>当 `delivery_mode` 设置为 `SEQUENCE` 时，此数组中的对象数量表示你将传入顺序的广告的数量。 |
#|schedules {+条件必填} |object[]| 当 `delivery_mode` 设置为 `SCHEDULE` 时必填。<br><br>你希望为广告设置的按排期投放的详细信息。<br><br>确保排期连续，并覆盖通过 `schedule_start_time` 和 `schedule_end_time` 传入的整个投放期。|
##|start_time |string| 广告投放开始时间，格式为 `"YYYY-MM-DD HH:MM:SS"`。 |
##|end_time |string| 广告投放结束时间，格式为 `"YYYY-MM-DD HH:MM:SS"`。 |
#|expected_orders {+条件必填} |number[]| 当 `delivery_mode` 设置为 `SEQUENCE` 时必填。  <br><br>广告组内某个广告的投放顺序。<br><br>若想为广告组中的每个广告设置固定投放顺序，需仅向此字段传入一个数字（例如 `[1]`）。值为 `[1]` 表示该广告将第一个投放。 |
|contextual_tag_ids |string[]|内容标签 ID。你可以使用 [/tool/contextual_tag/get/](https://ads.tiktok.com/marketing_api/docs?id=1747747118654465) 接口获取可用的内容标签。 <br><p><span style="color:darkred"><b>注意</b></span>： <ul><li> 此功能目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。 </li><li>仅支持在推广系列层级将 `RF_REACH` 设置为推广目标 (`objective_type`)。 </li><li>当 `brand_safety_type` 设置为 `THIRD_PARTY` 时，不支持该字段。</li><li>当 `feed_type` 设置为 `TOP_FEED` 时，不支持该字段。</li><li>如果在 [/campaign/create/](https://ads.tiktok.com/marketing_api/docs?id=1739318962329602) 中将 `rf_campaign_type` 设置为 `PULSE`，必须在此字段中输入 `PREMIUM` 类型的内容标签。在这种情况下，广告组的 CPM 是固定的。 </li></ul> |
|brand_safety_type|string|如需了解更新此字段的资格条件，参见[更新出价前品牌安全筛选设置的条件]()。<br><br>品牌安全类型。<br><br>枚举值： <ul><li>`EXPANDED_INVENTORY`：使用 TikTok 品牌安全解决方案。使用扩展库存，意味着你的广告将展示在已移除大部分不当内容、不包含成人主题的内容前后。在下一个 API 版本中，`EXPANDED_INVENTORY` 将替代 `NO_BRAND_SAFETY`，并成为默认的品牌安全选项。</li><li>`STANDARD_INVENTORY`：使用 TikTok 品牌安全解决方案。使用标准库存，意味着你的广告将展示在适合大多数品牌的内容前后。 </li><li>`LIMITED_INVENTORY`：使用 TikTok 品牌安全解决方案。使用有限库存，意味着你的广告将不会展示在包含成人主题的内容前后。</li></ul> 若想获取在你的品牌安全设置下可投放广告的国家和地区，需使用 [/tool/region/](https://ads.tiktok.com/marketing_api/docs?id=1737189539571713) 接口。 <br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>更新品牌安全设置（包括 `brand_safety_type`、`category_exclusion_ids` 和 `vertical_sensitivity_id`）目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li><li> 如需了解支持的推广目标、市场以及出价前品牌安全筛选功能的简要介绍，参见[品牌安全](https://ads.tiktok.com/marketing_api/docs?id=1739381752981505)。 </li></ul>|
|category_exclusion_ids|string[]|仅当满足以下任意条件时，才能更新此字段： <ul><li>广告组尚未达到 `schedule_start_time`。 </li><li>广告组已达到 `schedule_start_time`，但 `operation_status` 为 `DISABLE` 且消耗为 0。若想获取广告组的 `schedule_start_time` 和 `operation_status`，需使用 [/adgroup/get/](1739314558673922.html) 接口。 </li></ul>  <br>内容排除类别 ID。<br><br>你可以使用 [/tool/content_exclusion/get/](1769738074686465.html) 接口获取你的广告可不在其前后展示的内容类别 ID 列表 (`excluded_category_list`)。<br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>更新品牌安全设置（包括 `brand_safety_type`、`category_exclusion_ids` 和 `vertical_sensitivity_id`）目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li></ul>|

示例

(code curl http)
curl -H "Access-Token:xxx" -H "Content-Type:application/json" -X POST \
-d '{
 "languages": [
 "LANGUAGES"
 ], 
 "buy_impression": "BUY_IMPRESSION", 
 "is_comment_disable": "IS_COMMENT_DISABLE", 
 "gender": "GENDER", 
 "age": [
 "AGE"
 ], 
 "frequency_schedule": "FREQUENCY_SCHEDULE", 
 "budget": "BUDGET", 
 "rf_buy_type": "RF_BUY_TYPE", 
 "advertiser_id": "ADVERTISER_ID", 
 "frequency": "FREQUENCY", 
 "location": [
 "LOCATION"
 ], 
 "schedule_end_time": "SCHEDULE_END_TIME", 
 "request_id": "REQUEST_ID", 
 "operation_system": [
 "OPERATION_SYSTEM"
 ], 
 "buy_reach": "BUY_REACH", 
 "adgroup_name": "ADGROUP_NAME", 
 "adgroup_id": "ADGROUP_ID", 
 "schedule_start_time": "SCHEDULE_START_TIME"
}' \
https://business-api.tiktok.com/open_api/v1.3/adgroup/rf/update/
(/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|返回数据 |
#| advertiser_id  | string | 广告主 ID。 |
#| campaign_id | string | 广告组所属的推广系列。 |
#| adgroup_id | string | 广告组 ID。 |
#|share_disabled|boolean|是否禁止将此广告组中的广告分享到第三方平台。默认值：`False`。|
#| adgroup_name  | string | 广告组的名称。不得超过 100 个字符或包含任何表情符号。 |
#|promotion_type |string| 推广类型，你可以使用此字段来选择商品推广的投放位置。枚举值：`APP_ANDROID`、`APP_IOS`、`WEBSITE`、`WEBSITE_OR_DISPLAY`。|
#|optimization_event |string|广告组的转化事件。如果推广对象是带有监测 URL 的应用，此为必填字段。如需了解支持的应用事件，参见[转化事件](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889)。你可以使用 [/app/external_action/](https://ads.tiktok.com/marketing_api/docs?id=1740859338750977) 接口查看你的应用支持的事件。 |
#| app_id | string | 所推广手机应用的 ID。 |
#| comment_disabled | boolean | 是否禁止用户在 TikTok 上对你的广告发表评论。默认值：`False`。 |
#|audience_ids | string[]|你希望定向的受众的 ID。对于要在覆盖和频次广告中定向或排除的受众，你必须在创建或更新受众时将 `audience_sub_type` 设置为 `REACH_FREQUENCY`。 |
#|excluded_audience_ids|string[]|你希望排除的受众 ID。对于要在覆盖和频次广告中定向或排除的受众，你必须在创建或更新受众时将 `audience_sub_type` 设置为 `REACH_FREQUENCY`。|
#| age_groups| string[] | 你希望定向的年龄组。如果你的定向地域包含以色列或巴西，无法使用 `AGE_13_17`。枚举值参见[枚举值 - 受众年龄区间](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。 |
#| gender | string | 受众性别。枚举值参见[枚举值 - 受众性别](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。  |
#| languages | string[] | 你希望定向的语言的代码。支持的语言代码列表参见[枚举值 - 语言代码](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。  |
#| location_ids  | string[] | 定向地域的 ID。如果要定向多个地域，这些地域必须位于同一个国家或地区。你可以在[覆盖和频次](https://ads.tiktok.com/marketing_api/docs?id=1739470723315713)中查看支持的国家和地区。如需获取地域 ID 列表，参见[地域 ID](https://ads.tiktok.com/marketing_api/docs?id=1701890989574146)。|
#| is_hfss | boolean | 是否推广 HFSS 食品（高脂、高盐或高糖食品）。<span style="color:#f40909">请注意，禁止在欧洲市场面向未成年人推广 HFSS 食品。</span>  |
#| operating_systems| string[] |你希望定向的设备操作系统。枚举值：`ANDROID`、`IOS`、`PC`。|
#| network_types |string[]| 你希望定向的设备连接类型。默认值：`unlimited`。枚举值参见[枚举值 - 网络类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
#|device_model_ids| string[]| 你希望定向的设备型号的 ID。目前仅支持品牌层级的型号 ID。如果传入此字段，不得传入 `device_price_ranges`。如需了解不同层级的设备型号 ID 的枚举值，参见[设备型号](https://ads.tiktok.com/marketing_api/docs?id=1737172880570369)。|
#| device_price_ranges|number[]|定向设备价格范围。10,000 表示 1,000 以上。数字必须为 50 的倍数。<br><b><span style="color: darkred">重要说明</span></b>：系统会在你设置的上限基础上再加 50，并将所得的新数值用作设备定向的实际上限。实际上限会在 TikTok 广告管理平台的广告组设置中显示。如果你设置的价格范围为 [0, 250]，系统实际上会按 [0, 300] 处理。|
#| carrier_ids |string[]| 你希望定向的运营商。仅当运营商的 `in_use` 字段为 `true` 时，运营商才生效。运营商必须与你希望定向的 location(s) 保持一致。枚举值 (`carrier_id`) 参见[获取运营商列表](https://ads.tiktok.com/marketing_api/docs?id=1737168013095938)。 |
#| interest_category_ids |string[]|你希望定向的兴趣类别列表。使用 [/tool/interest_category/](https://ads.tiktok.com/marketing_api/docs?id=1737174348712961) 接口获取兴趣类别的完整列表。|
#| rf_purchased_type  | string | 购买类型。允许的值： <ul><li>`FIXED_SHOW`：按固定展示量购买。</li><li>`FIXED_REACH`：按固定用户覆盖人数购买。</li><li>`FIXED_BUDGET`：按固定预算购买。</li></ul>|
#| budget| float | 预算。请根据广告库存预估 API 返回的数据填写此数值。 |
#| purchased_impression | number | 要购买的展示量，<b>单位：1,000</b>。 |
#| purchased_reach  | number | 已购买的用户覆盖人数，<b>单位：1,000</b>。 |
#| schedule_start_time | string | 排期开始时间 (UTC+0)，格式为  `YYYY-MM-DD HH:MM:SS`。|
#| schedule_end_time | string | 排期结束时间 (UTC+0)，格式为 `YYYY-MM-DD HH:MM:SS`。|
#|frequency |number| `frequency` 和 `frequency_schedule` 共同决定用户看到你的广告的频率（仅适用于采用 `REACH` 推广目标的广告）。<br>例如，`frequency` = 2 & `frequency_schedule` = 3 表示“每 3 天展示广告的次数不超过两次”。 |
#|frequency_schedule |number| `frequency_schedule` 和 `frequency` 共同决定用户看到你的广告的频率（仅适用于采用 `REACH` 推广目标的广告）。如需了解更多信息，参见 `frequency` 字段。 |
#|optimization_goal  | string |你希望通过广告实现的可度量成效。它必须与推广系列层级的 `objective_type` 值一致。枚举值：`REACH`、`VIDEO_VIEW`、`CLICK`、`POST_ENGAGEMENT`、`INSTALL`。|
#|cpv_video_duration  | string | 目标视频观看时长。枚举值：`TWO_SECONDS`、`SIX_SECONDS`。 |
#|brand_safety_type|string|覆盖和频次广告的品牌安全类型。枚举值： <ul><li>`NO_BRAND_SAFETY`： 不使用任何品牌安全解决方案。 使用全部库存，意味着你的广告可能会展示在某些成人主题的内容前后。 </li><li>`EXPANDED_INVENTORY`：使用 TikTok 品牌安全解决方案。使用扩展库存，意味着你的广告将展示在已移除大部分不当内容、不包含成人主题的内容前后。在下一个 API 版本中，`EXPANDED_INVENTORY` 将替代 `NO_BRAND_SAFETY`，并成为默认的品牌安全选项。</li><li>`STANDARD_INVENTORY`：使用 TikTok 品牌安全解决方案。使用标准库存，意味着你的广告将展示在适合大多数品牌的内容前后。 </li><li>`LIMITED_INVENTORY`：使用 TikTok 品牌安全解决方案。使用有限库存，意味着你的广告将不会展示在包含成人主题的内容前后。</li><li>`THIRD_PARTY`：使用第三方品牌安全解决方案。 </li></ul> 若想获取在你的品牌安全设置下可投放广告的国家和地区，需使用 [/tool/region/](https://ads.tiktok.com/marketing_api/docs?id=1737189539571713) 接口。 |
#|brand_safety_partner|string|覆盖和频次广告的品牌安全合作伙伴。仅当 `brand_safety_type` 为 `THIRD_PARTY` 时可用。枚举值：`IAS`、`OPEN_SLATE`（此合作伙伴在 TikTok 广告管理平台上显示为 <strong>DoubleVerify</strong>，因为其已被 DoubleVerify 收购)。<br><p><span style="color:darkred"><b>注意</b></span>： <ul><li> 出价前第三方品牌安全解决方案目前为白名单功能。如需使用这些功能，请联系你的 TikTok 销售代表。 </li></ul>|
#|category_exclusion_ids|string[]| 内容排除类别 ID。|
#|video_download_disabled|boolean| 用户是否可以在 TikTok 上下载你的视频广告（创建后不可更新）。 默认值：False。|
#|feed_type |string| 信息流类型选项。枚举值：`STANDARD_FEED`、`TOP_FEED`。`STANDARD_FEED` 指库存量大且 CPM 价格正常的信息流，`TOP_FEED` 指库存有限且 CPM 价格更高的信息流。 |
#|delivery_mode |string| 用于排序和排定广告投放的策略。<br><br>枚举值：<ul><li>`STANDARD`：标准投放。你的广告将均匀投放，预计会获得大致相同的访问量。 </li><li>`SCHEDULE`：按排期投放。 设置投放每个广告的特定时间段。 </li><li>`SEQUENCE`：按顺序投放。设置特定的广告投放顺序。 </li><li>`VIEW_OPTIMIZE`：针对播放量优化投放。你的广告将按能最大限度提升完播率 (VTR) 的方式进行投放，系统会将更多展示量分配给预估 VTR 更高的广告。</li><li>`OPTIMIZE`：经过优化的投放，旨在实现最佳广告效果。</li></ul>|
#|schedule_infos |object[]| 广告投放信息。 |
##|schedules |object[]| 广告的按排期投放详细信息。 |
###|start_time |string| 广告投放开始时间。 |
###|end_time |string| 广告投放结束时间。 |
##|expected_orders |number[]| 广告组内某个广告的投放顺序。<br><br>例如，值为 `[1]` 表示该广告将第一个投放。|
##|is_draft|boolean|广告投放信息是否处于草稿模式。<br><br>如果此字段的值为 `true`，表示在请求中定义的广告投放信息尚未与任何特定广告相关联。<br><br>若想将广告投放信息与广告关联，需通过 [/ad/create/](1739953377508354.html) 接口将返回的 `schedule_id` 值传入请求参数 `schedule_id`。将广告投放信息与广告关联后，该字段的值将自动设置为 `false`，`schedule_id` 值将为广告投放信息所关联的广告的 ID。|
##|schedule_id|string|排期 ID。<br><br>如果 `is_draft` 的值为 `true`，表示在请求中定义的广告投放信息尚未与任何特定广告相关联。<br><br>若想将广告投放信息与广告关联，需通过 [/ad/create/](1739953377508354.html) 接口将此字段的值传入请求参数 `schedule_id`。将广告投放信息与广告关联后，`is_draft` 的值将自动设置为 `false`，此字段的值将为广告投放信息所关联的广告的 ID。|
#|notice|string|系统通知。|
#|contextual_tag_ids |string[]|内容标签 ID。 |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
 "code": 40002,
 "message": "This ad has finished delivering and can no longer be edited.",
 "request_id": "{{request_id}}",
    "data": {}
}
(/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 每日平台更新简报 →