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 用戶端產生的 ID，在這位使用者擁有的所有工作階段專屬。
name string 人類可讀的工作階段名稱。
description string 此時段的說明。
startTimeMillis long 開始時間，以 Epoch 紀元時間起算的毫秒為單位 (含首尾)。
endTimeMillis long 結束時間，以 Epoch 紀元時間起算的毫秒為單位 (含 Epoch 紀元時間起算)。
modifiedTimeMillis long 時間戳記，指出工作階段的上次修改時間。
application nested object 建立工作階段的應用程式。
application.packageName string 此應用程式的套件名稱。由 Android 應用程式建立時，這會做為專屬 ID，但 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 會定義完整工作階段時間，但活動時間可以較短，可使用 activity_time_millis 來指定。如果知道工作階段期間的閒置時間，也應透過含有 STILL 活動值的 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 用戶端產生的 ID，在這位使用者擁有的所有工作階段專屬。
name string 人類可讀的工作階段名稱。
description string 此時段的說明。
startTimeMillis long 開始時間，以 Epoch 紀元時間起算的毫秒為單位 (含首尾)。
endTimeMillis long 結束時間，以 Epoch 紀元時間起算的毫秒為單位 (含 Epoch 紀元時間起算)。
modifiedTimeMillis long 時間戳記，指出工作階段的上次修改時間。
application nested object 建立工作階段的應用程式。
application.packageName string 此應用程式的套件名稱。由 Android 應用程式建立時，這會做為專屬 ID，但 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 會定義完整工作階段時間，但活動時間可以較短，可使用 activity_time_millis 來指定。如果知道工作階段期間的閒置時間，也應透過含有 STILL 活動值的 com.google.activity.segment 資料點插入

試試看！

使用下方的 APIs Explorer，針對有效資料呼叫這個方法，然後查看回應。