Обновляет или вставляет данный сеанс. Попробуйте прямо сейчас .
Запрос
HTTP-запрос
PUT https://www.googleapis.com/fitness/v1/users/userId/sessions/sessionId
Параметры
Имя параметра | Ценность | Описание |
---|---|---|
Параметры пути | ||
sessionId | string | Идентификатор создаваемой сессии. |
userId | string | Создайте сеансы для указанного человека. Используйте me чтобы указать аутентифицированного пользователя. В данный момент поддерживается только me . |
Авторизация
Этот запрос требует авторизации со следующей областью действия:
Сфера |
---|
https://www.googleapis.com/auth/fitness.activity.write |
Дополнительные сведения см. на странице аутентификации и авторизации .
Тело запроса
В теле запроса укажите данные следующей структуры:
{ "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 }
Имя свойства | Ценность | Описание | Заметки |
---|---|---|---|
id | string | Генерируемый клиентом идентификатор, уникальный для всех сеансов, принадлежащих этому конкретному пользователю. | |
name | string | Удобочитаемое имя сеанса. | |
description | string | Описание этого сеанса. | |
startTimeMillis | long | Время начала в миллисекундах с начала эпохи включительно. | |
endTimeMillis | long | Время окончания в миллисекундах с начала эпохи включительно. | |
modifiedTimeMillis | long | Временная метка, указывающая, когда сеанс был в последний раз изменен. | |
application | nested object | Приложение, которое создало сеанс. | |
application. packageName | string | Имя пакета для этого приложения. Он используется в качестве уникального идентификатора при создании приложений Android, но не может быть указан клиентами REST. Клиенты REST будут иметь свой номер проекта разработчика, отраженный в идентификаторах потоков данных источника данных, а не в packageName. | |
application. version | string | Версия приложения. Вы должны обновлять это поле всякий раз, когда приложение изменяется таким образом, что это влияет на вычисление данных. | |
application. detailsUrl | string | Необязательный URI, который можно использовать для обратной связи с приложением. | |
application. name | string | Имя этого приложения. Это требуется для клиентов REST, но мы не обеспечиваем уникальность этого имени. Он предоставляется для удобства других разработчиков, которые хотели бы определить, какой REST создал приложение или источник данных. | |
activityType | integer | Тип деятельности, которую представляет этот сеанс. | |
activeTimeMillis | long | Активное время сеанса. В то время как start_time_millis и end_time_millis определяют полное время сеанса, активное время может быть короче и указано в active_time_millis. Если время бездействия во время сеанса известно, оно также должно быть вставлено через точку данных com.google.activity.segment со значением активности STILL. |
Ответ
В случае успеха этот метод возвращает тело ответа со следующей структурой:
{ "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 }
Имя свойства | Ценность | Описание | Заметки |
---|---|---|---|
id | string | Генерируемый клиентом идентификатор, уникальный для всех сеансов, принадлежащих этому конкретному пользователю. | |
name | string | Удобочитаемое имя сеанса. | |
description | string | Описание этого сеанса. | |
startTimeMillis | long | Время начала в миллисекундах с начала эпохи включительно. | |
endTimeMillis | long | Время окончания в миллисекундах с начала эпохи включительно. | |
modifiedTimeMillis | long | Временная метка, указывающая, когда сеанс был в последний раз изменен. | |
application | nested object | Приложение, которое создало сеанс. | |
application. packageName | string | Имя пакета для этого приложения. Он используется в качестве уникального идентификатора при создании приложений Android, но не может быть указан клиентами REST. Клиенты REST будут иметь свой номер проекта разработчика, отраженный в идентификаторах потоков данных источника данных, а не в packageName. | |
application. version | string | Версия приложения. Вы должны обновлять это поле всякий раз, когда приложение изменяется таким образом, что это влияет на вычисление данных. | |
application. detailsUrl | string | Необязательный URI, который можно использовать для обратной связи с приложением. | |
application. name | string | Имя этого приложения. Это требуется для клиентов REST, но мы не обеспечиваем уникальность этого имени. Он предоставляется для удобства других разработчиков, которые хотели бы определить, какой REST создал приложение или источник данных. | |
activityType | integer | Тип деятельности, которую представляет этот сеанс. | |
activeTimeMillis | long | Активное время сеанса. В то время как start_time_millis и end_time_millis определяют полное время сеанса, активное время может быть короче и указано в active_time_millis. Если время бездействия во время сеанса известно, оно также должно быть вставлено через точку данных com.google.activity.segment со значением активности STILL. |
Попытайся!
Используйте обозреватель API ниже, чтобы вызвать этот метод для оперативных данных и просмотреть ответ.