Users.sessions: update

Aggiorna o inserisci una determinata sessione. Prova subito.

Risorse richieste:

Richiesta HTTP

PUT https://www.googleapis.com/fitness/v1/users/userId/sessions/sessionId

Parametri

Nome del parametro Valore Descrizione
Parametri del percorso
sessionId string ID della sessione da creare.
userId string Creare sessioni per la persona identificata. Utilizza me per indicare l'utente autenticato. Al momento è supportato solo me.

Autorizzazione

Questa richiesta richiede l'autorizzazione con il seguente ambito:

Ambito
https://www.googleapis.com/auth/fitness.activity.write

Per scoprire di più, consulta la pagina Autenticazione e autorizzazione.

Corpo della richiesta

Nel corpo della richiesta, fornisci i dati con la seguente struttura:

{
  "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
}
Nome proprietà Valore Descrizione Note
id string Un identificatore generato dal client che sia univoco per tutte le sessioni di proprietà di questo particolare utente.
name string Un nome leggibile della sessione.
description string Una descrizione della sessione.
startTimeMillis long Un'ora di inizio, in millisecondi a partire dal periodo, compreso.
endTimeMillis long Un'ora di fine, in millisecondi dal periodo, inclusi.
modifiedTimeMillis long Un timestamp che indica quando la sessione è stata modificata l'ultima volta.
application nested object L'applicazione che ha creato la sessione.
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.
application.version string Versione dell'applicazione. Devi aggiornare questo campo ogni volta che l'applicazione cambia in modo da influire sul calcolo dei dati.
application.detailsUrl string Un URI facoltativo che può essere utilizzato per il collegamento all'applicazione.
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.
activityType integer Il tipo di attività rappresentata da questa sessione.
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à

Risposta

In caso di esito positivo, questo metodo restituisce un corpo di risposta con la seguente struttura:

{
  "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
}
Nome proprietà Valore Descrizione Note
id string Un identificatore generato dal client che sia univoco per tutte le sessioni di proprietà di questo particolare utente.
name string Un nome leggibile della sessione.
description string Una descrizione della sessione.
startTimeMillis long Un'ora di inizio, in millisecondi a partire dal periodo, compreso.
endTimeMillis long Un'ora di fine, in millisecondi dal periodo, inclusi.
modifiedTimeMillis long Un timestamp che indica quando la sessione è stata modificata l'ultima volta.
application nested object L'applicazione che ha creato la sessione.
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.
application.version string Versione dell'applicazione. Devi aggiornare questo campo ogni volta che l'applicazione cambia in modo da influire sul calcolo dei dati.
application.detailsUrl string Un URI facoltativo che può essere utilizzato per il collegamento all'applicazione.
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.
activityType integer Il tipo di attività rappresentata da questa sessione.
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à

Prova.

Utilizza Explorer API di seguito per chiamare questo metodo in base ai dati in tempo reale e visualizzare la risposta.