Users.sessions: update

지정된 세션을 업데이트하거나 삽입합니다. 지금 사용해 보기

요청

HTTP 요청

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

매개변수

매개변수 이름 설명
경로 매개변수
sessionId string 생성할 세션의 ID입니다.
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 클라이언트가 생성한 식별자로, 이 특정 사용자가 소유한 모든 세션에서 고유한 ID입니다.
name string 사람이 읽을 수 있는 세션 이름입니다.
description string 이 세션에 대한 설명입니다.
startTimeMillis long 시작 시간(에포크 이후 밀리초 단위, 에포크 시간 포함)입니다.
endTimeMillis long 종료 시간을 에포크 이후의 밀리초 단위로 나타낸 것입니다.
modifiedTimeMillis long 세션이 마지막으로 수정된 시간을 나타내는 타임스탬프입니다.
application nested object 세션을 만든 애플리케이션입니다.
application.packageName string 이 애플리케이션의 패키지 이름입니다. Android 애플리케이션에서 만들 때 고유 식별자로 사용되지만 REST 클라이언트에서는 지정할 수 없습니다. REST 클라이언트는 packageName 대신 개발자 프로젝트 번호를 데이터 소스 데이터 스트림 ID에 반영합니다.
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로 지정할 수 있습니다. 세션 중 비활성 시간이 알려진 경우 STILL 활동 값이 있는 com.google.activity.segment 데이터 포인트를 통해서도 삽입되어야 합니다.

응답

요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.

{
  "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 클라이언트가 생성한 식별자로, 이 특정 사용자가 소유한 모든 세션에서 고유한 ID입니다.
name string 사람이 읽을 수 있는 세션 이름입니다.
description string 이 세션에 대한 설명입니다.
startTimeMillis long 시작 시간(에포크 이후 밀리초 단위, 에포크 시간 포함)입니다.
endTimeMillis long 종료 시간을 에포크 이후의 밀리초 단위로 나타낸 것입니다.
modifiedTimeMillis long 세션이 마지막으로 수정된 시간을 나타내는 타임스탬프입니다.
application nested object 세션을 만든 애플리케이션입니다.
application.packageName string 이 애플리케이션의 패키지 이름입니다. Android 애플리케이션에서 만들 때 고유 식별자로 사용되지만 REST 클라이언트에서는 지정할 수 없습니다. REST 클라이언트는 packageName 대신 개발자 프로젝트 번호를 데이터 소스 데이터 스트림 ID에 반영합니다.
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로 지정할 수 있습니다. 세션 중 비활성 시간이 알려진 경우 STILL 활동 값이 있는 com.google.activity.segment 데이터 포인트를 통해서도 삽입되어야 합니다.

사용해 보기

아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.