コマンドラインを使用した API クイックスタート

このページでは、次のコマンドを使用して Google アナリティクス Data API v1 の使用を開始する方法について説明します。 追加します。

ステップ 1. API を有効にする

次のボタンをクリックすると、新しい Google Cloud プロジェクトが自動的に作成されます Google Analytics Data API v1 を有効にして、必要な OAuth2 認証情報を作成する チュートリアル:

Google アナリティクス Data API v1 を有効にする

OAuth2 認証情報の設定に自動的にリダイレクトされます クリックします。[Where are you called from?] というダイアログが表示されたら、 パソコン:

表示されたダイアログで、[クライアント構成をダウンロード] をクリックして、ファイルを保存します。 credentials.json で作業ディレクトリに移動します。

または、こちらの手順に沿って OAuth2 クライアントを 認証情報を既存の プロジェクトを手動で構成できます。

ステップ 2. Cloud SDK をインストールし、初期化する

gcloud コマンドライン ツールをインストールします。

ステップ 3: API 呼び出しを行う

Google Analytics Data API を使って Google アナリティクスのデータを プロパティです。

レポート エンティティを選択

このチュートリアルでは、環境変数 GA_PROPERTY_ID を使用して、 API リクエストで使用するプロパティ ID。

コマンドラインで次のように入力して、GA_PROPERTY_ID 変数を設定します。

export GA_PROPERTY_ID=[YOUR_GA_PROPERTY_ID]

[YOUR_GA_PROPERTY_ID] を、実際の Google アナリティクスのプロパティに置き換えます。 ID で識別されます。例:

export GA_PROPERTY_ID=1234567890

リクエスト JSON を作成する

次の request.json ファイルは、シンプルなレポートの作成方法を示しています。

次のテキストを含む JSON リクエスト ファイルを作成し、 作業ディレクトリにある書式なしテキスト ファイル request.json

request.json

{
  "dateRanges": [{ "startDate": "2020-09-01", "endDate": "2020-09-15" }],
  "dimensions": [{ "name": "country" }],
  "metrics": [{ "name": "activeUsers" }]
}

認証

この例でユーザー認証情報を取得するには、次のコマンドを実行して ステップ 1 でダウンロードした認証情報 JSON ファイルのパス

gcloud auth application-default login \
    --scopes=https://www.googleapis.com/auth/analytics.readonly \
    --client-id-file=[PATH/TO/credentials.json]

新しいブラウザ ウィンドウで OAuth ユーザーの同意ダイアログが開きます。

リクエストを送信する

curlrequest.json の本文の内容を使用して、リクエストを Google Analytics Data API です。コマンドラインで次のように入力します。

  curl -X POST \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
  -H "Content-Type: application/json; charset=utf-8" \
  https://analyticsdata.googleapis.com/v1beta/properties/$GA_PROPERTY_ID:runReport -d @request.json

curl コマンドでは、gcloud auth application-default print-access-token を使用します。 コマンドを実行して認証トークンを取得します。

なお、curl にファイル名を渡すには、-d オプション(「data」の意味)を使用します。 ファイル名の前に @ 記号を付けます。このファイルは同じディレクトリに配置する必要があります。 ここで curl コマンドを実行します。