向数据集添加数据点。无需事先创建数据集。
在后续调用中将返回给定数据集内的所有点
检索此数据集。数据点可以属于多个数据集。
此方法不使用补丁语义:提供的数据点是
直接插入,不会替换现有数据。
立即试用。
请求
HTTP 请求
PATCH https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
参数
参数名称 | 值 | 说明 |
---|---|---|
路径参数 | ||
dataSourceId |
string |
创建数据集的数据源的数据流 ID。 |
datasetId |
string |
不使用此字段,但可以放心地将其省略。 |
userId |
string |
为被识别的人员修补数据集。使用 me 指明
与经过身份验证的用户相关联。目前仅支持 me 。
|
授权
此请求需要获得以下至少一个范围的授权:
范围 |
---|
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
如需了解详情,请参阅身份验证和授权页面。
请求正文
在请求正文中,根据补丁语义规则提供 Users.dataSources.datasets 资源的相关部分,此相关部分应具有以下属性:
属性名称 | 值 | 说明 | 备注 |
---|---|---|---|
必需属性 | |||
dataSourceId |
string |
在此数据集中创建点的数据源的数据流 ID。 | |
maxEndTimeNs |
long |
数据集的这种可能的部分表示形式中所有数据点的最大结束时间。时间以纳秒为单位,从新纪元开始计算。这也应与数据集标识符的第二部分相匹配。 | |
minStartTimeNs |
long |
数据集的这种可能的部分表示形式中所有数据点的最短开始时间。时间以纳秒为单位,从新纪元开始计算。这也应与数据集标识符的第一部分相匹配。 | |
point[] |
list |
数据集中包含的部分数据点列表,按 endTimeNanos 排序。如果检索的是小型数据集,则此列表被视为完整;而对于修补数据集或检索的数据集因过大而无法包含在单个响应中时,此列表会被视为部分内容。 | |
point[].dataTypeName |
string |
用于定义此数据点中值格式的数据类型。 | |
point[].endTimeNanos |
long |
此数据点表示的间隔的结束时间(以纳秒为单位,自纪元开始)。 | |
point[].startTimeNanos |
long |
此数据点表示的间隔的开始时间(以纳秒为单位,自纪元开始)。 | |
point[].value[] |
list |
数据点的每个数据类型字段的值。与数据类型字段对应的每个值的出现顺序应与在数据源中指定的数据类型中列出的字段顺序相同。 系统将仅填充整数和浮点字段中的一个,具体取决于数据源的类型字段中的格式枚举值。 |
响应
如果成功,此方法将在响应正文中返回一项 Users.dataSources.datasets 资源。
试试看!
使用下面的 API Explorer 对实际数据调用此方法,然后查看响应。