跳到主要内容

上传客户人群数据文件


请求地址​

https://api.e.qq.com/v1.3/custom_audience_files/add


请求方法​

POST


所属权限​

人群管理（Audience Management）


请求参数​

参数名描述
access_token授权令牌，完成 OAuth 2.0 授权后获得，参考开发者环境
timestamp当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳签名算法。MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59
nonce随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性

请求体类型​

multipart/form-data


请求体参数​

阅读说明：Y - 必填；C - 条件选填（conditional），请关注“描述”信息；空 - 非必填

名称类型必填描述
account_idintegerY
推广帐号 id或 DataNexus 账号 id
audience_idintegerY
人群 id，通过 custom_audiences/add 接口创建客户人群获得
user_id_typeenumY
号码包类型，见 枚举值
filefileY
上传人群文件，txt 或者 csv 文件每行一个号码，文件压缩后的 zip 包，压缩后的 zip 包不超过 100M
operation_typeenum
文件操作类型，见 枚举值，如果不填则默认为 APPEND
open_app_idstring
微信/QQ 手机版 appid，当且仅当数据文件中的用户 id 类型为 'WECHAT_OPENID'（WX_OPENID）或 'MOBILE_QQ_OPENID' 时有效字段长度最小 1 字节，长度最大 128 字节

请求体示例​

curl 'https://api.e.qq.com/v1.1/custom_audience_files/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-F 'account_id=<ACCOUNT_ID>' \
-F 'audience_id=<AUDIENCE_ID>' \
-F 'user_id_type=IMEI' \
-F 'file=@/usr/local/my/audiencefile.zip'

应答体结构​

名称类型描述
custom_audience_file_idinteger
数据文件 id

应答示例​

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "custom_audience_file_id": "<CUSTOM_AUDIENCE_FILE_ID>"
    }
}



该内容是否有帮助？