报告级API接口

优质

小牛编辑

130浏览

2023-12-01

报告级的 API 接口，需要用户参数、应用参数和报告参数，所需参数、获取数据与百度移动统计站点的报告数据一致，具体接口如下：

接口

https://openapi.baidu.com/rest/2.0/mtj/svc/app/getDataByKey

每个查询均需要用户参数，应用参数，报告参数三个分类的参数，其中标记为必须的，每个查询都需要带有。

参数名	类型	是否必须	描述	样例
access_token	string	是	用户登入后获取的token	1.a6b7dbd428f731035f771b8d15063f61.86400.1292922000-2346678-124328

参数名	类型	是否必须	描述	样例
key	string	是	应用KEY，MTJ 站点 APPKEY	4b****9c

报告参数包括但不限于以下参数列表，具体每个报表所支持的参数见每个报表的说明。

参数名	类型	是否必须	描述	样例
method	string	是	查询的报告数据接口，每个报告不同	newuser/a
metrics	string	是	以逗号分隔的需要查询的指标，具体每个报告的指标见报告说明	user_count
gran	string	否	查询数据的时间粒度，只支持有该参数的报告,取值为day/hour/week/month，每个报告可取值不同	day
start-date	string	是	查询的起始时间	20170501000000
end-date	string	是	查询的结束时间	20170530235959
start-date2	string	否	对比查询的起始时间，对支持对比查询的报表有效	20170501000000
end-date2	string	否	对比查询的结束时间，对支持对比查询的报表有效	20170530235959
channel	string	否	以逗号拼接的渠道号（最多20位数字），作为渠道筛选	13843091911868416,3329055359020040241
version	string	否	以都厚拼接的版本号（最多20位数字），作为版本筛选	13561604050255872,3328210947783339568
start-index	uint	否	获取数据偏移，用于分页，默认为0	20
max-results	uint	否	单次调用获取的数据条数，默认是20	20

请求的报告返回格式每个报告基本相同，主要由以下几部分组成

其中，ReportData对应的结构为:

参数名	参数类型	描述
fields	array of string	指标列表
sum	array of string	总计数据
items	array	指标数据，由4部分构成（0：首列数据，1：指标数据，2：对比时间段数据，3：变化率数据）
total	uint	总计条目