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.