Users.dataSources: update

Обновляет указанный источник данных. dataStreamId , dataType , type , dataStreamName и свойства device за исключением version не могут быть изменены.

Источники данных идентифицируются по их dataStreamId . Попробуйте прямо сейчас .

Запрос

HTTP-запрос

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

Параметры

Имя параметра Ценность Описание
Параметры пути
dataSourceId string Идентификатор потока данных источника данных для обновления.
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 создал приложение или источник данных.
dataStreamId string Уникальный идентификатор потока данных, создаваемого этим источником данных. Идентификатор включает в себя:

  • Производитель физического устройства, модель и серийный номер (UID).
  • Имя или имя пакета приложения. Имя пакета используется, когда источник данных был создан приложением Android. Номер проекта разработчика используется, когда источник данных был создан клиентом REST.
  • Тип источника данных.
  • Имя потока источника данных.
Обратите внимание, что не все атрибуты источника данных используются как часть идентификатора потока. В частности, не используется версия оборудования/приложения. Это позволяет нам сохранять один и тот же поток при обновлении версии. Это также означает, что два объекта DataSource могут представлять один и тот же поток данных, даже если они не равны.

Точный формат идентификатора потока данных, созданного приложением Android, следующий: type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName

Точный формат идентификатора потока данных, созданного клиентом REST, следующий: type:dataType.name :developer project number :device.manufacturer :device.model:device.uid :dataStreamName type:dataType.name :developer project number :device.manufacturer :device.model:device.uid :dataStreamName type:dataType.name :developer project number :device.manufacturer :device.model:device.uid :dataStreamName type:dataType.name :developer project number :device.manufacturer :device.model:device.uid :dataStreamName type:dataType.name :developer project number :device.manufacturer :device.model:device.uid :dataStreamName

Если какое-либо из необязательных полей, составляющих идентификатор потока данных, отсутствует, они будут исключены из идентификатора потока данных. Минимальный допустимый идентификатор потока данных будет следующим: type:dataType.name:номер проекта разработчика.

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

dataType nested object Тип данных определяет схему потока данных, собираемых, вставляемых или запрашиваемых из 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, obfuscated(id1) == obfuscated(id2).

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

Допустимые значения:
  • " derived "
  • " raw "

Ответ

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

Попытайся!

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