Users.sessions: update

Aggiorna o inserisci una determinata sessione. Prova subito.

Richiesta

Richiesta HTTP

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

Parametri

Nome del parametro Valore Descrizione
Parametri del percorso
sessionId string L'ID della sessione da creare.
userId string Crea sessioni per la persona identificata. Usa 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 ulteriori informazioni, consulta la pagina relativa a 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 cliente univoco in tutte le sessioni di proprietà di questo utente specifico.
name string Un nome leggibile della sessione.
description string Una descrizione per questa sessione.
startTimeMillis long Un'ora di inizio inclusa, in millisecondi dall'epoca.
endTimeMillis long Un'ora di fine, inclusa, in millisecondi dall'epoca.
modifiedTimeMillis long Un timestamp che indica quando è stata l'ultima modifica della sessione.
application nested object L'applicazione che ha creato la sessione.
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. Il numero di progetto sviluppatore dei client REST sarà riportato negli ID stream di dati dell'origine dati, anziché in packageName.
application.version string La versione dell'applicazione. Devi aggiornare questo campo ogni volta che l'applicazione cambia in modo tale 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 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 desiderano identificare quale REST ha creato un'applicazione o un'origine dati.
activityType integer Il tipo di attività rappresentato da questa sessione.
activeTimeMillis long Tempo di attività della sessione. Mentre start_time_millis e end_time_millis definiscono il tempo dell'intera 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 di attività STILL

Risposta

Se l'esito è positivo, questo metodo restituisce un corpo della 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 cliente univoco in tutte le sessioni di proprietà di questo utente specifico.
name string Un nome leggibile della sessione.
description string Una descrizione per questa sessione.
startTimeMillis long Un'ora di inizio inclusa, in millisecondi dall'epoca.
endTimeMillis long Un'ora di fine, inclusa, in millisecondi dall'epoca.
modifiedTimeMillis long Un timestamp che indica quando è stata l'ultima modifica della sessione.
application nested object L'applicazione che ha creato la sessione.
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. Il numero di progetto sviluppatore dei client REST sarà riportato negli ID stream di dati dell'origine dati, anziché in packageName.
application.version string La versione dell'applicazione. Devi aggiornare questo campo ogni volta che l'applicazione cambia in modo tale 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 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 desiderano identificare quale REST ha creato un'applicazione o un'origine dati.
activityType integer Il tipo di attività rappresentato da questa sessione.
activeTimeMillis long Tempo di attività della sessione. Mentre start_time_millis e end_time_millis definiscono il tempo dell'intera 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 di attività STILL

Prova.

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