REST API 시작하기

이 튜토리얼에서는 Fitness REST API에 대한 액세스를 활성화하고, OAuth 액세스 토큰을 가져오고, HTTP 요청을 사용하여 API 메서드를 호출하는 방법을 보여줍니다.

피트니스 REST API를 사용하려면 RESTful 웹 서비스 및 JSON 표현의 기본사항을 이해하는 것이 중요합니다.

Google 계정 만들기

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

OAuth 2.0 클라이언트 ID 요청

다음 단계에 따라 Fitness API의 OAuth 2.0 클라이언트 ID를 요청합니다.

  1. <ph type="x-smartling-placeholder"></ph>(으)로 이동 Google API 콘솔을 참조하세요.
  2. 프로젝트를 선택하거나 새로 만듭니다. 앱의 Android 버전과 REST 버전에 동일한 프로젝트를 사용합니다.
  3. 계속을 클릭하여 Fitness API를 사용 설정합니다.
  4. 사용자 인증 정보로 이동을 클릭합니다.
  5. 새 사용자 인증 정보를 클릭한 다음 OAuth 클라이언트 ID를 선택합니다.
  6. 애플리케이션 유형 아래에서 웹 애플리케이션을 선택합니다.
  7. 승인된 JavaScript 출처에 요청이 시작되는 사이트의 기본 URL을 입력합니다(예: https://developers.google.com는 OAuth 플레이그라운드에서 사용하는 URL임).
  8. 승인된 리디렉션 URI에 응답이 처리될 사이트의 URL을 입력합니다(예: https://developers.google.com/oauthplayground은 OAuth 플레이그라운드에서 사용하는 URL임).

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

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

OAuth 플레이그라운드에서 REST API 사용해 보기

OAuth 플레이그라운드는 클라이언트 코드를 작성하기 전에 HTTP 요청을 제출하고 응답을 관찰하여 Fitness REST API를 익히는 가장 쉬운 방법입니다.

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

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

HTTP 요청 제출

다음 예는 HTTP 요청을 전송하여 사용 가능한 모든 데이터 소스를 나열하고 새 데이터 소스를 만드는 방법을 보여줍니다. Fitness 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 메서드에서 게시를 선택합니다.
  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 창에서 닫기를 클릭합니다.

  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에 관한 자세한 내용은 다음 페이지를 참고하세요.