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

Prova

Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.