Fitbit Web API был улучшен и модернизирован, чтобы обеспечить более стандартизированную, согласованную и масштабируемую основу для интеграции разработчиков. Теперь он называется Google Health API. Google Health API – это стратегическая эволюция устаревшего Fitbit Web API, перестроенного с нуля на современной инфраструктуре Google.
С этой платформой разработчики получают доступ ко всем возможностям инструментов разработчика Google Cloud и удобному, привычному и оптимизированному способу управления разрешениями пользователей через Google OAuth 2.0.
Что вы получаете с Google Health API?
- Единый источник достоверных данных. Наш новый поток согласованных данных решает сложную задачу по сопоставлению перекрывающихся элементов из нескольких источников. Это гарантирует, что приложения будут показывать те же данные, что и приложение Fitbit. Этот поток будет предоставляться в дополнение к нашему собственному потоку, который включает данные с устройств Fitbit и Pixel, а также записи, добавленные вручную.
- Техническая модернизация и производительность. Мы объединили более 100 устаревших конечных точек в упрощенные наборы типов данных и устранили несоответствия в форматах данных, часовых поясах, единицах измерения и обработке ошибок. Кроме того, теперь мы поддерживаем протокол HTTP/REST для высокопроизводительного извлечения данных. Кроме того, данные за день и вебхуки теперь доступны для всех типов данных через специальную конечную точку списка.
- Улучшенные вебхуки и масштабируемость. Расширенная поддержка вебхуков, включая автоматические подписки и подробное управление всеми типами данных, позволяет масштабировать приложения для здоровья на основе ИИ.
- Упрощенная идентификация и безопасность. Замените устаревшую авторизацию Fitbit (FOT) на Google OAuth 2.0. Это позволяет разработчикам использовать стандартные библиотеки аутентификации Google, упрощая базы кода и предоставляя пользователям привычный централизованный способ управления разрешениями. Все области действия Google Health API относятся к категории ограниченных, поэтому для получения доступа к ним требуется проверка конфиденциальности и безопасности.
Вам нравятся предложенные объекты? Начать
Версии API и общедоступный бета-канал
В Google Health API используется версионирование на основе каналов в соответствии с предложениями по улучшению API (AIP), в частности AIP-185: версионирование API и AIP-181: уровни стабильности. API доступен в двух общедоступных каналах: стабильном v4 и общедоступном бета-канале v4beta. Google поддерживает оба канала через стандартные каналы поддержки.
Сравнение стабильного и бета-канала
В соответствии с AIP-185 канал v4beta действует как надмножество стабильного канала v4. Она включает все стабильные функции v4, а также типы данных, поля и методы, которые находятся на этапе раннего доступа и тестируются партнерами.
В документации элементы API, доступные только в бета-канале, помечены как v4beta.
| Функция | Стабильный канал (v4) |
Общедоступная бета-версия (v4beta) |
|---|---|---|
| Базовый URI REST | https://health.googleapis.com/v4 |
https://health.googleapis.com/v4beta |
| Пакет gRPC | google.devicesandservices.health.v4 |
google.devicesandservices.health.v4beta |
| Справочная документация | v4 REST и v4 RPC | v4beta REST и v4beta RPC |
| Уровень стабильности | Готова к использованию в рабочей среде и регулируется правилами обратной совместимости AIP-180. | Нестабильная предварительная версия, которая может быть изменена или удалена в любое время без уведомления. |
| Планируемое использование | Работающие пользовательские приложения. | Раннее тестирование, создание прототипов, проверка схем и отзывы разработчиков. |
| Поддержка | Поддержка предоставляется по стандартным каналам поддержки. | Поддержка осуществляется по стандартным каналам поддержки. Вы можете сообщать об ошибках, получать помощь в устранении неполадок и оставлять отзывы о дизайне. |
Как работать с каналом v4beta
При изучении возможностей, помеченных тегом v4beta, следуйте этим рекомендациям:
- Используйте
v4betaв основном в средах разработки, промежуточных и непроизводственных средах тестирования. Не рекомендуется использовать в рабочей среде функции, которые зависят от конечных точекv4betaили типов данных, доступных только в бета-версии. - Схемы, названия полей, поведение конечных точек и представления данных в
v4betaмогут меняться без предупреждения. Бета-функции и типы данных также могут быть полностью удалены, если они не соответствуют целям проверки. - Изолируйте экспериментальный код клиента
v4betaс помощью флагов функций или отдельных модулей, чтобы критические изменения в бета-канале не нарушали основную интеграциюv4. - Чтобы получить поддержку, сообщить о проблемах и поделиться отзывом о реализации
v4beta, обратитесь в стандартные каналы поддержки. Это поможет нам улучшить окончательный дизайн API.
Переход с бета-версии 4 на стабильную версию 4
Новые типы данных и функции сначала добавляются в v4beta, чтобы партнеры могли протестировать их и проверить на рынке, а затем переносятся в стабильный канал v4.
Прежде чем перевести бета-функцию в статус v4, Google оценивает ее по следующим критериям:
- Тестирование партнерами подтверждает, что модель данных, семантика полей и шаблоны запросов соответствуют требованиям реальных приложений.
- Отзывы разработчиков и проверки дизайна завершены, и схема готова к блокировке в соответствии с гарантиями обратной совместимости AIP-180.
- Сквозные конвейеры данных, синхронизация устройств и надежность сервиса соответствуют стандартам качества.
- В соответствии с правилами прекращения поддержки AIP-185 все поля и функции, поддержка которых была прекращена во время бета-тестирования, удаляются, а не переносятся в
v4.
Хотя в AIP-181 указано, что бета-тестирование обычно длится около 90 дней, фактический срок перехода функции из v4beta в v4 зависит от ее сложности, доступности оборудования и отзывов пользователей. Некоторые функции могут стать общедоступными раньше, а другие – остаться в v4beta дольше или быть удалены.
Когда тип данных или функция переходит в стабильный канал v4, Google сообщает об этом в примечаниях к выпуску. После этого замените в запросах https://health.googleapis.com/v4beta на https://health.googleapis.com/v4, прежде чем выпускать интеграцию для пользователей.
Что произойдет с Fitbit Web API?
Устаревший Fitbit Web API был отключен в соответствии со следующим графиком:
- 30 сентября 2026 г. (прекращение поддержки). Поддержка Fitbit Web API прекращена. Google больше не исправляет ошибки и не предоставляет поддержку API.
- 2 ноября 2026 года (отключение API). Fitbit Web API и конечные точки Fitbit OAuth были отключены и больше не работают и не синхронизируют данные пользователей Google Health. Запросы к этим конечным точкам не выполняются и возвращают код статуса HTTP
410 Gone.
Разработчикам, использующим устаревший Fitbit Web API и авторизацию Fitbit, следует перенести свои приложения и пользователей на Google Health API и Google OAuth 2.0.
Чтобы начать, ознакомьтесь с руководством по переходу.
Какие устройства совместимы с сервисом?
Все устройства Fitbit и часы Google Pixel, как текущие, так и предыдущие, будут собирать данные, возвращаемые через Google Health API. Тип доступных данных зависит от функций, которые поддерживают устройства.
Список поддерживаемых устройств можно найти в Google Store.
Как сообщить о нарушении правил Программы?
Ваше мнение очень важно для нас. Вы можете поделиться своим мнением по каналам поддержки, указанным на странице Поддержка.
Мы приложили много усилий, чтобы эти API были удобными, но Google Health API активно развивается. Обратите внимание, что на основе ваших отзывов мы можем внести изменения в период с настоящего момента до конца мая, что потребует соответствующих обновлений с вашей стороны.
План действий
Ниже перечислены функции, которые появятся в 2026 году.
IV квартал 2026 г.
Типы данных (чтение и запись)
- Подробные данные о температуре кожи
- Скорость метаболизма (BMR)
- Мы добавим типы данных, чтобы достичь паритета с платформой "Здоровье и спорт". В IV квартале 2026 года и I квартале 2027 года мы планируем добавить ещё много типов данных платформы "Здоровье и спорт".
Функции
- Общедоступная бета-версия для раннего доступа к новым типам данных
- Конечная точка статистики для отслеживания телеметрии вебхуков