更新或插入给定会话。 立即尝试。
请求
HTTP 请求
PUT https://www.googleapis.com/fitness/v1/users/userId/sessions/sessionId
参数
参数名称 | 值 | 说明 |
---|---|---|
路径参数 | ||
sessionId |
string |
要创建的会话的 ID。 |
userId |
string |
为识别到的用户创建会话。使用 me 指示经过身份验证的用户。目前仅支持 me 。
|
授权
此请求需要获得以下范围的授权:
范围 |
---|
https://www.googleapis.com/auth/fitness.activity.write |
如需了解详情,请参阅身份验证和授权页面。
请求正文
在请求正文中,请按以下结构提供数据:
{ "id": string, "name": string, "description": string, "startTimeMillis": long, "endTimeMillis": long, "modifiedTimeMillis": long, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "activityType": integer, "activeTimeMillis": long }
属性名称 | 值 | 说明 | 备注 |
---|---|---|---|
id |
string |
客户端生成的标识符,该标识符在该用户拥有的所有会话中是唯一的。 | |
name |
string |
直观易懂的会话名称。 | |
description |
string |
此会话的说明。 | |
startTimeMillis |
long |
开始时间(以毫秒为单位,从 Epoch 起算)。 | |
endTimeMillis |
long |
结束时间(以毫秒为单位,从 Epoch 起算)。 | |
modifiedTimeMillis |
long |
指明会话上次修改时间的时间戳。 | |
application |
nested object |
创建会话的应用。 | |
application.packageName |
string |
此应用的软件包名称。该标识符在 Android 应用创建时用作唯一标识符,但 REST 客户端不能指定该标识符。REST 客户端会将其开发者项目编号(而非 packageName)反映到数据源数据流 ID 中。 | |
application.version |
string |
应用的版本。当应用以影响数据计算的方式发生变化时,您都应更新此字段。 | |
application.detailsUrl |
string |
可选 URI,可用于链接回应用。 | |
application.name |
string |
此应用的名称。REST 客户端必须填写此字段,但我们不强制要求此名称的唯一性。我们提供它只是为了方便其他开发者确定是哪一个 REST 创建了应用程序或数据源。 | |
activityType |
integer |
此会话所代表的活动类型。 | |
activeTimeMillis |
long |
会话活跃时间。虽然 start_time_millis 和 end_time_millis 定义了完整的会话时间,但活跃时间可以更短,可以通过 active_time_millis 指定。如果会话期间的非活动时间已知,则还应通过具有 STILL activity 值 的 com.google.activity.segment 数据点插入 |
响应
如果成功,此方法将返回采用以下结构的响应正文:
{ "id": string, "name": string, "description": string, "startTimeMillis": long, "endTimeMillis": long, "modifiedTimeMillis": long, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "activityType": integer, "activeTimeMillis": long }
属性名称 | 值 | 说明 | 备注 |
---|---|---|---|
id |
string |
客户端生成的标识符,该标识符在该用户拥有的所有会话中是唯一的。 | |
name |
string |
直观易懂的会话名称。 | |
description |
string |
此会话的说明。 | |
startTimeMillis |
long |
开始时间(以毫秒为单位,从 Epoch 起算)。 | |
endTimeMillis |
long |
结束时间(以毫秒为单位,从 Epoch 起算)。 | |
modifiedTimeMillis |
long |
指明会话上次修改时间的时间戳。 | |
application |
nested object |
创建会话的应用。 | |
application.packageName |
string |
此应用的软件包名称。该标识符在 Android 应用创建时用作唯一标识符,但 REST 客户端不能指定该标识符。REST 客户端会将其开发者项目编号(而非 packageName)反映到数据源数据流 ID 中。 | |
application.version |
string |
应用的版本。当应用以影响数据计算的方式发生变化时,您都应更新此字段。 | |
application.detailsUrl |
string |
可选 URI,可用于链接回应用。 | |
application.name |
string |
此应用的名称。REST 客户端必须填写此字段,但我们不强制要求此名称的唯一性。我们提供它只是为了方便其他开发者确定是哪一个 REST 创建了应用程序或数据源。 | |
activityType |
integer |
此会话所代表的活动类型。 | |
activeTimeMillis |
long |
会话活跃时间。虽然 start_time_millis 和 end_time_millis 定义了完整的会话时间,但活跃时间可以更短,可以通过 active_time_millis 指定。如果会话期间的非活动时间已知,则还应通过具有 STILL activity 值 的 com.google.activity.segment 数据点插入 |
试试看!
请使用下面的 API Explorer 对实际数据调用此方法,并查看响应。