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

Un ensemble de données représente un conteneur de projection pour des points de données. Ils ne possèdent pas leurs propres informations. Les ensembles de données représentent un ensemble de points de données provenant d'une source de données particulière. Un point de données peut se trouver dans plusieurs ensembles de données.

La liste des méthodes associées à cette ressource est présentée au bas de la page.

Représentations de la ressource

{
  "minStartTimeNs": long,
  "maxEndTimeNs": long,
  "dataSourceId": string,
  "point": [
    {
      "startTimeNanos": long,
      "endTimeNanos": long,
      "dataTypeName": string,
      "originDataSourceId": string,
      "value": [
        {
          "intVal": integer,
          "fpVal": double,
          "stringVal": string,
          "mapVal": [
            {
              "key": string,
              "value": {
                "fpVal": double
              }
            }
          ]
        }
      ],
      "modifiedTimeMillis": long,
      "rawTimestampNanos": long,
      "computationTimeMillis": long
    }
  ],
  "nextPageToken": string
}

Nom de propriété	Valeur	Description
`dataSourceId`	`string`	ID de flux de données de la source de données qui a créé les points dans cet ensemble de données.
`maxEndTimeNs`	`long`	Heure de fin la plus élevée de tous les points de données dans cette représentation éventuellement partielle de l'ensemble de données. L'heure est exprimée en nanosecondes à partir de l'epoch. Il doit également correspondre à la deuxième partie de l'identifiant de l'ensemble de données.
`minStartTimeNs`	`long`	Heure de début la plus courte de tous les points de données dans cette représentation éventuellement partielle de l'ensemble de données. L'heure est exprimée en nanosecondes à partir de l'epoch. Il doit également correspondre à la première partie de l'identifiant de l'ensemble de données.
`nextPageToken`	`string`	Ce jeton est défini lorsqu'un ensemble de données est reçu en réponse à une requête GET et que cet ensemble de données est trop volumineux pour être inclus dans une seule réponse. Indiquez cette valeur dans une requête GET ultérieure pour renvoyer la page de points de données suivante dans cet ensemble de données.
`point[]`	`list`	Liste partielle des points de données contenus dans l'ensemble de données, triés par endTimeNanos. Cette liste est considérée comme complète lors de la récupération d'un petit ensemble de données et partielle lors de l'application de correctifs à un ensemble de données ou de la récupération d'un ensemble de données trop volumineux pour être inclus dans une seule réponse.
`point[].computationTimeMillis`	`long`	N'UTILISEZ PAS CE CHAMP. Elle est ignorée et n'est pas stockée.
`point[].dataTypeName`	`string`	Type de données définissant le format des valeurs de ce point de données.
`point[].endTimeNanos`	`long`	Heure de fin de l'intervalle représenté par ce point de données, en nanosecondes depuis l'epoch.
`point[].modifiedTimeMillis`	`long`	Indique la date de la dernière modification de ce point de données. Utile uniquement dans les contextes où les données changent, plutôt que de représenter leur état actuel.
`point[].originDataSourceId`	`string`	Si le point de données est contenu dans un ensemble de données d'une source de données dérivée, ce champ sera renseigné avec l'ID de flux de la source de données à l'origine de la création du point de données. AVERTISSEMENT: N'utilisez pas ce champ pour autre chose que le débogage. La valeur de ce champ, si elle est définie, est un détail d'implémentation et sa cohérence n'est pas garantie.
`point[].rawTimestampNanos`	`long`	Code temporel brut de l'événement SensorEvent d'origine.
`point[].startTimeNanos`	`long`	Heure de début de l'intervalle représenté par ce point de données, en nanosecondes depuis l'epoch.
`point[].value[]`	`list`	Valeurs de chaque champ de type de données pour le point de données. Chaque valeur correspondant à un champ de type de données doit apparaître dans le même ordre que celui indiqué dans le champ, dans le type de données spécifié dans une source de données. Un seul des champs de type entier et à virgule flottante sera renseigné, selon la valeur d'énumération du format dans le champ de type de la source de données.
`point[].value[].fpVal`	`double`	Valeur à virgule flottante. Lorsque ce champ est défini, aucune autre valeur ne doit être définie.
`point[].value[].intVal`	`integer`	Valeur de nombre entier ("int"). Lorsque ce champ est défini, aucune autre valeur ne doit être définie.
`point[].value[].mapVal[]`	`list`	Valeur de la carte. L'espace clé et les unités valides pour la valeur correspondante de chaque entrée doivent être documentés lors de la définition du type de données. Dans la mesure du possible, les clés doivent être réduites. Les flux de données associés à des clés volumineuses et à une fréquence de données élevée peuvent être sous-échantillonnés.
`point[].value[].mapVal[].key`	`string`
`point[].value[].mapVal[].value`	`nested object`
`point[].value[].mapVal[].value.fpVal`	`double`	Valeur à virgule flottante.
`point[].value[].stringVal`	`string`	Valeur de chaîne. Lorsque ce champ est défini, aucune autre valeur ne doit être définie. Dans la mesure du possible, les chaînes doivent être réduites. Les flux de données contenant des valeurs de chaîne élevées et une fréquence de données élevée peuvent être sous-échantillonnés.

Méthodes

supprimer: Effectue une suppression inclusive de tous les points de données dont les heures de début et de fin chevauchent la période spécifiée par l'ID de l'ensemble de données. Pour la plupart des types de données, l'intégralité du point de données sera supprimée. Pour les types de données où la période représente une valeur cohérente (par exemple, com.google.activity.segment) et où un point de données chevauche l'un ou l'autre des points de terminaison de l'ensemble de données, seule la partie chevauchant le point de données est supprimée.
get: Renvoie un ensemble de données contenant tous les points de données dont les heures de début et de fin chevauchent la plage spécifiée d'heures de début minimale et maximale de l'ensemble de données. Plus précisément, tout point de données dont l'heure de début est inférieure ou égale à l'heure de fin de l'ensemble de données et dont l'heure de fin est supérieure ou égale à l'heure de début de l'ensemble de données.
patch: Ajoute des points de données à un ensemble de données. Il n'est pas nécessaire de créer l'ensemble de données au préalable. Tous les points de l'ensemble de données donné seront renvoyés avec les appels ultérieurs pour récupérer cet ensemble de données. Les points de données peuvent appartenir à plusieurs ensembles de données.

Cette méthode n'utilise pas la sémantique "patch" : les points de données fournis sont simplement insérés, et aucune donnée existante n'est remplacée.