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;

请求参数

  必选 类型及范围 说明
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."
}

关于错误返回值与错误代码,参见 错误代码说明

字段说明

其他



Language: [[{{{2/uri}}}|中文]]


文档更新时间: 2014-09-09
api评价