Examiner les fonctionnalités de Santé Connect
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page décrit les principales fonctions de l'API Santé Connect.
Opérations CRUD sur la synchronisation des enregistrements et des données
La plate-forme fournit des fonctions standards d'insertion, d'actualisation et de suppression pour les données enregistrées. Santé Connect comprend également une fonctionnalité qui permet aux applications clientes de synchroniser les données en dehors de Santé Connect. Cette opération crée un journal des modifications apportées aux données indiquant au développeur et à l'utilisateur si certains types de données ont été insérés ou supprimés par d'autres applications.
Fonctions d'agrégation de base
Les clients peuvent appliquer une fonction d'agrégation aux données sous-jacentes en fournissant les éléments suivants:
- Les valeurs moyennes, minimales ou maximales (par exemple, la fréquence cardiaque minimale et maximale au cours d'une session d'activité).
- Le total (par exemple, le nombre total de pas effectués au cours d'une journée).
- Compte simple du nombre de mesures sous-jacentes (par exemple, le nombre de sessions d'activité effectuées au cours d'une semaine donnée).
- La durée totale pour les types de données compatibles (par exemple, la durée totale de sommeil profond au cours d'une semaine ou la durée totale des sessions d'activité effectuées au cours d'une journée).
Vérification de disponibilité
Santé Connect est compatible avec la version 28 (Pie) ou ultérieure du SDK Android.
Ce SDK permet aux applications clientes de déterminer si l'API Santé Connect est installée sur l'appareil Android de l'utilisateur. Si ce n'est pas le cas, Santé Connect déclenche une vérification de disponibilité pour déterminer si l'appareil de l'utilisateur est compatible.
Vérifications des autorisations
Santé Connect nécessite que vous demandiez l'autorisation à l'utilisateur de lire et/ou d'écrire ses données de santé et de remise en forme pour chaque application. Cela vous permet également de consulter les autorisations déjà accordées ou refusées par l'utilisateur.
Lecture avec Santé Connect
Lecture au premier plan
Vous pouvez normalement lire les données de Santé Connect lorsque votre application est au premier plan. Dans ce cas, vous pouvez envisager d'utiliser un service de premier plan pour exécuter cette opération au cas où l'utilisateur ou le système placerait votre application en arrière-plan lors d'une opération de lecture.
Dans les situations où votre application peut s'attendre à une interruption, par exemple lorsqu'elle affiche une mesure dans votre application, effectuez une lecture directement depuis Santé Connect vers votre application cliente.
Dans les situations où vous préférez que votre application s'exécute sans interruption, utilisez un service de premier plan:
FOREGROUND_SERVICE_TYPE_HEALTH: permet à l'application de rester au premier plan pour collecter les données des capteurs, par exemple une application d'entraînement qui continue de collecter des données même lorsque l'utilisateur met l'application en arrière-plan.
FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: service de type générique qui permet à une application de continuer à collecter des données critiques pour les tâches qui prennent moins de trois minutes, même si l'utilisateur place l'application en arrière-plan avant qu'elle ne soit terminée.
Lecture en arrière-plan
Vous pouvez demander à votre application de s'exécuter en arrière-plan et de lire les données de Santé Connect. Si vous demandez l'autorisation Lecture en arrière-plan, votre utilisateur peut autoriser votre application à lire les données en arrière-plan.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/27 (UTC)."],[],[],null,["# Review Health Connect functionality\n\nThis page describes the main functions of the Health Connect API.\n\nCRUD operations on record and data synchronization\n--------------------------------------------------\n\nThe platform provides standard insert, update, and delete functions for recorded\ndata. Health Connect also includes functionality that allows client apps to\nsynchronize data out of Health Connect. This produces a log of data changes\nthat shows the developer and user whether certain data types have been\ninserted or deleted by other apps.\n\nBasic aggregation functions\n---------------------------\n\nClients can apply an aggregation function over underlying data, providing the\nfollowing:\n\n- The **average, minimum or maximum** values (for example, the minimum and maximum heart rate during an activity session).\n- The **sum total** (for example, the total step count in a daily interval).\n- A **simple count** of the number of underlying measurements (for example, the number of activity sessions in a given week).\n- The **total duration** on supported data types (for example, time spent in deep sleep this week, or total duration of activity sessions today).\n\nAvailability checks\n-------------------\n\nHealth Connect is compatible with Android SDK version 28 (Pie) and higher.\nThe SDK allows client apps to determine whether the Health Connect API is on\nthe user's Android-powered device. If it isn't, Health Connect triggers an\navailability check to determine whether the user's device is compatible.\n\nPermission checks\n-----------------\n\nHealth Connect requires you to request the user's permission to read and\nwrite their health and fitness data on a per-app basis. It also lets you\nsee what permissions have already been granted or denied by the user.\n\nReading with Health Connect\n---------------------------\n\n### Foreground reading\n\nYou can normally read data from Health Connect when your app is\nin the foreground. In these cases, you may consider using a foreground service\nto run this operation in case the user or system places your app\nin the background during a read operation.\n\nFor situations in which your app may expect an interruption, such as displaying\na reading in your application, read directly from Health Connect to your client\napplication.\n\nFor situations in which you prefer your app to run without\ninterruptions, use a\n[foreground service](/develop/background-work/services/fgs):\n\n- [`FOREGROUND_SERVICE_TYPE_HEALTH`](/reference/android/content/pm/ServiceInfo#FOREGROUND_SERVICE_TYPE_HEALTH): Allows app to remain in\n the foreground to collect sensor data, such as a workout app that continues\n to collect data even when the user puts the app in the background.\n\n- [`FOREGROUND_SERVICE_TYPE_SHORT_SERVICE`](/reference/android/content/pm/ServiceInfo#FOREGROUND_SERVICE_TYPE_SHORT_SERVICE): A generic-type\n service that allows an app to continue to collect critical data for\n tasks that take less than three minutes,\n even if the user places the app in the background before it completes.\n\n### Background reading\n\nYou can request that your application run in the background and read data from\nHealth Connect. If you request the\n[Background Read](/health-and-fitness/guides/health-connect/develop/read-data#background-read-example)\npermission, your user can grant your app access to read data in the background."]]
