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. Ils peuvent également exposer des données dérivées, créées en transformant ou en fusionnant d'autres données sources. Plusieurs sources de données peuvent exister pour le même type de données. Toutes les données dans chaque ensemble de données inséré dans Fitness API ou lu à partir de celle-ci possède une la source de données associée.

Chaque source de données produit un flux unique de mises à jour de l'ensemble de données, avec l'identifiant unique de la source de données. Toutes les modifications apportées à la source de données n'affectent pas de flux de données, de sorte que les données collectées par les versions mises à jour application/appareil peuvent toujours être considérés comme appartenant aux mêmes source.

Les sources de données sont identifiées à l'aide d'une chaîne générée par le serveur, basée sur sur le contenu de la source en cours de création. dataStreamId ne doit pas être défini lors de l'appel de cette méthode. Il généré automatiquement par le serveur au format correct. Si dataStreamId est défini, il doit correspondre au format que généré par le serveur. Ce format est une combinaison de certains champs source de données, et a un ordre spécifique. Dans le cas contraire, la requête échoue et génère une erreur.

spécifier un DataType qui n'est pas un type connu (commençant par "com.google.") crée 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. utiliser des types de données standards à la place.

En plus des champs de source de données inclus dans l'ID de la source de données, Numéro de projet du développeur authentifié lors de la création des données source est incluse. Ce numéro de projet de développeur est obscurci lors de la lecture par tout autre développeur lisant des types de données publics. 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 indique l'utilisateur authentifié. Seul `me` est pris en charge dans ce en temps réel.

Autorisation

Une autorisation est requise pour cette demande. 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 des données de capteurs à la plate-forme.
`application.name`	`string`	Nom de cette application. Ce nom est obligatoire pour les clients REST, mais nous n'appliquons pas l'unicité de ce nom. Elle est fournie à des fins de commodité pour les 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 collectées, insérées ou interrogées à partir de l'API Fitness.
`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 possibles sont les suivantes: <ph type="x-smartling-placeholder"> </ph> "`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 associés à des espaces de noms et ne doivent être uniques qu'au sein du type de données.
`dataType.name`	`string`	Chaque type de données possède un nom unique, associé à un espace de noms. Tous les types de données de l'espace de noms com.google sont partagés dans 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 de modèle visible par l'utilisateur final de l'appareil.
`device.type`	`string`	Constante représentant le type d'appareil Les valeurs possibles sont les suivantes: <ph type="x-smartling-placeholder"> </ph> "`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 verra le champ de l'UID sous forme claire et normale. L'obscurcissement préserve l'égalité. c'est-à-dire, pour deux ID donnés, 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 possibles sont les suivantes: <ph type="x-smartling-placeholder"> </ph> "`derived`" "`raw`"

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource "Users.dataSources" dans le corps de 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.