# analysis.getGameAnalysisData
本接口应在服务器端调用,详细说明参见服务端API。
获取小游戏分析数据。
# 请求地址
POST https://api.weixin.qq.com/datacube/getgameanalysisdata?access_token=ACCESS_TOKEN
# 请求参数
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
metric | string | 是 | 指标 id, 详见指标定义 | |
granularity | number | 是 | 时间粒度 | |
start_time | number | 是 | 开始时间戳(需按查询粒度的零时刻对齐) | |
end_time | number | 是 | 结束时间戳(需按查询粒度的零时刻对齐) | |
filter_list | Array.<Object> | 否 | 维度筛选列表,支持对1个或多个维度做条件过滤 | |
group_list | Array.<string> | 否 | 维度分组列表,展开单个粒度周期下的1个或多个维度的取值分布 | |
access_token / cloudbase_access_token | string | 是 | 接口调用凭证 |
granularity 的合法值
值 | 说明 | 最低版本 |
---|---|---|
1 | 1分钟 | |
5 | 5分钟 | |
60 | 1小时 | |
24 | 自然天 | |
7 | 自然周 | |
30 | 自然月 |
filter_list 的结构
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
dimension | string | 是 | 维度 id, 详见维度定义 | |
value | string | 是 | 维度的取值 |
# 返回值
# Object
返回的 JSON 数据包
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码(失败时才返回该字段) |
errmsg | string | 错误信息(失败时才返回该字段) |
data_list | Array.<Object> | 数据列表 |
errcode 的合法值
值 | 说明 | 最低版本 |
---|---|---|
0 | 请求成功 | |
61552 | 指标无效 | |
61553 | 粒度无效 | |
61554 | 时间范围无效 | |
61555 | 维度无效 | |
61556 | 维度重复 | |
61557 | 当前指标不支持该粒度 | |
61558 | 指标已废弃 | |
61559 | 指标不支持查询分布 | |
-10094011 | 接口访问频率限制 | |
-1 | 系统错误 |
data_list 的结构
属性 | 类型 | 说明 |
---|---|---|
timestamp | number | 数据时间戳 |
time_label | string | 数据时间标签 |
group_dimension_list | Array.<Object> | 维度取值分布列表 |
metric_value | number | 指标数值,当数据存在时该字段存在 |
group_dimension_list 的结构
属性 | 类型 | 说明 |
---|---|---|
value | string | 维度取值 |
label | string | 维度标签 |