Users.dataset: aggregate

특정 유형 또는 스트림의 데이터를 주어진 경계 유형입니다. 여러 유형의 여러 데이터 세트 소스는 요청당 정확히 하나의 버킷 유형으로 집계될 수 있습니다. 지금 사용해 보기

요청

HTTP 요청

POST https://www.googleapis.com/fitness/v1/users/userId/dataset:aggregate

매개변수

매개변수 이름 값 설명
경로 매개변수
userId string 식별된 개인에 대한 데이터를 집계합니다. me를 사용하여 표시 확인할 수 있습니다 현재는 me만 지원됩니다.

승인

이 요청을 처리하려면 다음 범위 중 하나 이상의 승인이 필요합니다.

범위
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

자세한 내용은 인증 및 승인 페이지를 참조하세요.

요청 본문

요청 본문에 다음과 같은 구조의 데이터를 제공합니다.

{
  "startTimeMillis": long,
  "endTimeMillis": long,
  "aggregateBy": [
    {
      "dataTypeName": string,
      "dataSourceId": string
    }
  ],
  "filteredDataQualityStandard": [
    string
  ],
  "bucketByTime": {
    "durationMillis": long,
    "period": {
      "type": string,
      "value": integer,
      "timeZoneId": string
    }
  },
  "bucketBySession": {
    "minDurationMillis": long
  },
  "bucketByActivityType": {
    "minDurationMillis": long,
    "activityDataSourceId": string
  },
  "bucketByActivitySegment": {
    "minDurationMillis": long,
    "activityDataSourceId": string
  }
}
속성 이름 값 설명 참고
startTimeMillis long 기간의 시작입니다. 이 기간과 교차하는 데이터가 집계됩니다. 시간은 에포크 이후 밀리초 단위로 표시됩니다(밀리초 포함).
endTimeMillis long 기간의 종료 시간입니다. 이 기간과 교차하는 데이터가 집계됩니다. 시간은 에포크 이후 밀리초 단위로 표시됩니다(밀리초 포함).
aggregateBy[] list 집계할 데이터 사양입니다. 하나 이상의 combineBy 사양을 제공해야 합니다. 지정된 모든 데이터는 동일한 버케팅 기준을 사용하여 집계됩니다. 응답에는 모든aggregateBy 사양의 하나의 데이터 세트가 포함됩니다.
aggregateBy[].dataTypeName string 집계할 데이터 유형입니다. 이 데이터 유형을 제공하는 모든 데이터 소스는 집계에 데이터를 제공합니다. 응답에는 이 데이터 유형 이름에 대한 단일 데이터 세트가 포함됩니다. 데이터 세트에는 다음과 같은 데이터 소스 ID가 포함됩니다. :com.google.android.gms:aggregated. 사용자에게 이 데이터 유형에 해당하는 데이터가 없으면 빈 데이터 세트가 반환됩니다. 참고: 데이터는 dataTypeName 또는 dataSourceId 중 하나만 사용하여 집계할 수 있습니다.
aggregateBy[].dataSourceId string 집계할 데이터 소스 ID입니다. 지정된 데이터 소스 ID의 데이터만 집계에 포함됩니다. 지정된 경우 이 데이터 소스가 있어야 합니다. 제공된 사용자 인증 정보의 OAuth 범위에서 이 데이터 유형에 대한 읽기 액세스 권한을 부여해야 합니다. 응답의 데이터 세트는 동일한 데이터 소스 ID를 갖게 됩니다. 참고: dataTypeName 또는 dataSourceId 중 하나만 사용하여 데이터를 집계할 수 있습니다.
filteredDataQualityStandard[] list 이 입력란을 돋보이게 해서는 안 됩니다. 무시됩니다.
bucketByTime nested object 단일 시간 간격으로 데이터를 집계하도록 지정합니다. 다른 버케팅 사양과 상호 배타적입니다.
bucketByTime.durationMillis long 결과 버킷이 정확히 durationMillis 기간별로 데이터를 집계하도록 지정합니다. 데이터가 없는 기간은 데이터 세트가 비어 있는 응답에 포함됩니다.
bucketByTime.period nested object
bucketByTime.period.type string

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "day"
  • "month"
  • "week"
bucketByTime.period.value integer
bucketByTime.period.timeZoneId string org.joda.timezone.DateTimeZone
bucketBySession nested object 사용자 세션별로 데이터가 집계되도록 지정합니다. 세션의 시간 범위에 속하지 않는 데이터는 응답에 포함되지 않습니다. 다른 버케팅 사양과 상호 배타적입니다.
bucketBySession.minDurationMillis long minDurationMillis보다 기간이 긴 세션만 집계 데이터의 컨테이너로 고려 및 사용되도록 지정합니다.
bucketByActivityType nested object 데이터가 기록되었을 때 수행된 활동 유형별로 데이터를 집계하도록 지정합니다. 특정 활동 유형에서 지정된 기간 동안 기록된 모든 데이터는 동일한 버킷으로 집계됩니다. 사용자가 비활성 상태일 때 기록된 데이터는 응답에 포함되지 않습니다. 다른 버케팅 사양과 상호 배타적입니다.
bucketByActivityType.minDurationMillis long minDurationMillis보다 기간이 긴 활동 세그먼트만 집계 데이터의 컨테이너로 고려 및 사용되도록 지정합니다.
bucketByActivityType.activityDataSourceId string 특정 activityDataSourceId가 지정되지 않은 경우 기본 활동 스트림이 사용됩니다.
bucketByActivitySegment nested object 사용자에 대해 기록된 각 활동 세그먼트에서 데이터를 집계하도록 지정합니다. bucketByActivitySegment와 비슷하지만 버케팅은 동일한 유형의 모든 세그먼트가 아닌 각 활동 세그먼트에 대해 수행됩니다. 다른 버케팅 사양과 상호 배타적입니다.
bucketByActivitySegment.minDurationMillis long minDurationMillis보다 기간이 긴 활동 세그먼트만 집계 데이터의 컨테이너로 고려 및 사용되도록 지정합니다.
bucketByActivitySegment.activityDataSourceId string 특정 activityDataSourceId가 지정되지 않은 경우 기본 활동 스트림이 사용됩니다.

응답

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

{
  "bucket": [
    {
      "type": string,
      "startTimeMillis": long,
      "endTimeMillis": long,
      "dataset": [
        users.dataSources.datasets Resource
      ],
      "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
      },
      "activity": integer
    }
  ]
}
속성 이름 값 설명 참고
bucket[] list 집계된 데이터가 포함된 버킷의 목록입니다.
bucket[].type string 버킷 유형은 버킷에서 데이터 집계가 수행되는 방식을 나타냅니다.

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "activitySegment"
  • "activityType"
  • "session"
  • "time"
  • "unknown"
bucket[].startTimeMillis long 집계된 데이터의 시작 시간(에포크 이후 밀리초 단위, 에포크 시간 포함)입니다.
bucket[].endTimeMillis long 집계된 데이터의 종료 시간(에포크 이후 밀리초 단위, 에포크 시간 포함)입니다.
bucket[].dataset[] list 요청의 AggregateBy당 데이터 세트가 하나씩 있습니다.
bucket[].session nested object Bucket.Type.SESSION에 사용 가능
bucket[].session.id string 클라이언트가 생성한 식별자로, 이 특정 사용자가 소유한 모든 세션에서 고유한 ID입니다.
bucket[].session.name string 사람이 읽을 수 있는 세션 이름입니다.
bucket[].session.description string 이 세션에 대한 설명입니다.
bucket[].session.startTimeMillis long 시작 시간(에포크 이후 밀리초 단위, 에포크 시간 포함)입니다.
bucket[].session.endTimeMillis long 종료 시간을 에포크 이후 밀리초 단위로 나타낸 것입니다.
bucket[].session.modifiedTimeMillis long 세션이 마지막으로 수정된 시간을 나타내는 타임스탬프입니다.
bucket[].session.application nested object 세션을 만든 애플리케이션입니다.
bucket[].session.application.packageName string 이 애플리케이션의 패키지 이름입니다. Android 애플리케이션에서 만들 때 고유 식별자로 사용되지만 REST 클라이언트에서는 지정할 수 없습니다. REST 클라이언트는 packageName 대신 개발자 프로젝트 번호를 데이터 소스 데이터 스트림 ID에 반영합니다.
bucket[].session.application.version string 애플리케이션의 버전입니다. 데이터 계산에 영향을 미치는 방식으로 애플리케이션이 변경될 때마다 이 필드를 업데이트해야 합니다.
bucket[].session.application.detailsUrl string 애플리케이션으로 다시 연결하는 데 사용할 수 있는 선택적인 URI입니다.
bucket[].session.application.name string 이 애플리케이션의 이름입니다. 이 이름은 REST 클라이언트에 필요하지만 이 이름의 고유성은 강제 적용되지 않습니다. 이는 애플리케이션 또는 데이터 소스를 만든 REST를 확인하려는 다른 개발자에게 편의를 위해 제공됩니다.
bucket[].session.activityType integer 이 세션이 나타내는 활동의 유형입니다.
bucket[].session.activeTimeMillis long 세션 활성 시간입니다. start_time_millis와 end_time_millis는 전체 세션 시간을 정의하지만, 활성 시간은 더 짧고 active_time_millis로 지정할 수 있습니다. 세션 중 비활성 시간이 알려진 경우 STILL 활동 값이 있는 com.google.activity.segment 데이터 포인트를 통해서도 삽입되어야 합니다.
bucket[].activity integer Bucket.Type.ACTIVITY_TYPE, Bucket.Type.ACTIVITY_SEGMENT에 사용 가능

사용해 보기

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