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 开始时间（以毫秒为单位，从 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 对实际数据调用此方法，并查看响应。