Users.sessions: update

更新或插入给定会话。 立即试用

请求

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 对实际数据调用此方法,然后查看响应。