Actualiza o inserta una sesión determinada. Pruébalo ahora.
Solicitud
Solicitud HTTP
PUT https://www.googleapis.com/fitness/v1/users/userId/sessions/sessionId
Parámetros
Nombre del parámetro | Valor | Descripción |
---|---|---|
Parámetros de ruta de acceso | ||
sessionId |
string |
El ID de la sesión que se creará. |
userId |
string |
Crea sesiones para la persona identificada. Usa me para indicar el usuario autenticado. En este momento, solo se admite me .
|
Autorización
Esta solicitud requiere una autorización con el siguiente alcance:
Alcance |
---|
https://www.googleapis.com/auth/fitness.activity.write |
Para obtener más información, consulta la página de autenticación y autorización.
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporciona datos con la siguiente estructura:
{ "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 }
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
id |
string |
Es un identificador generado por el cliente que es único en todas las sesiones que pertenecen a este usuario en particular. | |
name |
string |
Es un nombre legible de la sesión. | |
description |
string |
Una descripción de esta sesión. | |
startTimeMillis |
long |
Hora de inicio, en milisegundos desde la época, inclusive. | |
endTimeMillis |
long |
Hora de finalización, en milisegundos desde la época, inclusive. | |
modifiedTimeMillis |
long |
Una marca de tiempo que indica cuándo se modificó la sesión por última vez. | |
application |
nested object |
La aplicación que creó la sesión. | |
application.packageName |
string |
Es el nombre del paquete de esta aplicación. Este se usa como identificador único cuando lo crean las aplicaciones para Android, pero los clientes REST no pueden especificarlo. El número de proyecto de los clientes REST se reflejará en los IDs de flujo de datos de la fuente de datos, en lugar del packageName. | |
application.version |
string |
Versión de la aplicación. Debes actualizar este campo cada vez que la aplicación cambie de una manera que afecte el cálculo de los datos. | |
application.detailsUrl |
string |
Un URI opcional que se puede usar para establecer un vínculo de regreso a la aplicación. | |
application.name |
string |
Es el nombre de esta aplicación. Esto es obligatorio para los clientes REST, pero no aplicamos la exclusividad de este nombre. Se proporciona por conveniencia a otros desarrolladores que desean identificar qué REST creó una aplicación o una fuente de datos. | |
activityType |
integer |
El tipo de actividad que representa esta sesión. | |
activeTimeMillis |
long |
Tiempo de actividad de la sesión. Si bien start_time_millis y end_time_millis definen el tiempo de la sesión completa, el tiempo de actividad puede ser más corto y se puede especificar mediante active_time_millis. Si se conoce el tiempo de inactividad durante la sesión, también se debe insertar a través de un dato com.google.activity.segmento con un valor de actividad STILL. |
Respuesta
Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:
{ "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 }
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
id |
string |
Es un identificador generado por el cliente que es único en todas las sesiones que pertenecen a este usuario en particular. | |
name |
string |
Es un nombre legible de la sesión. | |
description |
string |
Una descripción de esta sesión. | |
startTimeMillis |
long |
Hora de inicio, en milisegundos desde la época, inclusive. | |
endTimeMillis |
long |
Hora de finalización, en milisegundos desde la época, inclusive. | |
modifiedTimeMillis |
long |
Una marca de tiempo que indica cuándo se modificó la sesión por última vez. | |
application |
nested object |
La aplicación que creó la sesión. | |
application.packageName |
string |
Es el nombre del paquete de esta aplicación. Este se usa como identificador único cuando lo crean las aplicaciones para Android, pero los clientes REST no pueden especificarlo. El número de proyecto de los clientes REST se reflejará en los IDs de flujo de datos de la fuente de datos, en lugar del packageName. | |
application.version |
string |
Versión de la aplicación. Debes actualizar este campo cada vez que la aplicación cambie de una manera que afecte el cálculo de los datos. | |
application.detailsUrl |
string |
Un URI opcional que se puede usar para establecer un vínculo de regreso a la aplicación. | |
application.name |
string |
Es el nombre de esta aplicación. Esto es obligatorio para los clientes REST, pero no aplicamos la exclusividad de este nombre. Se proporciona por conveniencia a otros desarrolladores que desean identificar qué REST creó una aplicación o una fuente de datos. | |
activityType |
integer |
El tipo de actividad que representa esta sesión. | |
activeTimeMillis |
long |
Tiempo de actividad de la sesión. Si bien start_time_millis y end_time_millis definen el tiempo de la sesión completa, el tiempo de actividad puede ser más corto y se puede especificar mediante active_time_millis. Si se conoce el tiempo de inactividad durante la sesión, también se debe insertar a través de un dato com.google.activity.segmento con un valor de actividad STILL. |
Pruébalo
Usa el Explorador de APIs que aparece a continuación para llamar a este método con los datos en tiempo real y ver la respuesta.