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.

Users.dataSources: update

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. Prova subito.

Richiesta

Richiesta HTTP

PUT https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId

Parametri

Nome del parametro	Valore	Descrizione
Parametri del percorso
`dataSourceId`	`string`	L'ID stream di dati dell'origine dati da aggiornare.
`userId`	`string`	Aggiorna l'origine dati della persona identificata. Usa `me` per indicare l'utente autenticato. Al momento è supportato solo `me`.

Autorizzazione

Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti:

Ambito
`https://www.googleapis.com/auth/fitness.activity.write`
`https://www.googleapis.com/auth/fitness.location.write`
`https://www.googleapis.com/auth/fitness.body.write`
`https://www.googleapis.com/auth/fitness.nutrition.write`
`https://www.googleapis.com/auth/fitness.blood_pressure.write`
`https://www.googleapis.com/auth/fitness.blood_glucose.write`
`https://www.googleapis.com/auth/fitness.oxygen_saturation.write`
`https://www.googleapis.com/auth/fitness.body_temperature.write`
`https://www.googleapis.com/auth/fitness.reproductive_health.write`

Per ulteriori informazioni, consulta la pagina relativa a autenticazione e autorizzazione.

Corpo della richiesta

Nel corpo della richiesta, fornisci una risorsaUsers.dataSources con le seguenti proprietà:

Nome proprietà	Valore	Descrizione
Proprietà obbligatorie
`application`	`nested object`	Informazioni su un'applicazione che invia dati dei sensori alla piattaforma.
`application.name`	`string`	Il nome di questa applicazione. Questa operazione è obbligatoria per i client REST, ma non applichiamo l'univocità di questo nome. Viene fornito per comodità ad altri sviluppatori che desiderano identificare quale REST ha creato un'applicazione o un'origine dati.
`dataStreamId`	`string`	Un identificatore univoco per lo stream di dati prodotto da questa origine dati. L'identificatore include: Il produttore, il modello e il numero di serie (UID) del dispositivo fisico. Il nome o il nome del pacchetto dell'applicazione. Il nome del pacchetto viene utilizzato quando l'origine dati è stata creata da un'applicazione Android. Il numero di progetto dello sviluppatore viene utilizzato quando l'origine dati è stata creata da un client REST. Il tipo di origine dati. Il nome dello stream dell'origine dati. Tieni presente che non tutti gli attributi dell'origine dati vengono utilizzati come parte dell'identificatore del flusso. In particolare, non viene utilizzata la versione dell'hardware o dell'applicazione. Questo ci consente di preservare lo stesso stream tramite gli aggiornamenti della versione. Questo significa anche che due oggetti DataSource possono rappresentare lo stesso stream di dati anche se sono diversi. Il formato esatto dell'ID stream di dati creato da un'applicazione Android è: `type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName` Il formato esatto dell'ID stream di dati creato da un client REST è: `type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName` Se non è presente uno qualsiasi dei campi facoltativi che costituiscono l'ID stream di dati, quest'ultimo viene omesso dall'ID stream di dati. L'ID dello stream di dati minimo utilizzabile sarebbe: type:dataType.name:developer project number Infine, il numero del progetto sviluppatore e l'UID del dispositivo sono offuscati quando vengono letti da qualsiasi client REST o Android che non ha creato l'origine dati. Solo l'utente che ha creato l'origine dati vedrà il numero del progetto sviluppatore in modo chiaro e normale. Ciò significa che un client vedrà un insieme di data_stream_id diverso rispetto a un altro client con credenziali diverse.
`dataType`	`nested object`	Il tipo di dati definisce lo schema per un flusso di dati che vengono raccolti, inseriti o sottoposti a query dall'API Fitness.
`dataType.field[]`	`list`	Un campo rappresenta una dimensione di un tipo di dati.
`dataType.field[].format`	`string`	I diversi formati supportati per ogni campo di un tipo di dati. I valori accettati sono: "`blob`" "`floatList`" "`floatPoint`" "`integer`" "`integerList`" "`map`" "`string`"
`dataType.field[].name`	`string`	Definisce il nome e il formato dei dati. A differenza dei nomi dei tipi di dati, i nomi dei campi non hanno uno spazio dei nomi e devono essere univoci solo all'interno del tipo di dati.
`dataType.name`	`string`	Ogni tipo di dati ha un nome univoco con spazio dei nomi. Tutti i tipi di dati nello spazio dei nomi com.google vengono condivisi come parte della piattaforma.
`device`	`nested object`	Rappresentazione di un dispositivo integrato (come uno smartphone o un dispositivo indossabile) che può contenere sensori.
`device.manufacturer`	`string`	Produttore del prodotto/hardware.
`device.model`	`string`	Nome del modello visibile all'utente finale per il dispositivo.
`device.type`	`string`	Una costante che rappresenta il tipo di dispositivo. I valori accettati sono: "`chestStrap`" "`headMounted`" "`phone`" "`scale`" "`smartDisplay`" "`tablet`" "`unknown`" "`watch`"
`device.uid`	`string`	Il numero di serie o un altro ID univoco dell'hardware. Questo campo è offuscato quando viene letto da qualsiasi client REST o Android che non ha creato l'origine dati. Solo l'utente che ha creato l'origine dati vedrà il campo UID in forma chiara e normale. L'offuscamento preserva l'uguaglianza, ovvero dati due ID, se id1 == id2, offuscato(id1) == offuscato(id2).
`device.version`	`string`	Stringa di versione dell'hardware/software del dispositivo.
`type`	`string`	Una costante che descrive il tipo di questa origine dati. Indica se l'origine dati produce dati non elaborati o derivati. I valori accettati sono: "`derived`" "`raw`"

Risposta

Se l'esito è positivo, questo metodo restituisce una risorsaUsers.dataSources nel corpo della risposta.

Prova.

Utilizza Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.