Users.dataSources.dataPointChanges: list

针对特定数据源的用户数据点变化的查询。 立即试用。

请求

HTTP 请求

GET https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/dataPointChanges

参数

参数名称 值 说明
路径参数
dataSourceId string 创建数据集的数据源的数据流 ID。
userId string 列出所标识的人员的数据点。使用 me 指明 与经过身份验证的用户相关联。目前仅支持 me。
可选的查询参数
limit integer 如果已指定，纳入的数据点更改将不会超过此数量 。
pageToken string 用于对大型结果集进行分页的延续令牌。 要获取下一页结果，请将此参数设置为 上一个响应中的 nextPageToken。

授权

此请求需要获得以下至少一个范围的授权：

范围
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.read
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.read
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.read
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.read
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write

如需了解详情，请参阅身份验证和授权页面。

请求正文

使用此方法时请勿提供请求正文。

响应

如果成功，此方法将返回采用以下结构的响应正文：

{
  "insertedDataPoint": [
    {
      "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
    }
  ],
  "deletedDataPoint": [
    {
      "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
}
属性名称 值 说明 备注
insertedDataPoint[] list 已为用户插入数据点。
insertedDataPoint[].startTimeNanos long 此数据点表示的间隔的开始时间（以纳秒为单位，自纪元开始）。
insertedDataPoint[].endTimeNanos long 此数据点表示的间隔的结束时间（以纳秒为单位，自纪元开始）。
insertedDataPoint[].dataTypeName string 用于定义此数据点中值格式的数据类型。
insertedDataPoint[].originDataSourceId string 如果数据点包含在派生数据源的数据集中，将在此字段中填充最初创建该数据点的数据源数据流 ID。

警告：此字段只能用于调试，请勿依赖此字段。此字段的值（如果已设置）属于实现细节，不能保证会保持一致。
insertedDataPoint[].value[] list 数据点的每个数据类型字段的值。与数据类型字段对应的每个值的出现顺序应与在数据源中指定的数据类型中列出的字段顺序相同。

系统将仅填充整数和浮点字段中的一个，具体取决于数据源的类型字段中的格式枚举值。
insertedDataPoint[].value[].intVal integer 整数值。设置此值后，就不能再设置其他值。
insertedDataPoint[].value[].fpVal double 浮点值。设置此值后，就不能再设置其他值。
insertedDataPoint[].value[].stringVal string 字符串值。设置此值后，就不能再设置其他值。应尽可能缩减字符串的数量。字符串值较大且数据频率较高的数据流可能会降采样。
insertedDataPoint[].value[].mapVal[] list 映射值。数据类型定义中应记录每个条目对应值的有效键空间和单位。应尽可能缩小键。密钥较大、数据频率较高的数据流可能会下采样。
insertedDataPoint[].value[].mapVal[].key string
insertedDataPoint[].value[].mapVal[].value nested object
insertedDataPoint[].value[].mapVal[].value.fpVal double 浮点值。
insertedDataPoint[].modifiedTimeMillis long 表示上次修改此数据点的时间。仅适用于我们列出数据更改（而非表示数据的当前状态）的上下文。
insertedDataPoint[].rawTimestampNanos long 原始 SensorEvent 的原始时间戳。
insertedDataPoint[].computationTimeMillis long 请勿使用此字段。它会被忽略，且不会被存储。
deletedDataPoint[] list 已删除用户的数据点。请注意，对于修改，应在处理插入之前解析该值。
deletedDataPoint[].startTimeNanos long 此数据点表示的间隔的开始时间（以纳秒为单位，自纪元开始）。
deletedDataPoint[].endTimeNanos long 此数据点表示的间隔的结束时间（以纳秒为单位，自纪元开始）。
deletedDataPoint[].dataTypeName string 用于定义此数据点中值格式的数据类型。
deletedDataPoint[].originDataSourceId string 如果数据点包含在派生数据源的数据集中，将在此字段中填充最初创建该数据点的数据源数据流 ID。

警告：此字段只能用于调试，请勿依赖此字段。此字段的值（如果已设置）属于实现细节，不能保证会保持一致。
deletedDataPoint[].value[] list 数据点的每个数据类型字段的值。与数据类型字段对应的每个值的出现顺序应与在数据源中指定的数据类型中列出的字段顺序相同。

系统将仅填充整数和浮点字段中的一个，具体取决于数据源的类型字段中的格式枚举值。
deletedDataPoint[].value[].intVal integer 整数值。设置此值后，就不能再设置其他值。
deletedDataPoint[].value[].fpVal double 浮点值。设置此值后，就不能再设置其他值。
deletedDataPoint[].value[].stringVal string 字符串值。设置此值后，就不能再设置其他值。应尽可能缩减字符串的数量。字符串值较大且数据频率较高的数据流可能会降采样。
deletedDataPoint[].value[].mapVal[] list 映射值。数据类型定义中应记录每个条目对应值的有效键空间和单位。应尽可能缩小键。密钥较大、数据频率较高的数据流可能会下采样。
deletedDataPoint[].value[].mapVal[].key string
deletedDataPoint[].value[].mapVal[].value nested object
deletedDataPoint[].value[].mapVal[].value.fpVal double 浮点值。
deletedDataPoint[].modifiedTimeMillis long 表示上次修改此数据点的时间。仅适用于我们列出数据更改（而非表示数据的当前状态）的上下文。
deletedDataPoint[].rawTimestampNanos long 原始 SensorEvent 的原始时间戳。
deletedDataPoint[].computationTimeMillis long 请勿使用此字段。它会被忽略，且不会被存储。
nextPageToken string 用于对大型结果集进行分页的延续令牌。在后续请求中提供此值以返回下一页结果。
dataSourceId string 包含数据点变化的数据源的数据流 ID。

试试看！

使用下面的 API Explorer 对实际数据调用此方法，然后查看响应。