セッション数

セッションを使用すると、ユーザーがすべての主要な できます。Google Fit アプリのジャーナル ページに表示されます。対象 たとえば、呼吸セッション、ウォーキング、ランニング、夜間の睡眠は、それぞれ 示されます。

セッションは、特定の期間のデータセットをグループ化します。 できます。（例: ユーザーが 3 km の走行と終点を記録した場合） セッションが作成され その時間内のすべてのフィットネスデータが 時間（歩数、速度、距離など）がセッションに関連付けられます。

セッション自体には、アクティビティの詳細は含まれません。これは次の場所にあります。 見てみましょう。セッションには次のプロパティがあります。

  • わかりやすいわかりやすい名前（「モーニング ランニング」など）
  • 広告文
  • 一意の識別子
  • キャプチャするアクティビティの種類（ランニングなど）

セッションを使用するメリット

  • ユーザーにとって便利: セッションは、アクティビティ データやワークアウトを 1 つの画面で整理するのに役立ちます。 ユーザーに有意義な方法で 提供できるからです次の場所でその日のすべてのアクティビティを確認できます: Google Fit アプリの [ジャーナル] ページ。
  • 一貫したユーザー エクスペリエンス: アプリまたはコンパニオン デバイスでアクティビティを許可している場合 ユーザーがアクティビティを開始および停止できる場所、 これらのワークアウトでは、ユーザーは両方のアプリでアクティビティを確認できます。
  • データの完全性: Google Fit では、複数の セッション情報を補完、拡充できます。これによりユーザーは より包括的に把握できるようになります
  • Google Fit プラットフォームを活用する: ユーザーがアクティビティを記録していない場合。 アプリがトラッキングをサポートしていない場合でも、Google Fit でセッションを読み取ることができます。 フィットネス ストアの詳細なデータや集計データをクエリして、 独自のスキーマやモジュールを実装しなくても、セッションを ストレージです。
  • ユーザー エンゲージメントの向上: 利用可能なセッションと 作成元のアプリです。他のフィットネス アプリを操作すると、 ユーザーエンゲージメントを高めることができます

セッションのユーザー承認を取得する

セッションの読み取りや書き込みを行う場合、アプリはユーザーの 付与します。セッションへのアクセスは同じ認可スコープを使用する 渡すには、次のようにリクエストする必要があります。

Android

適切な FitnessOptions のメソッド。 たとえば、ランニングに関連するセッションを読み取るには、次のように選択します。

    val fitnessOptions = FitnessOptions.builder()
        .accessActivitySessions(FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_HEART_RATE_BPM, FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_SPEED, FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_LOCATION_SAMPLE, FitnessOptions.ACCESS_READ)
        .build()

この例では、アプリがアクティビティ セッションのメタデータにアクセスする必要があることを指定しています。 また、セッション内で読み取るデータ型も指定します。 この例では、心拍数、速度、位置情報のデータタイプを使用します。

REST

次のようにスコープをリクエストします。

  • 睡眠アクティビティ タイプのセッション: <ph type="x-smartling-placeholder">
      </ph>
    • https://www.googleapis.com/auth/fitness.sleep.read
    • https://www.googleapis.com/auth/fitness.sleep.write
  • その他のすべてのセッション: <ph type="x-smartling-placeholder">
      </ph>
    • https://www.googleapis.com/auth/fitness.activity.read
    • https://www.googleapis.com/auth/fitness.activity.write

セッションの使用

Android

Sessions API を使用して次のことができます。

  • リアルタイムでセッションを作成する
  • フィットネス ストアにセッションを挿入する
  • アクティビティ セグメントを挿入して、ワークアウト中の一時停止をサポート
  • セッションとそれに関連するデータセットを読み取る
  • 別のアプリを起動して、作成したセッションに関する情報を表示する
  • 別のアプリがセッションを開始したときにインテントを受信する

REST

Sessions API を使用して次のことができます。

  • リアルタイムでセッションを作成する
  • フィットネス ストアにセッションを挿入する
  • アクティビティ セグメントを挿入して、ワークアウト中の一時停止をサポート
  • セッションとそれに関連するデータセットを読み取る

データセットとセグメントとセッションの相互作用

Google Fit の場合:

  • データセットとは、特定のデータセットからのデータポイントのセットを 特定の期間のデータソース。データセットは あります。ただし、セッションを作成する場合は、 そのデータセットを結合します
  • セグメントとは、ユーザーが行った操作そのものに基づいてセッション内のデータセットをグループ化するものです。 確認されます。たとえば、ユーザーが 30 分間のランニング（ その間に少し歩いたことが 次のように異なる可能性があります 分割しますランニングのセグメント、ウォーキングの休憩、 再実行します。
で確認できます。 <ph type="x-smartling-placeholder">
</ph>
図 1: さまざまなアプリがセッションとデータセットを [フィットネス ストア] に追加する。

図 1 は、アプリ A、B、C が挿入されたフィットネス ストアの時間間隔を示しています。 いくつか紹介します。

  • アプリ A は、セッションとは無関係に、データセット A1 と A2 をセッション 1 と A3 とともに挿入しました。
  • アプリ B は、セッション 2 とともにデータセット B1 と B2 を挿入しました。
  • アプリ C は、セッションとは独立してデータセット C1 を挿入しました。

フィットネス ストアからセッション データを読み取る際に、 自動的にそのセッションと 関連付けられます セッションの作成後にデータを挿入したり、 追跡された後にのみ新しいセッションを開始します。たとえば、フィットネスに関するクエリは、 セッション 1 のデータは次のように返されます。

  • データセット A1
  • データセット A2
  • データセット A3 の t1 と t2 の間の部分
  • データセット C1 の t1 と t2 の間の部分

各セッションとデータセットを挿入したアプリを特定できます。

セッションを作成する

セッションは、以下の複数の方法で作成できます。

  • アプリでアクティブにセッションを作成できるのは、 <ph type="x-smartling-placeholder">
      </ph>
    • ユーザーがデバイスでアクティビティを積極的に追跡している場合（Android のみ）、またはリアルタイム
    • 手動で挿入します
  • ユーザーが Google Fit アプリにワークアウトやアクティビティを手動で追加したとき。

セッションを作成するタイミング

睡眠データは追加されていますか？

  • Yes - セッションを作成し、手動でフィットネス ストアに挿入します。 たとえば、睡眠セッションを挿入します。この 睡眠管理用のアプリやデバイスを使っているユーザーは、デバイスを操作しないから 睡眠活動を開始および停止する（これは受動的に追跡されます）。
  • いいえ - アプリでユーザーがアクティビティを開始および停止できていますか？
    • No - セッションを作成しません。データセットはアプリからのみ追加してください。
    • ○ - Android API で、ユーザーがトラッキングした場合、リアルタイムでセッションを作成します または手動で管理できます。 REST API で、セッションを作成し、手動でフィットネス ストアに挿入します。
    • ユーザーがさまざまなデバイスでさまざまなアクティビティを行っていることをアプリは検出できますか？ （例: ウォーキングとランニング）
      • はい - セグメントを追加します。
      • No - データセットの追加のみを行います。無視 Google Fit に受動的に作成してもらうこともできます。

リーディング セッション

アプリは、いくつかの方法でセッションを読み取ることができます。

  • 作成または挿入された特定のセッションを探す <ph type="x-smartling-placeholder">
      </ph>
    • 名前または
    • ID
  • 作成または挿入されたすべてのセッションを期間別に表示する
  • すべてのアプリ（Google Fit を含む）で作成されたすべてのセッションを期間別に表示する

セッションを作成したソースを確認する

各セッションを作成したアプリやデバイスをユーザーに表示できます。各 データソースが関連付けられています。データソースには、 データを収集または変換した デバイスです

Android

現時点では、Android によって書き込まれたセッションのパッケージ名のみを取得できます できます。セッションを作成したアプリのパッケージ名を取得するには、次のコマンドを使用します。 getAppPackageName メソッドを使用します。アプリでこの情報を使用して フィットネス セッションを挿入した他のアプリが表示されます。ユーザーのアイコンを これらの アプリで識別できるようにします。

また、 インテントを 他のアプリを起動して、作成したセッションの詳細を表示する。他のアプリでも インテントを起動してアプリを起動します。

詳しくは、コンテンツを作成したソースを確認する あります。

REST

セッションを作成した Android アプリのパッケージ名を取得するには、次のコマンドを使用します。 session.application プロパティ。 REST API の場合は、代わりに session.name プロパティを使用してください。こちらの フィットネスのデータに挿入した他のアプリをユーザーに示すことができます。 あります。各アプリのアイコンを表示して、ユーザーが できます。

詳しくは、コンテンツを作成したソースを確認する あります。