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 | 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. 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 :
|
|
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 :
|
|
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 :
|
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.