Types de données

Google Fit fournit un ensemble de types de données de santé et de bien-être sous l'espace de noms com.google.

Les types de données définissent le format des valeurs à l'intérieur des points de données. Un point de données peut représenter:

  • Une lecture ou une observation instantanée
  • Agrégation avec des statistiques sur un intervalle de temps

Google Fit définit les types de données pour les observations instantanées et les types de données pour les données agrégées données. Les points de données sont constitués de valeurs pour les champs d'un type de données et d'informations d'horodatage. Les points qui représentent des observations instantanées comprennent un code temporel et des points de un type de données agrégées incluent également l'heure de début de l'intervalle.

Google Fit vous permet également de définir de nouveaux types de données.

Groupes de types de données

Google Fit contient les types de données suivants:

Types de données publiques
Les types de données standards fournis par la plate-forme portent le nom "com.google". préfixe. Par exemple, com.google.step_count.delta. Ces types de données capturent des lectures instantanées pour les données de santé et de bien-être, y compris l'activité physique, le sommeil et la nutrition. N'importe quelle valeur peut demander les autorisations appropriées pour lire et écrire dans ces types de données, à l'exception de quelques types de données de localisation, qui ne peuvent être lus que par l'application qui les a écrites.

Pour en savoir plus, consultez les pages suivantes :

Types de données de santé
Types de données fournis par la plate-forme dont l'accès est limité pour les raisons suivantes des données potentiellement sensibles. Pour en savoir plus, consultez l'article Données de santé types.
Agréger les types de données
Types de données permettant de lire les informations sur la santé et le bien-être agrégées par heure ou type d'activité. Pour en savoir plus, consultez la section Données globales types.
Types de données personnalisées privées
Types de données personnalisés définis par une application spécifique. Seule l'application qui définit data type peuvent lire et écrire des données de ce type. Pour en savoir plus, consultez Types de données personnalisés :

Utiliser des types de données

Android

Sur Android, les types de données sont définis comme des champs publics du DataType . La manière dont vous appelez les API Fitness avec le type de données dépend de ce que vous voulez accomplir:

  • Pour enregistrer des données, utilisez l'API Recording pour : créez un abonnement pour chaque type de données que vous souhaitez enregistrer.
  • Pour lire des données, utilisez l'API History afin d'envoyer une lecture. pour chaque type de données.
  • Pour insérer des données historiques passées, utilisez l'API History pour : envoyer une demande d'insertion pour chaque type de données.
  • Pour créer des sessions, insérez ou enregistrez des sessions avec l'API Sessions. avec les métadonnées de session.

Pour créer des points de données pour une requête DataType , attribuez des valeurs au format approprié. L'exemple suivant vous montre comment affecter le plat en tant que chaîne, le type de repas comme une constante la classe Field, et les teneurs en nutriments sous forme de valeurs flottantes mappées.

val nutritionSource = DataSource.Builder()
    .setDataType(DataType.TYPE_NUTRITION)
    ...
    .build()

val nutrients = mapOf(
    Field.NUTRIENT_TOTAL_FAT to 0.4f,
    Field.NUTRIENT_SODIUM to 1f,
    Field.NUTRIENT_POTASSIUM to 422f
)
val banana = DataPoint.builder(nutritionSource)
    .setTimestamp(now, TimeUnit.MILLISECONDS)
    .setField(Field.FIELD_FOOD_ITEM, "banana")
    .setField(Field.FIELD_MEAL_TYPE, Field.MEAL_TYPE_SNACK)
    .setField(Field.FIELD_NUTRIENTS, nutrients)
    .build()

Après avoir défini des points de données dans votre appli, vous pouvez insérer, lire ou supprimer des données historiques avec l'API History

REST

La ressource dataSources inclut le type de données (et la liste de ses champs) pour chaque source de données. Vous pouvez spécifier l'un de ces types de données lorsque vous créez des sources de données, et vous pouvez obtenir le nom du type de données et la liste de ses champs. lorsque vous récupérez une source de données dans un magasin de données de fitness.

Par exemple, une représentation de source de données spécifie son type de données comme suit:

{
"dataStreamId": "exampleDataSourceId",
...
"dataType": {
  "name": "com.google.step_count.delta"
},
...
}

Champs d'application des autorisations

Les champs d'application d'autorisation couvrent des groupes de types de données pour lesquels un utilisateur peut autoriser une application à y accéder. Ils aident les utilisateurs à comprendre à quels types de données une application souhaite accéder. Elles facilitent aussi l'autorisation d'utilisation des données par les applications, d'approuver chaque type de données individuel. Les utilisateurs accordent ces autorisations une fois qu'ils ont téléchargé votre application.

<ph type="x-smartling-placeholder">
</ph> Exemple de l&#39;écran de consentement pour les champs d&#39;application OAuth
Figure 2 : Écran de consentement pour les champs d'application OAuth

Après avoir testé votre application auprès d'un petit nombre d'utilisateurs, application, vous devez demander la validation en fonction champs d'application pertinents pour ces types de données. Parcourez les pages sur les types de données associées. ci-dessus pour comprendre quels champs d'application s'appliquent à chaque type de données.

Par exemple, si votre application doit lire et écrire la tension artérielle, doit déclarer qu'il fait à la fois des lectures et des écritures et demander les deux champs d'application. S'il s'agit n'écrit les données sur la tension artérielle que sur la plate-forme Google Fit, celle-ci n'a besoin le champ d'application d'écriture.

Choisissez les types de données de manière responsable. Ne demandez pas tous les types de données si votre application pourrait en avoir besoin. Les types spécifiés déterminent les niveaux d'accès que l'utilisateur est invité à spécifier pour laquelle vous devez accorder l'autorisation. Ne demandez que les types de données dont votre application a besoin pour que les utilisateurs plus susceptibles d'accorder l'accès. Les utilisateurs accordent plus facilement un accès à des ressources limitées les champs d'application décrits.

Utilisez ce tableau pour vérifier si les niveaux d'accès auxquels votre application a besoin d'accéder sont sensibles ou restreinte (qui détermine la validation étapes que vous devrez suivre):

Champ d'application Description Catégorie
https://www.googleapis.com/auth/fitness.activity.read Lire les données d'activité de la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.activity.write Écrire les données d'activité sur la plate-forme Google Fit Limité
https://www.googleapis.com/auth/fitness.blood_glucose.read Lire les données sur la glycémie à partir de la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.blood_glucose.write Écrire des données sur la glycémie sur la plate-forme Google Fit Limité
https://www.googleapis.com/auth/fitness.blood_pressure.read Lire des données sur la tension artérielle à partir de la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.blood_pressure.write Écrire des données sur la tension artérielle sur la plate-forme Google Fit Limité
https://www.googleapis.com/auth/fitness.body.read Lire les données de mesure corporelle (taille, poids, pourcentage de masse grasse) à partir de la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.body.write Écrire des données de mesure corporelle sur la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.body_temperature.read Lire des données sur la température corporelle à partir de la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.body_temperature.write Écrire des données sur la température corporelle sur la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.heart_rate.read Lire les données de fréquence cardiaque à partir de la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.heart_rate.write Écrire des données de fréquence cardiaque sur la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.location.read Lire les données de localisation à partir de la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.location.write Écrire les données de localisation sur la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.nutrition.read Lire les données nutritionnelles de la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.nutrition.write Écrire des données nutritionnelles sur la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.oxygen_saturation.read Lire les données sur la saturation en oxygène de la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.oxygen_saturation.write Écrire des données sur la saturation en oxygène sur la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.reproductive_health.read Lire des données sur la santé reproductive à partir de la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.reproductive_health.write Écrire des données sur la santé reproductive sur la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.sleep.read Lire les données sur le sommeil de la plate-forme Google Fit. Limité
https://www.googleapis.com/auth/fitness.sleep.write Écrire des données sur le sommeil sur la plate-forme Google Fit. Limité

Ajouter de nouveaux champs d'application à une application existante

Lorsque vous mettez à jour votre application pour demander un nouveau champ d'application (par exemple, si vous ajoutez le nouveau champ habilitations de sommeil ou de fréquence cardiaque, ou ajouter un champ d'application de lecture), les utilisateurs seront invités à votre application demande l'accès à ces habilitations. Ils peuvent choisir d'accorder ou refuser l'accès.

Il est recommandé de demander aux utilisateurs l'autorisation d'accéder aux ressources au moment vous en avez besoin. Suivez les consignes pour demander des augmentations autorisation.

Les utilisateurs seront plus enclins à vous accorder l'accès s'ils comprennent pourquoi et comment votre application utilise ces données:

  • Pensez à ajouter un écran qui avertit les utilisateurs ou les informe qu'ils seront invités ces champs d'application.
  • Expliquez clairement pourquoi votre appli demande l'accès à ces champs d'application/données. les utilisateurs peuvent prendre une décision éclairée.

En savoir plus sur les bonnes pratiques concernant les autorisations des applications pour Android