创建手动推广系列异步复制任务
此接口可用于创建手动推广系列异步复制任务。
一次只能复制一个推广系列。如需了解详细步骤，参见复制手动推广系列。创建任务后，使用 /campaign/copy/task/check/ 接口查看结果。
若想复制升级版 Smart+ 推广系列，需改用 /smart_plus/campaign/copy/task/create/ 接口。
注意
- 推广系列异步复制 API 目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。
- 此接口的频控限制为每个开发者应用每秒最多查询 1 次 (QPS) 和每分钟最多查询 30 次 (QPM)。全局频控限制不适用于此接口。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/campaign/copy/task/create/
方法 POST
Header
|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://business-api.tiktok.com/portal/docs/marketing-api-authentication/v1.3)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许值：`application/json`。|
参数
|字段{35%}|类型{10%}|描述{55%}|
|--- |--- |--- |
| advertiser_id {必填} | string | 广告主 ID。 |
| campaign_id {必填} | string | 要复制的推广系列的 ID。 <br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>不可复制包含自定义 TikTok 帖子的现有 GMV Max 推广系列。若想了解推广系列是否包含自定义 TikTok 帖子，需使用 [/campaign/gmv_max/info/](1822000968821762.html) 接口并查看返回的 `custom_anchor_video_list` 是否为 `[]`。</li><li>如果 iOS 专属推广系列使用未在你的 MMP 上激活 SAN 模块的应用，无法复制该推广系列。若想确保你的应用已启用 TikTok SAN 集成，参见[如何将现有应用迁移到 SAN](https://ads.tiktok.com/help/article/transition-to-san-for-existing-apps) 以及[如何将新应用集成到 SAN](https://ads.tiktok.com/help/article/integrate-to-san-for-new-apps)。 </li> <li>自 2024 年 9 月 30 日起，你无法再复制包含投放到 TikTok 广告位的[试玩广告](1737730803189826.html)的推广系列。</li><li>只能复制使用受支持的推广目标（`REACH`、`TRAFFIC`、`VIDEO_VIEWS`、`ENGAGEMENT`、`APP_PROMOTION`、`LEAD_GENERATION`、`WEB_CONVERSIONS`）的推广系列。 <ul><li> 无法复制属于 `ENGAGEMENT` 推广系列且 `promotion_type` 为 `LIVE_SHOPPING` 的广告组。</li><li> 无法复制属于 `ENGAGEMENT` 推广系列且 `optimization_goal` 为 `PAGE_VISIT` 的广告组。</li></ul></li><li> 不支持 Smart+ 推广系列和升级版 Smart+ 推广系列。若想复制升级版 Smart+ 推广系列，需改用 [/smart_plus/campaign/copy/task/create/](https://business-api.tiktok.com/portal/docs/create-an-asynchronous-copy-task-for-an-upgraded-smart-campaign/v1.3) 接口。</li><li> 要复制的推广系列必须至少包含 1 个未删除的广告组，并且该广告组中至少包含 1 个未删除的广告。</li><li> 要复制的推广系列不得包含超过 20 个未删除的广告组，其中每个广告组最多包含 50 个未删除的广告。</li><li> 不可复制推广系列中的程序化创意 (ACO) 广告组，但可复制智能创意广告组。</li><li> 如果复制的推广系列中包含绑定了拆分对比测试的广告组，系统只会复制这些广告组本身，而不会创建与这些广告组关联的拆分对比测试组。</li></ul> |
| request_id {必填} | string | 请求 ID 支持幂等处理，避免重复发送相同的请求。<br>如果在 10 秒的缓存时间内，以相同的请求 ID 多次重复发送请求，仅其中 1 次请求会成功。如果在缓存时间过后收到使用过期请求 ID 的重复请求，服务器会将其视为新请求，并进行相应的处理。<br><br>请求 ID 不同于返回参数中的 `request_id`，后者用于唯一标识 HTTP 请求。<br><br>该值应为 64 位整数字符串形式。<br><br>示例：`"123456789"`。 |
| operation_status | string | 新的推广系列创建时的状态。<br><br>枚举值： <ul><li> `ENABLE`：推广系列创建时处于已启用状态。 </li><li>`DISABLE`：推广系列创建时处于未启用状态。</li></ul> <br>默认值：`DISABLE`。<br><br>若想在创建推广系列后更新其状态，需使用 [/campaign/status/update/](1739320994354178.html) 接口。 |
|virtual_objective_type|string|新的推广目标类型。<br><br>枚举值：`SALES`。<br><br>此字段可用于创建使用销量推广目标的推广系列。销量推广目标合并了网站转化量和商品销量推广目标。详细了解[销量推广目标](1834189283112962.html)。|
|sales_destination{+条件必填}|string|仅当传入 `virtual_objective_type` 时必填且生效。<br><br>销售目标页面，即你希望提升销量的目标页面。<br><br>枚举值： <ul><li>`TIKTOK_SHOP`：TikTok Shop。提升你的 TikTok Shop 上的销量。</li><li>`WEBSITE`：网站。提升你的网站上的销量。</li><li>`APP`：应用。提升你的应用上的销量（需要商品库）。</li></ul>|
| campaign_name | string | 新建推广系列的名称。<br><br>长度限制：512 个字符。不支持使用表情符号。<br>中文或日文每个字计为两个字符，每个英文字母计为一个字符。<br><br>如果不传入，此字段将默认为 `"COPIED_{{name_of_the_original_campaign}}"`。 例如，如果原推广系列的名称为 `"FIRST_CAMPAIGN"` ，且不传入此字段，新建推广系列的名称将为 `"COPIED_FIRST_CAMPAIGN"`。 |
| is_advanced_dedicated_campaign | boolean | 是否为新建推广系列启用高级专属推广系列设置。高级专属推广系列利用可从实时信号中获益的高级投放模型。<br><br>如需了解如何创建高级专属推广系列，参见[创建高级专属推广系列](1797011827608577.html)。<br><br>枚举值：`true`、`false`。<br>如果不传入此字段，新建推广系列将沿用原推广系列的高级专属推广系列设置。<br><br><p><span style="color:darkred"><b>注意</b></span>：此字段设置后不可更新。 |
| budget | number | 新建推广系列的预算。<br><br>如果不传入，此字段将默认使用原推广系列的预算。<br><br>如需了解最低预算以及如何设置预算模式，参见[预算](1739381246298114.html)。如需获取某个币种的日预算取值范围，参见[币种 - 每日预算取值范围](1737585839634433.html)。 |
| rta_id | string | 实时 API (RTA) ID，即 RTA 策略识别 ID。<br><br>若想获取与你的广告账号关联的 RTA ID 列表，请联系你的 TikTok 销售代表。<br>如需了解为广告启用 RTA 的前提条件和步骤，参见[实时 API](1805437148769281.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：为广告启用 RTA 目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。你需要先完成入驻流程，才能接收并返回发送到你系统的 RTA 请求。 |
|po_number|string|PO（采购订单）号。<br>PO 号用于监测发票和对账。<br><br>[详细了解月度发票上的 PO 号](https://ads.tiktok.com/help/article/update-po-number-on-monthly-invoices)。|
| schedule_type | string | <ul><li> 仅在希望为新建推广系列中的所有广告组设置相同的排期时，才需传入此字段。 </li><li> 如果希望为新建推广系列中的每个广告组单独设置排期，可在对象数组 `adgroup_list` 中传入 `schedule_type`。 </li></ul> <br>所有新建广告组的排期类型。<br> <br> 枚举值： <ul><li>`SCHEDULE_START_END`：设置投放广告组的开始时间和结束时间。需同时传入 `schedule_start_time` 和 `schedule_end_time`。</li><li>`SCHEDULE_FROM_NOW`：设置持续投放广告组的开始时间。只需传入 `schedule_start_time`，结束时间将自动设置为开始时间后 10 年。</li></ul> |
| schedule_start_time {+条件必填} | string | 当传入 `schedule_type` 时必填。<br><br>所有新建广告组的排期开始时间 (UTC+0)，格式为 `"YYYY-MM-DD HH:MM:SS"`。<br><br>开始时间最多可比当前时间早 12 小时，但不得晚于 `"2028-01-01 00:00:00"`。 |
| schedule_end_time {+条件必填} | string |<ul><li> 当 `schedule_type` 为 `SCHEDULE_START_END` 时，此为必填字段。 </li><li> 当 `schedule_type` 为 `SCHEDULE_FROM_NOW` 时，不支持此字段。 </li></ul> <br>所有新建广告组的排期结束时间 (UTC+0)，格式为 `"YYYY-MM-DD HH:MM:SS"`。<br><br>结束时间不得晚于 `"2038-01-01 00:00:00"`。 |
| deep_copy_mode | string | 复制模式，用于确定在新建推广系列中创建广告组和广告的方式。<br><br>枚举值： <ul><li>`DEFAULT`：默认复制模式。在此模式下，系统会将原推广系列中所有未删除的广告组和广告复制到新建推广系列中。字段 `adgroup_list` 将被忽略。</li><li> `CUSTOM`：自定义复制模式。在此模式下，系统只会将原推广系列中传入的未删除广告组和广告复制到新建推广系列中。 <ul><li> 需一并传入字段 `adgroup_list`。一个广告组最多可复制 50 个广告，并且最多可复制 20 个广告组。 </li></ul></li></ul><br>默认值：`DEFAULT`。 |
| adgroup_list {+条件必填} | object[] | <ul><li> 当 `deep_copy_mode` 设置为 `DEFAULT` 或不传入时，此字段将被忽略。 </li><li> 当 `deep_copy_mode` 设置为 `CUSTOM` 时，此字段必填。</li></ul> <br>新建推广系列中广告组的自定义设置。<br><br>最大数量：20。 |
#| adgroup_id {+条件必填} | string | 当传入 `adgroup_list` 时必填。<br><br>要复制的广告组的 ID。该广告组应属于原推广系列 (`campaign_id`)。 <br><br><ul><li> 如果该广告组为非 ACO、非智能创意广告组，需在 `adgroup_id` 对象数组中传入 `ad_list`。 </li><li> 如果该广告组是智能创意广告组，无需在 `adgroup_id` 对象数组中传入 `ad_list`，但可以选择传入 `smart_creative_info`，以自定义用于在新建广告组中生成智能创意广告的广告创意。 </li></ul><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>自 2025 年 7 月 19 日起，无法再创建或复制投放到 TikTok Lite 下级广告位 (`TIKTOK_LITE`) 的广告组。为了确保顺畅无阻地创建广告，建议不要新建投放到该下级广告位的广告组，或复制包含这类广告组的推广系列。</li><li>自 2024 年 11 月 30 日起，你无法再创建或复制投放到 TikTok 广告位或自动广告位、使用“安装与应用内事件”优化目标的广告组。这一变更会影响具有以下配置的广告组： <ul><li>在推广系列层级：`objective_type` 为 `APP_PROMOTION`</li><li>在广告组层级：<ul><li>`optimization_goal` 为 `INSTALL` 且传入 `secondary_optimization_event` 合法值 </li><li>`placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 为 `["PLACEMENT_TIKTOK"]`，或 `placement_type` 为 `PLACEMENT_TYPE_AUTOMATIC` </li></ul> </li><li>投放到 TikTok 广告位、使用“安装与应用内事件”优化目标的现有广告组不受影响。此外，Pangle 广告位和全球化应用组合广告位（其中 `placement_type` 为 `PLACEMENT_TYPE_NORMAL`，且 `placements` 仅包含 `PLACEMENT_PANGLE` 或 `PLACEMENT_GLOBAL_APP_BUNDLE`，或两者均包含）不受影响。请留意这一变更，并在必要时，对集成进行适当的调整。</li></ul></li><li>如果广告组使用未在你的 MMP 上激活 SAN 模块的应用，无法复制该广告组。若想确保你的应用已启用 TikTok SAN 集成，参见[如何将现有应用迁移到 SAN](https://ads.tiktok.com/help/article/transition-to-san-for-existing-apps) 以及[如何将新应用集成到 SAN](https://ads.tiktok.com/help/article/integrate-to-san-for-new-apps)。</li></ul>|
#| operation_status| string | 新的广告组创建时的状态。<br><br>枚举值： <ul><li> `ENABLE`：广告组创建时处于已启用状态。</li><li>`DISABLE`：广告组创建时处于未启用状态。</li></ul> <br>默认值：`ENABLE`。<br><br>若想在创建广告组后更新其状态，需使用 [/adgroup/status/update/](1739591716326402.html) 接口。 |
#| adgroup_name| string | 新建广告组的名称。<br><br>长度限制：512 个字符。不支持使用表情符号。<br>中文或日文每个字计为两个字符，每个英文字母计为一个字符。<br><br>如果不传入，此字段将默认使用原广告组的名称。 |
#| automated_keywords_enabled | boolean | 仅当推广系列层级的 `is_search_campaign` 为 `true` 时生效。<br><br>是否启用自动关键词，让系统在你添加广告后自动生成关键词。这有助于扩展优质流量，进而提升效果。你可以在报告中查看效果出色的自动关键词。<br><br>支持的值：`true`、`false`。<br>默认值：`false`。<br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>搜索推广系列的自动关键词功能目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。|
#| location_ids| string[] | 新建广告组的定向地域 ID。<br><br>最大数量：3,000。如果你同时提供了 `location_ids` 和 `zipcode_ids`，每个广告组的地域 ID 和邮政编码 ID 的数量总和不得超过 3,000。<br><br>若想根据你的广告位和推广目标获取可用地域及其对应 ID，需使用 [/tool/region/](1737189539571713.html) 或 [/tool/targeting/search/](1761236883355649.html) 接口。<br>如需获取地域 ID 列表，参见[地域 ID](1739311040498689.html)。 <br> <br><p><span style="color:darkred"><b>注意</b></span>： <ul><li> 不支持重叠的定向地域。例如，你无法同时定向美国和加利福尼亚州。</li><li>如果你在创建广告组时通过 `location_ids` 或 `zipcode_ids` 定向了美国地域，后续可以将这些 ID 更新为美国境内的其他地域，但不能移除所有美国地域以仅定向美国以外的国家/地区。</li><li>如果复制现有广告组，并在 `tiktok_subplacements` 值中传入 `TIKTOK_LITE`，无法在新建广告组的定向地域 (`location_ids`) 中排除日本和韩国。</li></ul>|
#| zipcode_ids| string[] | 新建广告组的定向地域邮政编码 ID。<br><br>最大数量：3,000。如果你同时提供了 `location_ids` 和 `zipcode_ids`，每个广告组的地域 ID 和邮政编码 ID 的数量总和不得超过 3,000。<br><br>你可以通过从 [/tool/targeting/search/](1761236883355649.html) 接口返回的 `geo_id`（当 `geo_type` = `ZIP_CODE`），根据你的广告位、推广目标和关键词获取可用的邮政编码 ID。 <br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li> 邮政编码定向目前仅在美国、加拿大、巴西、印度尼西亚、泰国和越南可用。</li><li>在巴西、印度尼西亚、泰国和越南，邮政编码定向目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li><li>在已启用特殊广告类别 (`special_industries`) 的推广系列中，无法使用邮政编码定向。</li><li> 在 `objective_type` 为 `RF_REACH` 的推广系列中，无法使用邮政编码定向。</li><li>邮政编码定向仅支持 TikTok 广告位。因此，`placements` 值需包含 `PLACEMENT_TIKTOK`。</li><li> 不支持重叠的定向地域。例如，你无法同时定向美国和加利福尼亚州。</li><li>如果你在创建广告组时通过 `location_ids` 或 `zipcode_ids` 定向了美国地域，后续可以将这些 ID 更新为美国境内的其他地域，但不能移除所有美国地域以仅定向美国以外的国家/地区。 </li><li> 若想获取关于邮政编码 ID 的信息，只能使用 [/tool/targeting/info/](1761237001980929.html) 接口。</li></ul>|
#| audience_ids | string[] | 新建广告组定向的受众 ID 列表。<br><br>若想获取受众 ID，需使用 [/dmp/custom_audience/list/](1739940506015746.html) 接口。 |
#| excluded_audience_ids | string[] | 要在新建广告组中排除的受众 ID 列表。<br><br>若想获取受众 ID，需使用 [/dmp/custom_audience/list/](1739940506015746.html) 接口。 |
#| age_groups | string[] | 新建广告组的定向年龄组。<br><br>枚举值参见[枚举值 - 受众年龄区间](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138#item-link-Age%20Group)。<br><br>在某些情况下，不允许创建针对美国、拉丁美洲、欧洲经济区、英国、瑞士或加拿大 13-17 岁年龄组受众 (`AGE_13_17`) 定向投放的广告组。如需了解更多信息，参见 [TikTok 广告的新年龄限制](1788755983247362.html)。<br>如果使用不支持美国、拉丁美洲、欧洲经济区、英国、瑞士或加拿大 13-17 岁年龄组的定向选项，且不传入 `age_groups` 字段或将其设置为 `[]`，此字段将默认为 `["AGE_18_24", "AGE_25_34", "AGE_35_44", "AGE_45_54", "AGE_55_100"]`。 <br><br><p><span style="color:darkred"><b>注意</b></span>：如果广告组针对美国、拉丁美洲、欧洲经济区、英国、瑞士或加拿大 13-17 岁年龄组 (`AGE_13_17`) 定向投放，且通常不传入 `age_groups` 字段或将其设置为 `[]`，建议在字段中明确传入要定向的具体年龄组，例如 `AGE_18_24`。 |
#| budget | number | 新建广告组的预算。<br><br>如需了解最低预算以及如何设置预算模式，参见[预算](1739381246298114.html)。如需获取某个币种的日预算取值范围，参见[币种 - 每日预算取值范围](1737585839634433.html)。 |
#| schedule_type {+条件必填} | string | 当希望为新建广告组自定义排期设置时必填。<br><br>新建广告组的排期类型。<br> <br> 枚举值： <ul><li>`SCHEDULE_START_END`：设置投放广告组的开始时间和结束时间。需同时传入 `schedule_start_time` 和 `schedule_end_time`。</li><li>`SCHEDULE_FROM_NOW`：设置持续投放广告组的开始时间。只需传入 `schedule_start_time`，结束时间将自动设置为开始时间后 10 年。</li></ul> |
#| schedule_start_time {+条件必填} | string | 当在对象数组 `adgroup_list` 中传入 `schedule_type` 时必填。<br><br>新建广告组的排期开始时间 (UTC+0)，格式为 `"YYYY-MM-DD HH:MM:SS"`。<br><br>开始时间最多可比当前时间早 12 小时，但不得晚于 `"2028-01-01 00:00:00"`。 |
#| schedule_end_time {+条件必填} | string |<ul><li> 当对象数组 `adgroup_list` 中的 `schedule_type` 为 `SCHEDULE_START_END` 时必填。 </li><li> 当对象数组 `adgroup_list` 中的 `schedule_type` 为 `SCHEDULE_FROM_NOW` 时不支持此字段。 </li></ul> <br>新建广告组的排期结束时间 (UTC+0)，格式为 `"YYYY-MM-DD HH:MM:SS"`。<br><br>结束时间不得晚于 `"2038-01-01 00:00:00"`。 |
#| ad_list {+条件必填} | object[] | <ul><li> 当 `deep_copy_mode` 设置为 `DEFAULT` 或不传入时，此字段将被忽略。</li><li> 当 `deep_copy_mode` 设置为 `CUSTOM` 且原广告组 (`adgroup_id`) 为非 ACO、非智能创意广告组时，此字段必填。 <ul><li> 如果不希望自定义在新建广告组中生成的广告的设置，只需在此对象数组中传入 `ad_id`。 </li><li> 如果希望自定义在新建广告组中生成的广告的设置，在此对象数组中同时传入 `ad_id` 和其他参数。 </li></ul> </li></ul> <br>新建的非 ACO、非智能创意广告组中的广告设置。<br><br>最大数量：50。 |
##| ad_id {+条件必填} | string | 当传入 `ad_list` 时必填。<br><br>要复制的广告的 ID。该广告应属于原广告组 (`adgroup_id`)。 |
##| operation_status | string | 新的广告创建时的状态。<br><br>枚举值： <ul><li> `ENABLE`：广告创建时处于已启用状态。</li><li>`DISABLE`：广告创建时处于未启用状态。</li></ul><br>默认值：`ENABLE`。<br><br>若想在创建广告后更新其状态，需使用 [/ad/status/update/](1739953422970882.html) 接口。 |
##| ad_name | string | 新建广告的名称。<br><br>长度限制：512 个字符。不支持使用表情符号。<br>中文或日文每个字计为两个字符，每个英文字母计为一个字符。<br><br>如果不传入，此字段将默认为 `"COPIED_{{{ {name_of_the_original_ad}}_{ {ID_of_the_original_ad}}"`. 例如，如果原广告的名称为 `"FIRST_AD"` ，广告 ID 为 1234567891234567，且不传入此字段，新建广告的名称将为 `"COPIED_FIRST_AD_1234567891234567"`。 |
##| identity_type | string | 广告发布身份类型。<br><br>枚举值：`CUSTOMIZED_USER`、`AUTH_CODE`、`TT_USER`、`BC_AUTH_TT`。<br>查看[广告发布身份](1738958351620097.html)文档，详细了解广告发布身份。 |
##| identity_id | string | 广告发布身份 ID。<br><br>如果不使用 Spark Ads，可使用 `identity_id` 和 `identity_type` (`CUSTOMIZED_USER`) 来更好地管理广告信息。 |
##| identity_authorized_bc_id {+条件必填} | string | 当 `identity_type` 为 `BC_AUTH_TT` 时，此为必填字段。<br><br>与“添加到商务中心的 TikTok 用户”类型广告发布身份关联的商务中心 ID。 |
##| ad_format {+条件必填} | string | 广告样式。<br><br>枚举值： <ul><li>`SINGLE_VIDEO`：单视频广告。</li><li>`SINGLE_IMAGE`：单图广告。</li><li> `CAROUSEL_ADS`：标准轮播。</li></ul><br><ul><li> 若想将原广告复制到 TikTok 标准轮播广告中，此为必填字段，且必须设置为 `CAROUSEL_ADS`。 </li><li> 若想将 TikTok 标准轮播广告复制到单视频广告或单图广告中，此为必填字段。 </li></ul> |
##| video_id | string | 视频 ID。<br><br>若想获取视频 ID，需使用 [/file/video/ad/search/](1740050472224769.html) 接口。<br><br>若想创建 Spark Ads，需使用 `video_id` 或 `tiktok_item_id`。如需详细了解 Spark Ads，参见[创建 Spark Ads](1739470744631298.html)。 |
##| image_ids | string[] | 图片 ID 列表（用于广告或用作视频封面的图片）。<br><br>若想获取图片 ID，需使用 [/file/image/ad/search/](1740052016789506.html) 或 [/file/image/ad/upload/](1739067433456642.html) 接口。 |
##| music_id | string | 要在 TikTok 轮播广告中使用的音乐的 ID。<br><br>如需了解如何获取可在 TikTok 轮播广告中使用的音乐，参见[创建轮播广告](1766217791987713.html)。 |
##| tiktok_item_id | string | 作为 Spark Ads 投放的 TikTok 帖子 ID。<br><br>如需详细了解 Spark Ads，参见[创建 Spark Ads](1739470744631298.html)。<br><br>传入从 [/tt_video/info/](1738376324021250.html) 或 [/identity/video/get/](1740218475032577.html) 接口的返回结果中获取的 `item_id`。 <br><br><p><span style="color:darkred"><b>注意</b></span>：使用 Spark Ads，即表示你确认拥有将视频中的音乐用于商业用途的权利。 |
##| ad_text | string | 广告文案。作为广告创意的一部分展示给受众，用于传递你希望传达的信息。<br><br>如果你不了解如何撰写有效的广告文案，可以尝试[智能文案](1739084248002626.html)功能，该功能可根据行业和语言生成广告文案建议。<br><br>长度限制：100 个字符。不支持使用表情符号。<br>中文或日文每个字计为两个字符，每个英文字母计为一个字符。 |
##| aigc_disclosure_type | string | 是否开启 AIGC（人工智能生成内容）自主披露开关，标注广告包含 AI 生成内容。该开关开启后，当广告以完整形式展示时，将显示“广告主标记为 AI 生成”标签。<br><br>枚举值： <ul><li>`SELF_DISCLOSURE`：开启开关，声明广告包含 AI 生成内容。 </li><li>`NOT_DECLARED`：不声明广告包含 AI 生成内容。</li></ul>默认值：`NOT_DECLARED`。<br><br>如需了解该开关支持的推广目标和广告样式，以及使用该开关的详细步骤，参见 [AI 生成内容自主声明开关](1799186631031809.html)。|
##| creative_auto_enhancement_strategy_list | string[] | 应用于你的广告的自动优化策略列表。<br>你传入的优化功能将在你的推广系列投放期间自动实时应用。<br><br>枚举值：<ul><li>`VIDEO_QUALITY`：视频质量。通过提高分辨率和清晰度来提升整体视觉效果。</li><li>`MUSIC_REFRESH`：音乐焕新。替换为当前 TikTok 上流行的音乐，紧跟潮流趋势。</li><li>`IMAGE_QUALITY`：图片质量。通过提高分辨率和清晰度来提升整体视觉效果。</li><li>`IMAGE_RESIZE`：调整尺寸。调整图片大小，充分利用全屏功能。</li></ul><br>此字段的默认值取决于你是否已加入“默认启用自动优化”功能的白名单：<ul><li>如果你已加入默认启用特定策略的白名单，此字段的默认值将为包含这些策略的列表。<ul><li>例如，如果你已加入默认启用所有这些策略的白名单，此字段的默认值将为 `["MUSIC_REFRESH","VIDEO_QUALITY","IMAGE_QUALITY","IMAGE_RESIZE"]`。 </li></ul></li><li>如果你未加入默认启用任何策略的白名单，此字段的默认值将为空列表 (`[]`)。</li></ul><br>如需了解可启用此设置的场景，参见[适用于手动广告的自动优化功能](https://business-api.tiktok.com/portal/docs?id=1855450880142402#item-link-For%20Manual%20Ads)。<br><br><p><span style="color:darkred"><b>注意</b></span>：自动优化功能面向所有广告主提供。但默认启用这些功能目前为白名单功能，并且每一项优化功能的默认启用均需单独申请。如需使用此功能，请联系你的 TikTok 销售代表。 </p>|
##| tracking_pixel_id | string | 要监测的 Pixel ID。你可以使用此字段监测站外事件。<br><br>支持以下适用于竞价广告的推广目标：`REACH`、`VIDEO_VIEWS`、`TRAFFIC`、`WEB_CONVERSIONS`、`LEAD_GENERATION`、`APP_PROMOTION` 和 `ENGAGEMENT`。 <ul><li> 对于竞价推广目标：如果在广告组层级已传入 `pixel_id`，并希望使用 Pixel 监测站外事件，那么通过 `tracking_pixel_id` 字段传入的 Pixel ID 必须与在广告组层级通过 `pixel_id` 字段传入的 ID 一致。否则，你可以通过 `tracking_pixel_id` 字段传入任何想要监测的 Pixel ID。</li></ul> |
##| tracking_app_id | string | 你希望监测的应用的 ID。你可以使用此字段监测站外应用事件。<br><br>支持以下适用于竞价广告的推广目标：`REACH`、`VIDEO_VIEWS`、`TRAFFIC`、`WEB_CONVERSIONS`、`LEAD_GENERATION`、`APP_PROMOTION` 和 `ENGAGEMENT`。<br><br>如果在广告组层级已传入 `app_id`，并希望监测站外应用事件，那么通过此字段传入的应用 ID 必须与广告组层级传入的 ID 一致。否则，你可以通过此字段传入任何想要监测的应用 ID。你可以通过 [/app/list/](1740859313270786.html) 接口获取应用 ID (`app_id`)。 |
#| smart_creative_info | object | <ul><li> 当 `deep_copy_mode` 设置为 `DEFAULT` 或不传入时，此字段将被忽略。</li><li> 当 `deep_copy_mode` 设置为 `CUSTOM` 且原广告组 (`adgroup_id`) 为智能创意广告组时，此字段选填。 <ul><li> 如果希望沿用原广告组中的广告创意在新建广告组中生成广告，请勿传入此字段。 </li><li> 如果希望自定义广告创意，用于在新建广告组中生成智能创意广告，请传入此字段。 </li></ul> </li></ul><br>用于在新建智能创意广告组中生成智能创意广告的广告创意。 <br><br><p><span style="color:darkred"><b>注意</b></span>：智能创意仅支持在推广系列层级使用 `APP_PROMOTION`、`WEB_CONVERSIONS`、`TRAFFIC` 或 `LEAD_GENERATION` 作为推广目标 (`objective_type`)。 |
##| media_info_list{+条件必填} | object[] | 当传入 `smart_creative_info` 时必填。<br><br>媒体信息列表。<br><br>最大数量：30。 |
###| media_info {+条件必填} | object | 当传入 `media_info_list` 时必填。<br><br>素材信息。 |
####| image_info| object[] | 图片信息。 <ul><li> 若想上传图片素材（请求中不包含 `video_info`），此字段将用作图片素材。 </li><li> 若想上传视频素材（请求中包含 `video_info`），此字段将用作视频封面。只能针对每个 `image_info` 对象数组提交一张图片。</li></ul>|
#####| web_uri{+条件必填} | string | 当传入 `image_info` 时必填。<br><br>图片 ID。<br><br>通过 [/file/image/ad/upload/](1739067433456642.html) 接口上传图片后，你可以在返回结果中找到图片 ID。 |
#####| file_name | string | 图片名称。<br><br>长度限制：100 个字符。<br><br>如果使用图片素材，此字段将用于生成广告名称。如需了解广告名称生成规则，参见[广告名称生成规则](https://business-api.tiktok.com/portal/docs?id=1739473063234626#item-link-Ad%20name%20generation%20rules)。 |
####| video_info| object | 视频信息。 |
#####| video_id{+条件必填} | string | 当传入 `video_info` 时必填。<br><br>视频 ID。<br><br>通过 [/file/video/ad/upload/](https://ads.tiktok.com/marketing_api/docs?id=1737587322856449) 接口上传视频后，你可以在返回结果中获取视频 ID。 |
#####| file_name | string | 视频名称。<br><br>长度限制：100 个字符。<br><br>如果使用视频素材，此字段将用于生成广告名称。如需了解广告名称生成规则，参见[广告名称生成规则](https://business-api.tiktok.com/portal/docs?id=1739473063234626#item-link-Ad%20name%20generation%20rules)。 |
####| aigc_disclosure_type | string | 是否开启 AIGC（人工智能生成内容）自主披露开关，标注广告包含 AI 生成内容。该开关开启后，当广告以完整形式展示时，将显示“广告主标记为 AI 生成”标签。<br><br>枚举值： <ul><li>`SELF_DISCLOSURE`：开启开关，声明广告包含 AI 生成内容。 </li><li>`NOT_DECLARED`：不声明广告包含 AI 生成内容。</li></ul>默认值：`NOT_DECLARED`。<br><br>如需了解该开关支持的推广目标和广告样式，以及使用该开关的详细步骤，参见 [AI 生成内容自主声明开关](1799186631031809.html)。 |
####| tiktok_item_id | string | 作为 Spark Ads 投放的 TikTok 帖子 ID。<br><br>传入从 [/tt_video/info/](https://ads.tiktok.com/marketing_api/docs?id=1738376324021250) 或 [/identity/video/get/](https://ads.tiktok.com/marketing_api/docs?id=1740218475032577) 接口的返回结果中获取的 `tiktok_item_id`。 <br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li> 使用 Spark Ads，即表示你确认拥有将视频中的音乐用于商业用途的权利。 </li><li> 传入 `tiktok_item_id` 后，无需传入对象 `image_info`、`video_info` 和 `title_list`。</li></ul> |
####| identity_id {+条件必填} | string | 当传入 `tiktok_item_id` 时必填。<br><br>广告发布身份 ID。 |
####| identity_type {+条件必填} | string | 当传入 `tiktok_item_id` 时必填。<br><br>广告发布身份类型。<br><br>枚举值：`AUTH_CODE`、`TT_USER`。<br><br>查看[广告发布身份](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097)文档，详细了解广告发布身份。 |
##| title_list | object[] | 广告标题（也称为广告文案）列表。广告标题作为广告创意的一部分展示给受众，用于传递你希望传达的信息。<br><br>最大数量：5。 |
###| title {+条件必填} | string | 当传入 `title_list` 时必填。<br><br>广告标题（广告文案）。如果你不了解如何撰写有效的广告文案，可以尝试[智能文案](https://ads.tiktok.com/marketing_api/docs?id=1739084248002626)功能，该功能可根据行业和语言生成广告文案建议。<br><br>广告文案必须为 12-40 个字符，且不得包含表情符号。<br>中文或日文每个字计为两个字符，每个英文字母计为一个字符。 |
##| call_to_action_list | object[] | 行动引导文案列表。<br><br>最大数量：3。<br><br><p><span style="color:darkred"><b>注意</b></span>：对于 TikTok 广告，必须传入此字段或 `call_to_action_id`。如果同时传入两者，此字段将被忽略。 |
###| call_to_action {+条件必填} | string | 当传入 `call_to_action_list` 时必填。<br><br>行动引导文案。<br><br>枚举值参见[枚举值 - 行动引导文案](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。 |
##| deeplink_list | object[] | 深度链接列表。<br><br>最大数量：1。 |
###| deeplink | string | 你希望已安装应用的受众跳转到的具体位置。 |
###| deeplink_type | string | 深度链接类型。<br><br>枚举值： <ul><li> `NORMAL`：非延迟深度链接。</li><li>`DEFERRED_DEEPLINK`：延迟深度链接。 </li></ul><br>默认值：`NORMAL`。<br><br>如需了解支持非延迟深度链接和延迟深度链接的场景，参见[深度链接 - 适用范围 – 深度链接](https://business-api.tiktok.com/portal/docs?id=1779541971843073#item-link-Availability)小节。 <br><br><p><span style="color:darkred"><b>注意</b></span>：专属推广系列不支持延迟深度链接。因此，如果广告所属推广系列的 `campaign_type` 为 `IOS14_CAMPAIGN`，不可将此字段设置为 `DEFERRED_DEEPLINK`。 |
##| display_name_list |object[] | 显示名称列表。<br><br>每个 `display_name_list` 中只能包含一个 `app_name` 或 `landing_page_name`。 |
###| app_name | string | 在广告中显示的应用名称。<br><br>如果不传入，将使用应用商店中的名称。<br><br>长度限制：40 个字符。 |
###| landing_page_name | string | 落地页的显示名称。<br><br>长度限制：40 个字符。 |
##| page_list | object[]| 页面 ID 列表。<br><br>最大数量：3。 |
###| page_id {+条件必填} | string | 当传入 `page_list` 时必填。<br><br>页面 ID。 <br><br><ul><li>若想获取广告账号内的页面，需使用 [/page/get/](1820826387779586.html) 接口。</li><li>若想创建即时体验页面，需使用[即时体验页面编辑器 SDK](1740307202170881.html)。</li></ul>|
##| card_list | object[] | 创意素材包 ID 列表。<br><br>最大数量：1。 |
###| card_id | string | 传入以下任一创意素材包类型的 ID： <ul><li> 倒计时贴纸。</li><li> 礼品码贴纸。</li><li> 展示卡片。</li><li> 下载卡片。</li></ul><br>若想创建创意素材包，需使用 [/creative/portfolio/create/](1739091950439426.html) 接口。 <ul><li> 如需了解如何获取展示卡片 ID 或下载卡片素材包，参见[卡片](1749019652141058.html)。</li><li> 如需了解如何获取倒计时贴纸 ID 或礼品码贴纸素材包 ID，参见[贴纸](1749019667506177.html)。 </li></ul> |
##| landing_page_urls {+条件必填} | object[] | 当 `fallback_type` 设置为 `WEBSITE` 时必填。<br><br>落地页 URL 列表。<br><br>最大数量：1。 |
###| landing_page_url {+条件必填} | string | 当传入 `landing_page_urls` 时必填。<br><br>落地页 URL。 |
##| common_material | object | 通用素材。 |
###| identity_id | string | 广告发布身份 ID。 |
###| identity_type| string | 广告发布身份类型。<br><br>枚举值：`CUSTOMIZED_USER`。<br><br>查看[广告发布身份](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097)文档，详细了解广告发布身份。 |
###| ad_name | string | 广告名称。<br><br>长度限制：512 个字符。不支持使用表情符号。<br>中文或日文每个字计为两个字符，每个英文字母计为一个字符。<br><br>设置为 `""`（空字符串），系统将自动生成广告名称。自动生成的广告名称的格式为创意名称 + 创建时间（例如：adcreative20210111190739）。<br><br>如需了解广告名称的生成方式，参见[广告名称生成规则](https://business-api.tiktok.com/portal/docs?id=1739473063234626#item-link-Ad%20name%20generation%20rules)小节。 <br> <br><p><span style="color:darkred"><b>注意</b></span>：如果在这一步不传入广告名称，将无法通过 [/ad/aco/update/](1739473077112833.html) 接口更改名称。 |
###| call_to_action_id | string | 你希望在广告中使用的 CTA 素材包的 ID。<br><br>CTA 素材包是一组自动优化的 CTA。如需详细了解自动优化的 CTA，参见[智能推荐行动引导文案 > 动态优选行动引导文案](https://ads.tiktok.com/marketing_api/docs?id=1740307296329730)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：如果同时传入此字段和 `call_to_action_list`，`call_to_action_list` 将被忽略。 |
###| creative_authorized | string | 是否允许在 TikTok for Business 创意中心展示你的部分广告。仅对非美国广告主生效，默认值为 `false`。 <br><br><p><span style="color:darkred"><b>注意</b></span>：`creative_authorized` 仅适用于视频广告。 |
###| playable_url | string | 试玩素材 URL。<br><br>此 URL 仅对 Pangle 广告位生效。<br><br>若想获取 URL，需使用 [/playable/get/](https://ads.tiktok.com/marketing_api/docs?id=1737732758495234) 接口。<br><br>请注意，相同广告组中的所有广告共享相同的试玩素材。 |
###| fallback_type | string | 失败路径类型。<br><br>如果受众未安装应用，你可以将其跳转到相应页面，以便他们安装应用或查看特定网页。<br><br>枚举值：`APP_INSTALL`、`WEBSITE`。如果选择网站，需通过 `landing_page_urls` 字段传入 URL。<br> <br><p><span style="color:darkred"><b>注意</b></span>：不适用于延迟深度链接。 |
###| tracking_info | object | 监测信息。 |
####|impression_tracking_urls|string[]|默认展示监测 URL。由数据合作伙伴生成的 URL，用于监测你的广告获得的展示事件。通常可以在合作伙伴的平台上找到并复制此 URL。 <br><br><ul><li> 如果要监测的应用合作伙伴 ID（在广告组层级传入的 `app_id`）为 `44` (TikTok Business SDK) 或 `49`（TikTok 应用 API），无需传入此字段。如果已传入，此字段将被忽略。你可以通过 [/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786) 接口或 [/app/info/](https://ads.tiktok.com/marketing_api/docs?id=1740859272887297) 接口返回的 `partner_id`，获取应用合作伙伴 ID。</li><li> 如果你要监测的应用已启用自归因（在广告组层级传入的 `app_id`），且该应用的合作伙伴 ID 并非 `44` (TikTok Business SDK) 或 `49`（TikTok 应用 API），无需传入此字段。因为此字段将默认使用你为应用配置的默认展示监测 URL，且不支持 URL 更新。你可以通过 [/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786) 接口或 [/app/info/](https://ads.tiktok.com/marketing_api/docs?id=1740859272887297) 接口返回的 `self_attribution_enabled`，确认应用是否已启用自归因。</li></ul><br>你只能传入 1 个 URL。|
####| click_tracking_urls|string[]|点击监测 URL。由数据合作伙伴生成的 URL，用于监测你的广告获得的点击事件。通常可以在合作伙伴的平台上找到并复制此 URL。 <br><br><ul><li> 如果要监测的应用合作伙伴 ID（在广告组层级传入的 `app_id`）为 `44` (TikTok Business SDK) 或 `49`（TikTok 应用 API），无需传入此字段。如果已传入，此字段将被忽略。你可以通过 [/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786) 接口或 [/app/info/](https://ads.tiktok.com/marketing_api/docs?id=1740859272887297) 接口返回的 `partner_id`，获取应用合作伙伴 ID。</li><li> 如果你要监测的应用已启用自归因（在广告组层级传入的 `app_id`），且该应用的合作伙伴 ID 并非 `44` (TikTok Business SDK) 或 `49`（TikTok 应用 API），无需传入此字段。因为此字段将默认使用你为应用配置的点击监测 URL，且不支持 URL 更新。你可以通过 [/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786) 接口或 [/app/info/](https://ads.tiktok.com/marketing_api/docs?id=1740859272887297) 接口返回的 `self_attribution_enabled`，确认应用是否已启用自归因。</li></ul><br>你只能传入 1 个 URL。<br><br>目前，Pangle 不支持 DCM、Sizmek 或 Flashtalking。 |
####|tracking_pixel_id|string| 要监测的 Pixel ID。你可以使用此字段监测站外事件。<br><br>此字段支持以下适用于竞价广告的推广目标：`TRAFFIC`、`WEB_CONVERSIONS`、`LEAD_GENERATION` 和 `APP_PROMOTION`。<ul><li>对于竞价推广目标：<br>如果在广告组层级已传入 `pixel_id`，<strong>并</strong>希望使用 Pixel 监测站外事件，那么通过 `tracking_pixel_id` 字段传入的 Pixel ID 必须与在广告组层级通过 `pixel_id` 字段传入的 ID 一致。否则，你可以通过 `tracking_pixel_id` 字段传入任何想要监测的 Pixel ID。 |
####|tracking_app_id | string| 你希望监测的应用的 ID。你可以使用此字段监测站外应用事件。<br><br>支持以下适用于竞价广告的推广目标：`TRAFFIC`、`WEB_CONVERSIONS`、`LEAD_GENERATION` 和 `APP_PROMOTION`。<br><br>如果在广告组层级已传入 `app_id`，并希望监测站外应用事件，那么通过此字段传入的应用 ID 必须与广告组层级传入的 ID 一致。否则，你可以通过此字段传入任何想要监测的应用 ID。<br><br>你可以通过 [/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786) 接口获取应用 ID (`app_id`)。 |
####| tracking_offline_event_set_ids |string[]| 要监测的线下事件组 ID 列表。你可以使用此字段监测和度量浏览广告或与之互动的用户的线下活动。<br><br>最大数量：50。<br><br>如需详细了解如何创建和管理线下事件组，参见[此处](https://ads.tiktok.com/marketing_api/docs?id=1758051319816193)。 <br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li> 线下事件监测目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。 </li><li> 如果你已加入线下事件监测功能白名单，现有的自动监测线下事件组必须在新建广告下进行监测： <ul><li> 你可以省略此参数，那么此字段将自动默认为广告主账号下所有<strong>现有</strong>的自动监测线下事件组 ID；或者 </li><li> 你可以手动传入此参数。你需要通过此字段，至少传入所有<strong>现有</strong>的自动监测线下事件组 ID，非自动监测事件组 ID 可以选择性地传入。若想获取当前的自动监测线下事件组 ID，需调用 [/offline/get/](https://ads.tiktok.com/marketing_api/docs?id=1765596808589313) 接口获取所有线下事件组 ID，并根据返回的 `auto_tracking` 参数选择所有自动监测事件组。 </li></ul></li><li> 此字段支持以下推广目标：`TRAFFIC`、`LEAD_GENERATION`、`APP_PROMOTION` 和 `WEB_CONVERSIONS`。 </li></ul>|
示例
根据你对复制模式的偏好，以及是否设置与新建广告组共享排期，你可以使用以下任意示例代码复制推广系列：
使用默认复制模式，不与新建广告组共享排期
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/copy/task/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"campaign_id": "{{campaign_id}}",
"request_id": "{{request_id}}",
"deep_copy_mode": "DEFAULT"
}'
(/code)
使用默认复制模式，与新建广告组共享排期
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/copy/task/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"campaign_id": "{{campaign_id}}",
"request_id": "{{request_id}}",
"deep_copy_mode": "DEFAULT",
"schedule_type":"SCHEDULE_START_END",
"schedule_start_time":"{{schedule_start_time}}",
"schedule_end_time":"{{schedule_end_time}}"
}'
(/code)
使用自定义复制模式，不与新建广告组共享排期
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/copy/task/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"campaign_id": "{{campaign_id}}",
"request_id": "{{request_id}}",
"deep_copy_mode": "CUSTOM",
"adgroup_list": [
{
"adgroup_id": "{{adgroup_id}}",
"schedule_type":"SCHEDULE_START_END",
"schedule_start_time":"{{schedule_start_time}}",
"schedule_end_time":"{{schedule_end_time}}",
"ad_list":[{"ad_id":"{{ad_id}}"}]
},
{
"adgroup_id": "{{adgroup_id}}",
"schedule_type":"SCHEDULE_START_END",
"schedule_start_time":"{{schedule_start_time}}",
"schedule_end_time":"{{schedule_end_time}}",
"ad_list":[{"ad_id":"{{ad_id}}"}]
}
]
}'
(/code)
使用自定义复制模式，与新建广告组共享排期
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/copy/task/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"campaign_id": "{{campaign_id}}",
"request_id": "{{request_id}}",
"deep_copy_mode": "CUSTOM",
"schedule_type":"SCHEDULE_START_END",
"schedule_start_time":"{{schedule_start_time}}",
"schedule_end_time":"{{schedule_end_time}}",
"adgroup_list": [
{
"adgroup_id": "{{adgroup_id}}",
"ad_list":[{"ad_id":"{{ad_id}}"}]
},
{
"adgroup_id": "{{adgroup_id}}",
"ad_list":[{"ad_id":"{{ad_id}}"}]
}
]
}'
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|-|-|-|
|code |number|返回码。完整返回码列表及描述参见[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|message |string|返回信息。更多信息参见[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|request_id|string| 请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|
#| task_id | string | 推广系列异步复制任务的 ID。<br><br>若想查看任务结果，需使用 [/campaign/copy/task/check/](1788434463507458.html) 接口。<br><br>如果出现错误（`adgroup_error_list` 不为空），将不会生成任务 ID，此字段的值将为空字符串 (`""`)。 |
#| adgroup_error_list | object[] | 特定广告组复制过程中出现的错误。<br><br>如果未出现错误，此字段的值将为空列表 (`[]`)。 |
##| adgroup_id | string | 复制失败的广告组 ID。 |
##| error_message | string | 广告组 (`adgroup_id`) 复制过程中出现的错误。 |
示例
调用成功并已生成任务 ID
(code curl http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"task_id": "{{task_id}}",
"adgroup_error_list": []
}
}
(/code)
调用成功但未生成任务 ID
(code curl http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"adgroup_error_list": [
{
"adgroup_id": "{{adgroup_id}}",
"error_message": "Start time cannot be earlier than the current time. Please edit the start time and try again."
},
{
"adgroup_id": "{{adgroup_id}}",
"error_message": "Start time cannot be earlier than the current time. Please edit the start time and try again."
}
],
"task_id": ""
}
}
(/code)