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.