Users.sessions: list

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.