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.