Users.dataSources.datasets

Ein Dataset ist ein Projektionscontainer für Datenpunkte. Sie enthalten keine eigenen Informationen. Datasets stellen einen Satz von Datenpunkten aus einer bestimmten Datenquelle dar. Ein Datenpunkt kann in mehreren Datasets gefunden werden.

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, von der die Punkte in diesem Dataset erstellt wurden.
maxEndTimeNs	long	Die längste Endzeit aller Datenpunkte in dieser möglicherweise Teildarstellung des Datensatzes. Die Zeit wird in Nanosekunden der Epoche angegeben. Dieser 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 der Epoche angegeben. Dieser 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 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 Datensatz 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 unvollständig, wenn ein Dataset gepatcht oder ein Dataset abgerufen wird, das zu groß ist, um in eine einzelne Antwort aufgenommen zu werden.
point[].computationTimeMillis	long	VERWENDE DIESES FELD NICHT. Er 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 Intervalls, dargestellt durch diesen Datenpunkt, in Nanosekunden seit der Epoche.
point[].modifiedTimeMillis	long	Gibt an, wann dieser Datenpunkt zuletzt geändert wurde. Sie ist nur in Kontexten hilfreich, in denen die Datenänderungen aufgelistet 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 Stream-ID der Datenquelle gefüllt, mit der der Datenpunkt ursprünglich erstellt wurde. ACHTUNG: Verlassen Sie sich ausschließlich zur Fehlerbehebung auf dieses Feld. Wenn der Wert dieses Felds überhaupt festgelegt ist, handelt es sich um ein Implementierungsdetail, dessen Konsistenz nicht garantiert ist.
point[].rawTimestampNanos	long	Der Rohzeitstempel des ursprünglichen SensorEvent-Objekts.
point[].startTimeNanos	long	Startzeit des Intervalls, dargestellt durch diesen Datenpunkt, in Nanosekunden seit der Epoche.
point[].value[]	list	Werte jedes Datentypfelds für den Datenpunkt. Es wird erwartet, dass jeder Wert, der einem Datentypfeld entspricht, in derselben Reihenfolge auftritt, in der das Feld im Datentyp aufgelistet ist, der in einer Datenquelle angegeben ist. Abhängig vom Format „enum“ im Feld „Typ“ der Datenquelle wird nur eines der Felder „Ganzzahl“ und „Gleitkommazahl“ ausgefüllt.
point[].value[].fpVal	double	Gleitkommawert. Wenn dieser festgelegt ist, dürfen keine anderen Werte festgelegt werden.
point[].value[].intVal	integer	Ganzzahlwert. Wenn dieser festgelegt ist, dürfen keine anderen Werte festgelegt werden.
point[].value[].mapVal[]	list	Kartenwert. Der gültige Schlüsselbereich und die gültigen Einheiten für den entsprechenden Wert jedes Eintrags sollten in der Datentypdefinition dokumentiert sein. Schlüssel sollten nach Möglichkeit klein gehalten werden. Bei Datenstreams mit großen Schlüsseln und hoher Datenhäufigkeit kann es zu Downsampling-Stichproben kommen.
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 festgelegt ist, dürfen keine anderen Werte festgelegt werden. Strings sollten nach Möglichkeit klein gehalten werden. Bei Datenstreams mit großen Stringwerten und hoher Datenhäufigkeit kann es zu Downsampling-Stichproben kommen.

Methoden

delete

Führt ein inklusives Löschen aller Datenpunkte durch, deren Start- und Endzeit sich mit dem durch die Dataset-ID angegebenen Zeitraum überschneiden. Bei den meisten Datentypen wird der gesamte Datenpunkt gelöscht. Bei Datentypen, bei denen die Zeitspanne einen konsistenten Wert darstellt (z. B. com.google.activity.segment), und ein Datenpunkt auf einem der Endpunkte des Datasets liegt, wird nur der sich überschneidende Teil des Datenpunkts gelöscht.

get

Gibt ein Dataset zurück, das alle Datenpunkte enthält, deren Start- und Endzeit sich mit dem angegebenen Bereich der minimalen und maximalen Endzeit des Datasets überschneiden. Insbesondere Datenpunkte, deren Startzeit kleiner oder gleich der Endzeit des Datasets ist und deren Endzeit größer oder gleich der Startzeit des Datasets ist.

patch

Fügt einem Dataset Datenpunkte hinzu. Das Dataset muss nicht zuvor erstellt werden. Alle Punkte innerhalb des angegebenen Datasets werden mit nachfolgenden Aufrufen zum Abrufen dieses Datasets zurückgegeben. Datenpunkte können zu mehr als einem Dataset gehören.

Diese Methode verwendet keine Patch-Semantik: Die angegebenen Datenpunkte werden nur eingefügt, ohne vorhandene Daten zu ersetzen.