王尘宇

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取access_token的时候返回

page

int

选填

请求的页码

默认为1

page_size

int

选填

每页行数

默认为20，上限500

pack_ids

long[]

选填

微信号码包id集合

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

JSON

total_count

int

数据的总行数

details

JSON

数据明细信息

id

long

微信号码包id

pack_name

string

微信号码包名称

item_list

JSON

线索号码明细信息

WechatItem列表

related_page_ids

long[]

使用了当前微信号包的落地页id列表

WechatItem

字段

类型

说明

id

long

微信号码记录id

wechat_id

string

微信id

wechat_nickname

string

微信昵称

wechat_account_type

int

微信账号类型

wechat_app_id

string

微信appId

use_count

int

复制次数

related_page_ids

long[]

使用了当前微信号的落地页id列表

请求样例

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

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

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

--data-raw '{

 "advertiser_id": 20000993,

 "pack_ids": [

     165894775509420491,

     165896647561513419

 ]

}'

返回样例

{

 "code": 0,

 "message": "OK",

 "data": {

     "total_count": 2,

     "details": [

         {

             "id": 165896647561513419,

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

             "item_list": [

                 {

                     "id": 165893015545579979,

                     "wechat_id": "hhhggg1202",

                     "wechat_nickname": "小跳蛙",

                     "wechat_app_id": "",

                     "wechat_account_type": 1,

                     "use_count": 0,

                     "related_pack_ids": [

                         165894775509420491,

                         165896647561513419

                     ],

                     "related_page_ids": []

                 }

             ],

             "related_page_ids": []

         },

         {

             "id": 165894775509420491,

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

             "item_list": [

                 {

                     "id": 165893015545579979,

                     "wechat_id": "hhhggg1202",

                     "wechat_nickname": "小跳蛙",

                     "wechat_app_id": "",

                     "wechat_account_type": 1,

                     "use_count": 0,

                     "related_pack_ids": [

                         165894775509420491,

                         165896647561513419

                     ],

                     "related_page_ids": []

                 },

                 {

                     "id": 165895207728253387,

                     "wechat_id": "hhhggg12021",

                     "wechat_nickname": "小跳蛙1",

                     "wechat_app_id": "",

                     "wechat_account_type": 1,

                     "use_count": 0,

                     "related_pack_ids": [

                         165894775509420491

                     ],

                     "related_page_ids": []

                 }

             ],

             "related_page_ids": []

         }

     ]

 }

}

code

msg

描述

0

OK

成功

code

msg

描述

400000

系统繁忙

不可知错误

400001

请求过于频繁

400002

没有权限进行相关操作

没有权限进行相关操作

code

msg

描述

401000

参数错误

部分参数缺失

401001

参数格式错误

参数不符合格式要求

401002

选取时间跨度过大

日期跨度不符合要求

401003

选取起始时间超过允许范围

401004

选取起始时间晚于结束时间

401005

名称重复

code

msg

描述

402000

access_token过期

402001

refresh_token过期

402002

auth_code过期

402003

access_token为空

402004

access_token错误

402005

refresh_token错误

402006

auth_code错误

402007

账户状态异常

402008

授权类型错误

402009

密钥错误

402010

申请权限过大

申请的权限大于应用申请时填写的权限

402011

回调地址错误

redirect_uri不是应用申请时填写的回调地址

402012

应用不存在

code

msg

描述

410000

获取报表数据异常

410001

没有数据权限

试图获取非本账户的数据

410002

优化目标optimize_target错误