Le API Google Fit sono ritirate e la fine del servizio è prevista per la fine del 2026. Google offre diversi prodotti e servizi per la salute e il benessere per aiutare i tuoi 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 a quale servizio eseguire la migrazione in base a come utilizzi le API Google Fit.
Percorsi di migrazione consigliati
La scelta dell'API deve basarsi sul tipo di applicazione e sulle esigenze specifiche dei dati.
Per tipo di applicazione
| Tipo di applicazione | Percorso consigliato | Motivo principale |
|---|---|---|
| App per il monitoraggio dei passi | Connessione Salute | Lettura incentrata sul mobile dei dati aggregati sui passi 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 | L'API Google Health e Health Connect | Utilizza l'API Google Health per i dati dei dispositivi Fitbit/Google e Health Connect per i dati aggregati sul dispositivo. |
In base all'integrazione attuale
| Integrazione attuale | Percorso consigliato | Disponibilità |
|---|---|---|
| Google Fit (Android e API REST) | API Google Health | Disponibile |
| Lettura dei passi da dispositivo mobile (con l'API Google Fit Recording) | Connessione Salute | Disponibile |
| API Fit su Wear OS | Servizi per la salute | Disponibile |
| API Fitbit Web | API Google Health | Disponibile |
| API Recording su dispositivi mobili | Connessione Salute | Disponibile |
| Connessione Salute | 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 più adatto.
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 | Console Google Cloud | 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 progetto Google Cloud | Crea un progetto Google Cloud e attiva l'API Google Health |
API Fit e Health Connect
Utilizza questo percorso per le applicazioni Android mobile-first che leggono le metriche del dispositivo locale.
| Funzionalità | API Fit per Android | Connessione Salute |
|---|---|---|
| Registrazione | Console di Google Cloud | 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 | Centrato sul dispositivo (sul dispositivo) |
| Pubblico | Sviluppatori Android legacy | Sviluppatori di app mobile Android moderne |
| Autorizzazioni | Ambiti OAuth | Autorizzazioni del file manifest di Android |
Integrazioni dell'API Fit
Le sezioni seguenti forniscono indicazioni sulla migrazione da ciascuna delle API Google Fit. Se la tua 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 del consumo della batteria creando abbonamenti.
Ogni abbonamento collega un'app per Android a un particolare tipo di dati sul fitness o a un'origine dati e il tipo di dati Step viene di uso comune utilizzato per registrare i passi.
Segui questi passaggi per eseguire la migrazione dall'API Fit Recording:
| Telefono | Wear |
|
Utilizzare i servizi per la salute:
Per saperne di più sulle differenze tra i due, consulta la documentazione di Health Services. |
App che utilizzano l'API History per leggere o scrivere dati nello store per il fitness
L'API History consente alla tua app di eseguire operazioni collettive sullo store fitness. Queste operazioni includono la lettura, l'inserimento, l'aggiornamento e l'eliminazione dei dati storici su salute e benessere.
Segui questi passaggi per eseguire la migrazione dall'API History:
| Telefono | Wear |
|
Non applicabile. Utilizza Health Connect dall'app mobile e non dal dispositivo indossabile. |
App che utilizzano l'API Sensor per visualizzare dati sul fitness in tempo reale
L'API Sensor ti consente di leggere i dati dei sensori non elaborati nella tua app in tempo reale. L'API Sensor esegue le seguenti operazioni:
- Elenca le origini dati disponibili sul dispositivo e sui dispositivi associati.
- Registra i listener per ricevere i dati non elaborati dei sensori.
- Annulla la registrazione dei listener in modo che non ricevano più dati non elaborati dai sensori.
Segui questi passaggi per eseguire la migrazione dall'API Sensor:
| Telefono | Wear |
|
Utilizza Sensors, API Fused Location Provider |
Utilizzare Servizi per la salute su Wear OS:
|
App che utilizzano l'API Session per fornire riepiloghi dell'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 nello store di fitness.
Segui questi passaggi per eseguire la migrazione dall'API Session:
| Telefono | Wear |
|
Avvio/arresto: non applicabile. L'applicazione deve tenere traccia internamente dello stato delle sessioni in corso. Lettura/scrittura: Transizione all'API Google Health. |
Avvio/interruzione: utilizza Servizi per la salute (ExerciseClient) Lettura/scrittura: utilizza Health Connect con la tua app mobile. Per flussi di lavoro specifici, ti consigliamo quanto segue:
|
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à giornaliera rispetto a questi utilizzando l'API Goals.
| Telefono | Wear |
| Nessuna API sostitutiva disponibile. | Nessuna API sostitutiva disponibile. |
App che utilizzano l'API BLE
La tua app può trovare 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:
| Telefono | 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 Android Sensors o l'API Fused Location Provider per i dati non elaborati in tempo reale.
- API Goals: non è disponibile un'API sostitutiva. Gestisci il monitoraggio degli obiettivi e i target di attività giornalieri all'interno della logica dell'applicazione.
- API Bluetooth Low Energy (BLE): utilizza direttamente le API Bluetooth di 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 migrare gli utenti esistenti e nuovi a Health Connect o all'API Google Health in queste sezioni:
Utenti esistenti della tua app
Se la UI 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 ritireremo l'integrazione dell'app Fit e su quali sono le opzioni migliori per mantenere l'esperienza utente. Nel frattempo, puoi contattarci.
| ControllaFai questo | chiudiNon farlo |
| Offri Health Connect o l'API Google Health come nuova opzione nella tua app.
Concentrati sui vantaggi per gli utenti, come dati e approfondimenti 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 con l'API Google Health.
Health Connect offre l'accesso a nuove origini e tipi di dati per fornire un'esperienza più ricca 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.
| ControllaFai questo | chiudiNon farlo |
| 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. |