L'API Fitbit Web è stata migliorata e modernizzata per fornire una base più standardizzata, coerente e scalabile per le integrazioni degli sviluppatori e ora si chiama API Google Health. L'API Google Health rappresenta l'evoluzione strategica dell'API Fitbit Web legacy, ricostruita da zero sulla moderna infrastruttura di Google.
Con questa piattaforma, gli sviluppatori ottengono l'accesso a tutta la potenza degli strumenti per sviluppatori di Google Cloud e alla comodità di un modo familiare e semplificato per consentire agli utenti di gestire le proprie autorizzazioni tramite Google OAuth 2.0.
Cosa ottieni con l'API Google Health?
- Un'unica fonte attendibile: il nostro nuovo "flusso riconciliato" gestisce la complessa attività di riconciliazione dei punti dati sovrapposti provenienti da più fonti. In questo modo, le app mostrano gli stessi dati coerenti che gli utenti vedono nell'app Fitbit. Questo stream verrà fornito in aggiunta al nostro stream proprietario, che include i dati dei dispositivi Fitbit e Pixel, nonché le voci manuali.
- Modernizzazione tecnica e prestazioni: abbiamo consolidato oltre 100 endpoint legacy in un insieme semplificato di bundle di tipi di dati e abbiamo eliminato le incoerenze nei formati dei dati, nei fusi orari, nelle unità di misura e nella gestione degli errori. Inoltre, ora supportiamo il protocollo HTTP/REST per il recupero dei dati sul rendimento ad alte prestazioni. Inoltre, i dati infragiornalieri e i webhook sono ora disponibili per tutti i tipi di dati pertinenti tramite un endpoint di elenco dedicato.
- Webhook migliorati e scalabilità: approfitta del supporto esteso dei webhook, tra cui le iscrizioni automatiche e la gestione dettagliata di tutti i tipi di dati pertinenti, progettati per scalare con la prossima generazione di app per la salute basate sull'AI.
- Identità e sicurezza semplificate: sostituisci il token di autorizzazione Fitbit (FOT) legacy con Google OAuth 2.0. In questo modo, gli sviluppatori possono utilizzare le librerie di autenticazione Google standard, semplificando i codebase e offrendo agli utenti un modo familiare e centralizzato per gestire le proprie autorizzazioni. Tutti gli ambiti dell'API Google Health sono classificati come con restrizioni, pertanto l'accesso richiede un controllo della privacy e della sicurezza.
Ti piace quello che vedi? Inizia subito.
Versioni API e canale beta pubblico
L'API Google Health utilizza il controllo delle versioni basato sui canali in conformità con le proposte di miglioramento delle API (AIP) di Google, in particolare AIP-185: controllo delle versioni delle API e AIP-181: livelli di stabilità. L'API è disponibile su due canali pubblici: il canale stabile v4 e il canale beta pubblico v4beta. Google supporta entrambi i canali tramite i canali di assistenza standard.
Confronta i canali beta e stabile
In conformità con AIP-185, il canale v4beta funge da superset del canale stabile v4. Include tutte le funzionalità v4 stabili, oltre a tipi di dati, campi e metodi con accesso in anteprima attualmente in fase di test da parte dei partner.
Nella documentazione, gli elementi dell'API disponibili solo nel canale beta visualizzano l'etichetta v4beta.
| Funzionalità | Canale stabile (v4) |
Canale beta pubblico (v4beta) |
|---|---|---|
| URI di base REST | https://health.googleapis.com/v4 |
https://health.googleapis.com/v4beta |
| Pacchetto gRPC | google.devicesandservices.health.v4 |
google.devicesandservices.health.v4beta |
| Documenti di riferimento | REST v4 e RPC v4 | REST v4beta e RPC v4beta |
| Livello di stabilità | Pronto per la produzione e regolato dalle regole di compatibilità con le versioni precedenti di AIP-180. | Anteprima instabile soggetta a modifiche incompatibili o rimozione in qualsiasi momento senza preavviso. |
| Uso previsto | Applicazioni di produzione live rivolte agli utenti. | Test iniziali, prototipazione, convalida dello schema e feedback degli sviluppatori. |
| Assistenza | Supportato tramite i canali di assistenza standard. | Supportato tramite i canali di assistenza standard per segnalazioni di bug, risoluzione dei problemi e feedback sulla progettazione. |
Come trattare il canale v4beta
Quando esplori le funzionalità contrassegnate con v4beta, segui queste linee guida:
- Utilizza
v4betaprincipalmente in ambienti di sviluppo, gestione temporanea e test non di produzione. Non è consigliabile rilasciare funzionalità di produzione che dipendono da endpointv4betao da tipi di dati solo beta. - Tieni presente che gli schemi, i nomi dei campi, i comportamenti degli endpoint e le rappresentazioni dei dati in
v4betapossono cambiare senza preavviso. Le funzionalità e i tipi di dati beta possono anche essere rimossi completamente se non soddisfano gli obiettivi di convalida. - Isola il codice client sperimentale di
v4betadietro i flag di funzionalità o moduli separati in modo che le modifiche che provocano un errore nel canale beta non interrompano l'integrazione principale div4. - Ricevi assistenza, segnala problemi e condividi feedback sull'implementazione di
v4betatramite i nostri canali di assistenza standard per contribuire a definire il design finale dell'API.
Promozione dalla versione v4beta alla versione v4 stabile
I nuovi tipi di dati e le nuove funzionalità vengono inseriti in v4beta per supportare i test dei partner e la convalida del mercato prima di passare al canale stabile v4.
Google valuta le funzionalità beta in base ai seguenti criteri prima di promuoverle
a v4:
- I test dei partner confermano che il modello di dati, la semantica dei campi e i pattern di query soddisfano i requisiti delle applicazioni reali.
- Il feedback degli sviluppatori e le revisioni del design sono stati completati e lo schema è pronto per essere bloccato in base alle garanzie di compatibilità con le versioni precedenti di AIP-180.
- Le pipeline di dati end-to-end, la sincronizzazione dei dispositivi e l'affidabilità dei servizi soddisfano gli standard di qualità della produzione.
- In linea con le regole di ritiro di AIP-185, tutti i campi o i comportamenti ritirati durante i test beta vengono rimossi anziché essere promossi a
v4.
Sebbene AIP-181 fornisca una regola generale di circa 90 giorni per la valutazione della versione beta, la tempistica effettiva per la promozione di una funzionalità da v4beta a v4 dipende dalla complessità della funzionalità, dalla disponibilità dell'hardware e dal feedback di convalida. Alcune funzionalità potrebbero essere promosse prima, mentre altre potrebbero rimanere in v4beta più a lungo o essere ritirate.
Quando un tipo di dati o una funzionalità viene promosso al canale v4 stabile, Google annuncia la promozione nelle note di rilascio. A quel punto, aggiorna le richieste da https://health.googleapis.com/v4beta a https://health.googleapis.com/v4 prima di rilasciare l'integrazione agli utenti di produzione.
E l'API Fitbit Web?
L'API Fitbit Web legacy è stata disattivata in base alla seguente cronologia:
- 30 settembre 2026 (fine del supporto): il supporto per l'API Fitbit Web è terminato e Google ha smesso di correggere i bug o di fornire assistenza per l'API.
- 2 novembre 2026 (disattivazione dell'API): l'API Fitbit Web e gli endpoint Fitbit OAuth sono stati disattivati e non funzionano più né sincronizzano i dati da o verso gli utenti di Google Health. Le richieste a questi endpoint non vanno a buon fine e restituiscono un codice di stato HTTP
410 Gone.
Gli sviluppatori che utilizzano l'API Fitbit Web legacy e l'autorizzazione Fitbit devono eseguire la migrazione delle proprie applicazioni e dei propri utenti all'API Google Health e a Google OAuth 2.0.
Per iniziare, consulta la guida alla migrazione.
Quali dispositivi sono supportati?
Tutti i dispositivi Fitbit e gli smartwatch Google Pixel, attuali e precedenti, raccoglieranno i dati che vengono restituiti tramite l'API Google Health. Il tipo di dati disponibili dipende dalla funzionalità supportata dai dispositivi.
L'elenco dei dispositivi attuali è disponibile sul Google Store.
Come faccio a inviare feedback?
Il tuo feedback è molto apprezzato. Ti invitiamo a condividere le tue opinioni tramite i nostri canali di assistenza, elencati nella pagina Assistenza.
Sebbene abbiamo fatto di tutto per garantire che queste API ti supportino al meglio, l'API Google Health è in continua evoluzione. Tieni presente che, in base al tuo feedback, potremmo introdurre modifiche da qui alla fine di maggio che richiederebbero aggiornamenti corrispondenti da parte tua.
Roadmap
Questo è un elenco di funzionalità in arrivo nel 2026.
Q4 2026
Tipi di dati (lettura e scrittura)
- Temperatura cutanea granulare
- Metabolismo basale
- Aggiungeremo tipi di dati per raggiungere la parità con Connessione Salute. Prevediamo di aggiungere molti altri tipi di dati di Health Connect nel quarto trimestre del 2026 e nel primo trimestre del 2027.
Funzionalità
- Canale beta pubblico per l'accesso in anteprima ai nuovi tipi di dati
- Endpoint delle statistiche per monitorare la telemetria dei webhook