C/2/proxy/aim/account/campaign list
proxy/aim/account/campaign_list
查询账户下的计划列表,用于发起后续操作。
URL
https://c.api.weibo.com/2/proxy/aim/account/campaign_list.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
请求所有商业接口:
- 50000次/小时/IP;
- 50000次/小时/IP;
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | false | string | 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。 |
access_token | false | string | 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。 |
customer_id | true | int64 | 广告主的微博UID。 |
campaign_status | false | int | 指定广告计划状态。0:待投;1:在投;2:暂停;3:终止。 |
cursor | false | int | 游标, 用于分页请求(默认为0)。 |
count | false | int | 每次返回最大记录数(默认为1000)。 |
timestamp | true | timestamp | 调用方服务器当前时间的UNIX时间戳,此时间戳与我们服务器的时间差的绝对值在120秒内。 |
signature | true | string | 认证签名。加密方式为signature = md5(customer_id + secret_key + timestamp)。 |
注意事项
无
返回结果
JSON示例
//成功返回 { "data": [ { "campaign_id": 1, "campaign_name": "指定UID投放计划_01", "customer_id": 100000001, "customer_name": "微博AIM广告", "device": "1101,110200,110201,110202", "start_time": "2013-08-15 00:00:00", "end_time": "2013-08-16 23:59:59", "price": 400, "budget": 5000, "mid": 3468426641391104, "campaign_status": 1, "pause_status": 0 }, { "campaign_id": 2, "campaign_name": "指定UID投放计划_02", "customer_id": 100000001, "customer_name": "微博AIM广告", "device": "1101,110200,110201,110202", "start_time": "2013-08-17 00:00:00", "end_time": "2013-08-19 23:59:59", "price": 400, "budget": 8000, "mid": 3223436608451341, "campaign_status": 1, "pause_status": 0 }, .... ], "current_cursor": 0, "total_number": 10 } //失败返回 { "request": "/aim/campaign/create.json", "error_code": 271XX, "error": "error message." }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
无
其他
无