Questo riferimento API è organizzato per tipo di risorsa. Ciascun tipo di risorsa ha una o più rappresentazioni dei dati e uno o più metodi.
Tipi di risorse
- Users.dataSources
- Users.dataSources.dataPointChanges
- Users.dataSources.set
- Users.dataset
- Users.sessions
Origini utenti.dati
Per maggiori dettagli sulle risorse Users.dataSources, vedi la rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
Se non diversamente indicato, gli URI relativi a https://www.googleapis.com/fitness/v1/users | ||
creare |
POST /userId/dataSources
|
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. |
elimina |
DELETE /userId/dataSources/dataSourceId
|
Elimina l'origine dati specificata. Se l'origine dati contiene punti dati, la richiesta non andrà a buon fine. |
get |
GET /userId/dataSources/dataSourceId
|
Restituisce l'origine dati specificata. |
list |
GET /userId/dataSources
|
Elenca tutte le origini dati visibili allo sviluppatore, utilizzando gli ambiti OAuth forniti. L'elenco non è esaustivo: l'utente potrebbe avere origini dati private visibili solo ad altri sviluppatori o chiamate utilizzando altri ambiti. |
aggiorna |
PUT /userId/dataSources/dataSourceId
|
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 .
|
Users.dataSources.dataPointChanges
Per Users.dataSources.dataPointChanges Dettagli delle risorse, consulta la pagina rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
Se non diversamente indicato, gli URI relativi a https://www.googleapis.com/fitness/v1/users | ||
list |
GET /userId/dataSources/dataSourceId/dataPointChanges
|
Query per modifiche ai punti dati degli utenti per una determinata origine dati. |
Users.dataSources.sets
Per Users.dataSources.set di dettagli delle risorse, vedi la pagina resource resource.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
Se non diversamente indicato, gli URI relativi a https://www.googleapis.com/fitness/v1/users | ||
elimina |
DELETE /userId/dataSources/dataSourceId/datasets/datasetId
|
Consente di eliminare definitivamente tutti i punti dati i cui orari di inizio e fine presentano sovrapposizioni con l'intervallo di tempo specificato dall'ID del set di dati. Per la maggior parte dei tipi di dati, l'intero punto dati viene eliminato. Per i tipi di dati in cui l'intervallo di tempo rappresenta un valore coerente (ad esempio com.google.activity.segment ) e un punto dati si trova a un punto finale del set di dati, verrà eliminata solo la parte che si sovrappone al punto dati.
|
get |
GET /userId/dataSources/dataSourceId/datasets/datasetId
|
Restituisce un set di dati contenente tutti i punti dati i cui orari di inizio e fine si sovrappongono con l'intervallo specificato di ora di inizio minima e ora di fine del set di dati. In particolare, qualsiasi punto dati la cui ora di inizio è inferiore o uguale all'ora di fine del set di dati e la cui ora di fine è superiore o uguale all'ora di inizio del set di dati. |
patch |
PATCH /userId/dataSources/dataSourceId/datasets/datasetId
|
Aggiunge punti dati a un set di dati. Non è necessario creare prima il set di dati.
Tutti i punti all'interno del set di dati verranno restituiti con chiamate successive
per recuperare il set di dati. I punti dati possono appartenere a più di un set di dati.
Questo metodo non utilizza la semantica delle patch: i punti dati forniti vengono semplicemente inseriti, senza dati esistenti sostituiti. |
Set di dati utente
Per maggiori dettagli sulla risorsa Users.dataset, consulta la pagina relativa alla rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
Se non diversamente indicato, gli URI relativi a https://www.googleapis.com/fitness/v1/users | ||
aggregare |
POST /userId/dataset:aggregate
|
Aggrega i dati di un determinato tipo o di un flusso in bucket divisi per un determinato tipo di confine. È possibile aggregare più set di dati di più tipi da più origini in un solo tipo di bucket per richiesta. |
Utenti.sessioni
Per maggiori dettagli sulle risorse Users.sessions, vedi la rappresentazione delle risorse.
Metodo | Richiesta HTTP | Descrizione |
---|---|---|
Se non diversamente indicato, gli URI relativi a https://www.googleapis.com/fitness/v1/users | ||
elimina |
DELETE /userId/sessions/sessionId
|
Elimina una sessione specificata dall'ID sessione specificato. |
list |
GET /userId/sessions
|
Elenca le sessioni create in precedenza. |
aggiorna |
PUT /userId/sessions/sessionId
|
Aggiorna o inserisci una determinata sessione. |