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 spécifique. 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 Remarques
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 Heure de fin la plus élevée de tous les points de données dans cette représentation peut-être partielle de l'ensemble de données. Le temps est exprimé 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 petite de tous les points de données dans cette représentation peut-être partielle de l'ensemble de données. Le temps est exprimé 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 jeu 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, 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. Il est ignoré et non stocké.
point[].dataTypeName string Type de données définissant le format des valeurs dans 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ù nous listeons 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 la source de données qui a créé le point de données à l'origine.

AVERTISSEMENT: Ne vous fiez pas à ce champ pour autre chose que le débogage. Si elle est définie, la valeur de ce champ 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 normalement apparaître dans l'ordre 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 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. Aucune autre valeur ne doit être définie.
point[].value[].intVal integer Valeur de nombre entier ("int"). Lorsque cette propriété est définie, aucune autre valeur ne doit être définie.
point[].value[].mapVal[] list Mapper la valeur. 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, les clés doivent être petites. Les flux de données contenant 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 cette propriété est définie, aucune autre valeur ne doit être définie. Les chaînes doivent être petites dans la mesure du possible. Les flux de données contenant de grandes valeurs de chaîne 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 sont supprimées. ne chevauche pas la période spécifiée par l'ID de l'ensemble de données. Pour la plupart types de données, l'intégralité du point de données est 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 un point de données est à cheval sur chaque point final du jeu de données, uniquement la partie des données se chevauchant point d'accès sera supprimé.
get
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 pour l'heure de début minimale de l'ensemble de données et une heure de fin maximale. 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 à égale à l'heure de début de l'ensemble de données.
patch
Ajoute des points de données à un ensemble de données. L'ensemble de données n'a pas besoin d'être créé précédemment. Tous les points dans l'ensemble de données donné sont renvoyés avec les appels suivants 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ées, sans remplacer les données existantes.