查询特定数据源的用户数据点变化。 立即尝试。
请求
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 对实际数据调用此方法,并查看响应。