Users.sessions: update

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 Es 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 los 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 de la sesión legible por humanos.
description string Es una descripción de esta sesión.
startTimeMillis long Una hora de inicio, en milisegundos desde el ciclo de entrenamiento, inclusive.
endTimeMillis long Una hora de finalización, en milisegundos desde el ciclo de entrenamiento, 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 Nombre del paquete de esta aplicación. Se usa como identificador único cuando lo crean aplicaciones para Android, pero los clientes REST no pueden especificarlo. En los clientes de REST, el número de proyecto del desarrollador se reflejará en los IDs de flujo de datos de la fuente de datos, en lugar de en 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 volver a la aplicación.
application.name string Es el nombre de esta aplicación. Esto es obligatorio para los clientes REST, pero no aplicamos este nombre de unicidad. Se proporciona por conveniencia para otros desarrolladores que quieran 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. Mientras que start_time_millis y end_time_millis definen el tiempo completo de la sesión, 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.segment con un valor de actividad de 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 de la sesión legible por humanos.
description string Es una descripción de esta sesión.
startTimeMillis long Una hora de inicio, en milisegundos desde el ciclo de entrenamiento, inclusive.
endTimeMillis long Una hora de finalización, en milisegundos desde el ciclo de entrenamiento, 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 Nombre del paquete de esta aplicación. Se usa como identificador único cuando lo crean aplicaciones para Android, pero los clientes REST no pueden especificarlo. En los clientes de REST, el número de proyecto del desarrollador se reflejará en los IDs de flujo de datos de la fuente de datos, en lugar de en 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 volver a la aplicación.
application.name string Es el nombre de esta aplicación. Esto es obligatorio para los clientes REST, pero no aplicamos este nombre de unicidad. Se proporciona por conveniencia para otros desarrolladores que quieran 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. Mientras que start_time_millis y end_time_millis definen el tiempo completo de la sesión, 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.segment con un valor de actividad de STILL.

Pruébalo

Usa el Explorador de APIs que se muestra a continuación para llamar a este método en datos en vivo y ver la respuesta.