数据源分发关系更新
请求地址
https://api.e.qq.com/v3.0/data_source_dispatch/update
请求方法
POST
所属权限
数据上报(User Actions)
请求参数
参数名 | 描述 |
---|---|
access_token | 密钥信息,可在 DataNexus 的 数据源 - 【查看密钥】获取 |
timestamp | 当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳签名算法。MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59 |
nonce | 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性 |
请求体类型
application/json
请求体参数
阅读说明:Y - 必填;C - 条件选填(conditional),请关注“描述”信息;空 - 非必填
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
account_id | integer | Y | 推广帐号 id或 DataNexus 账号 id |
data_source_scenes | array | Y | 数据源分发列表,不能大于 50KB,数组最小长度 1,最大长度 50 |
user_action_set_id | integer | Y | 数据源 id,通过DataNexus创建数据源时分配的唯一 id,请注意,当填写的用户行为数据源类型为 {WECHAT, WECHAT_MINI_PROGRAM, WECHAT_MINI_GAME} 时,必填 user_id 字段中的 wechat_openid (或 wechat_unionid) 及 wechat_app_id |
scenes | array | Y | 应用场景信息 |
scene | enum | Y | 应用场景类型,见 枚举值 |
asset_ids | string | 资产列表 | |
data_set_id | integer | C | 数据集ID,更新商品应用场景时必填 |
catalog_id | integer | C | 商品库ID,更新动态商品广告应用场景时必填 |
switch_type | enum | 数据源分发开关,见 枚举值 |
请求体示例
curl 'https://api.e.qq.com/v1.1/data_source_dispatch/update?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
"account_id": 111111,
"switch_type": "SWITCH_ON",
"data_source_scenes":[
{
"data_source_id": 1111111111,
"scenes": [
{
"scene": "DMP",
"asset_ids": [
{
}
]
}
]
}
]
}'
应答体结构
名称 | 类型 | 描述 |
---|---|---|
success_count | integer | 成功个数 |
fail_list | array | 文件分发失败信息 |
user_action_set_id | integer | 数据源 id |
scenes | array | 应用场景信息 |
scene | string | 应用场景id,见 枚举值 |
asset_ids | array | 资产列表 |
data_set_id | string | 数据集id,更新商品应用场景时必填 |
catalog_id | string | 商品库ID,更新动态商品广告应用场景时必填 |
fail_reason | string | 失败原因 |
fail_reason | string | 失败原因 |
fail_reason | string | 失败原因 |
应答体示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"fail_list": [],
"success_count": 1
}
}
该内容是否有帮助?