# 用户数据授权接入

# 0. 背景

目前为了合规获取用户数据，平台在获取用户相关游戏数据前，必须经过用户授权后才能获取。

# 1. 平台请求接口

平台来请求 腾讯游戏来联，需要按照 腾讯游戏来联 的签名规则接入。

# 1.1 通用说明

# 域名

正式环境：https://s1.livelink.qq.com

测试环境：https://testapi-open.livelink.qq.com

# 参数说明

公共参数

# 签名计算

sig 签名

# 1.2 查询用户是否授权接口

# 使用说明

用来判断用户在具体场景下是否有授权

# 请求方式

POST

# 请求路由

/livelink?c=Index&a=GetGameGrantInfo

# 请求参数

{
  "scene": "xxx" // 具体场景值
}
1
2
3

场景值推算方式： act_{活动ID}。如：当前活动ID为2455，则场景值scene字段填写：act_2455。

# 返回参数

已授权返回示例

{
  "iRet": 0, // 0-正常，其他-异常
  "sMsg": "ok",
  "tid": 205215269096827186, // 请求id
  "jData": {
    "isGranted": true
  }
}
1
2
3
4
5
6
7
8

未授权返回示例

{
  "apiName": "Error",
  "iRet": -16018,
  "jData": {},
  "sMsg": "活动用户未授权",
  "tid": "234173888135754238",
  "v": 2
}
1
2
3
4
5
6
7
8

# 2. 前端接入

# 2.1 小程序隐私授权接入

参见小程序接入

# 2.2 PC隐私授权接入

参见PC中间页接入

# 2.3 隐私授权测试

隐私授权工具地址： https://livelink.qq.com/activities/#/testTool?activeName=gameDataAuth (opens new window)

# 3. 隐私授权信息推送接入(非必须)

# 3.1 说明

用户在绑定中心完成隐私授权开关操作后或者项目组变更了隐私授权权限点，腾讯侧可以调用平台的接口实时通知消息

# 3.2 平台接入推送

统一接入说明参考

# 3.3 推送数据说明

参数 类型 描述
gameCode string 游戏业务的缩写，腾讯游戏来联已接入业务查询
reqType string rolePrivacyChange（用户数据角色授权更改） privacyAuthChange（隐私授权权限点变更事件）
anchor string 平台用户id，reqType=privacyAuthChange场景下默认返回空
data string 推送具体数据内容，根据reqType不同返回不同数据

# 场景一：用户角色授权变化推送

背景：用户通过绑定中心对角色操作隐私授权变动时，把当前角色的隐私授权状态推送给平台

# 推送数据格式

{
    "gameCode":"cfm",
    "reqType":"rolePrivacyChange", // 角色授权变更
    "data":"{\"gameAuthScene\":\"act_905\",\"rolePrivacyState\":true,\"gameAuthVersion\":\"20220629184016\",\"fromId\":\"xxxxxx\"}", // fromId为平台拉起账户绑定传入来源id
    "anchor":"2297201120", // 平台用户id
    "uid": "2297201120" // 平台用户id与anchor保持一致
}
1
2
3
4
5
6
7

# data数据详解

参数名 类型 描述
gameAuthScene string 隐私授权的key
rolePrivacyState bool 当前用户角色的授权状态,true 已授权，false 没授权
gameAuthVersion string 当前隐私授权的版本

# 场景二：发布或者重新发布隐私授权权限点

背景：腾讯游戏来联的隐私授权点信息通过管理端配置，当权限点配置发生变动时，所有用户需要重新授权

# 推送数据格式

{
    "gameCode":"cf",
    "reqType":"privacyAuthChange",
    "data":"{\"gameAuthScene\":\"act_850\",\"gameAuthVersion\":\"20220629184016\",\"needUserAuth\":true}",
    "anchor":"", 
}
1
2
3
4
5
6

# data数据详解

参数名 类型 描述
gameAuthScene string 隐私授权的key
gameAuthVersion string 当前隐私授权的版本
needUserAuth bool 是否需要用户授权 true 需要 false 不需要

# 3.4 注意事项

隐私授权只跟用户的游戏角色挂钩，平台uid换绑角色，角色没有授权也需重新授权；权限点发生更改时，用户需要重新授权；处理方案：平台请求腾讯游戏来联相关流程（发货、条件等）会提示用户活动用户未授权，返回错误码为-16018，平台需根据改错误码做相应的处理

lastUpdate: 6/5/2024, 2:53:25 PM

← 平台登录能力接入 →