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
i dati non elaborati provenienti da sensori hardware su dispositivi locali o associati. Possono anche esporre 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 apportate all'origine dati influiscono
sull'ID stream di dati, quindi i dati raccolti dalle versioni aggiornate della stessa
applicazione/dispositivo possono comunque essere considerati appartenenti alla stessa
origine dati.
Le origini dati vengono identificate mediante una stringa generata dal server, in base ai contenuti dell'origine creata. Il campo dataStreamId
non deve essere impostato quando si richiama questo metodo. Verrà generato automaticamente dal server con il formato corretto. Se viene impostato un valore dataStreamId
, questo deve corrispondere al formato generato dal server. Questo formato è una combinazione di alcuni campi dell'origine dati e ha un ordine specifico. Se non corrisponde, la richiesta
non andrà a buon fine e verrà visualizzato un errore.
Se specifichi un DataType non noto (a partire da "com.google."), verrà creato un 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 deprecati; utilizza invece tipi di dati standard.
Oltre ai campi dell'origine dati inclusi nell'ID origine dati, è incluso il numero del progetto sviluppatore autenticato durante la creazione dell'origine dati. Questo numero di progetto dello sviluppatore è offuscato quando viene letto
da qualsiasi altro sviluppatore che legge tipi di dati pubblici.
Prova subito.
Richiesta
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. 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 | Note |
---|---|---|---|
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. | |
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:
|
|
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:
|
|
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:
|
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.