Met à jour la source de données spécifiée. Les propriétés dataStreamId
, dataType
, type
, dataStreamName
et device
, à l'exception de version
, ne peuvent pas être modifiées.
Les sources de données sont identifiées par leur dataStreamId
.
Essayer maintenant
Requête
Requête HTTP
PUT https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId
Paramètres
Nom du paramètre | Valeur | Description |
---|---|---|
Paramètres de chemin d'accès | ||
dataSourceId |
string |
ID de flux de données de la source de données à mettre à jour. |
userId |
string |
Mettez à jour 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. | |
dataStreamId |
string |
Identifiant unique du flux de données produit par cette source de données. Cet identifiant inclut:
Le format exact de l'ID de flux de données créé par une application Android est le suivant: type:dataType.name Le format exact de l'ID de flux de données créé par un client REST est: type:dataType.name Lorsque l'un des champs facultatifs composant l'ID de flux de données est absent, il est omis de l'ID du flux de données. L'ID de flux de données viable minimal est le suivant: type:dataType.name:numéro de projet du développeur Enfin, le numéro de projet du développeur et l'UID de l'appareil sont obscurcis lorsqu'ils sont lus 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 numéro de projet de développeur dans un format clair et normal. Cela signifie qu'un client voit un ensemble de data_stream_id différent de celui d'un autre client avec des identifiants différents. |
|
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.