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 紀元時間 (含) 起算。
modifiedTimeMillis long 指出上次修改工作階段的時間戳記。
application nested object 建立工作階段的應用程式。
application.packageName string 這個應用程式的套件名稱。在 Android 應用程式建立時，這個 ID 會用來當做專屬 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 可以定義完整工作階段時間，但活動時間可以較短，並且由 Active_time_millis 指定。如果已知工作階段的閒置時間，應該透過 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 紀元時間 (含) 起算。
modifiedTimeMillis long 指出上次修改工作階段的時間戳記。
application nested object 建立工作階段的應用程式。
application.packageName string 這個應用程式的套件名稱。在 Android 應用程式建立時，這個 ID 會用來當做專屬 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 可以定義完整工作階段時間，但活動時間可以較短，並且由 Active_time_millis 指定。如果已知工作階段的閒置時間，應該透過 com.google.activity.segment 資料點，並加入「持續」活動值

試試看！

使用下方的 APIs Explorer，針對即時資料呼叫這個方法，看看會有什麼結果。