Users.sessions: list

Перечисляет ранее созданные сеансы. Попробуйте сейчас .

Запрос

HTTP-запрос

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

Параметры

Имя параметра Ценить Описание
Параметры пути
userId string Перечислите сеансы для идентифицированного человека. Используйте me , чтобы указать аутентифицированного пользователя. В данный момент поддерживают только me .
Необязательные параметры запроса
activityType integer Если поле не пусто, должны быть возвращены только сеансы с этими типами активности.
endTime string Временная метка RFC3339 . В ответ будут включены только сеансы, закончившиеся между временем начала и окончания. Если это время опущено, но указано startTime , будут возвращены все сеансы от startTime до конца времени.
includeDeleted boolean Если это правда, и если оба 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 номер проекта разработчика будет отражен в идентификаторах потока данных источника данных, а не в имени пакета.
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 номер проекта разработчика будет отражен в идентификаторах потока данных источника данных, а не в имени пакета.
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-обозреватель ниже, чтобы вызвать этот метод для реальных данных и просмотреть ответ.