Users.sessions: list

이전에 생성된 세션을 나열합니다. 지금 사용해 보기

요청

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 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.