Users.sessions: list

以前に作成されたセッションを一覧表示します。 実習をご覧ください。

リクエスト

HTTP リクエスト

GET https://www.googleapis.com/fitness/v1/users/userId/sessions

パラメータ

パラメータ名 値 説明
パスパラメータ
userId string 特定されたユーザーのセッションを一覧表示します。me を使用して 表示されます。現時点でサポートされているのは me のみです。
省略可能なクエリ パラメータ
activityType integer 空でない場合は、これらのアクティビティ タイプを持つセッションのみが返されます。
endTime string RFC3339 タイムスタンプ。 開始時刻から終了時刻までに終了したセッションのみが含まれる 返されます。この時間が省略されて startTime が startTime から終了時間までのすべてのセッションが 返されます。
includeDeleted boolean true で、startTime と endTime の両方が 省略した場合は、セッションの削除内容が返されます。
pageToken string 継続トークン。増分同期に使用されます。 次の変更バッチを取得するには、このパラメータを 前のレスポンスからの nextPageToken。ページトークンは 開始時刻または終了時刻を指定した場合は無視されます。開始時刻がない場合 指定され、そのページトークンが指定されている場合、 30 日が返されます。
startTime string RFC3339 タイムスタンプ。 開始時刻から終了時刻までに終了したセッションのみが含まれる 返されます。この時刻を省略して endTime を指定すると、 開始時間から endTime までのすべてのセッションが対象となります 返されます。

承認

このリクエストは、少なくとも次のうち 1 つのスコープによる承認が必要です。

範囲
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.read
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.read
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.read
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.read
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write

詳細については、認証と認可のページをご覧ください。

リクエスト本文

このメソッドをリクエストの本文に含めないでください。

レスポンス

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

{
  "session": [
    {
      "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
    }
  ],
  "deletedSession": [
    {
      "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
    }
  ],
  "nextPageToken": string,
  "hasMoreData": boolean
}
プロパティ名 値 説明 メモ
session[] list 終了時間がリクエストの startTime～endTime のセッション。
session[].id string クライアントが生成した識別子。このユーザーが所有するすべてのセッション間で一意です。
session[].name string 人が読める形式のセッション名。
session[].description string このセッションの説明。
session[].startTimeMillis long エポックからのミリ秒単位の開始時間（両端を含む）。
session[].endTimeMillis long 終了時間（エポックからのミリ秒）。
session[].modifiedTimeMillis long セッションが最後に変更された日時を示すタイムスタンプ。
session[].application nested object セッションを作成したアプリケーション。
session[].application.packageName string このアプリケーションのパッケージ名。Android アプリで作成された場合は一意の識別子として使用されますが、REST クライアントで指定することはできません。REST クライアントでは、packageName ではなく、デベロッパー プロジェクト番号がデータソースのデータ ストリーム ID に反映されます。
session[].application.version string アプリケーションのバージョン。アプリケーションでデータの計算に影響するような変更が加えられるたびに、このフィールドを更新する必要があります。
session[].application.detailsUrl string アプリにリンクするために使用できる URI（省略可）。
session[].application.name string このアプリケーションの名前。これは REST クライアントでは必須ですが、この名前の一意性は強制しません。これは、アプリケーションやデータソースを作成した REST を確認したい他のデベロッパーのために便宜上提供されています。
session[].activityType integer このセッションが表すアクティビティのタイプ。
deletedSession[] list リクエストで includeDeleted が true に設定され、startTime と endTime が省略されている場合、前回の同期以降に削除されたセッションが含まれます。
deletedSession[].id string クライアントが生成した識別子。このユーザーが所有するすべてのセッション間で一意です。
deletedSession[].name string 人が読める形式のセッション名。
deletedSession[].description string このセッションの説明。
deletedSession[].startTimeMillis long エポックからのミリ秒単位の開始時間（両端を含む）。
deletedSession[].endTimeMillis long 終了時間（エポックからのミリ秒）。
deletedSession[].modifiedTimeMillis long セッションが最後に変更された日時を示すタイムスタンプ。
deletedSession[].application nested object セッションを作成したアプリケーション。
deletedSession[].application.packageName string このアプリケーションのパッケージ名。Android アプリで作成された場合は一意の識別子として使用されますが、REST クライアントで指定することはできません。REST クライアントでは、packageName ではなく、デベロッパー プロジェクト番号がデータソースのデータ ストリーム ID に反映されます。
deletedSession[].application.version string アプリケーションのバージョン。アプリケーションでデータの計算に影響するような変更が加えられるたびに、このフィールドを更新する必要があります。
deletedSession[].application.detailsUrl string アプリにリンクするために使用できる URI（省略可）。
deletedSession[].application.name string このアプリケーションの名前。これは REST クライアントでは必須ですが、この名前の一意性は強制しません。これは、アプリケーションやデータソースを作成した REST を確認したい他のデベロッパーのために便宜上提供されています。
deletedSession[].activityType integer このセッションが表すアクティビティのタイプ。
nextPageToken string それ以降の変更の同期に使用される同期トークン。これは、リクエストで startTime と endTime の両方が省略されている場合にのみ提供されます。
session[].activeTimeMillis long セッションのアクティブ時間。start_time_millis と end_time_millis は完全なセッション時間を定義しますが、アクティブ時間は、active_time_millis で短く指定することができます。セッション中の非アクティブ時間が判明している場合は、com.google.activity.segment データポイント（STILL アクティビティ値

）からも挿入する必要があります。
deletedSession[].activeTimeMillis long セッションのアクティブ時間。start_time_millis と end_time_millis は完全なセッション時間を定義しますが、アクティブ時間は、active_time_millis で短く指定することができます。セッション中の非アクティブ時間が判明している場合は、com.google.activity.segment データポイント（STILL アクティビティ値

）からも挿入する必要があります。
hasMoreData boolean サーバーに転送するデータがまだあることを示すフラグ。この項目は使用しないでください。サーバーからのレスポンスに値が入力されることはありません。

試してみよう:

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