이전에 생성된 세션을 나열합니다. 지금 사용해 보기
요청
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 대신 데이터 소스 데이터 스트림 ID에 반영됩니다. | |
session[].application.version |
string |
애플리케이션의 버전입니다. 애플리케이션이 데이터 계산에 영향을 미치는 방식으로 변경될 때마다 이 필드를 업데이트해야 합니다. | |
session[].application.detailsUrl |
string |
애플리케이션에 다시 연결하는 데 사용할 수 있는 URI(선택사항)입니다. | |
session[].application.name |
string |
이 애플리케이션의 이름입니다. REST 클라이언트의 경우 필수 항목이지만 이 이름에는 고유성이 없습니다. 이 ID는 어떤 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 대신 데이터 소스 데이터 스트림 ID에 반영됩니다. | |
deletedSession[].application.version |
string |
애플리케이션의 버전입니다. 애플리케이션이 데이터 계산에 영향을 미치는 방식으로 변경될 때마다 이 필드를 업데이트해야 합니다. | |
deletedSession[].application.detailsUrl |
string |
애플리케이션에 다시 연결하는 데 사용할 수 있는 URI(선택사항)입니다. | |
deletedSession[].application.name |
string |
이 애플리케이션의 이름입니다. REST 클라이언트의 경우 필수 항목이지만 이 이름에는 고유성이 없습니다. 이 ID는 어떤 REST가 애플리케이션이나 데이터 소스를 생성했는지 식별하려는 다른 개발자에게 편의를 위한 목적으로 제공됩니다. | |
deletedSession[].activityType |
integer |
이 세션이 나타내는 활동 유형입니다. | |
nextPageToken |
string |
추가 변경사항을 동기화하는 데 사용되는 동기화 토큰입니다. 요청에서 startTime 및 endTime을 모두 생략한 경우에만 제공됩니다. | |
session[].activeTimeMillis |
long |
세션 활성 시간. start_time_millis 및 end_time_millis는 전체 세션 시간을 정의하지만 활성 시간은 더 짧아지고 active_time_millis로 지정할 수 있습니다. 세션 중 비활성 시간을 알면 STILL 활동 값이 있는 com.google.activity.세그먼트 데이터 포인트도 |
|
deletedSession[].activeTimeMillis |
long |
세션 활성 시간. start_time_millis 및 end_time_millis는 전체 세션 시간을 정의하지만 활성 시간은 더 짧아지고 active_time_millis로 지정할 수 있습니다. 세션 중 비활성 시간을 알면 STILL 활동 값이 있는 com.google.activity.세그먼트 데이터 포인트도 |
|
hasMoreData |
boolean |
서버에 전송할 데이터가 더 있음을 나타내는 플래그입니다. 이 필드를 사용하지 마세요. 서버의 응답에는 채워지지 않습니다. |
사용해 보기
아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.