Users.dataSources.datasets

Zbiór danych reprezentuje kontener prognozy dla punktów danych. Nie mają żadnych własnych informacji. Zbiory danych reprezentują zbiór punktów danych pochodzących z określonego źródła danych. Punkt danych można znaleźć w więcej niż 1 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 usługi Wartość Opis Uwagi
dataSourceId string Identyfikator strumienia danych źródła danych, które utworzyło punkty w tym zbiorze danych.
maxEndTimeNs long Największy czas zakończenia ze wszystkich punktów danych w tej prawdopodobnie częściowej reprezentacji zbioru danych. Czas jest podany w nanosekundach od epoki. Powinien też być zgodny z drugą częścią identyfikatora zbioru danych.
minStartTimeNs long Najkrótszy czas rozpoczęcia ze wszystkich punktów danych w tej prawdopodobnie częściowej reprezentacji zbioru danych. Czas jest podany w nanosekundach od epoki. Powinien też być zgodny z pierwszą częścią identyfikatora zbioru danych.
nextPageToken string Ten token zostanie ustawiony, gdy zbiór danych w odpowiedzi na żądanie GET będzie zbyt duży, aby można go było uwzględnić w jednej odpowiedzi. Podaj 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 uporządkowana według parametru endTimeNanos. Podczas pobierania małego zbioru danych ta lista jest uznawana za kompletną, a podczas pobierania poprawek do zbioru danych lub pobierania zbioru danych, który jest zbyt duży, aby go uwzględnić w pojedynczej odpowiedzi.
point[].computationTimeMillis long NIE UŻYWAĆ TEGO POLA. Jest ignorowana i nie jest zapisywana.
point[].dataTypeName string Typ danych określający format wartości w tym punkcie danych.
point[].endTimeNanos long Czas zakończenia przedziału reprezentowanego przez ten punkt danych w nanosekundach od początku epoki.
point[].modifiedTimeMillis long Wskazuje, kiedy ostatnio ten punkt danych został zmodyfikowany. Jest przydatne tylko wtedy, gdy wymieniamy zmiany danych, a nie pokazuje ich bieżący stan.
point[].originDataSourceId string Jeśli punkt danych znajduje się w zbiorze danych związanych ze źródłem danych pochodnych, pole to zostanie zapełnione identyfikatorem strumienia źródła danych, za pomocą którego pierwotnie utworzono punkt danych.

OSTRZEŻENIE: nie korzystaj z tego pola do celów innych niż debugowanie. Wartość tego pola, o ile jest w ogóle ustawiona, stanowi szczegóły implementacji i nie ma gwarancji, że pozostanie spójna.
point[].rawTimestampNanos long Nieprzetworzona sygnatura czasowa pierwotnego zdarzenia SensorEvent.
point[].startTimeNanos long Czas rozpoczęcia przedziału reprezentowanego przez ten punkt danych w nanosekundach od początku epoki.
point[].value[] list Wartości poszczególnych pól typu danych dla punktu danych. Oczekuje się, że każda wartość odpowiadająca polu typu danych będzie występować w tej samej kolejności, w jakiej pole występuje w typie danych określonym w źródle danych.

W zależności od formatu wartości wyliczeniowej w polu typu źródła danych zostanie wypełnione tylko jedno z pól liczb całkowitych i zmiennoprzecinkowych.

point[].value[].fpVal double Wartość zmiennoprzecinkowa. Jeśli ta opcja jest ustawiona, nie można ustawiać innych wartości.
point[].value[].intVal integer Liczba całkowita. Jeśli ta opcja jest ustawiona, nie można ustawiać innych wartości.
point[].value[].mapVal[] list Mapuj wartość. W definicji typu danych należy udokumentować prawidłową przestrzeń kluczy i jednostki dla odpowiedniej wartości każdego wpisu. Klucze powinny być małe, jeśli to możliwe. Strumienie danych z dużymi kluczami i wysoką częstotliwością mogą być próbkowane.
point[].value[].mapVal[].key string
point[].value[].mapVal[].value nested object
point[].value[].mapVal[].value.fpVal double Wartość zmiennoprzecinkowa.
point[].value[].stringVal string Wartość ciągu. Jeśli ta opcja jest ustawiona, nie można ustawiać innych wartości. Ciągi powinny być małe, jeśli to możliwe. Strumienie danych z dużymi wartościami ciągu znaków i o dużej częstotliwości mogą być próbkowane.

Metody

usuń
Wykonuje włącznie z usunięciem wszystkich punktów danych, których czas rozpoczęcia i zakończenia nie pokrywają się z zakresem czasu określonym przez identyfikator zbioru danych. Większość typy danych, zostanie usunięty cały punkt danych. W przypadku typów danych, w których parametr okres prezentuje stałą wartość (np. com.google.activity.segment) i oddzielne punkty danych w obu punktach końcowych zbioru danych, a jedynie pokrywające się fragmenty danych, punkt zostanie usunięty.
pobierz
Zwraca zbiór danych zawierający wszystkie punkty danych, których czas rozpoczęcia i zakończenia pokrywają się z określonym zakresem minimalnego czasu rozpoczęcia zbioru danych i maksymalny czas zakończenia. Konkretnie: każdy punkt danych, którego czas rozpoczęcia jest krótszy: nie jest równy czasowi zakończenia zbioru danych, a godzina zakończenia jest późniejsza niż lub równy czasowi rozpoczęcia zbioru danych.
poprawka
Dodaje punkty danych do zbioru danych. Nie trzeba wcześniej utworzyć tego zbioru danych. Wszystkie punkty w danym zbiorze danych zostaną zwrócone z kolejnymi wywołaniami aby pobrać ten zbiór danych. Punkty danych mogą należeć do więcej niż 1 zbioru danych.

Ta metoda nie używa semantyki poprawki: podane punkty danych są po prostu wstawione – istniejące dane nie są zastąpione.