数据集表示数据点的投影容器。它们不会携带任何自己的信息。数据集表示来自特定数据源的一组数据点。一个数据点可能存在于多个数据集内。
有关此类资源的方法列表，请参阅本页面的结尾部分。
资源表示法
{
"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
- 返回一个数据集，其中包含开始和结束时间的所有数据点 与数据集最短开始时间的指定范围重叠， 最长结束时间。具体而言，开始时间短于此时间段的任何数据点 大于或等于数据集结束时间，且结束时间大于或等于 与数据集开始时间相同。
- patch
- 向数据集添加数据点。无需事先创建数据集。
在后续调用中将返回给定数据集内的所有点
检索此数据集。数据点可以属于多个数据集。
此方法不使用补丁语义：提供的数据点是 直接插入，不会替换现有数据。