Users.dataSources.datasets

数据集表示数据点的投影容器。他们自己不携带任何信息。数据集表示来自特定数据源的一组数据点。一个数据点可在多个数据集中找到。

有关此类资源的方法列表,请参阅本页面的结尾部分。

资源表示法

{
  "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 字符串值。设置此值后,不得设置其他值。字符串应尽可能保持小。字符串值较大且数据频率较高的数据流可能会被降采样。

方法

删除
执行包含开始时间和结束时间与数据集 ID 指定的时间范围重叠的所有数据点的包含性删除。对于大多数数据类型,整个数据点都会被删除。对于时间跨度表示一致值的数据类型(例如 com.google.activity.segment),并且数据点跨越数据集的任意端点,系统仅会删除数据点的重叠部分。
get
返回一个数据集,其中包含的数据点的开始和结束时间与数据集最短开始时间和最长结束时间的指定范围重叠。具体而言,开始时间早于或等于数据集结束时间的任何数据点,以及其结束时间大于或等于数据集开始时间的任何数据点。
patch
向数据集添加数据点。数据集无需事先创建。 对检索此数据集的后续调用将会返回指定数据集中的所有点。数据点可以属于多个数据集。

此方法不使用补丁语义:提供的数据点只是插入,没有替换现有数据。