Users.sessions: list

Muestra una lista de las sesiones creadas anteriormente. Pruébalo ahora.

Solicitud

Solicitud HTTP

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

Parámetros

Nombre del parámetro Valor Descripción
Parámetros de ruta de acceso
userId string Enumera las sesiones de la persona identificada. Usa me para indicar el usuario autenticado. En este momento, solo se admite me.
Parámetros de consulta opcionales
activityType integer Si este campo no está vacío, solo se deben mostrar sesiones con estos tipos de actividades.
endTime string Una marca de tiempo RFC3339. En la respuesta, solo se incluirán las sesiones que finalicen entre las horas de inicio y finalización. Si se omite este horario, pero se especifica startTime, se mostrarán todas las sesiones desde startTime hasta el final.
includeDeleted boolean Si es verdadero, y se omiten startTime y endTime, se mostrarán las eliminaciones de la sesión.
pageToken string El token de continuación, que se usa para la sincronización incremental. Para obtener el siguiente lote de cambios, establece este parámetro en el valor de nextPageToken de la respuesta anterior. El token de la página se ignora si se especifica la hora de inicio o finalización. Si no se especifica ninguna hora de inicio ni de finalización, y el token de la página, se muestran las sesiones modificadas en los últimos 30 días.
startTime string Una marca de tiempo RFC3339. En la respuesta, solo se incluirán las sesiones que finalicen entre las horas de inicio y finalización. Si se omite este tiempo, pero se especifica endTime, se mostrarán todas las sesiones desde el inicio hasta el endTime.

Autorización

Esta solicitud requiere autorización con al menos uno de los siguientes alcances:

Alcance
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.read
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.read
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.read
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.read
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write

Para obtener más información, consulta la página de autenticación y autorización.

Cuerpo de la solicitud

No proporciones un cuerpo de la solicitud con este método.

Respuesta

Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:

{
  "session": [
    {
      "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
    }
  ],
  "deletedSession": [
    {
      "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
    }
  ],
  "nextPageToken": string,
  "hasMoreData": boolean
}
Nombre de la propiedad Valor Descripción Notas
session[] list Sesiones con una hora de finalización entre el startTime y el endTime de la solicitud.

session[].id string Es un identificador generado por el cliente que es único en todas las sesiones que pertenecen a este usuario en particular.
session[].name string Es un nombre legible de la sesión.
session[].description string Una descripción de esta sesión.
session[].startTimeMillis long Hora de inicio, en milisegundos desde la época, inclusive.
session[].endTimeMillis long Hora de finalización, en milisegundos desde la época, inclusive.
session[].modifiedTimeMillis long Una marca de tiempo que indica cuándo se modificó la sesión por última vez.
session[].application nested object La aplicación que creó la sesión.
session[].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.
session[].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.
session[].application.detailsUrl string Un URI opcional que se puede usar para establecer un vínculo de regreso a la aplicación.
session[].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.
session[].activityType integer El tipo de actividad que representa esta sesión.
deletedSession[] list Si se configura includeDeleted como verdadero en la solicitud, y se omiten startTime y endTime, se incluirán las sesiones que se borraron desde la última sincronización.
deletedSession[].id string Es un identificador generado por el cliente que es único en todas las sesiones que pertenecen a este usuario en particular.
deletedSession[].name string Es un nombre legible de la sesión.
deletedSession[].description string Una descripción de esta sesión.
deletedSession[].startTimeMillis long Hora de inicio, en milisegundos desde la época, inclusive.
deletedSession[].endTimeMillis long Hora de finalización, en milisegundos desde la época, inclusive.
deletedSession[].modifiedTimeMillis long Una marca de tiempo que indica cuándo se modificó la sesión por última vez.
deletedSession[].application nested object La aplicación que creó la sesión.
deletedSession[].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.
deletedSession[].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.
deletedSession[].application.detailsUrl string Un URI opcional que se puede usar para establecer un vínculo de regreso a la aplicación.
deletedSession[].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.
deletedSession[].activityType integer El tipo de actividad que representa esta sesión.
nextPageToken string El token de sincronización que se utiliza para sincronizar más cambios. Solo se proporcionará si se omiten startTime y endTime de la solicitud.
session[].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.

deletedSession[].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.

hasMoreData boolean Marca para indicar que el servidor tiene más datos para transferir. NO USAR ESTE CAMPO. Nunca se propaga en las respuestas del servidor.

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.