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

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取access_token的时候返回

photo_ids

string[]

必填

视频ID

1.目前只支持一次查询一个photo_id关键帧；

2.视频的user_id要与当前account的user_id一致

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

请求样例

curl -X GET \

 -H 'Access-Token: 6acd879e43a32b58b5' \

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

 -d '{

   "advertiser_id":20000800,

   "photo_ids":["5189835635550640193"]

 }' -L https://ad.e.kuaishou.com/rest/openapi/v1/tool/key_frame

返回样例

{

   "code": 0,

   "message": "OK",

   "data": [

       "https://ali2.a.yximgs.com/bs2/multicover/4338454.jpg",

       "https://ali2.a.yximgs.com/bs2/multicover/6414979.jpg",

       "https://ali2.a.yximgs.com/bs2/multicover/6759047.jpg",

       "https://ali2.a.yximgs.com/bs2/multicover/6918688.jpg",

       "https://ali2.a.yximgs.com/bs2/multicover/7066256.jpg",

       "https://ali2.a.yximgs.com/bs2/multicover/7164708.jpg",

       "https://ali2.a.yximgs.com/bs2/multicover/7254790.jpg",

       "https://ali2.a.yximgs.com/bs2/multicover/7324291.jpg"

   ]

}

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手视频广告主ID

在获取access_token的时候返回

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

name

string

创意词包名称

replace_words

string[]

替换词

default_word

string

默认词

max_word_length

int

替换词最大长度

请求样例

curl -X GET \

 -H 'Access-Token: 6acd879e43a32b58b5' \

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

 -d '{

   "advertiser_id": 20000152

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

返回样例

{

   "code": 0,

   "message": "OK",

   "data": [

       {

           "name": "日期",

           "replace_words": [

               "今天"

           ],

           "default_word": "今天",

           "max_word_length": 2

       },

       {

           "name": "星期",

           "replace_words": [

               "星期一",

               "星期二",

               "星期三",

               "星期四",

               "星期五",

               "星期六",

               "星期天"

           ],

           "default_word": "周末",

           "max_word_length": 3

       }

}