Sessions

Les sessions permettent aux utilisateurs d'afficher rapidement et facilement une liste des principales activités qu'ils ont effectuées. Elles apparaissent sur la page du journal de l'application Google Fit. Par exemple, une session de respiration, une marche, une course à pied ou une nuit de sommeil sont deux exemples de sessions.

Les sessions regroupent des ensembles de données issus d'une période spécifique, qui ont été collectés lors d'une activité. Par exemple, si un utilisateur effectue le suivi au début et à la fin d'une course de 3 km, il est possible de créer une session et d'associer toutes les données d'activité physique enregistrées au cours de cette période (pas, vitesse, distance, etc.).

Les sessions elles-mêmes ne contiennent pas de détails sur l'activité. Il se trouve dans l'ensemble de données. Les sessions ont les propriétés suivantes:

  • Nom descriptif descriptif (par exemple, "course du lendemain")
  • Une description
  • Un identifiant unique
  • Type d'activité capturée (par exemple, une course)

Avantages des sessions

  • Utile pour les utilisateurs : les sessions vous aident à organiser les données d'activité et les entraînements de manière pertinente. Ils peuvent consulter toutes leurs activités de la journée sur la page "Journal" de l'application Google Fit.
  • Expérience utilisateur cohérente: si votre application ou votre appareil associé permet le suivi de l'activité (où les utilisateurs peuvent démarrer et arrêter une activité), la pratique de sessions d'entraînement permet aux utilisateurs de voir leur activité dans les deux applications.
  • Données plus complètes: Google Fit fusionne également les données de plusieurs sources pour compléter et enrichir les informations de votre session. Les utilisateurs bénéficient ainsi d'un aperçu plus complet de leur activité.
  • Exploitez la plate-forme Google Fit : si vos utilisateurs ne suivent pas leur activité, ou si votre application ne propose pas le suivi, vous pouvez toujours lire les sessions dans Google Fit. Vous pouvez interroger des données détaillées ou agrégées à partir du magasin de remise en forme et rechercher les sessions disponibles, sans avoir à implémenter votre propre schéma et stockage.
  • Renforcement de l'engagement utilisateur: vous pouvez présenter aux utilisateurs les sessions disponibles et les applications qui les ont créées. Interagir avec d'autres applications de fitness de cette manière peut accroître l'engagement des utilisateurs.

Obtenir l'autorisation des utilisateurs pour les sessions

Si vous souhaitez lire ou écrire des sessions, votre application doit obtenir l'autorisation de l'utilisateur. L'accès aux sessions utilise les mêmes champs d'application d'autorisation que les types de données, que vous devez demander comme suit:

Android

Spécifiez le type de session auquel votre application doit accéder, à l'aide des méthodes appropriées de FitnessOptions. Par exemple, pour lire les sessions de course à pied, vous pouvez choisir:

    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()

Cet exemple indique que votre application souhaite accéder aux métadonnées de session d'activité, et spécifie également les types de données qu'il souhaite lire dans ces sessions. Les types de données de fréquence cardiaque, de vitesse et de localisation sont utilisés dans cet exemple.

REST

Champs d'application de la requête:

  • Sessions avec types d'activités de sommeil :
    • https://www.googleapis.com/auth/fitness.sleep.read
    • https://www.googleapis.com/auth/fitness.sleep.write
  • Toutes les autres sessions :
    • https://www.googleapis.com/auth/fitness.activity.read
    • https://www.googleapis.com/auth/fitness.activity.write

Utiliser des sessions

Android

Vous pouvez utiliser l'API Sessions pour:

  • Créer des sessions en temps réel
  • Insérer des sessions dans la boutique de fitness
  • Insérer des segments d'activité pour permettre les pauses pendant les entraînements
  • Lire les sessions et les ensembles de données qui leur sont associés
  • Lancer une autre application pour afficher des informations sur une session qu'elle a créée
  • Recevoir un intent lorsqu'une autre application démarre une session

REST

Vous pouvez utiliser l'API Sessions pour:

  • Créer des sessions en temps réel
  • Insérer des sessions dans la boutique de fitness
  • Insérer des segments d'activité pour permettre les pauses pendant les entraînements
  • Lire les sessions et les ensembles de données qui leur sont associés

Interactions des ensembles de données et des segments avec les sessions

Dans Google Fit:

  • Un ensemble de données représente un ensemble de points de données d'une source de données spécifique sur une période spécifique. Les ensembles de données peuvent être insérés de leur propre côté. Toutefois, si vous créez une session, il peut être plus simple de créer simultanément la session et ses ensembles de données.
  • Un segment regroupe les ensembles de données d'une session en fonction de l'activité exacte de l'utilisateur au cours de cette session. Par exemple, si l'utilisateur suit une session de 30 minutes (la session) mais qu'il a marché pendant un certain temps au cours de celle-ci, il peut être divisé en segments. Il y aura un segment pour la course, la pause pour la marche, puis la course à nouveau.
Figure 1 : Différentes applications ajoutent des sessions et des ensembles de données au [magasin de fitness].

La figure 1 montre un intervalle de temps dans le magasin de fitness au cours duquel les applications A, B et C ont inséré des ensembles de données et des sessions:

  • L'application A a inséré les ensembles de données A1 et A2 en même temps que les sessions 1 et A3, indépendamment de toute session.
  • L'application B a inséré les ensembles de données B1 et B2 avec la session 2.
  • L'application C a inséré l'ensemble de données C1 indépendamment de toute session.

Lorsque vous lisez les données de session du magasin de remise en forme, toutes les données de remise en forme qui se trouvent dans l'intervalle d'une session sont automatiquement associées à cette session, même si vous insérez les données après la création de la session ou si vous créez une session après le suivi des données de manière passive. Par exemple, une requête pour les données de remise en forme de la session 1 renvoie:

  • Ensemble de données A1
  • Ensemble de données A2
  • La partie de l'ensemble de données A3 située entre t1 et t2
  • La partie de l'ensemble de données C1 située entre t1 et t2

Vous pouvez identifier l'application qui a inséré chaque session et ensemble de données.

Créer des sessions

Vous pouvez créer des sessions de différentes manières:

  • Votre application peut créer activement une session dans :
    • en temps réel lorsqu'un utilisateur suit activement une activité sur un appareil (Android uniquement).
    • en l'insérant manuellement.
  • Lorsqu'un utilisateur ajoute manuellement une séance de sport ou une activité dans l'application Google Fit.

Quand créer une session

Ajoutez-vous des données de sommeil ?

  • Oui : créez une session et insérez-la manuellement dans ce magasin. Par exemple, vous pouvez insérer une session de sommeil. En effet, les utilisateurs disposant d'applications ou d'appareils de suivi du sommeil n'interagissent pas avec les appareils pour démarrer et arrêter leur activité liée au sommeil (suivi effectué de façon passive).
  • Non : votre application permet-elle aux utilisateurs de démarrer et d'arrêter des activités ?

Sessions de lecture

Votre application peut lire des sessions de plusieurs manières:

  • Recherchez une session spécifique créée ou insérée par
    • Nom ou
    • ID
  • Rechercher toutes les sessions qu'il a créées/insérées, par période
  • Rechercher toutes les sessions disponibles créées par toutes les applications (y compris Google Fit) par période

Identifier les sources qui ont créé une session

Vous pouvez indiquer à vos utilisateurs l'application ou l'appareil à l'origine de chacune de leurs sessions. Chaque session est associée à une source de données, qui contient des informations sur l'application ou l'appareil qui a collecté ou transformé les données.

Android

Actuellement, vous ne pouvez obtenir que le nom de package d'une session écrite par un client Android. Pour obtenir le nom de package de l'application qui a créé une session, utilisez la méthode getAppPackageName. Vous pouvez utiliser ces informations dans votre application pour indiquer aux utilisateurs quelles autres applications ont inséré des sessions de remise en forme. Vous pouvez afficher l'icône de chacune de ces applications pour aider les utilisateurs à les identifier.

Vous pouvez également déclencher un intent pour lancer d'autres applications afin d'afficher les détails des sessions qu'elles ont créées. D'autres applications peuvent également déclencher une intention de lancement de votre application.

Découvrez comment trouver la source qui a créé une session.

REST

Pour obtenir le nom de package de l'application Android qui a créé des sessions, utilisez la propriété session.application. Pour les sessions créées à l'aide de l'API REST, utilisez plutôt la propriété session.name. Vous pouvez utiliser ces informations dans votre application pour indiquer aux utilisateurs quelles autres applications ont inséré des sessions de remise en forme. Vous pouvez afficher l'icône de chacune de ces applications pour aider les utilisateurs à les identifier.

Découvrez comment trouver la source qui a créé une session.