REST API を使ってみる

このチュートリアルでは、Fitness REST API へのアクセスを有効にし、OAuth アクセスを取得する方法について説明します HTTP リクエストを使用して API メソッドを呼び出します。

Fitness REST API を使用するには、 RESTful ウェブサービス JSON 表現を使用できます。

Google アカウントを取得する

Fitness REST API を使用するには、Google アカウントが必要です。 すでにアカウントをお持ちの場合は、これで完了です。その他のおすすめ テスト用に別の Google アカウントを作成

OAuth 2.0 クライアント ID をリクエストする

Fitness API の OAuth 2.0 クライアント ID をリクエストする手順は次のとおりです。

  1. <ph type="x-smartling-placeholder"></ph>に行く Google API Console
  2. プロジェクトを選択するか、新しいプロジェクトを作成します。同じプロジェクトを Android 作成する方法も学習します
  3. [続行] をクリックして、Fitness API を有効にします。
  4. [認証情報に進む] をクリックします。
  5. [新しい認証情報] をクリックし、[OAuth クライアント ID] を選択します。
  6. [アプリケーションの種類] で、[ウェブ アプリケーション] を選択します。
  7. [承認済みの JavaScript 生成元] で、サイトのベース URL を入力します。 リクエストの送信元(例: https://developers.google.com) OAuth Playground で使用される URL です)。
  8. [承認済みのリダイレクト URI] に、レスポンスがあるサイトの URL を入力します。 処理される(https://developers.google.com/oauthplayground など) OAuth Playground で使用される URL です)。
  9. [作成] をクリックします。新しい OAuth 2.0 クライアント ID とシークレットがリストに表示されます。 作成する必要があります。OAuth 2.0 クライアント ID は文字列で、 次のようになります。

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

OAuth Playground で REST API を試す

OAuth Playground を使用すると、Google Cloud で OAuth の Fitness REST API を使用して、HTTP リクエストを送信し、 クライアント コードを記述できます。

OAuth Playground で Fitness REST API を承認するには:

  1. OAuth Playground に移動します。
  2. [Step 1 Select &API を承認し、[Fitness v1] を展開して 使用するフィットネス スコープ。
  3. [Authorize APIs] ボタンをクリックし、使用する Google API Console プロジェクトを選択します。 使用して [許可] をクリックします。以下の機能にアクセスして、 選択した Google API Console アカウントに関連付けられているデータを変更する。
  4. [Exchange authorization code for tokens] ボタンをクリックします。OAuth プレイグラウンドでは、このヘッダーを Authorization: に自動的に含めます。 リクエスト ヘッダー。なお、アクセス トークンは 60 分(3,600 秒)で期限切れになります。

HTTP リクエストを送信する

次の例では、HTTP リクエストを送信してすべての 新しいデータソースを作成できますFitness REST の場合 URI の形式は次のとおりです。

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

利用可能なすべてのデータソースを一覧表示するには:

  1. [HTTP Method] で、[GET] を選択します。
  2. [リクエスト URI] に「https://www.googleapis.com/fitness/v1/users/me/dataSources」と入力します。
  3. [Send the request](リクエストを送信)をクリックします。

リクエストとレスポンスがページの右側に表示されます。もし 成功した場合は、前のステップのデータソースが JSON 形式の例です

データソースを作成するには:

  1. [HTTP Method] で、[POST] を選択します。
  2. [リクエスト URI] に「https://www.googleapis.com/fitness/v1/users/me/dataSources」と入力します。
  3. [リクエスト本文を入力] をクリックします。
  4. 次の JSON をコピーして、[Request Body] ウィンドウに貼り付けます。

    {
      "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. [Send the request](リクエストを送信)をクリックします。

リクエストとレスポンスがページの右側に表示されます。リクエスト Authorization ヘッダーに OAuth アクセス トークンを含めます。

Authorization: Bearer ya29.OAuthTokenValue

リクエストが成功すると、レスポンスの最初の行は次のようになります。

HTTP/1.1 200 OK

cURL を使用して Fit REST API にアクセスする

cURL コマンドライン ツールを使用して、 Fit REST APIリクエストを行うには OAuth アクセス トークンが必要です cURL を使用します(上記の手順をご覧ください)。 アクセス トークンの有効期限は 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 の詳細については、次のページをご覧ください。