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 les 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 sources de données. Il peut exister plusieurs sources de données pour le même type de données. Chaque point de données de chaque ensemble de données inséré dans ou lu à partir de l'API Fitness est associé à une source de données.

Chaque source de données génère un flux unique de mises à jour des 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 des 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 est généré automatiquement par le serveur au format approprié. Si un dataStreamId est défini, il doit correspondre au format que le serveur générera. Ce format combine certains champs de la source de données et présente un ordre spécifique. Si ce n'est pas le cas, la requête échouera et générera une erreur.

La spécification d'un type de données (dont le type n'est pas connu (commençant par "com.google.")) crée une source de données 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 à la place les 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 du développeur qui est 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 un 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 Value 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é à l'heure actuelle.

Autorisation

Cette requête nécessite une autorisation avec au moins l'un des champs d'application suivants:

Portée
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é Value Description Remarques
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. Cette étape est obligatoire pour les clients REST, mais nous n'imposons pas l'unicité de ce nom. Elle est fournie pour faciliter l'identification des développeurs qui souhaitent créer 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é par, inséré dans ou demandé par l'API Fitness.
dataType.field[] list Un champ représente une dimension d'un type de données.
dataType.field[].format string Différents formats compatibles pour chaque champ d'un type de données.

Les valeurs autorisé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 être uniques au sein du type de données.
dataType.name string Chaque type de données a un nom d'espace de noms unique. 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 visible par l'utilisateur final pour l'appareil.
device.type string Constante représentant le type de l'appareil.

Les valeurs autorisé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 verra le champ "uid" de manière claire et normale.

L'obscurcissement préserve l'égalité, c'est-à-dire, pour 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 autorisées sont les suivantes :
  • "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.