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 no está vacío, solo se deben mostrar las sesiones con estos tipos de actividad. |
endTime |
string |
Una marca de tiempo RFC3339. Solo se incluirán las sesiones que finalicen entre las horas de inicio y finalización la respuesta. Si se omite este tiempo, pero sí se establece startTime especificado, todas las sesiones desde el startTime hasta el final del tiempo se devuelvan. |
includeDeleted |
boolean |
Si es verdadero, y si tanto startTime como endTime son omitido, se devolverán las eliminaciones de la sesión. |
pageToken |
string |
El token de continuación, que se utiliza 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 muestra ninguna hora de inicio,
de finalización y se especifica el token de la página, las sesiones modificadas en el último período
Se devuelven durante 30 días.
|
startTime |
string |
Una marca de tiempo RFC3339. Solo se incluirán las sesiones que finalicen entre las horas de inicio y finalización la respuesta. Si se omite este tiempo, pero se especifica endTime, todas las sesiones desde el inicio hasta el endTime que se devuelven. |
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 que está entre las startTime y las 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 de la sesión legible por humanos. | |
session[].description |
string |
Es una descripción de esta sesión. | |
session[].startTimeMillis |
long |
Una hora de inicio, en milisegundos desde el ciclo de entrenamiento, inclusive. | |
session[].endTimeMillis |
long |
Una hora de finalización, en milisegundos desde el ciclo de entrenamiento, 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 |
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. | |
session[].application.version |
string |
Versión de la aplicación. Debes actualizar este campo cada vez que la aplicación cambie de una forma que afecte el cálculo de los datos. | |
session[].application.detailsUrl |
string |
Un URI opcional que se puede usar para volver 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 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. | |
session[].activityType |
integer |
El tipo de actividad que representa esta sesión. | |
deletedSession[] |
list |
Si estableces includeDeleted como verdadera 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 de la sesión legible por humanos. | |
deletedSession[].description |
string |
Es una descripción de esta sesión. | |
deletedSession[].startTimeMillis |
long |
Una hora de inicio, en milisegundos desde el ciclo de entrenamiento, inclusive. | |
deletedSession[].endTimeMillis |
long |
Una hora de finalización, en milisegundos desde el ciclo de entrenamiento, 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 |
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. | |
deletedSession[].application.version |
string |
Versión de la aplicación. Debes actualizar este campo cada vez que la aplicación cambie de una forma que afecte el cálculo de los datos. | |
deletedSession[].application.detailsUrl |
string |
Un URI opcional que se puede usar para volver 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 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. | |
deletedSession[].activityType |
integer |
El tipo de actividad que representa esta sesión. | |
nextPageToken |
string |
El token de sincronización que se usa para sincronizar más cambios. Esto solo se proporcionará si se omiten startTime y endTime de la solicitud. | |
session[].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. |
|
deletedSession[].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. |
|
hasMoreData |
boolean |
Marca que indica que el servidor tiene más datos para transferir. NO UTILICE ESTE CAMPO. Nunca se propaga en las respuestas del servidor. |
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.