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 se trouve 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é	Value	Description
`dataSourceId`	`string`	ID du flux de données de la source de données qui a créé les points dans cet ensemble de données.
`maxEndTimeNs`	`long`	Plus grande heure de fin de tous les points de données dans cette représentation éventuellement partielle. La durée est exprimée en nanosecondes depuis l'époque. Il doit également correspondre à la deuxième partie de l'identifiant de l'ensemble de données.
`minStartTimeNs`	`long`	Plus petit point de départ de tous les points de données dans cette représentation éventuellement partielle. La durée est exprimée en nanosecondes depuis l'époque. 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 l'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, ordonné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 lorsque vous corrigez un ensemble de données ou récupérez un ensemble de données trop volumineux pour être inclus dans une seule réponse.
`point[].computationTimeMillis`	`long`	NE PAS UTILISER 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 écoulées depuis l'époque.
`point[].modifiedTimeMillis`	`long`	Indique la dernière fois que ce point de données a été modifié. Utile uniquement dans les contextes où nous répertorions les modifications des données, plutôt que de représenter l'état actuel des données.
`point[].originDataSourceId`	`string`	Si le point de données est contenu dans un ensemble de données pour une source de données dérivée, ce champ sera renseigné avec l'ID de flux de source de données qui a créé le point de données à l'origine. AVERTISSEMENT: N'utilisez ce champ que pour le débogage. La valeur de ce champ, s'il est définie, constitue un détail de l'implémentation. Il n'est pas garanti qu'elle reste cohérente.
`point[].rawTimestampNanos`	`long`	Horodatage 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'époque.
`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 dans lequel le champ est répertorié dans le type de données spécifié dans une source de données. Un seul des champs d'entier et à virgule flottante sera renseigné, en fonction de 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 paramètre est défini, aucune autre valeur ne doit être définie.
`point[].value[].intVal`	`integer`	Valeur de nombre entier ("int"). Lorsque ce paramètre 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 dans la définition du type de données. Dans la mesure du possible, utilisez des clés de petite taille. Les flux de données associés à des clés volumineuses et à une fréquence de données élevée peuvent être é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 paramètre est défini, aucune autre valeur ne doit être définie. Les chaînes doivent être réduites autant que possible. Les flux de données avec des valeurs de chaîne élevées et une fréquence de données élevée peuvent être é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 se chevauchent avec 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 est supprimée. Pour les types de données dans lesquels la période représente une valeur cohérente (telle que com.google.activity.segment) et un point de données chevauche l'un des points de terminaison de l'ensemble de données, seule la partie chevauchant le point de données est supprimée.
obtenir: Renvoie un ensemble de données contenant tous les points de données dont les heures de début et de fin se chevauchent avec la plage spécifiée de l'heure de début minimale et de l'heure de fin maximales 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.
correctif: Ajoute des points de données à un ensemble de données. Vous n'avez pas besoin de créer l'ensemble de données précédemment. Tous les points de l'ensemble de données seront renvoyés avec des 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.