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

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

广告主ID

在获取accessToken的时候返回

type

int

可选

上传图片类型

默认为2

1：上传app_icon图片；

2：广告组设置中scene_id为7时的封面图片；

4：广告组设置中scene_id为3时的便利贴广告素材图片

upload_type

int

必填

上传方式

1: 通过文件上传；2: 通过图片url上传

file

file

图片文件

upload_type为1时必填，详细要求见附录

url

string

图片url

upload_type为2时必填，详细要求见附录

signature

string

图片md5值

用于服务端校验，当 upload_type为1时必填

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

url

string

图片预览地址

width

long

图片宽度

height

long

图片高度

size

long

图片大小

format

string

图片格式

signature

string

图片md5值

image_token

string

图片token

创建创意时使用

请求样例

curl -X POST \

-H 'Access-Token: 69d99a7c1fdf3f4b271b' \

-H 'Content-Type: multipart/form-data' \

-F "advertiser_id=200152" \

-F "type=2" \

-F "upload_type=1" \

-F "file=@/Users/jackchou/Downloads/ad-material/1280.jpg" \

-F "signature=69d99a7c1fdf3f4b271b" \

-L https://ad.e.kuaishou.com/rest/openapi/v2/file/ad/image/upload

返回样例

{

 "code":0,

 "message":"OK",

 "data":{

   "url":"http://tx2.a.yximgs.com/udata/pkg/ma83d97a19866ec81b.jpg",

   "width":720,

   "height":1280,

   "size":62491,

   "format":"jpg",

   "signature":"69d99a7c1fdf3f4b271b",

   "image_token":"b5f183d9760c4959866ec81b"

 }

}

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

广告主ID

在获取access_token的时候返回

start_date

string

可选

开始时间

与end_date同时传或同时不传；

过滤筛选条件，格式为"yyyy-MM-dd"

end_date

string

可选

结束时间

与start_date同时传或同时不传；

过滤筛选条件，格式为"yyyy-MM-dd"

page

int

请求的页码数

默认1

page_size

int

每页行数

默认20，不超过500

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

details

struct

详情

url

string

图片预览地址

width

long

图片宽度

height

long

图片高度

size

long

图片大小

format

string

图片格式

signature

string

图片MD5

image_token

string

图片token

创建创意时使用

total_count

int

图片总数

请求样例

curl -X GET \

 -H 'Access-Token: 76021ddf612c3ffd57c3c' \

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

 -d '{

   "advertiser_id": 20000800,

   "page_size":1,

   "page":1

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

返回样例

{

   "code": 0,

   "message": "OK",

   "data": {

       "total_count": 4,

       "details": [

           {

               "url": "http://static.yximgs.com/udata/pkg/markb21f94845c4350.jpg",

               "width": 720,

               "height": 1280,

               "size": 441029,

               "format": "jpg",

               "signature": "44a20b91b0727fa2abb68b19c0456422",

               "image_token": "market0a8a3104ee6b4f148ab21f94845c4350.jpg"

           }

       ]

   }

}