创建更改日志下载任务

您可以使用本接口根据您传入的参数创建更改日志下载任务。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/activities/task/create/|/v1.3/changelog/task/create/| |请求参数名称|opt_types order_field|operation_types order_fields| |请求参数类型|advertiser_id:number order_fields:string|advertiser_id: string order_fields :string[]| |废弃请求参数|/|page page_size`|


## 请求

**地址**  
https://business-api.tiktok.com/open_api/v1.3/changelog/task/create/

**方法** POST

**Header**

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

参数

|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string| 广告主 ID。 |
|start_time |string| 查询起始时间，格式为 `YYYY-MM-DD HH:MM:SS` <br>比如：`2025-09-01 00:00:00`。|
|end_time |string| 查询结束时间，格式为 `YYYY-MM-DD HH:MM:SS`<br>比如：`2025-09-01 00:00:00`。<br><font color="Red">注意</font>: 允许的最长时间间隔为30天，请确保`end_time`在`start_time`后的30天内。|
|timezone |string| 返回结果时区，枚举值见[附录-时区信息](https://ads.tiktok.com/marketing_api/docs?id=1737586324313089)。 |
|module |string| 查询模块，枚举值: `BIDDING_AND_OPTIMIZATION`,`BUDGET`,`STATUS`,`TARGETING`。 |
|object_ids |string[]| 查询对象ID。 |
|object_type |string| 查询对象类型，枚举值: `AD`,`ADGROUP`,`ADVERTISER`,`CAMPAIGN`,`INSTANT_FORM`。 |
|operation_types|string[]| 操作类型。枚举值：`CREATE`, `AUDIT`, `STATUS`, `UPDATE`, `DELETE`, `DOWNLOAD_LEADS`, `SUBSCRIBE_FORM`, `UNSUBSCRIBE_FORM`。 |
|order_fields |string[]| 排序字段。 |

示例

(code curl http)
curl -H "Access-Token:xxx" -H "Content-Type:application/json" -X POST \
-d '{
    "order_type": "ORDER_TYPE", 
    "order_fields": "ORDER_FIELDS", 
    "operation_types": [
        "OPT_TYPES"
    ], 
    "start_time": "START_TIME", 
    "object_type": "OBJECT_TYPE", 
    "object_ids": [
        "OBJECT_IDS"
    ], 
    "module": "MODULE", 
    "advertiser_id": "ADVERTISER_ID", 
    "end_time": "END_TIME", 
    "timezone": "TIMEZONE", 
}' \
https://business-api.tiktok.com/open_api/v1.3/changelog/task/create/
(/code)

|字段|类型|描述|
|---|---|---|
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data |object|返回数据 。 |
#|task_id {条件返回}|string| 任务ID。 |
|request_id |string|请求的日志ID，唯一标识一个请求。  |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
  "code": 0,
  "data": {
    "task_id": "6917870916856709125"
  },
  "message": "OK"
}
(/code);