はじめてのアナリティクス Reporting API v4: ウェブ アプリケーション向け JavaScript クイックスタート

このチュートリアルでは、アナリティクス Reporting API v4 にアクセスする手順を詳しく説明します。

1. API を有効にする

アナリティクス Reporting API v4 を使用するには、まずセットアップ ツールの手順に沿って Google API Console でプロジェクトを作成し、API を有効にして、認証情報を作成する必要があります。

注: ウェブ クライアント ID またはインストール済みアプリケーション クライアントを作成するには、同意画面でプロダクト名を設定する必要があります。まだ設定していない場合は、同意画面を設定するように求められます。

認証情報を作成

  • [認証情報] ページを開きます。
  • [認証情報を作成] をクリックし、[OAuth クライアント ID] を選択します。
  • [アプリケーションの種類] で [ウェブ アプリケーション] を選択します。
  • クライアント ID に「quickstart」という名前を付け、[作成] をクリックします。
  • [承認済みの JavaScript 生成元] を http://localhost:8080 に設定します。
  • [作成] をクリックします。

2. サンプルをセットアップする

HelloAnalytics.html というファイル名を 1 つ作成する必要があります。このファイルには、この例の HTML コードと JavaScript コードが含まれます。

  • 次のソースコードをコピーするかダウンロードして、HelloAnalytics.html にします。
  • <REPLACE_WITH_CLIENT_ID> は、上記で作成したクライアント ID に置き換えます。
  • <REPLACE_WITH_VIEW_ID> は、ビュー ID に置き換えます。ビュー ID はアカウント エクスプローラから取得できます。
<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>Hello Analytics Reporting API V4</title>
  <meta name="google-signin-client_id" content="<REPLACE_WITH_CLIENT_ID>">
  <meta name="google-signin-scope" content="https://www.googleapis.com/auth/analytics.readonly">
</head>
<body>

<h1>Hello Analytics Reporting API V4</h1>

<!-- The Sign-in button. This will run `queryReports()` on success. -->
<p class="g-signin2" data-onsuccess="queryReports"></p>

<!-- The API response will be printed here. -->
<textarea cols="80" rows="20" id="query-output"></textarea>

<script>
  // Replace with your view ID.
  var VIEW_ID = '<REPLACE_WITH_VIEW_ID>';

  // Query the API and print the results to the page.
  function queryReports() {
    gapi.client.request({
      path: '/v4/reports:batchGet',
      root: 'https://analyticsreporting.googleapis.com/',
      method: 'POST',
      body: {
        reportRequests: [
          {
            viewId: VIEW_ID,
            dateRanges: [
              {
                startDate: '7daysAgo',
                endDate: 'today'
              }
            ],
            metrics: [
              {
                expression: 'ga:sessions'
              }
            ]
          }
        ]
      }
    }).then(displayResults, console.error.bind(console));
  }

  function displayResults(response) {
    var formattedJson = JSON.stringify(response.result, null, 2);
    document.getElementById('query-output').value = formattedJson;
  }
</script>

<!-- Load the JavaScript API client and Sign-in library. -->
<script src="https://apis.google.com/js/client:platform.js"></script>

</body>
</html>

3: サンプルを実行する

  • HelloAnalytics.html をウェブサーバーに公開し、ブラウザでページを読み込みます。
  • [ログイン] ボタンをクリックして、Google アナリティクスへのアクセスを承認します。

以上の手順が完了すると、サンプルコードによって、指定されたビューの過去 7 日間のセッション数が出力されます。