Users.dataSources: create

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

Источник данных — это уникальный источник данных датчиков. Источники данных могут предоставлять необработанные данные, поступающие от аппаратных датчиков на локальных или сопутствующих устройствах. Они также могут предоставлять производные данные, созданные путем преобразования или объединения других источников данных. Для одного и того же типа данных может существовать несколько источников данных. Каждая точка данных в каждом наборе данных, вставленная в Fitness API или прочитанная из него, имеет связанный источник данных.

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

Источники данных идентифицируются с помощью строки, сгенерированной сервером на основе содержимого создаваемого источника. Поле dataStreamId не должно быть установлено при вызове этого метода. Он будет автоматически сгенерирован сервером в правильном формате. Если установлен dataStreamId , он должен соответствовать формату, который сгенерирует сервер. Этот формат представляет собой комбинацию некоторых полей из источника данных и имеет определенный порядок. Если оно не соответствует, запрос завершится с ошибкой.

Если указать тип данных, который не является известным типом (начинающийся с «com.google.»), будет создан источник данных с пользовательским типом данных . Пользовательские типы данных доступны для чтения только приложению, которое их создало. Пользовательские типы данных устарели ; вместо этого используйте стандартные типы данных.

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

Запрос

HTTP-запрос

POST https://www.googleapis.com/fitness/v1/users/userId/dataSources

Параметры

Имя параметра Ценить Описание
Параметры пути
userId string Создайте источник данных для идентифицированного лица. Используйте me , чтобы указать аутентифицированного пользователя. В данный момент поддерживают только me .

Авторизация

Для этого запроса требуется авторизация хотя бы в одной из следующих областей:

Объем
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.write

Дополнительную информацию см. на странице аутентификации и авторизации .

Тело запроса

В теле запроса укажите ресурс Users.dataSources со следующими свойствами:

Имя свойства Ценить Описание Примечания
Обязательные свойства
application nested object Информация о приложении, которое передает данные датчиков на платформу.
application. name string Имя этого приложения. Это необходимо для клиентов REST, но мы не гарантируем уникальность этого имени. Он предоставляется для удобства других разработчиков, которые хотят определить, какой REST создал приложение или источник данных.
dataType nested object Тип данных определяет схему потока данных, которые собираются, вставляются или запрашиваются из Fitness API.
dataType. field[] list Поле представляет одно измерение типа данных.
dataType.field[]. format string Различные поддерживаемые форматы для каждого поля типа данных.

Приемлемые значения:
  • " blob "
  • " floatList "
  • " floatPoint "
  • " integer "
  • " integerList "
  • " map "
  • " string "
dataType.field[]. name string Определяет имя и формат данных. В отличие от имен типов данных, имена полей не имеют пространства имен и должны быть уникальными только в пределах типа данных.
dataType. name string Каждый тип данных имеет уникальное имя в пространстве имен. Все типы данных в пространстве имен com.google являются общими как часть платформы.
device nested object Представление интегрированного устройства (например, телефона или носимого устройства), которое может содержать датчики.
device. manufacturer string Производитель продукта/оборудования.
device. model string Видимое конечному пользователю название модели устройства.
device. type string Константа, представляющая тип устройства.

Приемлемые значения:
  • " chestStrap "
  • " headMounted "
  • " phone "
  • " scale "
  • « smartDisplay »
  • " tablet "
  • " unknown "
  • " watch "
device. uid string Серийный номер или другой уникальный идентификатор оборудования. Это поле запутывается при чтении любым клиентом REST или Android, который не создавал источник данных. Только создатель источника данных увидит поле uid в понятной и нормальной форме.

Обфускация сохраняет равенство; то есть для двух идентификаторов, если id1 == id2, запутано(id1) == запутано(id2).

device. version string Строка версии аппаратного/программного обеспечения устройства.
type string Константа, описывающая тип этого источника данных. Указывает, производит ли этот источник данных необработанные или производные данные.

Приемлемые значения:
  • " derived "
  • " raw "

Ответ

В случае успеха этот метод возвращает ресурс Users.dataSources в теле ответа.

Попробуйте!

Используйте API-интерфейс ниже, чтобы вызвать этот метод для реальных данных и просмотреть ответ.