快手广告投放平台：账户查询模块《NO.2》

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

number

必填

快手广告主ID

在获取access_token的时候返回

返回参数

字段

类型

说明

备注

day_budget

long

单日预算

单位：厘

day_budget_schedule

long[]

分日预算

单位：厘，单日预算和分日预算同时存在时，以分日预算为准

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取access_token的时候返回

campaign_id

long

可选

快手广告计划ID

过滤筛选条件，若不传或传空则视为无限制条件

campaign_name

string

可选

快手广告计划名称

精确查询

campaign_type

int

可选

快手广告计划类型

过滤筛选条件；

2 - 提升应用安装;

3 - 获取电商下单;

4 - 推广品牌活动;

5 - 收集销售线索;

7 - 提升应用活跃;

status

int

可选

快手广告计划状态

过滤筛选条件；

-2：所有包含已删除

5：只包含已删除

不传：所有不包含已删除

其他值无效

start_date

string

可选

开始时间

与end_date同时传或同时不传；

过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应update_time信息

end_date

string

可选

结束时间

与start_date同时传或同时不传；

过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应update_time信息

page

int

可选

请求的页码数

默认为1

page_size

int

可选

请求的每页行数

默认为20

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

details

struct

返回值详情

campaign_id

long

快手广告计划ID

campaign_name

string

快手广告计划名称

campaign_type

int

快手广告计划类型

过滤筛选条件；

2 - 提升应用安装;

3 - 获取电商下单;

4 - 推广品牌活动;

5 - 收集销售线索;

status

int

快手广告计划状态

（优先看这个状态，计算结果）

-1：不限，1：已暂停，3：计划超预算，4：有效，5：已删除，6：余额不足

put_status

int

投放状态

（操作结果）

1：投放中；2：暂停 3：删除

create_channel

int

创建渠道

0：快手广告投放后台创建；1：Marketing API创建

create_time

string

创建时间

格式样例："2019-06-11 15:17:25"

update_time

string

最后修改时间

格式样例："2019-06-11 15:17:25"

day_budget

long

单日预算

单位：厘

day_budget_schedule

long[]

分日预算

单位：厘，单日预算和分日预算同时存在时，以分日预算为准

total_count

int

数据总数

请求样例

curl -X GET \

-H 'Access-Token: eaba7ce39b944a4e0c' \

-H 'Content-Type: application/json' \

-d '{

  "advertiser_id": 49,

  "campaign_name":"tetest"

}' -L https://ad.e.kuaishou.com/rest/openapi/v1/campaign/list

返回样例