Users.dataSources.datasets

Набор данных представляет собой контейнер проекции для точек данных. Никакой собственной информации они не несут. Наборы данных представляют собой набор точек данных из определенного источника данных. Точку данных можно найти в нескольких наборах данных.

Список методов для этого ресурса см. в конце этой страницы.

Представления ресурсов

{
  "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 ), а точка данных охватывает любую конечную точку набора данных, будет удалена только перекрывающаяся часть точки данных.
получать
Возвращает набор данных, содержащий все точки данных, время начала и окончания которых перекрывается с указанным диапазоном минимального времени начала и максимального времени окончания набора данных. В частности, любая точка данных, время начала которой меньше или равно времени окончания набора данных, а время окончания больше или равно времени начала набора данных.
пластырь
Добавляет точки данных в набор данных. Набор данных не обязательно создавать заранее. Все точки в данном наборе данных будут возвращены с последующими вызовами для получения этого набора данных. Точки данных могут принадлежать более чем одному набору данных.

Этот метод не использует семантику исправлений: предоставленные точки данных просто вставляются без замены существующих данных.