DeviceList
本页内容
当前应用的设备记录列表。先读取标识类型、来源与一致性说明,再按游标分页;设备隐私能力单独授权。
如何阅读本模型
先从下方相关接口确认该模型用于请求还是响应,再按字段层级读取。请求模型由调用方填写,响应模型由平台返回;同名字段在不同模型中可能含义不同。
应用、版本、任务和回执的区别见基本概念。需要一份可跟做的示例时,从相关接口进入对应产品指南。
字段定义
“必需”指字段所在的对象出现时,该字段是否必须存在。类型中含 null 表示值允许为空;未返回、null、空字符串和零分别处理。
| 字段 | 必需 | 说明 |
|---|---|---|
app_id |
是 | 业务应用的完整 ID,来自列出应用或预留新应用的响应。 查看取值约束
|
generated_at |
是 | 本次结果的生成时间,Unix 秒。 查看取值约束
|
source |
是 | 设备明细的数据来源,devices 为已登记设备,overflow 为超限记录。 查看取值约束
|
device_identifier |
是 | 设备标识的来源和口径,为应用内统计标识。 查看取值约束
|
network_visible |
是 | 本次授权是否允许查看 IP 和地区。 |
consistency |
是 | 分页数据的一致性口径。实时留存记录可能在翻页期间发生变化。 查看取值约束
|
legacy_launches_may_exclude_first_open |
是 | 历史启动次数是否可能缺少首次打开。 查看取值约束
|
items |
是 | 与当前请求条件匹配的记录。数组元素的字段见下方各行。 查看取值约束
|
items[].device_id |
是 | 应用上报并由平台留存的设备标识,用于安装统计和游标查询。 查看取值约束
|
items[].ip |
是 | 获准访问的设备网络 IP。用作筛选条件时需要网络字段权限。 查看取值约束
|
items[].region |
是 | 平台记录的网络地区。用作筛选条件时需要网络字段权限。 查看取值约束
|
items[].first_seen_at |
是 | 首次登记时间,Unix 秒。 查看取值约束
|
items[].last_seen_at |
是 | 最近一次记录的打开时间,Unix 秒。 查看取值约束
|
items[].recorded_launches |
是 | 已留存的启动次数。 查看取值约束
|
next_cursor |
是 | 传给下一次请求的 cursor。为 null 表示已到末页。 查看取值约束
|
相关接口
下面根据接口定义列出使用本模型的操作,包括嵌套在其他对象中的情况。接口示例展示完整请求和响应;模型本身不会增加任何权限。