API Google Fit, включая REST API Google Fit, станут недоступны после 30 июня 2025 г. С 1 мая 2024 г. разработчики не смогут зарегистрироваться для использования этих API .

Инструкции о том, на какой API или платформу следует выполнить миграцию, см. в руководстве по миграции Health Connect . Для сравнения Health Connect с API-интерфейсами Google Fit и веб-API Fitbit посетите руководство по сравнению Health Connect .

Узнайте больше о Health Connect и о том, как интегрироваться с API.

Эта страница переведена с помощью Cloud Translation API.

Users.dataSources

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

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

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

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

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

{
  "dataStreamId": string,
  "name": string,
  "dataStreamName": string,
  "type": string,
  "dataType": {
    "name": string,
    "field": [
      {
        "name": string,
        "format": string,
        "optional": boolean
      }
    ]
  },
  "device": {
    "uid": string,
    "type": string,
    "version": string,
    "model": string,
    "manufacturer": string
  },
  "application": {
    "packageName": string,
    "version": string,
    "detailsUrl": string,
    "name": string
  },
  "dataQualityStandard": [
    string
  ]
}

Имя свойства	Ценить	Описание
`application`	`nested object`	Информация о приложении, которое передает данные датчиков на платформу.
`application. detailsUrl`	`string`	Необязательный URI, который можно использовать для обратной ссылки на приложение.
`application. name`	`string`	Имя этого приложения. Это необходимо для клиентов REST, но мы не гарантируем уникальность этого имени. Он предоставляется для удобства других разработчиков, которые хотят определить, какой REST создал приложение или источник данных.
`application. packageName`	`string`	Имя пакета для этого приложения. Он используется как уникальный идентификатор при создании приложений Android, но не может быть указан клиентами REST. У клиентов REST номер проекта разработчика будет отражен в идентификаторах потока данных источника данных, а не в имени пакета.
`application. version`	`string`	Версия приложения. Вам следует обновлять это поле всякий раз, когда в приложении происходят изменения, влияющие на вычисление данных.
`dataQualityStandard[]`	`list`	НЕ ЗАПОЛНЯЙТЕ ЭТО ПОЛЕ. Он никогда не заполняется в ответах платформы и игнорируется в запросах. В будущей версии он будет полностью удален.
`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` Если какое-либо из необязательных полей, составляющих идентификатор потока данных, отсутствует, они будут исключены из идентификатора потока данных. Минимальный идентификатор потока данных: тип:тип данных.имя:номер проекта разработчика. Наконец, номер проекта разработчика и UID устройства запутываются при чтении любым клиентом REST или Android, который не создал источник данных. Только создатель источника данных увидит номер проекта разработчика в понятном и обычном виде. Это означает, что клиент увидит другой набор data_stream_ids, чем другой клиент с другими учетными данными.
`dataStreamName`	`string`	Имя потока однозначно идентифицирует этот конкретный источник данных среди других источников данных того же типа от того же базового производителя. Установка имени потока не является обязательной, но ее следует выполнять всякий раз, когда приложение предоставляет два потока для одного и того же типа данных или когда устройство имеет два эквивалентных датчика.
`dataType`	`nested object`	Тип данных определяет схему потока данных, которые собираются, вставляются или запрашиваются из Fitness API.
`dataType. field[]`	`list`	Поле представляет одно измерение типа данных.
`dataType.field[]. format`	`string`	Различные поддерживаемые форматы для каждого поля типа данных. Приемлемые значения: " `blob` " " `floatList` " " `floatPoint` " " `integer` " " `integerList` " " `map` " " `string` "
`dataType.field[]. name`	`string`	Определяет имя и формат данных. В отличие от имен типов данных, имена полей не имеют пространства имен и должны быть уникальными только в пределах типа данных.
`dataType.field[]. optional`	`boolean`
`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`	Строка версии аппаратного/программного обеспечения устройства.
`name`	`string`	Видимое имя конечного пользователя для этого источника данных.
`type`	`string`	Константа, описывающая тип этого источника данных. Указывает, производит ли этот источник данных необработанные или производные данные. Приемлемые значения: " `derived` " " `raw` "

Методы

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

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

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

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

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

Помимо полей источника данных, включенных в идентификатор источника данных, включается номер проекта разработчика, аутентификация которого выполняется при создании источника данных. Этот номер проекта разработчика запутывается при чтении любым другим разработчиком, читающим общедоступные типы данных.
удалить: Удаляет указанный источник данных. Запрос завершится неудачей, если источник данных содержит какие-либо точки данных.
получать: Возвращает указанный источник данных.
список: Перечисляет все источники данных, видимые разработчику, с использованием предоставленных областей OAuth. Список не является исчерпывающим; у пользователя могут быть частные источники данных, которые видны только другим разработчикам, или вызовы с использованием других областей.
обновлять: Обновляет указанный источник данных. Свойства dataStreamId , dataType , type , dataStreamName и device , за исключением version , не могут быть изменены.

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