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 associati. Loro può anche esporre dati derivati, creati trasformando o unendo altri dati fonti. Possono esistere più origini dati per lo stesso tipo di dati. Ogni dato punto in ogni set di dati inserito o letto dall'API Fitness ha un un'origine dati associata.

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 sul l'ID stream di dati, in modo che i dati raccolti dalle versioni aggiornate l'applicazione/il dispositivo possono essere considerati appartenenti agli stessi dati sorgente.

Le origini dati vengono identificate utilizzando una stringa generata dal server, in base sui contenuti dell'origine che viene creata. dataStreamId non deve essere impostato quando richiami questo metodo. it verranno generati automaticamente dal server con il formato corretto. Se un dataStreamId è impostato, deve corrispondere al formato utilizzato generato dal server. Questo formato è una combinazione di alcuni campi dell'origine dati e ha un ordine specifico. Se non corrisponde, la richiesta non riuscirà con un errore.

Specificare un DataType che non è un tipo noto (a partire da "com.google.") creerà un'origine dati 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, il valore numero del progetto sviluppatore autenticato durante la creazione dei dati è inclusa l'origine dati. Questo numero di progetto sviluppatore è offuscato durante la lettura da parte di qualsiasi altro sviluppatore che legge i 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 percorso
userId string Crea 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.
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.