Users.dataSources: update

Met à jour la source de données spécifiée. dataStreamId dataType, type, dataStreamName et device, à l'exception de version, ne peut pas être modifié.

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 du 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 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 Remarques
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.
dataStreamId string Identifiant unique du flux de données produit par cette source de données. Cet identifiant inclut les éléments suivants:

  • Fabricant, modèle et numéro de série (UID) de l'appareil physique.
  • Nom du package ou du package de l'application. Le nom de package est utilisé lorsque la source de données a été créée par une application Android. Le numéro de projet du développeur est utilisé lorsque la source de données a été créée par un client REST.
  • Type de la source de données.
  • Nom du flux de la source de données.
Notez que tous les attributs de la source de données ne sont pas utilisés dans l'identifiant du flux. Plus précisément, la version du matériel/de l'application n'est pas utilisée. Cela nous permet de conserver le même flux lors des mises à jour de version. Cela signifie également que deux objets DataSource peuvent représenter le même flux de données, même s'ils ne sont pas égaux.

Le format exact de l'ID de flux de données créé par une application Android est le suivant: type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName

Le format exact de l'ID de flux de données créé par un client REST est le suivant: type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

Si l'un des champs facultatifs qui constituent l'ID du flux de données est absent, il est omis de l'ID. L'ID de flux de données minimum viable serait le suivant: type:dataType.name:developer project number

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 peut voir le numéro de projet du développeur sous une forme claire et normale. Cela signifie qu'un client verra un ensemble d'ID 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 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.