Users.dataSources.datasets

Ein Dataset stellt einen Projektionscontainer für Datenpunkte dar. Sie tragen selbst keine Informationen bei. Datasets stellen einen Satz von Datenpunkten aus einer bestimmten Datenquelle dar. Ein Datenpunkt kann in mehreren Datasets enthalten sein.

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

{
  "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
}
Property-Name Wert Beschreibung Hinweise
dataSourceId string Die Datenstream-ID der Datenquelle, über die die Punkte in diesem Dataset erstellt wurden.
maxEndTimeNs long Die längste Endzeit aller Datenpunkte in dieser möglicherweise Teildarstellung des Datasets. Die Zeit wird in Nanosekunden ab der Epoche angegeben. Er sollte auch mit dem zweiten Teil der Dataset-ID übereinstimmen.
minStartTimeNs long Die kleinste Startzeit aller Datenpunkte in dieser möglicherweise Teildarstellung des Datasets. Die Zeit wird in Nanosekunden ab der Epoche angegeben. Er sollte auch mit dem ersten Teil der Dataset-ID übereinstimmen.
nextPageToken string Dieses Token wird festgelegt, wenn ein Dataset als Antwort auf eine GET-Anfrage empfangen wird und das Dataset zu groß ist, um in eine einzelne Antwort aufgenommen zu werden. Geben Sie diesen Wert in einer nachfolgenden GET-Anfrage an, um die nächste Seite mit Datenpunkten in diesem Dataset zurückzugeben.
point[] list Eine unvollständige Liste der im Dataset enthaltenen Datenpunkte, sortiert nach endTimeNanos. Diese Liste gilt als vollständig, wenn ein kleines Dataset abgerufen wird, und als Teil, wenn ein Dataset gepatcht oder ein Dataset abgerufen wird, das zu groß ist, um es in eine einzelne Antwort aufzunehmen.
point[].computationTimeMillis long VERWENDEN SIE DIESES FELD NICHT. Sie wird ignoriert und nicht gespeichert.
point[].dataTypeName string Der Datentyp, der das Format der Werte in diesem Datenpunkt definiert.
point[].endTimeNanos long Die Endzeit des durch diesen Datenpunkt dargestellten Intervalls in Nanosekunden seit der Epoche.
point[].modifiedTimeMillis long Gibt an, wann dieser Datenpunkt zuletzt geändert wurde. Nur nützlich, wenn die Datenänderungen aufgelistet werden und nicht der aktuelle Status der Daten dargestellt wird.
point[].originDataSourceId string Wenn der Datenpunkt in einem Dataset für eine abgeleitete Datenquelle enthalten ist, wird dieses Feld mit der Datenquellenstream-ID gefüllt, mit der der Datenpunkt ursprünglich erstellt wurde.

WARNUNG: Dieses Feld sollte ausschließlich für die Fehlerbehebung verwendet werden. Der Wert dieses Feldes ist, sofern er überhaupt festgelegt ist, ein Implementierungsdetail und seine Konsistenz ist nicht garantiert.
point[].rawTimestampNanos long Der unformatierte Zeitstempel des ursprünglichen SensorEvent.
point[].startTimeNanos long Die Startzeit des durch diesen Datenpunkt dargestellten Intervalls in Nanosekunden seit der Epoche.
point[].value[] list Werte jedes Datentypfelds für den Datenpunkt. Es wird davon ausgegangen, dass alle Werte, die einem Datentypfeld entsprechen, in derselben Reihenfolge auftreten, in der das Feld im Datentyp aufgeführt ist, der in einer Datenquelle angegeben ist.

Nur eines der Felder für Ganzzahl oder Gleitkomma wird ausgefüllt, je nachdem, welcher Formatwert im Typfeld der Datenquelle angegeben wurde.

point[].value[].fpVal double Gleitkommawert. Wenn dieser Parameter festgelegt ist, dürfen keine anderen Werte festgelegt werden.
point[].value[].intVal integer Ganzzahlwert. Wenn dieser Parameter festgelegt ist, dürfen keine anderen Werte festgelegt werden.
point[].value[].mapVal[] list Zuordnungswert. Der gültige Schlüsselbereich und die Einheiten für den entsprechenden Wert jedes Eintrags sollten als Teil der Datentypdefinition dokumentiert werden. Schlüssel sollten möglichst klein gehalten werden. Bei Datenstreams mit großen Schlüsseln und hoher Datenhäufigkeit wird möglicherweise eine geringere Stichprobenerhebung verwendet.
point[].value[].mapVal[].key string
point[].value[].mapVal[].value nested object
point[].value[].mapVal[].value.fpVal double Gleitkommawert.
point[].value[].stringVal string Stringwert. Wenn dieser Parameter festgelegt ist, dürfen keine anderen Werte festgelegt werden. Strings sollten möglichst klein gehalten werden. Bei Datenstreams mit großen Stringwerten und hoher Datenhäufigkeit kann es zu einer Herabstufung der Stichproben kommen.

Methoden

Delete
Alle Datenpunkte mit Start- und Endzeiten werden einschließend gelöscht sich mit dem durch die Dataset-ID angegebenen Zeitraum überschneiden. Für die meisten wird der gesamte Datenpunkt gelöscht. Für Datentypen, bei denen der Zeitspanne steht für einen einheitlichen Wert (z. B. com.google.activity.segment) und ein Datenpunkt überspannt an einem beliebigen Endpunkt des Datasets, nur der sich überschneidende Teil der Daten wird gelöscht.
get
Gibt ein Dataset zurück, das alle Datenpunkte mit Start- und Endzeit enthält sich mit dem angegebenen Bereich der minimalen Startzeit des Datasets überschneiden und für das Ende. Insbesondere Datenpunkte, deren Startzeit kürzer ist als oder gleich der Endzeit des Datasets und deren Endzeit größer als oder ist mit der Dataset-Startzeit übereinstimmt.
patch
Fügt einem Dataset Datenpunkte hinzu. Das Dataset muss nicht zuvor erstellt worden sein. Alle Punkte innerhalb des angegebenen Datasets werden mit nachfolgenden Aufrufen zurückgegeben. um dieses Dataset abzurufen. Datenpunkte können zu mehr als einem Dataset gehören.

Diese Methode verwendet keine Patch-Semantik: Die bereitgestellten Datenpunkte sind nur eingefügt werden, ohne dass vorhandene Daten ersetzt werden.