跳到主要内容

数据源获取


请求地址​

https://api.e.qq.com/v3.0/user_action_sets/get


请求方法​

GET


所属权限​

数据上报（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_idintegerY
推广帐号 id或 DataNexus 账号 id
user_action_set_idinteger
用户行为源 id，通过 user_action_sets 接口 创建用户行为源时分配的唯一 id。请注意，当填写的用户行为数据源类型为 {WECHAT, WECHAT_MINI_PROGRAM, WECHAT_MINI_GAME} 时，必填 user_id 字段中的 wechat_openid (或 wechat_unionid) 及 wechat_app_id。
typeenum[]
数据源类型，见 枚举值
mobile_app_idinteger
应用 id，IOS：App Store id ； ANDROID：应用宝 id，type=ANDROID 或 IOS 时必填
wechat_app_idstring
微信 AppID，当 type = WECHAT 或 WECHAT_MINI_PROGRAM 或 WECHAT_MINI_GAME 时必填字段长度最小 2 字节，长度最大 64 字节
namestring
用户行为源名称，当 type=WEB 时必填，当 type=ANDROID 或 IOS 时，若未填写该字段，则默认通过 mobile_app_id 获取名称字段长度最小 1 字节，长度最大 32 字节
include_permissionboolean
是否返回数据源权限信息，true 表示返回，false 表示不返回，可选值：{ true, false }

请求体示例​

curl -G 'https://api.e.qq.com/v1.1/user_action_sets/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'user_action_set_id=1111111111' \
-d 'type=WEB' \
-d 'name=webuser_action_set'

应答体结构​

名称类型描述
listarray
返回数组列表
user_action_set_idinteger
用户行为源 id，通过 user_action_sets 接口 创建用户行为源时分配的唯一 id。请注意，当填写的用户行为数据源类型为 {WECHAT, WECHAT_MINI_PROGRAM, WECHAT_MINI_GAME} 时，必填 user_id 字段中的 wechat_openid (或 wechat_unionid) 及 wechat_app_id。
typeenum
数据源类型，见 枚举值
mobile_app_idinteger
应用 id，IOS：App Store id ； ANDROID：应用宝 id，type=ANDROID 或 IOS 时必填
namestring
用户行为源名称，当 type=WEB 时必填，当 type=ANDROID 或 IOS 时，若未填写该字段，则默认通过 mobile_app_id 获取名称
descriptionstring
用户行为源描述
activate_statusstring
数据接入状态，true 表示已接入，false 表示未接入
created_timestring
创建时间，格式为 yyyy-MM-dd HH:mm:ss，如 2023-01-01 10:42:56
access_waystring
数据源来源，见 枚举值
usagesenum[]
接入用途类型，如需分发给 pKAM,填写 DEEP_DATA_COOPERATION
enable_conversion_claimboolean
是否开启转化归因，true 表示开启，false 表示不开启，不传则默认开启
permissionobject
数据源权限
can_create_audienceboolean
是否可以提取人群，true 表示可以，false 表示不可以
can_exact_conversion_claimboolean
是否可以精准归因，true 表示可以，false 表示不可以
can_as_servingboolean
是否可以投放广告，true 表示可以，false 表示不可以

应答示例​

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "type": "WEB",
                "name": "webuser_action_set",
                "description": "",
                "user_action_set_id": 1111111111,
                "activate_status": true,
                "created_time": "2017-02-20 16:04:27"
            }
        ]
    }
}



该内容是否有帮助？