Les API Google Fit, y compris l'API REST Google Fit, ne seront plus disponibles après le 30 juin 2025. Depuis le 1er mai 2024, les développeurs ne peuvent plus s'inscrire pour utiliser ces API.

Pour obtenir des instructions sur l'API ou la plate-forme vers laquelle effectuer la migration, consultez le guide de migration de Santé Connect. Pour comparer Santé Connect aux API Google Fit et Fitbit Web, consultez le guide comparatif Santé Connect.

Apprenez-en plus sur Santé Connect et sur l'intégration à l'API.

Cette page a été traduite par l'API Cloud Translation.

Users.dataSources: create

Crée une source de données unique parmi toutes les sources de données appartenant à cet utilisateur.

Une source de données est une source unique de données de capteurs. Les sources de données peuvent exposer des données brutes provenant de capteurs matériels sur des appareils locaux ou associés. Elles peuvent également exposer des données dérivées, créées par transformation ou fusion d'autres sources de données. Plusieurs sources de données peuvent exister pour le même type de données. Chaque point de données de chaque ensemble de données inséré dans l'API Fitness ou lu à partir de celui-ci est associé à une source de données.

Chaque source de données génère un flux unique de mises à jour d'ensembles de données, avec un identifiant de source de données unique. Toutes les modifications apportées à la source de données n'affectent pas l'ID du flux de données. Par conséquent, les données collectées par les versions mises à jour de la même application ou du même appareil peuvent toujours être considérées comme appartenant à la même source de données.

Les sources de données sont identifiées à l'aide d'une chaîne générée par le serveur, en fonction du contenu de la source en cours de création. Le champ dataStreamId ne doit pas être défini lors de l'appel de cette méthode. Il sera automatiquement généré par le serveur au bon format. Si un dataStreamId est défini, il doit correspondre au format généré par le serveur. Ce format, dans un ordre spécifique, combine certains champs de la source de données. En l'absence de correspondance, la requête échoue et renvoie une erreur.

Si vous spécifiez un DataType non connu (à partir de "com.google."), vous créerez une DataSource avec un type de données personnalisé. Les types de données personnalisés ne sont lisibles que par l'application qui les a créés. Les types de données personnalisés sont obsolètes. Utilisez plutôt des types de données standards.

En plus des champs de source de données inclus dans l'ID de la source de données, le numéro de projet de développeur authentifié lors de la création de la source de données est inclus. Ce numéro de projet de développeur est obscurci lorsqu'il est lu par tout autre développeur lisant des types de données publiques. Essayer maintenant

Requête

Requête HTTP

POST https://www.googleapis.com/fitness/v1/users/userId/dataSources

Paramètres

Nom du paramètre	Valeur	Description
Paramètres de chemin d'accès
`userId`	`string`	Créez la source de données pour la personne identifiée. Utilisez `me` pour indiquer l'utilisateur authentifié. Seul `me` est accepté pour le moment.

Autorisation

Une autorisation est requise pour cette requête. Celle-ci doit inclure au moins l'un des champs d'application suivants:

Champ d'application
`https://www.googleapis.com/auth/fitness.activity.write`
`https://www.googleapis.com/auth/fitness.location.write`
`https://www.googleapis.com/auth/fitness.body.write`
`https://www.googleapis.com/auth/fitness.nutrition.write`
`https://www.googleapis.com/auth/fitness.blood_pressure.write`
`https://www.googleapis.com/auth/fitness.blood_glucose.write`
`https://www.googleapis.com/auth/fitness.oxygen_saturation.write`
`https://www.googleapis.com/auth/fitness.body_temperature.write`
`https://www.googleapis.com/auth/fitness.reproductive_health.write`

Pour en savoir plus, consultez la page Authentification et autorisation.

Corps de la requête

Dans le corps de la requête, indiquez une ressource Users.dataSources avec les propriétés suivantes:

Nom de propriété	Valeur	Description
Propriétés obligatoires
`application`	`nested object`	Informations sur une application qui transmet les données des capteurs à la plate-forme.
`application.name`	`string`	Nom de cette application. Ce nom est obligatoire pour les clients REST, mais nous n'imposons pas l'unicité de ce nom. Il est fourni pour plus de commodité aux autres développeurs qui souhaitent identifier quel REST a créé une application ou une source de données.
`dataType`	`nested object`	Le type de données définit le schéma d'un flux de données recueillies par l'API Fitness, qui y sont insérées ou qui y sont interrogées.
`dataType.field[]`	`list`	Un champ représente une dimension d'un type de données.
`dataType.field[].format`	`string`	Les différents formats acceptés pour chaque champ d'un type de données. Les valeurs acceptées sont les suivantes : "`blob`" "`floatList`" "`floatPoint`" "`integer`" "`integerList`" "`map`" "`string`"
`dataType.field[].name`	`string`	Définit le nom et le format des données. Contrairement aux noms de type de données, les noms de champs ne sont pas liés à un espace de noms et doivent uniquement être uniques au sein du type de données.
`dataType.name`	`string`	Chaque type de données possède un nom unique et associé à un espace de noms. Tous les types de données de l'espace de noms com.google sont partagés au sein de la plate-forme.
`device`	`nested object`	Représentation d'un appareil intégré (tel qu'un téléphone ou un accessoire connecté) pouvant accueillir des capteurs.
`device.manufacturer`	`string`	Fabricant du produit/matériel.
`device.model`	`string`	Nom du modèle de l'appareil visible par l'utilisateur final.
`device.type`	`string`	Constante représentant le type d'appareil Les valeurs acceptées sont les suivantes : "`chestStrap`" "`headMounted`" "`phone`" "`scale`" "`smartDisplay`" "`tablet`" "`unknown`" "`watch`"
`device.uid`	`string`	Numéro de série ou autre identifiant unique du matériel. Ce champ est obscurci lorsqu'il est lu par un client REST ou Android qui n'a pas créé la source de données. Seul le créateur de la source de données voit le champ UID dans un format clair et normal. L'obscurcissement préserve l'égalité ; c'est-à-dire avec deux ID, si id1 == id2, obscurci(id1) == obscurci(id2).
`device.version`	`string`	Chaîne de version du matériel/logiciel de l'appareil.
`type`	`string`	Constante décrivant le type de cette source de données. Indique si cette source de données produit des données brutes ou dérivées. Les valeurs acceptées sont les suivantes : "`derived`" "`raw`"

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource Users.dataSources dans le corps de la réponse.

Essayer

Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.