数据集表示数据点的投影容器。此类信息不附带任何信息。数据集表示来自特定数据源的一组数据点。数据点可能存在于多个数据集中。
有关此类资源的方法列表,请参阅本页面的结尾部分。
资源表示法
{ "minStartTimeNs": long, "maxEndTimeNs": long, "dataSourceId": string, "point": [ { "startTimeNanos": long, "endTimeNanos": long, "dataTypeName": string, "originDataSourceId": string, "value": [ { "intVal": integer, "fpVal": double, "stringVal": string, "mapVal": [ { "key": string, "value": { "fpVal": double } } ] } ], "modifiedTimeMillis": long, "rawTimestampNanos": long, "computationTimeMillis": long } ], "nextPageToken": string }
属性名称 | 值 | 说明 | 备注 |
---|---|---|---|
dataSourceId |
string |
此数据集中创建点的数据源的 ID。 | |
maxEndTimeNs |
long |
可能属于数据集的一部分的所有数据点的最长结束时间。时间以纳秒为单位,从新纪元开始计算。此标识符还应与数据集标识符的第二部分相匹配。 | |
minStartTimeNs |
long |
此数据集中可能只有部分表示的所有数据点的最短开始时间。时间以纳秒为单位,从新纪元开始计算。此标识符还应与数据集标识符的第一部分相匹配。 | |
nextPageToken |
string |
当收到响应 GET 数据集的数据集但数据集太大而无法包含在单个响应中时,将设置此令牌。在后续 GET 请求中提供此值,以返回此数据集中的下一页数据点。 | |
point[] |
list |
数据集中包含的部分数据点,按 endTimeNanos 排序。在修补小数据集或检索因过大而无法包含在单个响应中的数据集时,检索小数据集并认为部分数据完整。 | |
point[].computationTimeMillis |
long |
请勿使用此字段。它会被忽略,不会被存储。 | |
point[].dataTypeName |
string |
数据类型,用于定义此数据点中的值的格式。 | |
point[].endTimeNanos |
long |
此数据点所表示的时间段的结束时间(以自纪元以来的纳秒为单位)。 | |
point[].modifiedTimeMillis |
long |
表示此数据点的上次修改时间。仅在我们列出数据更改(而不是表示数据的当前状态)的环境中有用。 | |
point[].originDataSourceId |
string |
如果数据点包含在某个派生数据源的数据集中,系统会使用填充最初创建该数据源的数据源 ID 填充此字段。 警告:除调试外,请勿将此字段用于任何其他用途。如果设置了此字段,则其值是实现细节,并不保证始终保持一致。 |
|
point[].rawTimestampNanos |
long |
原始 SensorEvent 的原始时间戳。 | |
point[].startTimeNanos |
long |
此数据点所表示间隔的开始时间(以自纪元以来的纳秒为单位)。 | |
point[].value[] |
list |
数据点的每个数据类型字段的值。与数据类型字段对应的每个值的出现顺序应与在数据源中指定的数据类型中列出的字段顺序相同。 系统只会填充整数字段和浮点字段中的一个,具体取决于数据源类型字段中的格式枚举值。 |
|
point[].value[].fpVal |
double |
浮点值。如果设置此属性,则不得设置其他值。 | |
point[].value[].intVal |
integer |
整数值。如果设置此属性,则不得设置其他值。 | |
point[].value[].mapVal[] |
list |
映射值。每个条目的对应值的有效键空间和单位应作为数据类型定义的一部分进行记录。键应尽可能小。具有较大键和高数据频率的数据流可能会降采样。 | |
point[].value[].mapVal[].key |
string |
||
point[].value[].mapVal[].value |
nested object |
||
point[].value[].mapVal[].value.fpVal |
double |
浮点值。 | |
point[].value[].stringVal |
string |
字符串值。如果设置此属性,则不得设置其他值。字符串应尽可能小。具有较大字符串值和数据频率的数据流可能会降采样。 |
方法
- delete
- 删除所有开始和结束日期与数据集 ID 指定的时间范围重叠的数据点。对于大多数数据类型,系统会删除整个数据点。对于时间跨度表示一致的值的数据类型(例如
com.google.activity.segment
),并且数据点横跨数据集的任何端点,系统只会删除数据点的重叠部分。 - get
- 返回一个数据集,其中包含开始时间和结束时间与数据集的指定最短范围和最长结束时间重叠的所有数据点。具体而言,开始时间短于或等于数据集结束时间且结束时间大于或等于数据集开始时间的任何数据点。
- 补丁程序
- 向数据集添加数据点。之前不需要创建数据集。给定数据集内的所有点都将返回,并调用此数据集进行后续调用。数据点可以属于多个数据集。
此方法不使用修补语义:所提供的数据点只是插入而已,没有替换现有数据。