快手广告投放平台：建站工具模块API接口《NO.3》

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取access_token的时候返回

items

JSON

必填

待创建的微信号信息列表

新建微信号码个数至少为1，支持批量

wechat_id

string

必填

微信id

wechat_nickname

string

必填

微信昵称

wechat_account_type

int

必填

微信账号类型

1个人号   2公众号

wechat_app_id

string

公众号必填

微信APPID

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

JSON

success_map

Map<Integer, Long>

创建成功列表

key为入参的索引值，0开始;

value为创建成功的微信号码记录id

error_msg_map

Map<Integer, String>

创建失败列表

key为入参的索引值，0开始；

value为创建失败原因

请求样例

curl --location --request POST 'https://ad.e.kuaishou.com/rest/openapi/v2/gemini/wechat/item/create' \

--header 'access-token: 2001269897942cf166354de6d5c444b6' \

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

--data-raw '{

 "advertiser_id": 20000993,

 "items": [

     {

         "wechat_id": "hhhggg12022",

         "wechat_nickname": "小跳蛙1",

         "wechat_account_type": 1

     },

     {

         "wechat_id": "ba2dredhan2",

         "wechat_nickname": "APP1",

         "wechat_app_id": "72hfdi2893hc",

         "wechat_account_type": 2

     },

     {

         "wechat_id": "23dy2hdhc0823",

         "wechat_nickname": "APP2",

         "wechat_app_id": "23f8h03hf8f",

         "wechat_account_type": 2

     }

 ]

}'

返回样例

{

 "code": 0,

 "message": "OK",

 "data": {

     "success_map": {

         "0": 166256380663237067,

         "1": 166256380709374411,

         "2": 166256380847851979

     },

     "error_msg_map": {}

 }

}

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

广告主ID

在获取access_token的时候返回

pack_name

string

必填

微信号码名称

最多30个字符

item_ids

long[]

必填

微信包下的微信号码记录ID列表

个数至少为1

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

JSON

id

long

创建的微信号码包id

请求样例

curl --location --request POST 'https://ad.e.kuaishou.com/rest/openapi/v2/gemini/wechat/pack/create' \

--header 'access-token: 2001269897942cf166354de6d5c444b6' \

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

--data-raw '{

 "advertiser_id": 20000993,

 "pack_name": "小跳蛙号码包",

 "item_ids": [

     165893015545579979

 ]

}'

返回样例

{

 "code": 0,

 "message": "OK",

 "data": {

     "id": 165896647561513419

 }

}

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

广告主ID

在获取access_token的时候返回

ids

long[]

必填

待删除的微信号码记录ID列表

个数至少为1

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

JSON

success_list

long[]

删除成功id列表

error_msg_map

Map<Long,String>

key为删除失败id

value为失败原因

请求样例

curl --location --request POST 'https://ad.e.kuaishou.com/rest/openapi/v2/gemini/wechat/item/delete' \

--header 'access-token: 2001269897942cf166354de6d5c444b6' \

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

--data-raw '{

 "advertiser_id": 20000993,

 "ids": [

     165895207728253387

 ]

}'

返回样例

{

 "code": 0,

 "message": "OK",

 "data": {

     "success_list": [

         165895207728253387

     ],

     "error_msg_map": {}

 }

}