快手广告管理平台Marketing API开发文档《NO.32》

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取access_token的时候返回

media

struct

选填

媒体包参数结构

用于支持搜索

is_related_unit

bool

选填

是否关联快手广告组信息

默认false

page

int

选填

当前页码

默认为1

page_size

int

选填

分页大小

默认20，最大不超过50

media

字段

类型

是否必填

说明

备注

media_id

long

选填

媒体包ID

name

string

选填

媒体包名字

修改媒体包名

source_type

int

选填

媒体包来源

0-不限，未指定，1-行业优质流量包，2-广告主自定义，默认0

pos_ids

string[]

选填

广告位列表

修改媒体包广告位

status

int

选填

状态

删除媒体包，0-下线，1-上线，默认1

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

媒体包对象

data

字段

类型

说明

备注

datails

struct[]

关联广告组信息列表

total_count

long

总共条数

details

字段

类型

说明

备注

relate_units

struct[]

关联广告组信息列表

media

struct

媒体包信息

relate_units

字段

类型

说明

备注

unit_id

long

广告组ID

unit_name

string

广告组名字

campaign_id

long

广告计划ID

campaign_type

int

广告计划类型

计划类型，过滤筛选条件

1 - 作品推广；

2 - 提升应用安装；

3 - 获取电商下单；

4 - 推广品牌活动；

5 - 收集销售线索；

6 - 保量广告；

7 - 提高应用活跃

put_status

int

在投状态

UNKNOWN_PUT_STATUS = 0; // 默认值

PUT_STATUS_OPEN = 1; // 投放

PUT_STATUS_PAUSE = 2; // 暂停

PUT_STATUS_DeleteD = 3; // 删除

review_status

int

审核状态

UNKNOWN_REVIEW_STATUS = 0; // 默认值

REVIEW_WAIT_AUDIT = 1; //审核中

REVIEW_THROUGH = 2; //通过审核

REVIEW_NOT_THROUGH = 3; //审核未通过

BANNED = 4; //封禁

media_using

bool

媒体包是否在使用

media_type

int

媒体包的使用类型

0-未知，1-定向，2-排除

media

字段

类型

说明

备注

media_id

long

媒体包ID

name

string

媒体包名字

advertiser_id

long

广告主ID

source_type

int

媒体包来源

0-不限，未指定，1-行业优质流量包，2-广告主自定义，默认0

pos_ids

string[]

广告位列表

修改媒体包广告位

status

int

状态

删除媒体包，0-下线，1-上线，默认1

create_time

long

创建时间

时间戳

update_time

long

更新时间

请求样例

curl -X POST \

-H 'Access-Token: 69d99a7c1fdf3f4b271b' \

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

-d '{

  "advertiser_id":20000152,

  "media":{

      "media_id":213123213,

      "name":"新建定向媒体包",

      "soruce_type":2,

  },

  "is_related_unit": true,

  "pageInfo":{

      "current_page":1,

      "page_size":10,

   }

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

返回样例

{

  "code":0,

  "message":"OK",

  "data":{

      "details":[

          {

              "media":{

                  "media_id":337630,

                  "advertiser_id":42932,

                  "create_time":1603291774359,

                  "update_time":1603291774359,

                  "name":"test——2",

                  "source_type":2,

                  "pos_ids":[

                      "sadsads231afasfs",

                      "231erew232123231"

                  ],

                  "status":1

              },

              "relate_units":[

                  {

                      "unit_id":1213,

                      "unit_name":"媒体包测试组",

                      "campaign_id":23213112,

                      "campaign_type":2,

                      "put_status":1,

                      "media_type":1

                  }

              ]

          },

          {

              "media":{

                  "media_id":33890,

                  "account_id":42932,

                  "create_time":1563173027191,

                  "update_time":1563173027191,

                  "name":"模板_test_1",

                  "source_type":2,

                  "pos_ids":[

                      "212wqeqwe1312",

                      "23123eqweqwe21"

                  ],

                  "status":1

              },

              "relate_units":[

                  {

                      "unit_id":1213,

                      "unit_name":"媒体包测试组",

                      "campaign_id":23213112,

                      "campaign_type":2,

                      "put_status":1,

                      "media_type":1

                  }

              ]

          }

      ],

       "total_count":2

  }

}