Список сеансов, созданных ранее. Попробуйте прямо сейчас .
Запрос
HTTP-запрос
GET https://www.googleapis.com/fitness/v1/users/userId/sessions
Параметры
Имя параметра | Ценность | Описание |
---|---|---|
Параметры пути | ||
userId | string | Перечислите сеансы для указанного человека. Используйте me чтобы указать аутентифицированного пользователя. В данный момент поддерживается только me . |
Необязательные параметры запроса | ||
activityType | integer | Если не пусто, должны быть возвращены только сеансы с этими типами активности. |
endTime | string | Отметка времени RFC3339 . В ответ будут включены только сеансы, заканчивающиеся между временем начала и временем окончания. Если это время опущено, но указано startTime , будут возвращены все сеансы от startTime до конца времени. |
includeDeleted | boolean | Если значение равно true, и если оба startTime и endTime опущены, будет возвращено удаление сеанса. |
pageToken | string | Токен продолжения, который используется для добавочной синхронизации. Чтобы получить следующий пакет изменений, установите для этого параметра значение nextPageToken из предыдущего ответа. Маркер страницы игнорируется, если указано время начала или окончания. Если время начала, время окончания и токен страницы не указаны, возвращаются сеансы, измененные за последние 30 дней. |
startTime | string | Отметка времени RFC3339 . В ответ будут включены только сеансы, заканчивающиеся между временем начала и временем окончания. Если это время опущено, но указано endTime , будут возвращены все сеансы с начала времени до endTime . |
Авторизация
Этот запрос требует авторизации по крайней мере в одной из следующих областей:
Сфера |
---|
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 |
Дополнительные сведения см. на странице аутентификации и авторизации .
Тело запроса
Не указывайте тело запроса с этим методом.
Ответ
В случае успеха этот метод возвращает тело ответа со следующей структурой:
{ "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 }
Имя свойства | Ценность | Описание | Заметки |
---|---|---|---|
session[] | list | Сеансы с временем окончания между startTime и endTime запроса. | |
session[]. id | string | Генерируемый клиентом идентификатор, уникальный для всех сеансов, принадлежащих этому конкретному пользователю. | |
session[]. name | string | Удобочитаемое имя сеанса. | |
session[]. description | string | Описание этого сеанса. | |
session[]. startTimeMillis | long | Время начала в миллисекундах с начала эпохи включительно. | |
session[]. endTimeMillis | long | Время окончания в миллисекундах с начала эпохи включительно. | |
session[]. modifiedTimeMillis | long | Временная метка, указывающая, когда сеанс был в последний раз изменен. | |
session[]. application | nested object | Приложение, которое создало сеанс. | |
session[].application. packageName | string | Имя пакета для этого приложения. Он используется в качестве уникального идентификатора при создании приложений Android, но не может быть указан клиентами REST. Клиенты REST будут иметь свой номер проекта разработчика, отраженный в идентификаторах потоков данных источника данных, а не в packageName. | |
session[].application. version | string | Версия приложения. Вы должны обновлять это поле всякий раз, когда приложение изменяется таким образом, что это влияет на вычисление данных. | |
session[].application. detailsUrl | string | Необязательный URI, который можно использовать для обратной связи с приложением. | |
session[].application. name | string | Имя этого приложения. Это требуется для клиентов REST, но мы не обеспечиваем уникальность этого имени. Он предоставляется для удобства других разработчиков, которые хотели бы определить, какой REST создал приложение или источник данных. | |
session[]. activityType | integer | Тип деятельности, которую представляет этот сеанс. | |
deletedSession[] | list | Если includeDeleted установлено значение true в запросе, а startTime и endTime опущены, это будет включать сеансы, которые были удалены с момента последней синхронизации. | |
deletedSession[]. id | string | Генерируемый клиентом идентификатор, уникальный для всех сеансов, принадлежащих этому конкретному пользователю. | |
deletedSession[]. name | string | Удобочитаемое имя сеанса. | |
deletedSession[]. description | string | Описание этого сеанса. | |
deletedSession[]. startTimeMillis | long | Время начала в миллисекундах с начала эпохи включительно. | |
deletedSession[]. endTimeMillis | long | Время окончания в миллисекундах с начала эпохи включительно. | |
deletedSession[]. modifiedTimeMillis | long | Временная метка, указывающая, когда сеанс был в последний раз изменен. | |
deletedSession[]. application | nested object | Приложение, которое создало сеанс. | |
deletedSession[].application. packageName | string | Имя пакета для этого приложения. Он используется в качестве уникального идентификатора при создании приложений Android, но не может быть указан клиентами REST. Клиенты REST будут иметь свой номер проекта разработчика, отраженный в идентификаторах потоков данных источника данных, а не в packageName. | |
deletedSession[].application. version | string | Версия приложения. Вы должны обновлять это поле всякий раз, когда приложение изменяется таким образом, что это влияет на вычисление данных. | |
deletedSession[].application. detailsUrl | string | Необязательный URI, который можно использовать для обратной связи с приложением. | |
deletedSession[].application. name | string | Имя этого приложения. Это требуется для клиентов REST, но мы не обеспечиваем уникальность этого имени. Он предоставляется для удобства других разработчиков, которые хотели бы определить, какой REST создал приложение или источник данных. | |
deletedSession[]. activityType | integer | Тип деятельности, которую представляет этот сеанс. | |
nextPageToken | string | Токен синхронизации, который используется для синхронизации дальнейших изменений. Это будет предоставлено только в том случае, если и startTime , и endTime опущены в запросе. | |
session[]. activeTimeMillis | long | Активное время сеанса. В то время как start_time_millis и end_time_millis определяют полное время сеанса, активное время может быть короче и указано в active_time_millis. Если время бездействия во время сеанса известно, оно также должно быть вставлено через точку данных com.google.activity.segment со значением активности STILL. | |
deletedSession[]. activeTimeMillis | long | Активное время сеанса. В то время как start_time_millis и end_time_millis определяют полное время сеанса, активное время может быть короче и указано в active_time_millis. Если время бездействия во время сеанса известно, оно также должно быть вставлено через точку данных com.google.activity.segment со значением активности STILL. | |
hasMoreData | boolean | Флаг, указывающий, что серверу нужно передать больше данных. НЕ ИСПОЛЬЗУЙТЕ ЭТО ПОЛЕ. Он никогда не заполняется в ответах сервера. |
Попытайся!
Используйте обозреватель API ниже, чтобы вызвать этот метод для оперативных данных и просмотреть ответ.