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

Consente di aggiornare l'origine dati specificata. dataStreamId, dataType, type, dataStreamName e device proprietà ad eccezione di version, non può essere modificato.

Le origini dati sono identificate dal relativo dataStreamId. Prova subito.

Richiesta

Richiesta HTTP

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

Parametri

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

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 Autenticazione e autorizzazione.

Corpo della richiesta

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

Nome proprietà	Valore	Descrizione
Proprietà obbligatorie
`application`	`nested object`	Informazioni su un'applicazione che alimenta i dati dei sensori nella 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 vorrebbero identificare il REST che 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 del progetto 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 stream. Nello specifico, non viene utilizzata la versione dell'hardware o dell'applicazione. In questo modo possiamo mantenere lo stesso flusso tramite gli aggiornamenti della versione. Ciò significa anche che due oggetti DataSource potrebbero rappresentare lo stesso stream di dati anche se non sono uguali. 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 uno qualsiasi dei campi facoltativi che compongono l'ID stream di dati non è presente, verrà omesso dall'ID stream di dati. L'ID minimo dello stream di dati utilizzabile sarebbe: type:dataType.name:developer project number Infine, il numero del progetto sviluppatore e l'UID del dispositivo vengono offuscati quando vengono letti da un client REST o Android che non ha creato l'origine dati. Solo il creatore dell'origine dati vedrà il numero del progetto dello sviluppatore in formato normale e chiaro. Ciò significa che un client vedrà un set di data_stream_id diverso rispetto a un altro client con credenziali differenti.
`dataType`	`nested object`	Il tipo di dati definisce lo schema di 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 (ad esempio uno smartphone o un dispositivo indossabile) in grado di contenere sensori.
`device.manufacturer`	`string`	Produttore del prodotto/hardware.
`device.model`	`string`	Nome di modello visibile all'utente finale del 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'autore dell'origine dati vedrà il campo UID in formato normale e chiaro. L'offuscamento preserva l'uguaglianza; cioè, dati due ID, se id1 == id2, offuscato(id1) == offuscato(id2).
`device.version`	`string`	Stringa della versione per l'hardware/software del dispositivo.
`type`	`string`	Una costante che descrive il tipo di questa origine dati. Indica se questa origine dati produce dati non elaborati o derivati. I valori accettati sono: "`derived`" "`raw`"

Risposta

In caso di esito positivo, questo metodo restituisce una risorsa Users.dataSources nel corpo della risposta.