向数据集添加数据点。数据集无需事先创建。
对检索此数据集的后续调用将会返回指定数据集中的所有点。数据点可以属于多个数据集。
此方法不使用补丁语义:提供的数据点只是插入,没有替换现有数据。
立即试用。
请求
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 对实际数据调用此方法,并查看响应。