REST API 시작하기

이 튜토리얼에서는 피트니스 REST API에 대한 액세스를 활성화하고 OAuth 액세스 권한을 얻는 방법을 보여줍니다. 토큰을 확인하고, HTTP 요청을 사용하여 API 메서드를 호출할 수 있습니다.

Fitness REST API를 사용하려면 RESTful 웹 서비스 JSON 표현이 포함됩니다

Google 계정 만들기

피트니스 REST API를 사용하려면 Google 계정이 필요합니다. 계정이 있는 경우 별도의 조치를 취할 필요가 없습니다. 또한 테스트용으로 별도의 Google 계정을 만들어야 합니다.

OAuth 2.0 클라이언트 ID 요청

Fitness API용 OAuth 2.0 클라이언트 ID를 요청하려면 다음 단계를 따르세요.

  1. Google API 콘솔을 참조하세요.
  2. 프로젝트를 선택하거나 새로 만듭니다. Android에서 동일한 프로젝트 사용 앱의 REST 버전을 제공합니다
  3. 계속을 클릭하여 Fitness API를 사용 설정합니다.
  4. 사용자 인증 정보로 이동을 클릭합니다.
  5. 새 사용자 인증 정보를 클릭하고 OAuth 클라이언트 ID를 선택합니다.
  6. 애플리케이션 유형 아래에서 웹 애플리케이션을 선택합니다.
  7. 승인된 자바스크립트 원본에 사이트의 기준 URL을 입력합니다. 요청이 시작되는 위치 (예: https://developers.google.com) 는 OAuth Playground에서 사용하는 URL입니다.
  8. 승인된 리디렉션 URI에서 응답이 있는 사이트의 URL을 입력합니다. 처리됩니다 (예: https://developers.google.com/oauthplayground). 는 OAuth Playground에서 사용하는 URL입니다.

  9. 만들기를 클릭합니다. 새 OAuth 2.0 클라이언트 ID 및 비밀번호가 목록에 표시됩니다. 프로젝트 ID입니다 OAuth 2.0 클라이언트 ID는 문자열이며, 다음과 같습니다.

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

OAuth Playground에서 REST API 사용해 보기

OAuth 플레이그라운드는 API에 익숙해지는 가장 쉬운 방법입니다. 피트니스 REST API를 사용하기 전에 HTTP 요청을 제출하고 응답을 관찰 클라이언트 코드를 작성할 수 있습니다

OAuth 플레이그라운드에서 피트니스 REST API를 승인하려면 다음 안내를 따르세요.

  1. OAuth 플레이그라운드로 이동합니다.
  2. 1단계에서 승인하고 Fitness v1을 펼친 다음 피트니스 범위
  3. API 승인 버튼을 클릭하고 다음을 수행할 Google API 콘솔 프로젝트를 선택합니다. 메시지가 표시되면 허용을 클릭합니다. 이 기능을 사용하면 선택한 Google API 콘솔 계정과 연결된 데이터 수정
  4. 승인 코드를 토큰으로 교환 버튼을 클릭합니다. OAuth 플레이그라운드는 Authorization:에 이 헤더를 자동으로 포함합니다. 요청 헤더에 사용해야 합니다. 액세스 토큰은 60분 (3,600초) 후에 만료됩니다.

HTTP 요청 제출

다음 예는 HTTP 요청을 전송하여 모든 새 데이터 소스를 만들 수 있습니다. 피트니스 REST용 API의 경우 URI 형식은 다음과 같습니다.

https://www.googleapis.com/fitness/v1/resourcePath?parameters

사용 가능한 모든 데이터 소스를 나열하는 방법은 다음과 같습니다.

  1. HTTP 메서드에서 GET을 선택합니다.
  2. 요청 URI에 https://www.googleapis.com/fitness/v1/users/me/dataSources를 입력합니다.
  3. 요청 보내기를 클릭합니다.

요청과 응답이 페이지 오른쪽에 표시됩니다. 만약 요청이 성공하면 응답에는 이전 요청의 데이터 소스가 JSON 형식의 예입니다

데이터 소스를 만드는 방법은 다음과 같습니다.

  1. HTTP 메서드에서 POST를 선택합니다.
  2. 요청 URI에 https://www.googleapis.com/fitness/v1/users/me/dataSources를 입력합니다.
  3. 요청 본문 입력을 클릭합니다.

  4. 요청 본문 창에서 다음 JSON을 복사하여 붙여넣습니다.

    {
  "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"
  }
}

  5. Request Body(요청 본문) 창에서 Close(닫기)를 클릭합니다.

  6. 요청 보내기를 클릭합니다.

요청과 응답이 페이지 오른쪽에 표시됩니다. 요청 Authorization 헤더에 OAuth 액세스 토큰이 포함됩니다.

Authorization: Bearer ya29.OAuthTokenValue

요청이 성공하면 응답의 첫 번째 줄은 다음과 같습니다.

HTTP/1.1 200 OK

cURL을 사용하여 피트니스 REST API에 액세스

cURL 명령줄 도구를 사용하여 피트니스 REST API. 요청하려면 OAuth 액세스 토큰이 필요합니다. (이전 안내 참고) 액세스 토큰은 1시간 후에 만료됩니다. 다음 예는 간단한 bash 스크립트를 사용하여 모든 데이터 소스를 나열합니다.

#!/bin/bash
ACCESS_TOKEN=""
curl \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  https://www.googleapis.com/fitness/v1/users/me/dataSources

다음 단계

REST API에 대해 자세히 알아보려면 다음 페이지를 참조하세요.