Elenca le sessioni create in precedenza. Prova subito.
Risorse richieste:
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 della persona identificata. Utilizza me per indicare
l'utente autenticato. Al momento è supportato solo me .
|
Parametri di ricerca facoltativi | ||
activityType |
integer |
Se il campo non è vuoto, dovrebbero 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'inizio e la fine. Se questo orario viene omesso, ma startTime viene specificato, verranno restituite tutte le sessioni da startTime alla fine. |
includeDeleted |
boolean |
Se restituisce true e vengono omessi sia startTime che endTime, vengono restituite le eliminazioni di sessione. |
pageToken |
string |
Il token di continuazione, che viene utilizzato per la sincronizzazione incrementale.
Per ottenere il batch di modifiche successivo, imposta questo parametro sul valore nextPageToken della risposta precedente. Il token della pagina viene ignorato se è specificata l'ora di inizio o di fine. Se l'ora di inizio, l'ora di fine e il token della pagina non sono specificati, 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'inizio e la fine. Se questo tempo viene omesso, ma viene specificato endTime, verranno ripristinate tutte le sessioni dall'inizio fino a 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 scoprire di più, consulta la pagina Autenticazione e autorizzazione.
Corpo della richiesta
Non fornire un corpo della richiesta con questo metodo.
Risposta
In caso di esito positivo, questo metodo restituisce un corpo di 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 client che sia univoco per tutte le sessioni di proprietà di questo particolare utente. | |
session[].name |
string |
Un nome leggibile della sessione. | |
session[].description |
string |
Una descrizione della sessione. | |
session[].startTimeMillis |
long |
Un'ora di inizio, in millisecondi a partire dal periodo, compreso. | |
session[].endTimeMillis |
long |
Un'ora di fine, in millisecondi dal periodo, inclusi. | |
session[].modifiedTimeMillis |
long |
Un timestamp che indica quando la sessione è stata modificata l'ultima volta. | |
session[].application |
nested object |
L'applicazione che ha creato la sessione. | |
session[].application.packageName |
string |
Nome del pacchetto dell'applicazione. Viene utilizzato come identificatore univoco quando viene creato dalle applicazioni Android, ma non può essere specificato dai client REST. Il numero di progetto client degli sviluppatori REST verrà riportato negli ID stream di dati dell'origine dati, anziché in packageName. | |
session[].application.version |
string |
Versione dell'applicazione. Devi aggiornare questo campo ogni volta che l'applicazione cambia in modo 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 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. | |
session[].activityType |
integer |
Il tipo di attività rappresentata da questa sessione. | |
deletedSession[] |
list |
Se il valore includeDeleted è impostato su true nella richiesta e startTime e endTime vengono omessi, verranno incluse le sessioni eliminate dall'ultima sincronizzazione. |
|
deletedSession[].id |
string |
Un identificatore generato dal client che sia univoco per tutte le sessioni di proprietà di questo particolare utente. | |
deletedSession[].name |
string |
Un nome leggibile della sessione. | |
deletedSession[].description |
string |
Una descrizione della sessione. | |
deletedSession[].startTimeMillis |
long |
Un'ora di inizio, in millisecondi a partire dal periodo, compreso. | |
deletedSession[].endTimeMillis |
long |
Un'ora di fine, in millisecondi dal periodo, inclusi. | |
deletedSession[].modifiedTimeMillis |
long |
Un timestamp che indica quando la sessione è stata modificata l'ultima volta. | |
deletedSession[].application |
nested object |
L'applicazione che ha creato la sessione. | |
deletedSession[].application.packageName |
string |
Nome del pacchetto dell'applicazione. Viene utilizzato come identificatore univoco quando viene creato dalle applicazioni Android, ma non può essere specificato dai client REST. Il numero di progetto client degli sviluppatori REST verrà riportato negli ID stream di dati dell'origine dati, anziché in packageName. | |
deletedSession[].application.version |
string |
Versione dell'applicazione. Devi aggiornare questo campo ogni volta che l'applicazione cambia in modo 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 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. | |
deletedSession[].activityType |
integer |
Il tipo di attività rappresentata 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 |
Durata attività sessione. Mentre start_time_millis e end_time_millis definiscono l'intera durata della 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 STILL dell'attività |
|
deletedSession[].activeTimeMillis |
long |
Durata attività sessione. Mentre start_time_millis e end_time_millis definiscono l'intera durata della 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 STILL dell'attività |
|
hasMoreData |
boolean |
Contrassegni 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 in base ai dati in tempo reale e visualizzare la risposta.