Google Health API использует надежную и стандартизированную платформу для управления доступом к пользовательским данным и их безопасностью. Центральным компонентом этой модернизации является переход от устаревшей авторизации Fitbit (FOT) к Google OAuth 2.0. Это изменение позволяет разработчикам использовать стандартные библиотеки аутентификации Google, что упрощает реализацию и предоставляет пользователям привычный и централизованный интерфейс для управления разрешениями.
Регистрация приложения
Все приложения, использующие Google Health API, должны быть зарегистрированы в консоли Google Cloud, которая служит центральным узлом для управления всеми вашими приложениями Google.
Инструкции по регистрации приложения приведены в руководстве по началу работы. Вот различия, которые вы заметите при регистрации приложений.
| Fitbit Web API | Google Health API | |
| Общедоступные ссылки | https://dev.fitbit.com/apps | https://console.cloud.google.com |
| Добавление нового приложения | Нажмите Зарегистрировать новое приложение. |
|
| Основная информация | Поля, которые нужно заполнить:
|
Поля, которые нужно заполнить:
|
| Типы приложений | Разработчик должен выбрать:
|
|
| Идентификатор клиента | Регистрируется при сохранении настроек приложения. | Зарегистрировано отдельно |
| Тип доступа | Доступ на чтение и запись контролируется на уровне приложения. | Доступ на чтение и запись контролируется на уровне области действия. |
| Дополнительные URL |
|
|
Реализация OAuth
Приложения Google Health API поддерживают только клиентские библиотеки Google OAuth2. Для популярных фреймворков доступны клиентские библиотеки, которые упрощают реализацию OAuth 2.0.
Различия между библиотеками Google OAuth2 и библиотеками OAuth2 с открытым исходным кодом:
| Fitbit Web API | Google Health API | |
| Поддержка библиотеки OAuth2 | ПО с открытым исходным кодом | Клиентские библиотеки Google OAuth2 |
| Функциональность | Несоответствие на разных платформах | Единый для всех платформ |
| URL авторизации | https://www.fitbit.com/oauth2/authorize | https://accounts.google.com/o/oauth2/v2/auth |
| URL токена | https://api.fitbit.com/oauth2/token | https://oauth2.googleapis.com/token |
| Срок действия токена доступа | 8 часов | 1 час |
| Размер токена доступа | 1024 байта | 2048 байт |
| Токен обновления | Токены обновления генерируются при использовании процесса предоставления кода авторизации. Для пользователя можно создать только один токен обновления. Срок действия токенов не ограничен, но использовать их можно только один раз. | Чтобы создать токен обновления, строка авторизации должна содержать параметр запроса access_type=offline. Для одного пользователя можно создать несколько токенов обновления. Токены обновления могут иметь ограниченный срок действия. Они будут отозваны, если не использовались в течение шести месяцев, если пользователь предоставил временный доступ или если приложение находится в режиме тестирования. Подробнее об истечении срока действия токена обновления. |
| Ответ токена | Ответ JSON содержит:
|
Ответ JSON содержит:
Чтобы получить идентификатор пользователя, вызовите конечную точку users.getIdentity после того, как будет предоставлена хотя бы одна область Google Health, и не отключайте устаревшие токены Fitbit, пока не будет подтвержден legacyUserId.
|
Повторная аутентификация пользователей (обязательный повторный запрос согласия)
Пользователям Fitbit нужно будет повторно дать согласие на новую интеграцию, поскольку ваше приложение использует другую библиотеку OAuth. Токены доступа и токены обновления нельзя перенести в Google Health API, и они не будут работать.
Каждый пользователь, который повторно дает согласие, учитывается в ограничении частоты запросов на предоставление токенов OAuth для облачного проекта Google Cloud. Google Cloud применяет ограничение частоты запросов на предоставление токенов OAuth, чтобы контролировать, как быстро ваше приложение может интегрировать или повторно выполнять аутентификацию пользователей. Если вы ожидаете,что в течение 24 часов у вас будет более 10 000 регистраций или повторных аутентификаций, заранее запросите увеличение квоты. Подробнее об ограничениях частоты запросов для приложений OAuth…