API Reference

이 API 참조는 리소스 유형을 기준으로 구성되어 있습니다. 각 리소스 유형은 하나 이상의 데이터 표현 및 하나 이상의 메소드를 갖습니다.

리소스 유형

  1. Users.dataSources
  2. Users.dataSources.dataPointChanges
  3. Users.dataSources.datasets
  4. Users.dataset
  5. Users.sessions

사용자 데이터 소스

Users.dataSources 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참고하세요.

메서드 HTTP 요청 설명
달리 명시되지 않는 한 URI는 https://www.googleapis.com/fitness/v1/users를 기준으로 합니다.
만들기 POST  /userId/dataSources 이 사용자에게 속한 모든 데이터 소스에서 고유한 새 데이터 소스를 만듭니다.

데이터 소스는 센서 데이터의 고유한 소스입니다. 데이터 소스는 로컬 또는 호환 기기의 하드웨어 센서에서 발생하는 원시 데이터를 노출할 수 있습니다. 또한 다른 데이터 소스를 변환하거나 병합하여 생성된 파생 데이터를 노출할 수도 있습니다. 동일한 데이터 유형에 대해 여러 데이터 소스가 존재할 수 있습니다. 피트니스 API에 삽입되거나 피트니스 API에서 읽은 모든 데이터 세트의 모든 데이터 포인트에는 관련 데이터 소스가 있습니다.

각 데이터 소스는 고유한 데이터 소스 식별자를 사용하여 고유한 데이터 세트 업데이트 스트림을 생성합니다. 데이터 소스의 모든 변경사항이 데이터 스트림 ID에 영향을 미치는 것은 아니므로, 동일한 애플리케이션/기기의 업데이트된 버전에서 수집한 데이터는 여전히 동일한 데이터 소스에 속하는 것으로 간주될 수 있습니다.

데이터 소스는 생성되는 소스의 콘텐츠를 기반으로 서버에서 생성된 문자열을 사용하여 식별됩니다. 이 메서드를 호출할 때 dataStreamId 필드를 설정하면 안 됩니다. 서버에서 올바른 형식으로 자동 생성됩니다. dataStreamId가 설정된 경우 서버가 생성할 형식과 일치해야 합니다. 이 형식은 데이터 소스의 일부 필드 조합이며 특정 순서가 있습니다. 일치하지 않으면 요청이 실패하고 오류가 발생합니다.

알려진 유형이 아닌 DataType("com.google."으로 시작)을 지정하면 커스텀 데이터 유형으로 DataSource가 생성됩니다. 커스텀 데이터 유형은 데이터 세트를 만든 애플리케이션만 읽을 수 있습니다. 맞춤 데이터 유형은 지원 중단되었습니다. 대신 표준 데이터 유형을 사용하세요.

데이터 소스 ID에 포함된 데이터 소스 필드 외에도 데이터 소스를 만들 때 인증된 개발자 프로젝트 번호도 포함됩니다. 공개 데이터 유형을 읽는 다른 개발자가 이 개발자 프로젝트 번호를 읽을 때 난독화됩니다.
delete DELETE  /userId/dataSources/dataSourceId 지정된 데이터 소스를 삭제합니다. 데이터 소스에 데이터 포인트가 포함되어 있으면 요청이 실패합니다.
get GET  /userId/dataSources/dataSourceId 지정된 데이터 소스를 반환합니다.
list GET  /userId/dataSources 제공된 OAuth 범위를 사용하여 개발자에게 표시되는 모든 데이터 소스를 나열합니다. 이 목록은 완전한 목록이 아닙니다. 사용자는 다른 개발자에게만 표시되는 비공개 데이터 소스나 다른 범위를 사용하는 호출을 가지고 있을 수 있습니다.
업데이트 PUT  /userId/dataSources/dataSourceId 지정된 데이터 소스를 업데이트합니다. version를 제외한 dataStreamId, dataType, type, dataStreamName, device 속성은 수정할 수 없습니다.

데이터 소스는 dataStreamId로 식별됩니다.

Users.dataSources.dataPointChanges

Users.dataSources.dataPointChanges 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
달리 명시되지 않는 한 URI는 https://www.googleapis.com/fitness/v1/users를 기준으로 합니다.
list GET  /userId/dataSources/dataSourceId/dataPointChanges 특정 데이터 소스에 대한 사용자의 데이터 포인트 변경 쿼리

Users.dataSources.datasets

Users.dataSources.datasets 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
달리 명시되지 않는 한 URI는 https://www.googleapis.com/fitness/v1/users를 기준으로 합니다.
delete DELETE  /userId/dataSources/dataSourceId/datasets/datasetId 시작 및 종료 시간이 데이터 세트 ID로 지정한 기간과 겹치는 모든 데이터 포인트를 삭제합니다. 대부분의 데이터 유형에서 전체 데이터 포인트가 삭제됩니다. 기간이 일관된 값 (예: com.google.activity.segment)을 나타내고 데이터 포인트가 데이터 세트의 어느 한쪽 끝에 걸쳐 있는 데이터 유형의 경우 데이터 포인트의 겹치는 부분만 삭제됩니다.
get GET  /userId/dataSources/dataSourceId/datasets/datasetId 시작 및 종료 시간이 데이터 세트의 최소 시작 시간과 최대 종료 시간의 지정된 범위와 겹치는 모든 데이터 포인트가 포함된 데이터 세트를 반환합니다. 특히 시작 시간이 데이터 세트 종료 시간보다 작거나 같고 종료 시간이 데이터 세트 시작 시간보다 크거나 같은 데이터 포인트입니다.
패치 PATCH  /userId/dataSources/dataSourceId/datasets/datasetId 데이터 세트에 데이터 포인트를 추가합니다. 이전에 데이터 세트를 만들 필요가 없습니다. 이 데이터 세트를 검색하기 위해 지정된 데이터 세트 내의 모든 포인트가 후속 호출로 반환됩니다. 데이터 포인트는 2개 이상의 데이터 세트에 속할 수 있습니다.

이 메서드는 패치 시맨틱스를 사용하지 않습니다. 제공된 데이터 포인트만 삽입되며 기존 데이터는 대체되지 않습니다.

Users.dataset

Users.dataset 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
달리 명시되지 않는 한 URI는 https://www.googleapis.com/fitness/v1/users를 기준으로 합니다.
집계 POST  /userId/dataset:aggregate 특정 유형 또는 스트림의 데이터를 지정된 경계 유형으로 나뉜 버킷으로 집계합니다. 여러 소스와 여러 소스의 여러 데이터 세트를 요청당 정확히 하나의 버킷 유형으로 집계할 수 있습니다.

사용자 세션

Users.sessions 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
달리 명시되지 않는 한 URI는 https://www.googleapis.com/fitness/v1/users를 기준으로 합니다.
delete DELETE  /userId/sessions/sessionId 지정된 세션 ID로 지정된 세션을 삭제합니다.
list GET  /userId/sessions 이전에 생성된 세션을 나열합니다.
업데이트 PUT  /userId/sessions/sessionId 지정된 세션을 업데이트하거나 삽입합니다.