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