Users.dataSources.datasets

Zbiór danych odpowiada kontenerowi projekcji na punkty danych. Nie mają własnych informacji. Zbiory danych reprezentują zbiór punktów z określonego źródła danych. Punkt danych można znaleźć w więcej niż jednym zbiorze danych.

Listę metod dla tego zasobu znajdziesz na końcu tej strony.

Reprezentacje zasobów

{
  "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
}
Nazwa właściwości Wartość Opis Uwagi
dataSourceId string Identyfikator strumienia danych źródła, z którego utworzono punkty w tym zbiorze danych.
maxEndTimeNs long Największy czas zakończenia wszystkich punktów danych w tym prawdopodobnie reprezentacji zbioru danych. Czas jest w nanosekundach od początku epoki. Powinna ona także pasować do drugiej części identyfikatora zbioru danych.
minStartTimeNs long Najkrótszy czas rozpoczęcia wszystkich punktów danych w tym prawdopodobnie reprezentacji zbioru danych. Czas jest w nanosekundach od początku epoki. Powinna ona także odpowiadać pierwszej części identyfikatora zbioru danych.
nextPageToken string Ten token zostanie ustawiony po otrzymaniu zbioru danych w odpowiedzi na żądanie GET, a zbiór danych będzie zbyt duży, by uwzględnić go w pojedynczej odpowiedzi. Wpisz tę wartość w kolejnym żądaniu GET, aby zwrócić następną stronę punktów danych w tym zbiorze danych.
point[] list Częściowa lista punktów danych zawartych w zbiorze danych, posortowana według: endTimeNanos. Ta lista jest uznawana za pełną, gdy pobierasz mały zbiór danych, a częściowo podczas pobierania poprawek w zbiorze danych lub podczas pobierania zbioru danych, który jest zbyt duży do uwzględnienia w pojedynczej odpowiedzi.
point[].computationTimeMillis long NIE używaj tego pola. Jest ignorowane i nie jest przechowywane.
point[].dataTypeName string Typ danych określający format wartości w tym punkcie danych.
point[].endTimeNanos long Czas zakończenia przedziału czasu reprezentowanego przez ten punkt danych (w nanosekundach od początku epoki).
point[].modifiedTimeMillis long Wskazuje, kiedy ostatnio wprowadzono dany punkt danych. Ta opcja jest przydatna tylko w kontekście, w którym podajemy zmiany, a nie odzwierciedla obecny stan danych.
point[].originDataSourceId string Jeśli punkt danych znajduje się w zbiorze danych dla pochodzenia źródła danych, to pole zostanie wypełnione identyfikatorem strumienia danych, z którego początkowo utworzono punkt danych.

OSTRZEŻENIE: nie należy polegać na tym polu poza debugowaniem. Wartość tego pola, jeśli jest ustawiona w ogóle, jest szczegółami implementacji i nie ma gwarancji, że pozostanie ona spójna.
point[].rawTimestampNanos long Nieprzetworzona sygnatura czasowa z pierwotnego czujnika EventEvent.
point[].startTimeNanos long Czas rozpoczęcia przedziału czasu reprezentowanego przez ten punkt danych w nanosekundach od początku epoki.
point[].value[] list Wartości każdego pola typu danych dla punktu danych. Należy się spodziewać, że każda wartość odpowiadająca polu typu danych nastąpi w takiej kolejności, w jakiej to pole znajduje się na liście typów danych określonych w źródle danych.

W zależności od wartości formatu w polu typu źródła danych wypełnione zostanie tylko jedno pole liczby całkowitej i zmiennoprzecinkowej.

point[].value[].fpVal double Liczba zmiennoprzecinkowa. Jeśli to ustawienie jest ustawione, inne wartości nie mogą być ustawione.
point[].value[].intVal integer Wartość w formie liczby całkowitej. Jeśli to ustawienie jest ustawione, inne wartości nie mogą być ustawione.
point[].value[].mapVal[] list Wartość mapy. Prawidłową przestrzeń klucza i jednostki odpowiadającej wartości poszczególnych wpisów należy udokumentować w ramach definicji typu danych. W miarę możliwości klucze powinny być małe. Strumienie danych z dużymi kluczami i wysoka częstotliwość danych mogą być próbkowane.
point[].value[].mapVal[].key string
point[].value[].mapVal[].value nested object
point[].value[].mapVal[].value.fpVal double Liczba zmiennoprzecinkowa.
point[].value[].stringVal string Wartość ciągu znaków. Jeśli to ustawienie jest ustawione, inne wartości nie mogą być ustawione. Jeśli to możliwe, ciągi znaków powinny być małe. Strumienie danych z dużymi wartościami ciągu i dużą częstotliwością danych mogą być próbkowane.

Metody

usuń
Usunięcie wszystkich punktów danych, gdy czas rozpoczęcia i zakończenia pokrywa się z zakresem czasu określonym w identyfikatorze zbioru danych. W przypadku większości typów danych cały punkt danych zostanie usunięty. W przypadku typów danych, w których przedział czasu zawiera stałą wartość (np. com.google.activity.segment), a punkt danych znajduje się po obu stronach punktu końcowego zbioru danych, usuwany jest tylko pokrywający się punkt danych.
pobierz
Zwraca zbiór danych zawierający wszystkie punkty danych, których czas rozpoczęcia i zakończenia pokrywa się z określonym zakresem minimalnego czasu rozpoczęcia i zakończenia zbioru danych. W szczególności każdy punkt danych, którego czas rozpoczęcia jest krótszy niż czas zakończenia zbioru danych lub jego równy, a czas zakończenia jest większy lub równy czasowi rozpoczęcia zbioru danych.
poprawka
Dodaje punkty danych do zbioru danych. Nie trzeba wcześniej tworzyć zbioru danych. Wszystkie punkty w danym zbiorze danych zostaną zwrócone z kolejnymi wywołaniami w celu pobrania tego zbioru danych. Punkty danych mogą należeć do więcej niż jednego zbioru danych.

Ta metoda nie wykorzystuje semantyki poprawki: podane punkty danych są tylko wstawiane bez zastępowania danych.