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 は完全なセッション時間を定義しますが、アクティブ時間はこれより短く、active_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 クライアントが生成し、この特定のユーザーが所有するすべてのセッションで一意の識別子。
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 は完全なセッション時間を定義しますが、アクティブ時間はこれより短く、active_time_millis で指定できます。セッション中の非アクティブ時間がわかっている場合は、STILL アクティビティ値を持つ com.google.activity.segment データポイントを介して挿入する必要もあります。

試してみよう:

以下の API Explorer を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認してください。