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 Если значение равно 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 ниже, чтобы вызвать этот метод для оперативных данных и просмотреть ответ.