Elenca le sessioni create in precedenza. Prova subito.
Richiesta
Richiesta HTTP
GET https://www.googleapis.com/fitness/v1/users/userId/sessions
Parametri
Nome del parametro | Valore | Descrizione |
---|---|---|
Parametri del percorso | ||
userId |
string |
Elenca le sessioni per la persona identificata. Usa me per indicare l'utente autenticato. Al momento è supportato solo me .
|
Parametri di query facoltativi | ||
activityType |
integer |
Se il campo non è vuoto, devono essere restituite solo le sessioni con questi tipi di attività. |
endTime |
string |
Un timestamp RFC3339. Nella risposta verranno incluse solo le sessioni che terminano tra l'ora di inizio e l'ora di fine. Se questo intervallo di tempo viene omesso, ma è specificato startTime, verranno restituite tutte le sessioni dal giorno startTime fino alla fine. |
includeDeleted |
boolean |
Se il valore è true, e se vengono omessi sia startTime che endTime, verranno restituite le eliminazioni delle sessioni. |
pageToken |
string |
Il token di continuazione, utilizzato per la sincronizzazione incrementale.
Per ottenere il gruppo di modifiche successivo, imposta questo parametro sul valore di
nextPageToken della risposta precedente. Il token della pagina viene ignorato se viene specificata un'ora di inizio o di fine. Se non viene specificata nessuna ora di inizio, ora di fine e il token della pagina, vengono restituite le sessioni modificate negli ultimi 30 giorni.
|
startTime |
string |
Un timestamp RFC3339. Nella risposta verranno incluse solo le sessioni che terminano tra l'ora di inizio e l'ora di fine. Se questo orario viene omesso, ma è specificato endTime, verranno restituite tutte le sessioni dall'inizio fino al giorno endTime. |
Autorizzazione
Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti:
Ambito |
---|
https://www.googleapis.com/auth/fitness.activity.read |
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.read |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.read |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.read |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.read |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.read |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.read |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.read |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.read |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
Per ulteriori informazioni, consulta la pagina relativa a autenticazione e autorizzazione.
Corpo della richiesta
Non fornire il corpo di una richiesta con questo metodo.
Risposta
Se l'esito è positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:
{ "session": [ { "id": string, "name": string, "description": string, "startTimeMillis": long, "endTimeMillis": long, "modifiedTimeMillis": long, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "activityType": integer, "activeTimeMillis": long } ], "deletedSession": [ { "id": string, "name": string, "description": string, "startTimeMillis": long, "endTimeMillis": long, "modifiedTimeMillis": long, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "activityType": integer, "activeTimeMillis": long } ], "nextPageToken": string, "hasMoreData": boolean }
Nome proprietà | Valore | Descrizione | Note |
---|---|---|---|
session[] |
list |
Sessioni con un'ora di fine compresa tra startTime e endTime della richiesta. |
|
session[].id |
string |
Un identificatore generato dal cliente univoco in tutte le sessioni di proprietà di questo utente specifico. | |
session[].name |
string |
Un nome leggibile della sessione. | |
session[].description |
string |
Una descrizione per questa sessione. | |
session[].startTimeMillis |
long |
Un'ora di inizio inclusa, in millisecondi dall'epoca. | |
session[].endTimeMillis |
long |
Un'ora di fine, inclusa, in millisecondi dall'epoca. | |
session[].modifiedTimeMillis |
long |
Un timestamp che indica quando è stata l'ultima modifica della sessione. | |
session[].application |
nested object |
L'applicazione che ha creato la sessione. | |
session[].application.packageName |
string |
Nome del pacchetto per questa applicazione. Viene utilizzato come identificatore univoco quando viene creato dalle app per Android, ma non può essere specificato dai client REST. Il numero di progetto sviluppatore dei client REST sarà riportato negli ID stream di dati dell'origine dati, anziché in packageName. | |
session[].application.version |
string |
La versione dell'applicazione. Devi aggiornare questo campo ogni volta che l'applicazione cambia in modo tale da influire sul calcolo dei dati. | |
session[].application.detailsUrl |
string |
Un URI facoltativo che può essere utilizzato per il collegamento all'applicazione. | |
session[].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. | |
session[].activityType |
integer |
Il tipo di attività rappresentato da questa sessione. | |
deletedSession[] |
list |
Se includeDeleted è impostato su true nella richiesta e startTime e endTime vengono omessi, saranno incluse le sessioni eliminate dall'ultima sincronizzazione. |
|
deletedSession[].id |
string |
Un identificatore generato dal cliente univoco in tutte le sessioni di proprietà di questo utente specifico. | |
deletedSession[].name |
string |
Un nome leggibile della sessione. | |
deletedSession[].description |
string |
Una descrizione per questa sessione. | |
deletedSession[].startTimeMillis |
long |
Un'ora di inizio inclusa, in millisecondi dall'epoca. | |
deletedSession[].endTimeMillis |
long |
Un'ora di fine, inclusa, in millisecondi dall'epoca. | |
deletedSession[].modifiedTimeMillis |
long |
Un timestamp che indica quando è stata l'ultima modifica della sessione. | |
deletedSession[].application |
nested object |
L'applicazione che ha creato la sessione. | |
deletedSession[].application.packageName |
string |
Nome del pacchetto per questa applicazione. Viene utilizzato come identificatore univoco quando viene creato dalle app per Android, ma non può essere specificato dai client REST. Il numero di progetto sviluppatore dei client REST sarà riportato negli ID stream di dati dell'origine dati, anziché in packageName. | |
deletedSession[].application.version |
string |
La versione dell'applicazione. Devi aggiornare questo campo ogni volta che l'applicazione cambia in modo tale da influire sul calcolo dei dati. | |
deletedSession[].application.detailsUrl |
string |
Un URI facoltativo che può essere utilizzato per il collegamento all'applicazione. | |
deletedSession[].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. | |
deletedSession[].activityType |
integer |
Il tipo di attività rappresentato da questa sessione. | |
nextPageToken |
string |
Il token di sincronizzazione utilizzato per sincronizzare ulteriori modifiche. Verrà fornito solo se startTime e endTime vengono omessi dalla richiesta. | |
session[].activeTimeMillis |
long |
Tempo di attività della sessione. Mentre start_time_millis e end_time_millis definiscono il tempo dell'intera sessione, il tempo attivo può essere più breve e specificato da active_time_millis. Se il tempo di inattività durante la sessione è noto, deve essere inserito anche tramite un punto dati com.google.activity.segment con un valore di attività STILL |
|
deletedSession[].activeTimeMillis |
long |
Tempo di attività della sessione. Mentre start_time_millis e end_time_millis definiscono il tempo dell'intera sessione, il tempo attivo può essere più breve e specificato da active_time_millis. Se il tempo di inattività durante la sessione è noto, deve essere inserito anche tramite un punto dati com.google.activity.segment con un valore di attività STILL |
|
hasMoreData |
boolean |
Flag per indicare che il server ha più dati da trasferire. NON UTILIZZARE QUESTO CAMPO. Non viene mai inserito nelle risposte del server. |
Prova.
Utilizza Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.