创建批量请求
开发环境
开发环境
POST
/v1.3/batch_requests/add
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| batch_request_spec* | struct[] | 批量调用接口任务所需条件 数组最大长度 100 |
| relative_path* | string | 相对接口请求路径； POST 请求不带参数，形如：v1.2/campaigns/update ； GET 请求带参数，形如：v1.2/campaigns/get?account_id=12345 字段长度最小 1 字节，长度最大 40960 字节 |
| body | string | POST 原始请求时的正文，暂时不支持 JSON 编码的字符串 字段长度最小 1 字节，长度最大 40960 字节 |
使用说明 1.目前可以创建批量请求的接口: campaigns/add, campaigns/update, campaigns/get, campaigns/delete, adgroups/add, adgroups/update, adgroups/get, adgroups/delete, advertiser/add, advertiser/get, advertiser/update。 2.list 参数里返回的响应顺序和 batch_request_spec 中请求参数的顺序一致。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1.3/batch_requests/add' \
--header 'access_token;' \
--header 'timestamp;' \
--header 'nonce;' \
--header 'fields;' \
--data-urlencode 'batch_request_spec=[{"relative_path":"v1.2/campaigns/update","body":"account_id=<ACCOUNT_ID>' \
--data-urlencode 'campaign_id=123' \
--data-urlencode 'campaign_name=testcampaignname"},{"relative_path":"v1.2/campaigns/get?account_id=<ACCOUNT_ID>' \
--data-urlencode 'fields=["campaign_name","campaign_id"]"}]'响应示例响应示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"list": [
{
"http_code": 200,
"headers": [
{
"name": "X-TSA-Trace-Id",
"value": "94eff22c95ede3a34b942ae041bf2db6"
},
{
"name": "X-RateLimit-Remaining",
"value": "50%,50%"
}
],
"body": "{\"code\": 0, \"message\":\"\", \"message_cn\":\"\", \"data\": {\"campaign_id\":123}}"
},
{
"http_code": 200,
"headers": [
{
"name": "X-TSA-Trace-Id",
"value": "94eff22c95ede3a34b942ae041bf2db6"
},
{
"name": "X-RateLimit-Remaining",
"value": "60%,60%"
}
],
"body": "{\"code\": 0, \"message\":\"\", \"message_cn\":\"\", \"data\": {\"list\":{\"campaign_id\": 123, \"campaign_name\": \"testcampaignname\"},\"page_info\":{\"page\": 1,\"page_size\": 10, \"total_number\": 1, \"total_page\": 1}}}"
}
]
}
}请求参数
Header 参数
Body 参数application/x-www-form-urlencoded
返回响应
修改于 2023-11-07 02:55:54