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 で短く指定することができます。セッション中の非アクティブ時間が判明している場合は、com.google.activity.segment データポイント（STILL アクティビティ値

）からも挿入する必要があります。

レスポンス

成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。

{
  "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 で短く指定することができます。セッション中の非アクティブ時間が判明している場合は、com.google.activity.segment データポイント（STILL アクティビティ値

）からも挿入する必要があります。

試してみよう:

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