创建批量请求
| 所属权限 | ads_management |
| 请求地址 | batch_requests/add |
| 请求方法 | POST |
| Content-Type | application/json |
全局参数
全局参数是指每一个接口都需要使用到的参数。详情参考，代码案例参考。
| 参数名称 | 参数类型 |
|---|---|
| access_token | 授权令牌，完成 OAuth 2.0 授权后获得，参考授权认证章节 |
| timestamp |
当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。 MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳 MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59 |
| nonce | 随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性 |
请求参数
标有*的参数为必填项
| 名称 | 类型 | 描述 |
|---|---|---|
|
batch_request_spec*
|
struct[] | 批量调用接口所需条件列表 |
|
relative_path*
|
string | 相对接口请求路径； POST 请求不带参数，形如：v3.0/adgroups/update ； GET 请求带参数，形如：v3.0/adgroups/get?account_id=12345 |
|
body
|
string | POST 原始请求时的正文，是 JSON 编码的字符串 |
使用说明
- 目前可以创建批量请求的接口: adgroups/update, advertiser/update。
- list 参数里返回的响应顺序和 batch_request_spec 中请求参数的顺序一致。
请求示例
curl 'https://api.e.qq.com/v3.0/batch_requests/add?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
"batch_request_spec": [
{
"body": "{\"adgroup_id\": 5076530760, \"dynamic_creative_id\": 41006154, \"configured_status\": \"AD_STATUS_NORMAL\", \"account_id\": 20458}",
"relative_path": "v3.0/dynamic_creatives/update"
},
{
"body": "{\"adgroup_id\": 5076530876, \"dynamic_creative_id\": 41006147, \"configured_status\": \"AD_STATUS_SUSPEND\", \"account_id\": 20458}",
"relative_path": "v3.0/dynamic_creatives/update"
}
]
}'
应答字段
| 名称 | 类型 | 描述 |
|---|---|---|
|
list
|
struct[] | 返回信息列表 |
|
http_code
|
integer | http 返回码 |
|
headers
|
struct[] | http header |
|
name
|
string | 单个 header 名 |
|
value
|
string | 单个 header 值 |
|
body
|
string | 返回的正文数据 |
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"list": [
{
"body": "{\"code\":0,\"data\":{\"dynamic_creative_id\":41006154},\"message\":\"\",\"message_cn\":\"\"}"
},
{
"body": "{\"code\":0,\"data\":{\"dynamic_creative_id\":41006147},\"message\":\"\",\"message_cn\":\"\"}"
}
]
}
}场景组合示例
枚举值会自动根据已选条件变化，只展示有示例数据的枚举值
可视化调试工具
问题仍未解决？
请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务
