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

получать

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

пластырь

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

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