Users.sessions: update

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

Запрос

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