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 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. In questa sezione vengono incluse solo le sessioni che terminano tra l'ora di inizio e quella di fine la risposta. Se questo orario viene omesso, ma startTime è specificato, tutte le sessioni dal giorno startTime alla fine dell'orario da restituire. |
includeDeleted |
boolean |
Se il valore è true e se startTime e endTime sono entrambi omesso, verranno restituite le eliminazioni della sessione. |
pageToken |
string |
Il token di continuazione, utilizzato per la sincronizzazione incrementale.
Per ottenere il successivo gruppo di modifiche, imposta questo parametro sul valore
nextPageToken dalla risposta precedente. Il token della pagina è
ignorato se è specificata l'ora di inizio o di fine. Se non è impostata l'ora di inizio,
ora di fine e il token della pagina è specificato, le sessioni sono state modificate
vengono restituiti entro 30 giorni.
|
startTime |
string |
Un timestamp RFC3339. In questa sezione vengono incluse solo le sessioni che terminano tra l'ora di inizio e quella di fine la risposta. Se questo orario viene omesso ma viene specificato endTime, tutte le sessioni dall'inizio fino al giorno endTime saranno restituito. |
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 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 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 client 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, in millisecondi dal epoca, inclusa. | |
session[].endTimeMillis |
long |
Ora di fine inclusa, in millisecondi dall'epoca. | |
session[].modifiedTimeMillis |
long |
Un timestamp che indica la data dell'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. Per i client REST, il numero del progetto sviluppatore sarà riportato negli ID stream di dati dell'origine dati, invece che nel valore 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 rimandare 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 vorrebbero identificare il REST che ha creato un'applicazione o un'origine dati. | |
session[].activityType |
integer |
Il tipo di attività rappresentato da questa sessione. | |
deletedSession[] |
list |
Se il criterio includeDeleted è impostato su true nella richiesta e i criteri startTime e endTime vengono omessi, saranno incluse le sessioni eliminate dall'ultima sincronizzazione. |
|
deletedSession[].id |
string |
Un identificatore generato dal client 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, in millisecondi dal epoca, inclusa. | |
deletedSession[].endTimeMillis |
long |
Ora di fine inclusa, in millisecondi dall'epoca. | |
deletedSession[].modifiedTimeMillis |
long |
Un timestamp che indica la data dell'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. Per i client REST, il numero del progetto sviluppatore sarà riportato negli ID stream di dati dell'origine dati, invece che nel valore 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 rimandare 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 vorrebbero identificare il REST che 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 sia startTime sia 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 di attività 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à ANCORA |
|
deletedSession[].activeTimeMillis |
long |
Tempo di attività della sessione. Mentre start_time_millis e end_time_millis definiscono la durata dell'intera sessione, il tempo di attività 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à ANCORA |
|
hasMoreData |
boolean |
Contrassegno che indica che il server ha più dati da trasferire. NON UTILIZZARE QUESTO CAMPO. Non viene mai inserito in risposte dal server. |
Prova
Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.