数据源添加
请求地址
https://api.e.qq.com/v1.1/data_source/add
请求方法
POST
所属权限
User Actions
请求参数
参数名 | 描述 |
---|---|
access_token | 授权令牌,完成 OAuth 2.0 授权后获得,参考开发者环境 |
timestamp | 当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳签名算法。MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59 |
nonce | 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性 |
请求体类型
application/json
请求体参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
account_id | integer | Y | 推广帐号 id或 DataNexus 账号 id |
type | enum | Y | 数据源类型,枚举列表:{ WEB, ANDROID, IOS, OFFLINE, WECHAT, WECHAT_MINI_PROGRAM, WECHAT_MINI_GAME } |
mobile_app_id | integer | 应用 id,IOS:App Store id ; ANDROID:应用宝 id,type=ANDROID 或 IOS 时必填 | |
wechat_app_id | integer | 微信 AppID,当 type = WECHAT 或 WECHAT_MINI_PROGRAM 或 WECHAT_MINI_GAME 时必填字段长度最小 2 字节,长度最大 64 字节 | |
name | integer | Y | 数据源源名称,当 type=WEB 时必填,当 type=ANDROID 或 IOS 或 WECHAT 或 WECHAT_MINI_PROGRAM 或 WECHAT_MINI_GAME时,若未填写该字段,则默认通过 mobile_app_id/wechat_app_id 获取名称字段长度最小 1 字节,长度最大 32 字节 |
请求体示例
curl 'https://api.e.qq.com/v1.1/data_source/add?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
"account_id": "<ACCOUNT_ID>",
"type": "WEB",
"name": "webuser",
"description": "",
"usages": []
}'
应答体结构
名称 | 类型 | 描述 |
---|---|---|
data_source_id | integer | 数据源 id |
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"data_source_id": 1111111111
}
}