L'API Google Health utilizza un framework solido e standardizzato per la gestione della sicurezza e dell'accesso ai dati degli utenti. Un componente centrale di questa modernizzazione è la transizione dall'autorizzazione Fitbit legacy (FOT) a Google OAuth 2.0. Questo passaggio consente agli sviluppatori di sfruttare le librerie di autenticazione standard di Google, semplificando l'implementazione e fornendo agli utenti un'interfaccia familiare e centralizzata per la gestione delle autorizzazioni.
Registrazione app
Tutte le app dell'API Google Health devono essere registrate utilizzando la console Google Cloud, che funge da hub centrale per la gestione di tutte le app Google.
Per istruzioni su come registrare l'app, segui i passaggi indicati in Guida introduttiva. Di seguito sono riportate le differenze che noterai durante la registrazione delle app.
| API web Fitbit | API Google Health | |
| Link pubblici | https://dev.fitbit.com/apps | https://console.cloud.google.com |
| Aggiunta di una nuova app | Premi Registra una nuova app |
|
| Informazioni di base | Campi da compilare:
|
Campi da compilare:
|
| Tipi di applicazioni | Uno sviluppatore deve selezionare:
|
|
| ID client | Registrato quando le impostazioni dell'applicazione vengono salvate | Registrato separatamente |
| Tipo di accesso | L'accesso in lettura e scrittura è controllato a livello di app | L'accesso in lettura e scrittura è controllato a livello di ambito |
| URL aggiuntivi |
|
|
Implementazione di OAuth
Le app dell'API Google Health supportano solo le librerie client Google OAuth2. Le librerie client sono disponibili per i framework più diffusi, il che semplifica l'implementazione di OAuth 2.0. Di seguito sono riportate le differenze tra le librerie Google OAuth2 e le librerie OAuth2 open source:
| API web Fitbit | API Google Health | |
| Supporto della libreria OAuth2 | Open source | Librerie client Google OAuth2 |
| Funzionalità | Incoerente tra le piattaforme | Coerente tra le piattaforme |
| URL di autorizzazione | https://www.fitbit.com/oauth2/authorize | https://accounts.google.com/o/oauth2/v2/auth |
| URL del token | https://api.fitbit.com/oauth2/token | https://oauth2.googleapis.com/token |
| Durata del token di accesso | 8 ore | 1 ora |
| Dimensioni del token di accesso | 1024 byte | 2048 byte |
| Token di aggiornamento | I token di aggiornamento vengono generati quando si utilizza il flusso di concessione del codice di autorizzazione. Per un utente può essere generato un solo token di aggiornamento. I token non scadono mai e possono essere utilizzati una sola volta. | Per generare un token di aggiornamento, la stringa di autorizzazione deve contenere il parametro di query "access_type=offline". Per un singolo utente possono essere creati più token di aggiornamento. I token di aggiornamento possono essere basati sul tempo. Scadranno se non sono stati utilizzati entro 6 mesi, se l'utente ha concesso l'accesso basato sul tempo o se l'app è in modalità "Test". Per maggiori dettagli, vedi Scadenza del token di aggiornamento. |
| Risposta del token | La risposta JSON contiene:
|
La risposta JSON contiene:
Per ottenere l'ID utente, utilizza l'endpoint users.getIdentity. |
Ri-autenticazione dell'utente (ri-consenso obbligatorio)
Gli utenti Fitbit devono dare nuovamente il consenso alla nuova integrazione, perché la tua app utilizza una libreria OAuth diversa. Non è possibile trasferire i token di accesso e i token di aggiornamento all'API Google Health e farli funzionare.