Note di rilascio

24 marzo 2026

Annuncio del lancio dell'API Google Health

L'API Google Health è la prossima generazione dell'API Fitbit Web, creata da zero e progettata per la nostra preziosa community di sviluppatori. Questa release iniziale si concentra sul raggiungimento della parità con l'API Fitbit Web per i tipi di dati più richiesti, oltre all'aggiunta di funzionalità richieste dalla community di sviluppatori. Ecco uno sguardo alle funzionalità disponibili oggi.

Punti salienti delle funzionalità principali

  • Configurazione semplificata: registra i tuoi progetti e gestisci gli ID client OAuth direttamente tramite la console Google Cloud che già conosci.
  • Ampio supporto della piattaforma: utilizza le librerie Google OAuth2 per un'integrazione perfetta in tutti i principali linguaggi di programmazione e piattaforme.
  • Accesso semplificato ai dati: utilizza nuove definizioni di ambiti che consolidano più tipi di dati in un unico ambito facile da gestire.
  • Endpoint coerenti tra i tipi di dati: semplifica il percorso di codifica con nuovi endpoint uniformi e supporto dei filtri progettati per semplificare la funzionalità in tutti i tipi di dati.
  • Copertura completa dei dati: accedi al supporto di lettura e scrittura per più tipi di dati.
  • Notifiche in tempo reale: ricevi aggiornamenti istantaneamente con il supporto avanzato dei webhook, che include la creazione automatica degli abbonamenti e contenuti dei messaggi di notifica più ricchi.
  • Supporto intraday predefinito: recupera i dati intraday granulari per impostazione predefinita utilizzando l'endpoint list, eliminando passaggi aggiuntivi.
  • Suite di documentazione completa: inizia subito a utilizzare la nostra nuova documentazione completa, che include:
    • Guide introduttive, API, migrazione e risoluzione dei problemi
    • Guida di riferimento completa per REST
    • Nuovo strumento di parità dell'API Google Health, codice campione e codelab guidato

Tipi di dati supportati

Questo lancio fornisce l'accesso ai tipi di dati essenziali, garantendo che tu disponga delle informazioni di base necessarie per creare soluzioni sanitarie innovative.

Tipi di dati che supportano la lettura:

  • Attività e fitness: minuti attivi, minuti in zona attiva, livello di attività, altitudine, calorie nelle zone di frequenza cardiaca, VO2 max giornaliero, distanza, allenamento, piani, VO2 max di corsa, periodo sedentario, passi, tempo nella zona di frequenza cardiaca, calorie totali, VO2 max
  • Metriche di salute e misurazioni: grasso corporeo, variabilità del battito cardiaco giornaliera, zone del battito cardiaco giornaliera, saturazione di ossigeno giornaliera, frequenza respiratoria giornaliera, battito cardiaco a riposo giornaliero, derivazioni della temperatura del sonno giornaliera, frequenza cardiaca, variabilità del battito cardiaco, saturazione di ossigeno, riepilogo relativo al sonno della frequenza respiratoria, peso
  • Identità: restituisce l'ID utente Fitbit e l'ID utente Google
  • Posizione: dati GPS basati su un allenamento registrato esposto in formato TCX
  • Alimentazione: diario dell'idratazione
  • Profilo: informazioni di base del profilo degli utenti
  • Impostazioni: impostazioni del dispositivo e dell'app mobile configurate dagli utenti
  • Sonno: diari del sonno classici e per fasi

Tipi di dati che supportano la scrittura:

Puoi scrivere e modificare i dati per questi tipi di dati:

  • Attività e fitness: allenamento
  • Metriche di salute e misurazioni: grasso corporeo, peso
  • Profilo
  • Impostazioni
  • Sonno

Endpoint chiave per l'interazione

Sono disponibili i seguenti endpoint per gestire abbonamenti, utenti e dati relativi a salute e attività fisica:

  • users: Metodi getIdentity, getProfile, getSettings, updateProfile, e updateSettings per la gestione di identità e profili.
  • users.dataTypes.dataPoints: metodi batchDelete, dailyRollUp, list, patch, reconcile, e rollUp per la gestione completa dei tipi di dati.