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 客户端的开发者项目编号会反映在数据源数据流 ID 中，而不是体现在 packageName 中。
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	开始时间（以毫秒为单位，从新纪元开始，含边界值）。
endTimeMillis	long	结束时间（以毫秒为单位，从新纪元开始，含边界值）。
modifiedTimeMillis	long	指明会话上次修改时间的时间戳。
application	nested object	创建会话的应用。
application.packageName	string	此应用的软件包名称。此标识符在 Android 应用创建时用作唯一标识符，但 REST 客户端无法指定它。REST 客户端的开发者项目编号会反映在数据源数据流 ID 中，而不是体现在 packageName 中。
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 针对实际数据调用此方法并查看响应。