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.