Le API Google Fit saranno supportate fino alla fine del 2026. Google offre diversi prodotti e servizi per la salute e il benessere per aiutare gli utenti a continuare a raggiungere i loro obiettivi dopo il ritiro.
Attenzione:l'API Google Fit (inclusa l'API REST) sarà supportata solo fino alla fine del 2026. Ti consigliamo di eseguire la migrazione all'API Google Health per le integrazioni basate sul cloud o a Health Connect per il monitoraggio dei passi e le app mobile-first.
Le seguenti linee guida mostrano il servizio a cui eseguire la migrazione in base a come utilizzi le API Google Fit.
Percorsi di migrazione consigliati
La scelta dell'API deve essere basata sul tipo di applicazione e sulle esigenze di dati specifiche.
Per tipo di applicazione
| Tipo di applicazione | Percorso consigliato | Motivo principale |
|---|---|---|
| App di monitoraggio dei passi | Health Connect | Lettura mobile-first dei dati dei passi aggregati da varie fonti. |
| App complementare per fitness tracker | API Google Health | Piattaforma incentrata sul web che richiede OAuth per l'integrazione degli utenti. |
| Piattaforma Salute e fitness | A API Google Health & Health Connect | Utilizza l'API Google Health per i dati dei dispositivi Fitbit/Google e Health Connect per i dati aggregati sul dispositivo. |
Per integrazione attuale
| Integrazione attuale | Percorso consigliato | Disponibilità |
|---|---|---|
| API Fit History e API Fit Session | API Google Health | Disponibile |
| Lettura dei passi da dispositivo mobile (con l'API Fit Recording) | Health Connect | Disponibile |
| API Fit su Wear OS | Servizi per la salute | Disponibile |
| API Fitbit Web | API Google Health | Disponibile |
| Health Connect | Mantieni l'integrazione esistente o aggiungi l'API Google Health | Disponibile |
Confronti tecnici
Le sezioni seguenti forniscono un confronto tecnico tra le API Google Fit, l'API Google Health e Health Connect per aiutarti a scegliere il percorso di migrazione giusto.
API Fit e API Google Health
Utilizza questo percorso se la tua app è una piattaforma basata sul web o richiede interazioni server-server (S2S).
| Funzionalità | API Fit (Android/REST) | API Google Health |
|---|---|---|
| Configurazione del progetto | Google Cloud Console | Crea un progetto Google Cloud |
| Configurazione OAuth | Tipo di applicazione web o Android | Tipo di applicazione web |
| Architettura dei dati | Tipi con prefisso com.google |
Tipi di dati unificati dell'API Google Health |
| Registrazione app | Crea un progetto Google Cloud | Crea un progetto Google Cloud e abilita l'API Google Health |
API Fit e Health Connect
Utilizza questo percorso per le applicazioni Android mobile-first che leggono le metriche dei dispositivi locali.
| Funzionalità | API Fit per Android | Health Connect |
|---|---|---|
| Registrazione | Google Cloud Console | Progetto Play Store e dichiarazione relativa alle app per la salute |
| Autenticazione | OAuth 2.0 richiesto | Nessun OAuth richiesto (autorizzazioni sul dispositivo) |
| Archiviazione dei dati | Incentrato sulla cloud | Incentrato sul dispositivo (sul dispositivo) |
| Pubblico | Sviluppatori Android precedenti | Sviluppatori di app per dispositivi mobili Modern Android |
| Autorizzazioni | Ambiti OAuth | Autorizzazioni del file manifest Android |
Integrazioni dell'API Fit
Le sezioni seguenti forniscono indicazioni sulla migrazione da ciascuna delle API Google Fit. Se l'integrazione include anche elementi dell'interfaccia utente che si connettono all' app Google Fit, consulta le linee guida per le integrazioni dell'app Fit per ulteriori indicazioni.
App che utilizzano l'API Fit Recording per registrare i passi
L'API Fit Recording consente alla tua app di richiedere l'archiviazione automatica
dei dati dei sensori in modo efficiente dal punto di vista della batteria creando abbonamenti.
Ogni abbonamento connette un'app per Android a un tipo di dati sul fitness o a un'origine dati specifica e il tipo di dati Step è di uso comune per registrare i passi.
Segui questi passaggi per eseguire la migrazione dall'API Fit Recording:
| Smartphone | Wear |
|
Utilizza i servizi per la salute:
Per saperne di più sulle differenze tra i due, consulta la documentazione dei servizi per la salute. |
App che utilizzano l'API History per leggere o scrivere dati nel fitness store
L'API History consente alla tua app di eseguire operazioni collettive sul fitness store. Queste operazioni includono la lettura, l'inserimento, l'aggiornamento e l'eliminazione dei dati storici relativi a salute e benessere.
Segui questi passaggi per eseguire la migrazione dall'API History:
| Smartphone | Wear |
|
Non applicabile. Utilizza Health Connect dall'app per dispositivi mobili e non dal dispositivo indossabile. |
App che utilizzano l'API Sensor per visualizzare i dati sul fitness in tempo reale
L'API Sensor consente di leggere i dati dei sensori non elaborati in tempo reale nella tua app. L'API Sensor esegue le seguenti operazioni:
- Elenca le origini dati disponibili sul dispositivo e sui dispositivi complementari.
- Registra i listener per ricevere i dati dei sensori non elaborati.
- Annulla la registrazione dei listener in modo che non ricevano più i dati dei sensori non elaborati.
Segui questi passaggi per eseguire la migrazione dall'API Sensor:
| Smartphone | Wear |
|
Utilizza l'API Sensors, Fused Location Provider |
Utilizza i servizi per la salute su Wear OS:
|
App che utilizzano l'API Session per fornire riepiloghi delle attività
Le sessioni rappresentano un intervallo di tempo durante il quale gli utenti svolgono un'attività di fitness.
L'API Session consente alla tua app di creare sessioni nel fitness store.
Segui questi passaggi per eseguire la migrazione dall'API Session:
| Smartphone | Wear |
|
Avvio/arresto: non applicabile. L'applicazione deve monitorare internamente lo stato delle sessioni in corso. Lettura/scrittura: esegui la transizione all'API Google Health. |
Avvio/arresto: utilizza i servizi per la salute (ExerciseClient) Lettura/scrittura: utilizza Health Connect con la tua app per dispositivi mobili. Per flussi di lavoro specifici, ti consigliamo di seguire questa procedura:
|
App che utilizzano l'API Goals
Gli obiettivi sono target nell'app Google Fit che gli utenti possono impostare per le loro metriche, come passi e punti cardio. La piattaforma Fit registra i loro obiettivi e monitora la loro attività quotidiana rispetto a questi utilizzando l'API Goals.
| Smartphone | Wear |
| Nessuna API sostitutiva disponibile. | Nessuna API sostitutiva disponibile. |
App che utilizzano l'API BLE
La tua app può trovare i dispositivi Bluetooth Low Energy (BLE) disponibili e inserire i dati dei sensori nella piattaforma Google Fit utilizzando l'API BLE.
Segui questi passaggi per eseguire la migrazione dall'API BLE:
| Smartphone | Wear |
| Utilizza direttamente le API Bluetooth Android. | Utilizza direttamente le API Bluetooth Android. |
Funzionalità ritirate
Le seguenti funzionalità non hanno una sostituzione diretta dell'API. Utilizza le API standard Android consigliate:
- API Sensor: utilizza il framework Sensors Android o l'API Fused Location Provider per i dati non elaborati in tempo reale.
- API Goals: nessuna API sostitutiva disponibile. Gestisci il monitoraggio degli obiettivi e i target di attività giornaliera nella logica dell'applicazione.
- API Bluetooth Low Energy (BLE): utilizza direttamente le API Bluetooth Android per comunicare con l'hardware.
Integrazioni dell'app Fit
Se la tua app si connette a Google Fit per la condivisione dei dati, segui le indicazioni per la migrazione degli utenti esistenti e nuovi a Health Connect o all'API Google Health in queste sezioni:
Utenti esistenti della tua app
Se l'interfaccia utente della tua app include un modo per gli utenti di connettersi a Google Fit (o se la tua app è inclusa nell'elenco delle app che funzionano con Google Fit), puoi continuare a gestire l'integrazione dell'app Fit per gli utenti attuali.
Manterremo aggiornata questa sezione con informazioni su quando ritirare l'integrazione dell'app Fit e quali sono le opzioni migliori per mantenere l'esperienza utente. Nel frattempo, puoi contattarci.
| checkEsegui questa operazione | closeNon eseguire questa operazione |
| Offri Health Connect o l'API Google Health come nuova opzione nella tua app.
Concentrati sui vantaggi per gli utenti, come dati e insight più completi, privacy e sicurezza.
|
Chiedi agli utenti di disconnettersi da Google Fit.
|
Nuovi utenti della tua app
Per offrire un'esperienza simile ai nuovi utenti della tua app, ti consigliamo di creare un'integrazione con Health Connect o l' API Google Health.
Health Connect offre l'accesso a nuove origini e tipi di dati per offrire un'esperienza più completa agli utenti, con i dati archiviati in modo sicuro sul dispositivo. L'API Google Health fornisce una piattaforma incentrata sul web per i dati dei dispositivi Fitbit e Google.
| checkEsegui questa operazione | closeNon eseguire questa operazione |
| Includi Health Connect o l'API Google Health nel flusso di configurazione della tua app. | Offri Fit come app a cui gli utenti possono connettersi una volta che Health Connect è disponibile. |