피트니스 REST API를 사용하면 데이터 소스를 만들고, 가져오고, 업데이트할 수 있습니다. 데이터 소스는 센서 데이터의 고유한 소스가 될 수 있습니다. 데이터 소스를 사용하여 피트니스에 피트니스 데이터를 삽입합니다. 특정 데이터 소스에서 삽입한 피트니스 데이터를 검색할 수 있습니다.
데이터 소스는 Users.dataSources
로 표시됩니다.
리소스도 제공합니다
데이터 소스 만들기
이 예시에서는 'MyDataSource'라는 새 데이터 소스를 만드는 방법을 보여줍니다. 걸음 수 증가를 제공합니다.
- HTTP 메서드
- 게시
- 요청 URL
https://www.googleapis.com/fitness/v1/users/me/dataSources
- 요청 본문
{ "dataStreamName": "MyDataSource", "type": "derived", "application": { "detailsUrl": "http://example.com", "name": "Foo Example App", "version": "1" }, "dataType": { "field": [ { "name": "steps", "format": "integer" } ], "name": "com.google.step_count.delta" }, "device": { "manufacturer": "Example Manufacturer", "model": "ExampleTablet", "type": "tablet", "uid": "1000001", "version": "1.0" } }
- 응답
데이터 소스가 성공적으로 생성되면 응답은
200 OK
상태입니다. 있습니다. 응답 본문에는 데이터 소스의 JSON 표현이 포함됩니다.datasource.dataStreamId
포함 속성 값을 정의합니다.- curl 명령어
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X POST \ --header "Content-Type: application/json;encoding=utf-8" -d @createds.json \ "https://www.googleapis.com/fitness/v1/users/me/dataSources"
특정 데이터 소스 가져오기
이 예에서는 데이터 소스('MyDataSource')를 가져오는 방법을 보여줍니다.
만든 버킷이 있습니다 새 데이터 소스를 만들면
dataStreamId
에는 고유 식별자 (아래에 '1234567890'으로 표시됨)가 포함되어 있어
참조). 개발자 프로젝트 번호이며
이 특정 개발자 계정을 사용하여 만든 모든 요청이 포함됩니다. 반드시
dataStreamId
를 가져올 수 있습니다.
- HTTP 메서드
- 받기
- 요청 URL
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
- 요청 본문
- 없음
- 응답
- 데이터 소스가 있으면 응답은
200 OK
상태 코드입니다. 응답 본문에는 데이터 소스의 JSON 표현입니다. - curl 명령어
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X GET
--header "Content-Type: application/json;encoding=utf-8"
"https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource"
집계된 데이터 가져오기
이 예시에서는 집계된 데이터의 특정 데이터 소스를 쿼리하는 방법을 보여줍니다.
데이터(이 경우 estimated_steps
)는
Google 피트니스 앱의 걸음 수 계산 JSON 요청의 타임스탬프는
밀리초 단위입니다.
- HTTP 메서드
- 게시
- 요청 URL
https://www.googleapis.com/fitness/v1/users/me/dataset:aggregate
- 요청 본문
{ "aggregateBy": [{ "dataSourceId": "derived:com.google.step_count.delta:com.google.android.gms:estimated_steps" }], "bucketByTime": { "durationMillis": 86400000 }, "startTimeMillis": 1454284800000, "endTimeMillis": 1455062400000 }
- 응답
데이터 소스가 있으면 응답은
200 OK
상태 코드입니다. 이 응답 본문에는 데이터 소스의 JSON 표현이 포함됩니다.- curl 명령어
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X POST \ --header "Content-Type: application/json;encoding=utf-8" -d @aggregate.json \ "https://www.googleapis.com/fitness/v1/users/me/dataset:aggregate"
데이터 소스 업데이트
이 예에서는 데이터의 이름과 기기 버전을 업데이트하는 방법을 보여줍니다. 있습니다.
- HTTP 메서드
- PUT
- 요청 URL
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
- 요청 본문
{ "dataStreamId": "derived:com.google.step_count.delta:1234567890:Example Manufacturer:ExampleTablet:1000001:MyDataSource", "dataStreamName": "MyDataSource", "type": "derived", "application": { "detailsUrl": "http://example.com", "name": "Foo Example App", "version": "1" }, "dataType": { "field": [ { "name": "steps", "format": "integer" } ], "name": "com.google.step_count.delta" }, "device": { "manufacturer": "Example Manufacturer", "model": "ExampleTablet", "type": "tablet", "uid": "1000001", "version": "2.0" } }
- 응답
데이터 소스가 성공적으로 업데이트되면 응답은
200 OK
상태입니다. 있습니다. 응답 본문에는 데이터 소스의 JSON 표현이 포함됩니다.- curl 명령어
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X PUT \ --header "Content-Type: application/json;encoding=utf-8" -d @updateds.json \ "https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource"
데이터 소스 소거
이 예에서는 데이터 소스를 삭제하는 방법을 보여줍니다.
- HTTP 메서드
- 삭제
- 요청 URL
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
- 요청 본문
- 없음
- 응답
- 데이터 소스가 삭제되면 응답은
200 OK
입니다. 있습니다. 응답 본문에는 다음과 같은 데이터 소스의 JSON 표현이 포함됩니다. - curl 명령어
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X DELETE \ --header "Content-Type: application/json;encoding=utf-8" \ "https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource"