Le API Google Fit, inclusa l'API REST Google Fit, non saranno più disponibili dopo il 30 giugno 2025. A partire dal 1° maggio 2024, gli sviluppatori non possono registrarsi per utilizzare queste API.

Per istruzioni sull'API o sulla piattaforma verso cui eseguire la migrazione, visita la guida alla migrazione di Connessione Salute. Per un confronto tra Connessione Salute con le API Google Fit e le API web di Fitbit, visita la guida al confronto di Connessione Salute.

Scopri di più su Connessione Salute e su come eseguire l'integrazione con l'API.

Questa pagina è stata tradotta dall'API Cloud Translation.

API Reference

Questo riferimento API è organizzato per tipo di risorsa. Ogni tipo di risorsa ha una o più rappresentazioni dei dati e uno o più metodi.

Users.dataSources

Per i dettagli della risorsa Users.dataSources, consulta la pagina relativa alla rappresentazione delle risorse.

Metodo	Richiesta HTTP	Descrizione
URI relativi a https://www.googleapis.com/fitness/v1/users, se non diversamente specificato
creazione	`POST /userId/dataSources`	Crea una nuova origine dati univoca per tutte le origini dati appartenenti a questo utente. Un'origine dati è una fonte unica di dati dei sensori. Le origini dati possono esporre i dati non elaborati provenienti da sensori hardware su dispositivi locali o associati. Possono anche esporre dati derivati, creati trasformando o unendo altre origini dati. Possono esistere più origini dati per lo stesso tipo di dati. A ogni punto dati in ogni set di dati inserito o letto dall'API Fitness è associata un'origine dati. Ogni origine dati produce un flusso univoco di aggiornamenti del set di dati, con un identificatore univoco dell'origine dati. Non tutte le modifiche apportate all'origine dati influiscono sull'ID stream di dati, quindi i dati raccolti dalle versioni aggiornate della stessa applicazione/dispositivo possono comunque essere considerati appartenenti alla stessa origine dati. Le origini dati vengono identificate mediante una stringa generata dal server, in base ai contenuti dell'origine creata. Il campo `dataStreamId` non deve essere impostato quando si richiama questo metodo. Verrà generato automaticamente dal server con il formato corretto. Se viene impostato un valore `dataStreamId`, questo deve corrispondere al formato generato dal server. Questo formato è una combinazione di alcuni campi dell'origine dati e ha un ordine specifico. Se non corrisponde, la richiesta non andrà a buon fine e verrà visualizzato un errore. Se specifichi un DataType non noto (a partire da "com.google."), verrà creato un DataSource con un tipo di dati personalizzato. I tipi di dati personalizzati sono leggibili solo dall'applicazione che li ha creati. I tipi di dati personalizzati sono deprecati; utilizza invece tipi di dati standard. Oltre ai campi dell'origine dati inclusi nell'ID origine dati, è incluso il numero del progetto sviluppatore autenticato durante la creazione dell'origine dati. Questo numero di progetto dello sviluppatore è offuscato quando viene letto da qualsiasi altro sviluppatore che legge tipi di dati pubblici.
elimina	`DELETE /userId/dataSources/dataSourceId`	Elimina l'origine dati specificata. Se l'origine dati contiene punti dati, la richiesta non andrà a buon fine.
recupero	`GET /userId/dataSources/dataSourceId`	Restituisce l'origine dati specificata.
list	`GET /userId/dataSources`	Elenca tutte le origini dati visibili allo sviluppatore, utilizzando gli ambiti OAuth forniti. L'elenco non è completo. L'utente potrebbe disporre di origini dati private visibili solo ad altri sviluppatori o chiamate che utilizzano altri ambiti.
aggiornamento	`PUT /userId/dataSources/dataSourceId`	Aggiorna l'origine dati specificata. Le proprietà `dataStreamId`, `dataType`, `type`, `dataStreamName` e `device`, ad eccezione di `version`, non possono essere modificate. Le origini dati sono identificate dai rispettivi `dataStreamId`.

Users.dataSources.dataPointChanges

Per i dettagli della risorsa Users.dataSources.dataPointChanges, consulta la pagina relativa alla rappresentazione delle risorse.

Metodo	Richiesta HTTP	Descrizione
URI relativi a https://www.googleapis.com/fitness/v1/users, se non diversamente specificato
list	`GET /userId/dataSources/dataSourceId/dataPointChanges`	Query sulle modifiche dei punti dati dell'utente per una determinata origine dati.

Users.dataSources.datasets

Per i dettagli delle risorse Users.dataSources.datasets, consulta la pagina relativa alla rappresentazione delle risorse.

Metodo	Richiesta HTTP	Descrizione
URI relativi a https://www.googleapis.com/fitness/v1/users, se non diversamente specificato
elimina	`DELETE /userId/dataSources/dataSourceId/datasets/datasetId`	Esegue un'eliminazione inclusiva di tutti i punti dati le cui ore di inizio e fine presentano una sovrapposizione con l'intervallo di tempo specificato dall'ID del set di dati. Per la maggior parte dei tipi di dati, l'intero punto dati verrà eliminato. Per i tipi di dati in cui l'intervallo di tempo rappresenta un valore coerente (come `com.google.activity.segment`) e un punto dati si trova a cavallo di uno dei punti finali del set di dati, verrà eliminata solo la parte sovrapposta del punto dati.
recupero	`GET /userId/dataSources/dataSourceId/datasets/datasetId`	Restituisce un set di dati contenente tutti i punti dati le cui ore di inizio e fine si sovrappongono all'intervallo specificato di ora di inizio minima e ora di fine massima del set di dati. In particolare, qualsiasi punto dati la cui ora di inizio è inferiore o uguale all'ora di fine del set di dati e la cui ora di fine è maggiore o uguale all'ora di inizio del set di dati.
cerotto	`PATCH /userId/dataSources/dataSourceId/datasets/datasetId`	Aggiunge punti dati a un set di dati. Non è necessario creare il set di dati in precedenza. Tutti i punti all'interno del set di dati specificato verranno restituiti con le chiamate successive per recuperare questo set di dati. I punti dati possono appartenere a più di un set di dati. Questo metodo non utilizza la semantica delle patch: i punti dati forniti sono semplicemente inseriti, senza la sostituzione dei dati esistenti.

Users.dataset

Per i dettagli della risorsa Users.dataset, consulta la pagina relativa alla rappresentazione delle risorse.

Metodo	Richiesta HTTP	Descrizione
URI relativi a https://www.googleapis.com/fitness/v1/users, se non diversamente specificato
aggregato	`POST /userId/dataset:aggregate`	Aggrega i dati di un determinato tipo o il flusso in bucket divisi per un determinato tipo di confine. Più set di dati di più tipi e provenienti da più origini possono essere aggregati in un solo tipo di bucket per richiesta.

Users.sessions

Per i dettagli della risorsa Users.sessions, consulta la pagina relativa alla rappresentazione delle risorse.

Metodo	Richiesta HTTP	Descrizione
URI relativi a https://www.googleapis.com/fitness/v1/users, se non diversamente specificato
elimina	`DELETE /userId/sessions/sessionId`	Elimina una sessione specificata dall'ID sessione specificato.
list	`GET /userId/sessions`	Elenca le sessioni create in precedenza.
aggiornamento	`PUT /userId/sessions/sessionId`	Aggiorna o inserisci una determinata sessione.