更新或插入给定会话。 立即试用。
请求
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 |
开始时间,以从公元纪年开始计算的毫秒数(含边界值)进行表示。 | |
endTimeMillis |
long |
结束时间,以从公元纪年开始计算的毫秒数表示(包括这两个数值)。 | |
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 定义完整的会话时间,但活动时间可以缩短,并通过 activity_time_millis 指定。如果会话期间的闲置时间已知,则还应通过 com.google.activity.segment 数据点插入,并将 STILL 活动值设为 |
响应
如果成功,此方法将返回采用以下结构的响应正文:
{ "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 |
开始时间,以从公元纪年开始计算的毫秒数(含边界值)进行表示。 | |
endTimeMillis |
long |
结束时间,以从公元纪年开始计算的毫秒数表示(包括这两个数值)。 | |
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 定义完整的会话时间,但活动时间可以缩短,并通过 activity_time_millis 指定。如果会话期间的闲置时间已知,则还应通过 com.google.activity.segment 数据点插入,并将 STILL 活动值设为 |
试试看!
使用下面的 API Explorer 对实际数据调用此方法,然后查看响应。