Aller au contenu principal

Intégration domotique Google Health, gratuite et open source

Intégration Google Health pour Gladys Assistant

Pas, fréquence cardiaque, sommeil et poids de Google Health (Fitbit, Pixel Watch) dans Gladys.

Cette intégration amène vos données Google Health dans Gladys : ce que votre bracelet ou votre balance Fitbit, ou votre Pixel Watch, envoie à votre compte Google. Pas, fréquence cardiaque, sommeil, poids et plus encore deviennent des capteurs, des widgets de tableau de bord et des déclencheurs de scène.

L'accès est en lecture seule : Gladys ne peut rien modifier dans votre compte.

Avant de commencer​

Il vous faut :

  • Gladys 5.3 ou plus récent ;
  • un compte Google qui utilise l'application Fitbit (c'est là que vit le profil Google Health) ;
  • un projet Google Cloud gratuit. Google ne donne les données de santé qu'à une application qui vous appartient : vous créez donc votre propre « application », une seule fois. Comptez une dizaine de minutes.

L'intégration parle à Google par Internet (cloud) : il n'y a pas de mode local.

Étape 1 — Créer votre application Google​

  1. Ouvrez la console Google Cloud et créez un projet (n'importe quel nom, par exemple Gladys).
  2. Ouvrez API et services → Bibliothèque, cherchez Google Health API et cliquez sur Activer.
  3. Ouvrez API et services → Écran de consentement OAuth :
    • type d'utilisateur Externe ;
    • renseignez le nom de l'application et votre adresse e-mail ;
    • dans Accès aux données, ajoutez les trois champs d'application qui se terminent par googlehealth.activity_and_fitness.readonly, googlehealth.health_metrics_and_measurements.readonly et googlehealth.sleep.readonly ;
    • dans Audience, ajoutez votre propre adresse Google comme utilisateur test.
  4. Ouvrez API et services → Identifiants → Créer des identifiants → ID client OAuth, type Application Web.
  5. Copiez l'ID client et le secret client.

L'URI de redirection​

Google ne vous renvoie que vers une adresse que vous avez déclarée. Dans le client OAuth, sous URI de redirection autorisés, ajoutez l'adresse utilisée par Gladys.

Le plus simple pour la connaître : faites l'étape 2 une première fois. Si Google répond redirect_uri_mismatch, copiez l'adresse affichée dans les détails de l'erreur, ou cliquez sur Tester la connexion dans Gladys : l'adresse s'affiche sous le bouton. Ajoutez-la au client OAuth, attendez une minute, puis reconnectez.

Google n'accepte qu'une adresse en https:// avec un nom de domaine, ou http://localhost. Ouvrez Gladys par une telle adresse au moment de connecter (votre adresse Gladys Plus convient).

Étape 2 — Configurer l'intégration​

  1. Ouvrez l'onglet Configuration de l'intégration.
  2. Collez l'ID client OAuth et le secret client OAuth, puis enregistrez.
  3. Cliquez sur Connecter à côté de Compte Google, choisissez votre compte et cochez toutes les autorisations. Une autorisation non cochée laisse ses capteurs vides.
  4. De retour dans Gladys, l'état passe à connecté. Ouvrez l'onglet Découverte et ajoutez l'appareil Google Health.

Autres réglages :

  • Objectif de pas quotidien et Objectif de sommeil : utilisés par la jauge du widget et par les déclencheurs de scène.
  • Intervalle de rafraîchissement : fréquence de lecture de Google (15 minutes par défaut, 5 minutes au plus court). Votre montre elle-même ne se synchronise avec votre téléphone que de temps en temps : un intervalle plus court apporte rarement des données plus fraîches.
  • Fuseau horaire : par exemple Europe/Paris. Il décide quand commence « aujourd'hui ». Vide, la journée suit l'heure UTC.

Ce que vous obtenez​

L'appareil​

Un appareil Google Health avec ces capteurs :

CapteurUnité
Pas du jourpas
Distance du jourkm
Calories actives, calories totales du jourkcal
Étages du jourétages
Minutes en zone active du jourminutes
Fréquence cardiaque, fréquence cardiaque au reposbpm
Sommeil : durée, profond, paradoxal, léger, éveilminutes
Poidskg
Masse grasse, saturation en oxygène (SpO2)%
Variabilité de la fréquence cardiaquems
Fréquence respiratoirepar min

Un capteur reste vide si vos appareils ne le mesurent pas. Les compteurs « du jour » repartent de zéro à minuit dans votre fuseau horaire. Les noms des capteurs sont en anglais dans Gladys ; vous pouvez les renommer.

Widgets du tableau de bord​

  • Santé du jour : les pas par rapport à l'objectif, la fréquence cardiaque, le dernier sommeil, les calories, la distance et le poids, avec un bouton Actualiser.
  • Santé sur 7 jours : un graphique en barres des sept derniers jours de la mesure choisie (pas, distance, calories, étages, minutes en zone active), avec la moyenne par jour et le meilleur jour.

Scènes​

Déclencheurs, dans la catégorie Intégrations de l'éditeur de scènes :

  • Objectif de pas quotidien atteint — une fois par jour. Variables : pas, objectif.
  • Une nuit de sommeil est enregistrée — filtre : objectif atteint ou manqué. Variables : temps de sommeil (minutes et heures), sommeil profond et paradoxal.
  • Une pesée est enregistrée — filtre : en hausse, en baisse ou stable. Variables : poids, écart avec la pesée précédente.
  • Une séance de sport est enregistrée — variables : nom, type, durée, calories, distance.

Actions :

  • Lire Google Health maintenant — lit le compte sans attendre.
  • Obtenir le résumé santé du jour — renvoie les chiffres et une phrase toute faite (dans la langue choisie) à envoyer par message ou à faire dire, par exemple : « Aujourd'hui : 8 200 pas (objectif 10 000), 6,1 km, 2 150 kcal. »

Un déclencheur part quand Google reçoit la donnée, donc après la synchronisation de votre montre, et à la lecture suivante de l'intégration.

Boutons de l'écran de configuration​

  • Tester la connexion — lit le compte tout de suite et dit ce qui a été trouvé.
  • Déconnecter le compte Google — oublie le compte et révoque l'accès chez Google. L'appareil et son historique restent dans Gladys.

Dépannage​

  • redirect_uri_mismatch — voir « L'URI de redirection » plus haut.
  • « Accès bloqué » ou erreur 403 access_denied chez Google — votre adresse n'est pas dans les utilisateurs test de l'écran de consentement.
  • La connexion se perd tous les 7 jours — Google fait expirer l'accès d'une application laissée en Test. Sur l'écran de consentement, publiez l'application (pour votre seul usage, aucune validation n'est demandée sous 100 utilisateurs ; Google affiche un avertissement « application non validée » que vous pouvez passer).
  • « Ce compte Google n'a pas de profil Google Health (Fitbit) » — ouvrez une fois l'application Fitbit avec ce compte Google.
  • Certains capteurs restent vides — une autorisation n'a pas été cochée : déconnectez, reconnectez et cochez tout. Ou vos appareils ne mesurent pas cette donnée.
  • Les valeurs semblent en retard — ouvrez l'application Fitbit sur votre téléphone pour forcer la synchronisation de la montre.

Vie privée​

Vos données de santé vont de Google à votre Gladys, et nulle part ailleurs. L'intégration ne contacte que accounts.google.com, oauth2.googleapis.com et health.googleapis.com. Vous pouvez révoquer l'accès à tout moment depuis votre compte Google.

Paramètres de configuration​

Voici les paramètres demandés par Google Health dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Pour commencersectionNonGoogle ne donne vos données de santé qu'à une application qui vous appartient. Dans la console Google Cloud : créez un projet, activez l'API Google Health, configurez l'écran de consentement OAuth (ajoutez-vous comme utilisateur test), puis créez un client OAuth de type « Application Web ». Collez son ID client et son secret ci-dessous, enregistrez, puis cliquez sur Connecter. La documentation détaille chaque étape.
ID client OAuthstringOuiID client du client OAuth « Application Web » de votre projet Google Cloud.
Secret client OAuthsecretOuiSecret client du même client OAuth. Il ne quitte jamais Gladys.
Compte Googleoauth2NonEnregistrez d'abord l'ID client et le secret, puis connectez le compte Google dont Gladys doit lire les données de santé. L'accès est en lecture seule.
Objectifs et rafraîchissementsectionNonLes objectifs pilotent les jauges des widgets et les déclencheurs de scène.
Objectif de pas quotidiennumberNonNombre de pas à atteindre chaque jour.
Objectif de sommeil (heures)numberNonHeures de sommeil à atteindre chaque nuit.
Intervalle de rafraîchissement (s)numberNonFréquence de lecture de Google Health, en secondes (5 minutes minimum). Votre montre elle-même ne se synchronise que de temps en temps.
Fuseau horairestringNonVotre fuseau horaire IANA : il décide quand commence « aujourd'hui ». Vide : UTC.

Comment installer Google Health dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Google Health apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/prohand/google-health:1.0.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/prohand/google-health.

Google Health nécessite Gladys >=5.3.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

Google Health est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par prohand, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂