Zbiór danych reprezentuje kontener prognozy dla punktów danych. Nie mają w nich żadnych własnych informacji. Zbiory danych reprezentują zbiór punktów danych z określonego źródła. Punkt danych można znaleźć w więcej niż jednym zbiorze danych.
Listę metod stosowanych w przypadku 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 | Notatki |
---|---|---|---|
dataSourceId |
string |
Identyfikator strumienia danych ze źródła danych, które utworzyło punkty w tym zbiorze danych. | |
maxEndTimeNs |
long |
Największy czas zakończenia wszystkich punktów danych w tej prawdopodobnie częściowej reprezentacji zbioru danych. Czas jest wyrażony w nanosekundach od epoki. Powinna też pasować do drugiej części identyfikatora zbioru danych. | |
minStartTimeNs |
long |
Najmniejszy czas rozpoczęcia wszystkich punktów danych w tej prawdopodobnie częściowej reprezentacji zbioru danych. Czas jest wyrażony w nanosekundach od epoki. Powinna też pasować do pierwszej części identyfikatora zbioru danych. | |
nextPageToken |
string |
Ten token jest ustawiany, gdy zbiór danych zostanie odebrany w odpowiedzi na żądanie GET, a zbiór danych będzie zbyt duży, aby można go było umieścić w jednej odpowiedzi. Podaj tę wartość w kolejnym żądaniu GET, aby zwrócić kolejną 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. Ta lista jest uznawana za pełną w przypadku pobierania małego zbioru danych i częściową w przypadku stosowania poprawek do zbioru danych lub pobierania zbioru danych, który jest zbyt duży, aby uwzględnić go w jednej odpowiedzi. | |
point[].computationTimeMillis |
long |
NIE UŻYWAJ TEGO POLA. Jest ignorowana i nie jest przechowywana. | |
point[].dataTypeName |
string |
Typ danych określający format wartości w tym punkcie danych. | |
point[].endTimeNanos |
long |
Czas zakończenia przedziału przedstawionego przez ten punkt danych (w nanosekundach od początku epoki). | |
point[].modifiedTimeMillis |
long |
Wskazuje, kiedy ostatnio ten punkt danych został zmodyfikowany. Ta opcja jest przydatna tylko w kontekstach, w których wymieniamy zmiany w danych, a nie przedstawia ich bieżący stan. | |
point[].originDataSourceId |
string |
Jeśli punkt danych znajduje się w zbiorze danych dla pochodnego źródła danych, w tym polu pojawi się identyfikator strumienia źródła danych, z którego pierwotnie utworzono punkt danych. OSTRZEŻENIE: nie należy korzystać z tego pola w celach innych niż debugowanie. Wartość tego pola, o ile jest w ogóle ustawiona, stanowi szczegóły implementacji i nie możemy zagwarantować, że pozostanie spójna. |
|
point[].rawTimestampNanos |
long |
Nieprzetworzona sygnatura czasowa z pierwotnego zdarzenia SensorEvent. | |
point[].startTimeNanos |
long |
Czas rozpoczęcia przedziału przedstawionego przez ten punkt danych podany w nanosekundach od początku epoki. | |
point[].value[] |
list |
Wartości każdego pola typu danych punktu danych. Każda wartość odpowiadająca polu typu danych powinna występować w tej samej kolejności, w jakiej występuje to pole 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 dotyczących liczb całkowitych i zmiennoprzecinkowych. |
|
point[].value[].fpVal |
double |
Wartość zmiennoprzecinkowa. Jeśli ten parametr jest skonfigurowany, nie można ustawiać innych wartości. | |
point[].value[].intVal |
integer |
Wartość całkowita. Jeśli ten parametr jest skonfigurowany, nie można ustawiać innych wartości. | |
point[].value[].mapVal[] |
list |
Wartość na mapie. Prawidłowe przestrzenie klucza i jednostki dla odpowiedniej wartości każdego wpisu powinny być udokumentowane w ramach definicji typu danych. Klucze powinny być jak najmniejsze. Strumienie danych z dużymi kluczami i wysoką częstotliwością danych mogą być próbkowane w dół. | |
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 znaków. Jeśli ten parametr jest skonfigurowany, nie można ustawiać innych wartości. Ciągi znaków powinny być jak najmniejsze. Strumienie danych z dużymi wartościami ciągów znaków i dużą częstotliwością danych mogą zostać objęte próbkowaniem. |
Metody
- usuń
- Wykonuje włącznie z usunięciem wszystkich punktów danych, których czasy rozpoczęcia i zakończenia pokrywają się z przedziałem czasowym określonym przez identyfikator 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 przedstawia stałą wartość (np.
com.google.activity.segment
), a punkt danych znajduje się w jednym z punktów końcowych zbioru danych, usunięta zostanie tylko część tego punktu danych, która pokrywa się z nim. - pobierz
- Zwraca zbiór danych zawierający wszystkie punkty danych, których czasy rozpoczęcia i zakończenia pokrywają się z określonym zakresem minimalnego i maksymalnego czasu zakończenia zbioru danych. W szczególności dotyczy to każdego punktu danych, którego czas rozpoczęcia jest krótszy lub równy czasowi zakończenia zbioru danych i który czas zakończenia jest późniejszy lub równy czasowi rozpoczęcia zbioru danych.
- poprawka
- Dodaje punkty danych do zbioru danych. Zbiór danych nie musi być utworzony wcześniej.
Wszystkie punkty w danym zbiorze danych zostaną zwrócone wraz z kolejnymi wywołaniami służącymi do pobrania tego zbioru danych. Punkty danych mogą należeć do więcej niż 1 zbioru danych.
Ta metoda nie korzysta z semantyki poprawki: podane punkty danych są tylko wstawiane, a istniejące dane nie są zastępowane.