지정된 세션을 업데이트하거나 삽입합니다. 지금 사용해 보기
요청
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 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.