Набор данных представляет собой контейнер проекции для точек данных. Никакой собственной информации они не несут. Наборы данных представляют собой набор точек данных из определенного источника данных. Точку данных можно найти в нескольких наборах данных.
Список методов для этого ресурса см. в конце этой страницы.
Представления ресурсов
{
"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
}| Имя свойства | Ценить | Описание | Примечания |
|---|---|---|---|
dataSourceId | string | Идентификатор потока данных источника данных, создавшего точки в этом наборе данных. | |
maxEndTimeNs | long | Наибольшее время окончания всех точек данных в этом, возможно, частичном представлении набора данных. Время указывается в наносекундах от эпохи. Это также должно соответствовать второй части идентификатора набора данных. | |
minStartTimeNs | long | Наименьшее время начала всех точек данных в этом, возможно, частичном представлении набора данных. Время указывается в наносекундах от эпохи. Это также должно соответствовать первой части идентификатора набора данных. | |
nextPageToken | string | Этот токен будет установлен, когда набор данных будет получен в ответ на запрос GET, и набор данных слишком велик, чтобы его можно было включить в один ответ. Укажите это значение в последующем запросе GET, чтобы вернуть следующую страницу точек данных в этом наборе данных. | |
point[] | list | Частичный список точек данных, содержащихся в наборе данных, упорядоченный по endTimeNanos. Этот список считается полным при получении небольшого набора данных и частичным при исправлении набора данных или получении набора данных, который слишком велик для включения в один ответ. | |
point[]. computationTimeMillis | long | НЕ ИСПОЛЬЗУЙТЕ ЭТО ПОЛЕ. Он игнорируется и не сохраняется. | |
point[]. dataTypeName | string | Тип данных, определяющий формат значений в этой точке данных. | |
point[]. endTimeNanos | long | Время окончания интервала, представленного этой точкой данных, в наносекундах с начала эпохи. | |
point[]. modifiedTimeMillis | long | Указывает, когда в последний раз эта точка данных была изменена. Полезно только в тех контекстах, где мы перечисляем изменения данных, а не представляем текущее состояние данных. | |
point[]. originDataSourceId | string | Если точка данных содержится в наборе данных для производного источника данных, это поле будет заполнено идентификатором потока источника данных, который изначально создал точку данных. ВНИМАНИЕ: не используйте это поле ни для чего, кроме отладки. Значение этого поля, если оно вообще установлено, является деталью реализации и не гарантируется, что оно останется согласованным. | |
point[]. rawTimestampNanos | long | Необработанная временная метка исходного SensorEvent. | |
point[]. startTimeNanos | long | Время начала интервала, представленного этой точкой данных, в наносекундах с начала эпохи. | |
point[]. value[] | list | Значения каждого поля типа данных для точки данных. Ожидается, что каждое значение, соответствующее полю типа данных, будет встречаться в том же порядке, в котором поле указано в типе данных, указанном в источнике данных. Будет заполнено только одно из полей целого числа или поля с плавающей запятой, в зависимости от значения перечисления формата в поле типа источника данных. | |
point[].value[]. fpVal | double | Значение с плавающей запятой. Если этот параметр установлен, другие значения задавать нельзя. | |
point[].value[]. intVal | integer | Целочисленное значение. Если этот параметр установлен, другие значения задавать нельзя. | |
point[].value[]. mapVal[] | list | Значение карты. Допустимое ключевое пространство и единицы измерения для соответствующего значения каждой записи должны быть задокументированы как часть определения типа данных. Ключи по возможности должны быть маленькими. Потоки данных с большими ключами и высокой частотой данных могут подвергаться понижающей дискретизации. | |
point[].value[].mapVal[]. key | string | ||
point[].value[].mapVal[]. value | nested object | ||
point[].value[].mapVal[].value. fpVal | double | Значение с плавающей запятой. | |
point[].value[]. stringVal | string | Строковое значение. Если этот параметр установлен, другие значения задавать нельзя. По возможности строки следует делать небольшими. Потоки данных с большими строковыми значениями и высокой частотой данных могут подвергаться понижающей выборке. |
Методы
- удалить
- Выполняет инклюзивное удаление всех точек данных, время начала и окончания которых пересекается с временным диапазоном, указанным идентификатором набора данных. Для большинства типов данных будет удалена вся точка данных. Для типов данных, где временной интервал представляет собой согласованное значение (например,
com.google.activity.segment), а точка данных охватывает любую конечную точку набора данных, будет удалена только перекрывающаяся часть точки данных. - получать
- Возвращает набор данных, содержащий все точки данных, время начала и окончания которых перекрывается с указанным диапазоном минимального времени начала и максимального времени окончания набора данных. В частности, любая точка данных, время начала которой меньше или равно времени окончания набора данных, а время окончания больше или равно времени начала набора данных.
- пластырь
- Добавляет точки данных в набор данных. Набор данных не обязательно создавать заранее. Все точки в данном наборе данных будут возвращены с последующими вызовами для получения этого набора данных. Точки данных могут принадлежать более чем одному набору данных.
Этот метод не использует семантику исправлений: предоставленные точки данных просто вставляются без замены существующих данных.