Users.dataSources: create

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 dati non elaborati provenienti da sensori hardware su dispositivi locali o companion. Possono anche esporre i 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 all'origine dati influiscono sull'ID stream di dati, pertanto i dati raccolti dalle versioni aggiornate della stessa applicazione/dispositivo possono comunque essere considerati appartenenti alla stessa origine dati.

Le origini dati sono identificate tramite una stringa generata dal server, in base ai contenuti dell'origine che viene creata. Il campo dataStreamId non deve essere impostato quando viene richiamato questo metodo. Verrà generata automaticamente dal server con il formato corretto. Se è impostato un valore dataStreamId, deve corrispondere al formato generato dal server. Questo formato è una combinazione di alcuni campi dell'origine dati e ha un ordine specifico. In caso contrario, la richiesta avrà esito negativo con errore.

Specificando un DataType non di tipo noto (che inizia con "com.google.") verrà creata una 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 ritirati; utilizza tipi di dati standard.

Oltre ai campi dell'origine dati inclusi nell'ID origine dati, è incluso il numero di progetto sviluppatore autenticato durante la creazione dell'origine dati. Questo numero di progetto dello sviluppatore viene offuscato quando letto da altri sviluppatori che leggono i tipi di dati pubblici. Prova subito.

Risorse richieste:

Richiesta HTTP

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

Parametri

Nome del parametro Valore Descrizione
Parametri del percorso
userId string Crea l'origine dati per la 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.
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.