将数据点添加到数据集。之前不需要创建数据集。给定数据集内的所有点都将返回,并调用此数据集进行后续调用。数据点可以属于多个数据集。
此方法不使用补丁语义:提供的数据点仅仅是插入的,没有替换现有数据。立即试用。
请求
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.dataset 资源的相关部分:
属性名称 | 值 | 说明 | 备注 |
---|---|---|---|
必需属性 | |||
dataSourceId |
string |
此数据集中创建点的数据源的 ID。 | |
maxEndTimeNs |
long |
可能属于数据集的一部分的所有数据点的最长结束时间。时间以纳秒为单位,从新纪元开始计算。此标识符还应与数据集标识符的第二部分相匹配。 | |
minStartTimeNs |
long |
此数据集中可能只有部分表示的所有数据点的最短开始时间。时间以纳秒为单位,从新纪元开始计算。此标识符还应与数据集标识符的第一部分相匹配。 | |
point[] |
list |
数据集中包含的部分数据点,按 endTimeNanos 排序。在修补小数据集或检索因过大而无法包含在单个响应中的数据集时,检索小数据集并认为部分数据完整。 | |
point[].dataTypeName |
string |
数据类型,用于定义此数据点中的值的格式。 | |
point[].endTimeNanos |
long |
此数据点所表示的时间段的结束时间(以自纪元以来的纳秒为单位)。 | |
point[].startTimeNanos |
long |
此数据点所表示间隔的开始时间(以自纪元以来的纳秒为单位)。 | |
point[].value[] |
list |
数据点的每个数据类型字段的值。与数据类型字段对应的每个值的出现顺序应与在数据源中指定的数据类型中列出的字段顺序相同。 系统只会填充整数字段和浮点字段中的一个,具体取决于数据源类型字段中的格式枚举值。 |
响应
如果成功,此方法将在响应正文中返回 Users.dataSources.dataset 资源。
试试看!
请使用下面的 API Explorer 针对实际数据调用此方法并查看响应。