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.