Dostęp do danych i autoryzacja

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

Rejestracja aplikacji

Wszystkie aplikacje korzystające z interfejsu Google Health API muszą być zarejestrowane w Google Cloud Console, która jest centralnym miejscem do zarządzania wszystkimi aplikacjami Google.

Instrukcje rejestracji aplikacji znajdziesz w przewodniku Pierwsze kroki. Oto różnice, które zauważysz podczas rejestracji 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ę	Utwórz projekt Google Cloud Włącz interfejs 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 polityki 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 Prywatnie	Aplikacja internetowa Android Rozszerzenie do Chrome iOS Telewizory Aplikacja komputerowa Platforma uniwersalna systemu Windows
Identyfikator klienta	Rejestrowany po zapisaniu ustawień aplikacji	Rejestrowany 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	URL przekierowania: witryna, na którą użytkownicy są przekierowywani po autoryzacji zakresów	Autoryzowane źródła JavaScriptu: źródło HTTP, które hostuje aplikację internetową URL przekierowania: witryna, na którą 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 w przypadku popularnych frameworków, co ułatwia implementację protokołu OAuth 2.0. Różnice między bibliotekami Google OAuth2 a bibliotekami OAuth2 typu open source są następujące:

	Fitbit Web API	Google Health API
Obsługa biblioteki OAuth2	Oprogramowanie typu open source	Biblioteki klienta Google OAuth2
Funkcjonalność	Niespójna na różnych platformach	Spójna na różnych platformach
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
Okres 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 Flow. 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ć ograniczone czasowo. Wygasną, jeśli nie będą używane przez 6 miesięcy, użytkownik przyzna dostęp ograniczony czasowo lub aplikacja będzie w trybie „Testowanie”. Więcej informacji znajdziesz w sekcji Wygaśnięcie tokena odświeżania.
Odpowiedź tokena	Odpowiedź JSON zawiera: token dostępu data ważności tokena dostępu zakresy typ tokena token odświeżania Identyfikator użytkownika	Odpowiedź JSON zawiera: token dostępu data ważności tokena dostępu zakresy typ tokena token odświeżania Aby uzyskać identyfikator użytkownika, użyj punktu końcowego users.getIdentity.

Ponowne uwierzytelnianie użytkownika (obowiązkowe ponowne wyrażenie zgody)

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