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 dal rispettivo dataStreamId. Prova subito.

Risorse richieste:

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 dello stream di dati dell'origine dati da aggiornare.
userId string Aggiorna l'origine dati della persona identificata. Utilizza 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 scoprire di più, 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 inserisce i dati dei sensori nella piattaforma.
application.name string Il nome dell'applicazione. Questo passaggio è obbligatorio per i client REST, ma non applichiamo l'unicità di questo nome. Viene fornito per comodità di altri sviluppatori che vogliono 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 di sviluppatore viene utilizzato quando l'origine dati è stata creata da un client REST.
  • Il tipo dell'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 streaming. In particolare, non viene utilizzata la versione dell'hardware/dell'applicazione. In questo modo possiamo mantenere lo stesso stream mediante aggiornamenti della versione. Questo significa anche che due oggetti DataSource possono rappresentare lo stesso stream di dati anche se non sono uguali.

Il formato esatto dell'ID stream di dati creato da un'applicazione Android è il seguente: 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 dei campi facoltativi che compongono l'ID stream di dati è assente, verrà omesso dall'ID stream di dati. L'ID minimo dello stream di dati valido sarebbe: type:dataType.name:numero progetto progetto

Infine, il numero di progetto sviluppatore e l'UID dispositivo sono offuscati quando letti da client REST o Android che non hanno creato l'origine dati. Solo il creatore dell'origine dati vedrà il numero di progetto dello sviluppatore in modo chiaro e normale. Ciò significa che un client vedrà un set di dati_stream_id diverso rispetto a un altro client con credenziali diverse.

dataType nested object Il tipo di dati definisce lo schema di un flusso di dati 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 dispongono di 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 e 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 un telefono o un indossabile) in grado di contenere sensori.
device.manufacturer string Produttore del prodotto/hardware.
device.model string Nome del 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 un client REST o Android che non ha creato l'origine dati. Solo il creatore dell'origine dati vedrà il campo uid in forma chiara e normale.

L'offuscamento preserva l'uguaglianza; ovvero, sono presenti due ID, se id1 == id2, offuscati(id1) == offuscati(id2).

device.version string Stringa della versione dell'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.

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