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 ), а точка данных охватывает любую конечную точку набора данных, будет удалена только перекрывающаяся часть точки данных.

получить

Возвращает набор данных, содержащий все точки данных, время начала и окончания которых перекрываются с указанным диапазоном минимального времени начала и максимального времени окончания набора данных. В частности, любая точка данных, время начала которой меньше или равно времени окончания набора данных и время окончания которого больше или равно времени начала набора данных.

пластырь

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

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