Users.sessions: list

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.