Les types de données dans Santé Connect sont stockés dans des objets qui sont des sous-classes de Record.
Pour chaque type de données, des champs associés sont disponibles. Ils peuvent être génériques (time et zoneOffset) ou spécifiques (title, count et percentage).
Certains champs utilisent des types de base (long, double ou chaîne, par exemple), tandis que d'autres utilisent des types complexes tels que des énumérations et des classes comme Instant et ZoneOffset. Les attributs de ces champs peuvent être obligatoires ou facultatifs. Certains attributs sont en lecture seule, tandis que d'autres sont limités à une plage de valeurs spécifique.
Pour obtenir la liste complète des types de données disponibles et de leurs champs, consultez les classes dans Jetpack.
Attributs de métadonnées
Les données de l'API Santé Connect incluent également des attributs de métadonnées décrits dans la liste suivante :
- Identifiant Santé Connect : un identifiant unique (UID) est attribué à chaque point de données lors de leur création. Cela est particulièrement utile pour les opérations de lecture et d'écriture standards. Pour en savoir plus, consultez ID Santé Connect.
- Heure de la dernière modification : indique l'horodatage de la dernière mise à jour d'un enregistrement. Cette information est générée automatiquement à la première création de l'enregistrement ou à chaque mise à jour.
- Origine des données : Santé Connect stocke des informations sur l'application d'où proviennent les données. Il contient le nom du package de l'origine, qui est automatiquement ajouté lors de la création.
- Appareil : Santé Connect stocke des informations sur l'appareil d'où proviennent les données. Il indique le fabricant et le modèle de l'appareil dont vous spécifiez la valeur manuellement.
- ID client : Santé Connect fournit des ID client permettant aux applications clientes de consulter les données à l'aide de leurs propres ID. Cela facilite la résolution des conflits et la synchronisation. Ces informations sont fournies manuellement à l'enregistrement.
- Version des enregistrements client : en plus de l'ID client, Santé Connect assure la gestion des versions pour faciliter le suivi des modifications lors de la synchronisation des données. Ces informations sont fournies manuellement à l'enregistrement.
- Méthode d'enregistrement : Santé Connect vous permet de comprendre comment les données sont enregistrées. Ces méthodes incluent les applications qui enregistrent les données de manière passive (automatiquement) et les utilisateurs qui enregistrent les données de manière active ou manuelle.
ID Santé Connect
Santé Connect attribue des identifiants uniques (UID) aux objets de données nouvellement insérés, qui identifient les objets de données et les distinguent des autres. Les ID Santé Connect sont utiles dans les requêtes de lecture ou d'écriture. Les ID Santé Connect ne sont pas identiques aux ID client. Une application cliente attribue des ID client, tandis que Santé Connect n'attribue que des ID Santé Connect.
Tenez compte des remarques suivantes lorsque vous utilisez des ID Santé Connect :
- Les sessions ont un seul ID Santé Connect, mais les données qu'elles contiennent ont leurs propres ID Santé Connect.
- Les ID Santé Connect ne sont pas liés à des codes temporels et ne sont pas concernés par eux.
- Certains cas d'utilisation peuvent nécessiter de stocker un ID Santé Connect spécifique au cours d'un workflow. Par exemple, un ID spécifique est requis pour récupérer et afficher à un utilisateur l'entrée de données qu'il vient d'enregistrer.
Heure dans Santé Connect
Toutes les données écrites dans Santé Connect doivent préciser les informations de fuseau horaire. Préciser le fuseau horaire permet aux applications de lire les données pour les représenter en temps civil. Le temps civil est l'heure locale de l'utilisateur, qui n'est pas nécessairement exprimée en temps universel coordonné (UTC).
Dans de rares cas, le fuseau horaire peut ne pas être disponible. Lorsque cela se produit dans Android 14 (niveau d'API 34), Santé Connect définit le décalage de fuseau horaire en fonction du fuseau horaire par défaut du système de l'appareil. Dans Android 13 et versions antérieures (niveau d'API 33 et versions antérieures), il est possible d'écrire dans Santé Connect sans préciser d'informations de fuseau horaire, ce qu'il faut éviter dans la mesure du possible.
Paramètres de l'heure et du fuseau horaire
Les informations de fuseau horaire précisées lors de l'écriture des données permettent de les avoir à disposition lors de la lecture de données dans Santé Connect. Toutefois, cette information peut manquer dans certains cas, par exemple lorsque le fuseau horaire n'est pas précisé. Votre application doit être prête à traiter ces deux types de données, en fonction de votre situation spécifique.