Note di rilascio

26 maggio 2026

Nuovi ambiti

  • .ecg.readonly per la lettura dei dati ECG.
  • .irn.readonly per la lettura dei dati IRN.

Modifiche ai nomi degli ambiti

Sostituzione degli ambiti di lettura/scrittura con .writeonly. Ora gli sviluppatori devono specificare esplicitamente le autorizzazioni di lettura e scrittura.

  • .activity_and_fitness ora è .activity_and_fitness.writeonly
  • .health_metrics_and_measurements ora è .health_metrics_and_measurements.writeonly
  • .nutrition ora è .nutrition.writeonly
  • .profile ora è .profile.writeonly
  • .settings ora è .settings.writeonly
  • .sleep ora è .sleep.writeonly

Nuovi tipi di dati

È stato aggiunto il supporto per i seguenti tipi di dati:

  • Attività e fitness: active-energy-burned
  • ECG: electrocardiogram
  • Metriche di salute e misurazioni: core-body-temperature, blood-glucose
  • IRN: irregular-rhythm-notification
  • Alimentazione: food, food-measurement-unit, nutrition-log

Nuovi endpoint

  • project.subscribers.subscriptions: metodi create, delete, list e patch per la gestione manuale degli abbonamenti.
  • users: getIrnProfile restituisce il coinvolgimento attuale di un utente con la funzionalità IRN.
  • users.pairedDevices: get e list i dispositivi associati all'account di un utente.

Webhook

È stato aggiunto il supporto per le seguenti funzionalità webhook:

  • Supporto per gli abbonamenti manuali quando viene registrato un abbonato.
  • Supporto per le notifiche per i tipi di dati activityLevel, bloodGlucose, dailyRespiratoryRate, heartRateVariability, height, hydrationLog, nutritionLog, respiratoryRateSleepSummary, runVo2Max, sedentaryPeriod, timeInHeartRateZone.
  • Supporto per metriche personalizzate, avvisi ed errori degli abbonati nella console Google Cloud.
  • Riprova automaticamente le notifiche webhook non riuscite per un massimo di 7 giorni se la comunicazione con l'abbonato viene interrotta.

Aggiornamenti della documentazione in evidenza

14 aprile 2026

Nuovi tipi di dati

  • Attività e fitness: swim-lengths-data
  • Metriche di salute e misurazioni: height

Nuovi endpoint

Supporto webhook

  • Creazione automatica dell'abbonamento quando viene registrato un abbonato.
  • Gestisci manualmente gli abbonamenti utilizzando gli endpoint project.subscribers
  • Supporto per le notifiche per i tipi di dati activeZoneMinutes, altitude, bodyFat, caloriesInHeartRateZone, dailyHeartRateVariability, dailyHeartRateZones, dailyOxygenSaturation, dailyRestingHeartRate, dailySleepTemperatureDerivations, distance, exercise, floors, heartRate, sleep, steps, totalCalories e weight.

Altre funzionalità

  • Librerie REST su GitHub: le librerie REST dell'API Google Health sono disponibili per tutte le librerie client supportate incluse nel progetto GitHub API di Google.
  • Supporto per Explorer API: gli endpoint possono essere chiamati utilizzando Explorer API, integrato nella documentazione di riferimento.
  • Supporto per OAuth Playground: l'API Google Health v4 è elencata in OAuth 2.0 Playground, uno strumento che consente di chiamare gli endpoint che supportano la libreria OAuth di Google.

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 stimata community di sviluppatori. Questa release iniziale è incentrata 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 per le piattaforme: crea sulle librerie Google OAuth2 per un'integrazione perfetta in tutti i principali linguaggi di programmazione e piattaforme.
  • Accesso semplificato ai dati: utilizza le nuove definizioni degli 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 per i 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 webhook avanzato, 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 e misurazioni di salute: grasso corporeo, variabilità del battito cardiaco giornaliera, zone del battito cardiaco giornaliere, 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: registro di idratazione
  • Profilo: informazioni di base del profilo degli utenti
  • Impostazioni: impostazioni del dispositivo e dell'app mobile configurate dagli utenti
  • Sonno: registri 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 sul fitness e sulla salute:

  • 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.