Les sessions permettent aux utilisateurs de voir rapidement et facilement une liste de toutes les activités principales qu'ils ont effectuées. Ils apparaissent sur la page de journal de l'application Google Fit. Par exemple, une séance de respiration, une marche, une course à pied ou une nuit de sommeil sont des exemples de sessions.
Les sessions regroupent les ensembles de données d'une période spécifique collectés au cours d'une activité. Par exemple, si un utilisateur a suivi le début et la fin d'une course de 3 km, une session peut être créée et toutes les données de remise en forme enregistrées pendant cette période (telles que les pas, la vitesse et la distance) seront associées à cette session.
Les sessions elles-mêmes ne contiennent aucun détail sur l'activité. Il se trouve dans le jeu de données. Les sessions ont les propriétés suivantes:
- Un nom descriptif et convivial (par exemple, "course du matin")
- Une description
- Un identifiant unique
- Le type d'activité enregistrée (une course, par exemple)
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 pour les utilisateurs. Il peut voir toutes ses activités de la journée dans la page "Journal" de l'application Google Fit.
- Expérience utilisateur cohérente: si votre application ou votre appareil associé permet le suivi des activités (où les utilisateurs peuvent démarrer et arrêter une activité), les sessions pour ces entraînements permettent aux utilisateurs de voir leur activité dans les deux applications.
- Données plus complètes: Google Fit fusionne également les données provenant de plusieurs sources pour compléter et enrichir les informations sur votre session. Cela donne aux utilisateurs un aperçu plus complet de leur activité.
- Exploitez la plate-forme Google Fit: si vos utilisateurs n'effectuent pas le suivi de leur activité ou si votre application n'est pas compatible avec le suivi, vous pouvez tout de même lire les sessions dans Google Fit. Vous pouvez interroger des données détaillées ou agrégées de la boutique de fitness et trouver les sessions disponibles, sans avoir à implémenter votre propre schéma et votre propre espace de stockage.
- Renforcement de l'engagement utilisateur: vous pouvez montrer à vos utilisateurs les sessions disponibles et les applications qui les ont créées. Interagir avec d'autres applications de fitness de cette manière peut augmenter l'engagement utilisateur.
Obtenir l'autorisation de l'utilisateur 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. Pour ce faire, procédez comme suit:
Android
Spécifiez le type de session à laquelle votre application doit accéder à l'aide des méthodes appropriées de FitnessOptions
.
Par exemple, pour lire les sessions relatives à la 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 les types de données qu'elle 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
Les champs d'application des requêtes sont les suivants:
- Sessions avec des types d'activité 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
Utilisation des sessions
Android
Vous pouvez utiliser l'API Sessions pour:
- Créer des sessions en temps réel
- Insérer des sessions dans le magasin de fitness
- Insérez des segments d'activité pour favoriser les pauses pendant vos 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 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 le magasin de fitness
- Insérez des segments d'activité pour favoriser les pauses pendant vos entraînements
- Lire les sessions et les ensembles de données qui leur sont associés
Comment les ensembles de données et les segments interagissent avec les sessions
Dans Google Fit:
- Un ensemble de données représente un ensemble de points de données provenant d'une source de données particulière sur une période donnée. Les ensembles de données peuvent être insérés individuellement. Toutefois, si vous créez une session, il peut être plus facile de créer la session et ses ensembles de données ensemble.
- Un segment regroupe les ensembles de données d'une session en fonction de l'activité exacte de l'utilisateur au cours de la session. Par exemple, si l'utilisateur effectue le suivi d'une course de 30 minutes (la session), mais qu'il a marché un peu au cours de cette période, il peut être divisé en segments. Il y aura une section pour la course, puis la pause pour la marche et enfin la course à nouveau.
La figure 1 montre un intervalle de temps dans le magasin de fitness pendant lequel 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 avec les sessions 1 et A3 indépendamment des sessions.
- 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 toutes les sessions.
Lorsque vous lisez des données de session à partir du magasin de fitness, toutes les données de remise en forme enregistrées dans l'intervalle de temps d'une session sont automatiquement associées à cette session, même si vous insérez les données après avoir créé la session ou si vous créez une session après le suivi passive des données. Par exemple, une requête pour les données de fitness de la session 1 renverrait:
- Ensemble de données A1
- Ensemble de données A2
- Partie de l'ensemble de données A3 comprise entre t1 et t2
- La partie de l'ensemble de données C1 entre t1 et t2
Vous pouvez savoir quelle application a inséré chaque session et chaque ensemble de données.
Créer des sessions
Il existe différentes manières de créer des sessions:
- 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 un entraînement 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 le magasin de remise en forme. Par exemple, vous pouvez insérer une session de sommeil. En effet, les utilisateurs d'applications ou d'appareils de suivi du sommeil n'interagissent pas avec les appareils pour démarrer et arrêter leur activité de sommeil (suivi passive).
- Non. Votre application permet-elle aux utilisateurs de démarrer et d'arrêter des activités ?
- Non : ne pas créer de session. Ajoutez uniquement des ensembles de données de votre application.
- Oui avec l'API Android, créez une session en temps réel si les utilisateurs suivent leur activité, ou manuellement. Avec l'API REST, créez une session et insérez-la manuellement dans le magasin de remise en forme.
- Votre application peut-elle détecter les activités plus détaillées d'un utilisateur (marche ou course, par exemple) ?
- Oui. Ajoutez des segments.
- Non : vous ne pouvez ajouter que des ensembles de données. Ignorez des segments pour le moment et laissez Google Fit les créer passivement.
Sessions de lecture
Votre application peut lire les sessions de plusieurs manières:
- Recherchez une session spécifique créée/insérée par
- Nom ou
- ID
- Recherchez toutes les sessions créées/insérées par période.
- Recherchez toutes les sessions disponibles créées par l'ensemble des applications (y compris Google Fit) par période.
Identifier les sources qui ont créé une session
Vous pouvez indiquer aux utilisateurs l'application ou l'appareil qui a créé 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 du 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 fitness. 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 créées par l'utilisateur. D'autres applications peuvent également déclencher un intent pour lancer votre application.
Découvrez comment trouver la source qui a créé une session.
REST
Pour obtenir le nom du 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 fitness. 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.