Доступ к данным и авторизация

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
Добавление нового приложения Нажмите Зарегистрировать новое приложение.
  1. Как создать проект Google Cloud
  2. Включите Google Health API.
Основная информация Поля, которые нужно заполнить:
  • Название приложения
  • Описание
  • URL сайта приложения
  • Организация
  • URL сайта организации
  • URL условий использования
  • URL "Политика конфиденциальности"
Поля, которые нужно заполнить:
  • Название приложения
  • Электронная почта службы поддержки
  • Аудитория (внутренняя или внешняя)
  • Контактный адрес электронной почты
  • Значок логотипа
  • URL сайта приложения
  • URL политики конфиденциальности
  • URL условий использования
  • Авторизованный домен
Типы приложений Разработчик должен выбрать:
  • Сервер
  • Клиент
  • Personal
  • Веб-приложение
  • Android
  • Расширение Chrome
  • iOS
  • телевизоры;
  • Компьютерное приложение
  • Универсальная платформа Windows
Идентификатор клиента Регистрируется при сохранении настроек приложения. Зарегистрировано отдельно
Тип доступа Доступ на чтение и запись контролируется на уровне приложения. Доступ на чтение и запись контролируется на уровне области действия.
Дополнительные URL
  • URL переадресации. Сайт, на который перенаправляются пользователи после авторизации областей действия.
  • Разрешенные источники JavaScript. Источник HTTP, на котором размещено веб-приложение.
  • 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…