Dostęp do danych i autoryzacja

Interfejs Google Health API korzysta z solidnego i ustandaryzowanego systemu zarządzania dostępem do danych użytkownika i ich bezpieczeństwem. Głównym elementem tej modernizacji jest przejście ze starszej autoryzacji Fitbita (FOT) na Google OAuth 2.0. Ta zmiana umożliwia deweloperom korzystanie ze standardowych bibliotek uwierzytelniania Google, co upraszcza implementację, a użytkownikom zapewnia znajomy i scentralizowany interfejs do zarządzania uprawnieniami.

Rejestracja aplikacji

Wszystkie aplikacje korzystające z interfejsu Google Health API muszą być zarejestrowane w konsoli Google Cloud, która służy jako centralne miejsce do zarządzania wszystkimi aplikacjami Google.

Instrukcje rejestrowania aplikacji znajdziesz w artykule Pierwsze kroki. Oto różnice, które zauważysz podczas rejestrowania aplikacji.

Fitbit Web API Google Health API
Linki publiczne https://dev.fitbit.com/apps https://console.cloud.google.com
Dodawanie nowej aplikacji Kliknij Zarejestruj nową aplikację.
  1. Utwórz projekt Google Cloud
  2. Włącz Google Health API.
Podstawowe informacje Pola do wypełnienia:
  • Nazwa aplikacji
  • Opis
  • Adres URL witryny aplikacji
  • Organizacja
  • Adres URL witryny organizacji
  • Adres URL warunków korzystania z usługi
  • Adres URL sekcji Polityka prywatności
Pola do wypełnienia:
  • Nazwa aplikacji
  • Adres e-mail pomocy
  • odbiorcy (wewnętrzni lub zewnętrzni),
  • Kontaktowy adres e-mail
  • Ikona logo
  • Adres URL witryny aplikacji
  • URL Polityki prywatności
  • Adres URL warunków korzystania z usługi
  • Autoryzowana domena
Typy aplikacji Deweloper musi wybrać:
  • Serwer
  • Klient
  • Osobista
  • Aplikacja internetowa
  • Android
  • Rozszerzenie do Chrome
  • iOS
  • Telewizory
  • Aplikacja komputerowa
  • Universal Windows Platform
Identyfikator klienta Rejestrowane po zapisaniu ustawień aplikacji Zarejestrowane osobno
Typ dostępu Uprawnienia do odczytu i zapisu są kontrolowane na poziomie aplikacji Uprawnienia do odczytu i zapisu są kontrolowane na poziomie zakresu.
Dodatkowe adresy URL
  • Adres URL przekierowania: witryna, do której użytkownicy są przekierowywani po autoryzacji zakresów.
  • Autoryzowane źródła JavaScriptu: źródło HTTP, które hostuje aplikację internetową.
  • Adres URL przekierowania: witryna, do której użytkownicy są przekierowywani po autoryzacji zakresów.

Implementacja protokołu OAuth

Aplikacje korzystające z interfejsu Google Health API obsługują tylko biblioteki klienta Google OAuth2. Biblioteki klienta są dostępne dla popularnych platform, co upraszcza implementację protokołu OAuth 2.0.

Różnice między bibliotekami Google OAuth2 a bibliotekami OAuth2 open source są następujące:

Fitbit Web API Google Health API
Obsługa biblioteki OAuth2 Oprogramowanie typu open source Biblioteki klienta Google OAuth2
Funkcje Niespójne na różnych platformach Spójność na różnych platformach
Adres URL autoryzacji https://www.fitbit.com/oauth2/authorize https://accounts.google.com/o/oauth2/v2/auth
URL tokena https://api.fitbit.com/oauth2/token https://oauth2.googleapis.com/token
Czas ważności tokena dostępu 8 godzin 1 godzina
Rozmiar tokena dostępu 1024 bajty 2048 bajtów
Token odświeżania Tokeny odświeżania są generowane podczas korzystania z przepływu przyznawania kodu autoryzacji. Dla użytkownika można wygenerować tylko 1 token odświeżania. Tokeny nigdy nie wygasają i można ich użyć tylko raz. Aby wygenerować token odświeżania, ciąg autoryzacji musi zawierać parametr zapytania „access_type=offline”. Dla jednego użytkownika można utworzyć wiele tokenów odświeżania. Tokeny odświeżania mogą być oparte na czasie. Jeśli nie będą używane przez 6 miesięcy, użytkownik przyznał dostęp na określony czas lub aplikacja jest w trybie „Testowanie”, wygasną. Więcej informacji znajdziesz w sekcji Wygaśnięcie tokena odświeżania.
Odpowiedź tokena Odpowiedź JSON zawiera:
  • token dostępu
  • wygaśnięcie tokena dostępu
  • zakresy
  • typ tokena
  • token odświeżania
  • identyfikator użytkownika
Odpowiedź JSON zawiera:
  • token dostępu
  • wygaśnięcie tokena dostępu
  • zakresy
  • typ tokena
  • token odświeżania

Aby uzyskać identyfikator użytkownika, wywołaj punkt końcowy users.getIdentity po przyznaniu co najmniej 1 zakresu Google Health i utrzymuj starsze tokeny Fitbita jako aktywne do momentu zweryfikowania legacyUserId.

Użytkownicy Fitbita muszą ponownie wyrazić zgodę na nową integrację, ponieważ Twoja aplikacja korzysta z innej biblioteki OAuth. Nie można przenieść tokenów dostępu i tokenów odświeżania do interfejsu API Google Health i ich używać.

Każdy użytkownik, który ponownie wyrazi zgodę, jest wliczany do limitu przyznawania tokenów OAuth w projekcie Google Cloud. Google Cloud wymusza ograniczanie liczby żądań przyznawania tokenów OAuth, aby kontrolować, jak szybko aplikacja może rejestrować lub ponownie uwierzytelniać użytkowników. Jeśli spodziewasz się,że w ciągu 24 godzin przekroczysz 10 000 rejestracji lub ponownych uwierzytelnień użytkowników, poproś o zwiększenie limitu z wyprzedzeniem. Więcej informacji znajdziesz w artykule na temat ograniczeń liczby żądań aplikacji OAuth.