このドキュメントでは、Google アナリティクス Management API バージョン 3.0 の概要を説明します。
はじめに
Analytics Management API を使用すると、Google アナリティクスの設定データにプログラムでアクセスできます（ユニバーサル アナリティクスのみ）。大規模なアナリティクス アカウントや複雑なアナリティクス アカウントを効率的に管理するためのアプリケーションを構築できます。多数のプロパティを持つ大企業は、アカウント設定を自動化できます。レポート アプリケーションを作成する場合でも、Management API のアカウント操作ツールを利用できます。
Google アナリティクスの Management API を使用すると、次のことができます。
- ユーザーのアカウント、プロパティ（ユニバーサル アナリティクスのみ）、ビュー（旧プロファイル）のすべての情報を一覧表示します。
- プロパティ（ユニバーサル アナリティクスのみ）、ビュー（プロファイル）、目標を管理します。
- アカウントの階層構造に対するユーザー権限を管理する
- Core Reporting API で使用するビュー（旧プロファイル）の ID を取得する。
- 有効な目標を特定し、その目標に設定されている名前にアクセスする。
- アナリティクス プロパティ（ユニバーサル アナリティクスのみ）と Google 広告アカウントのリンクを管理します。
- リマーケティング オーディエンス を管理する。
Google アナリティクス Management API を使用する前に、アナリティクスのアカウント構造について理解しておくことが重要です。Google アナリティクス アカウントは複数のレベルで構成され、Management API では各レベルのエンティティをプログラマティックに操作できます。
Management API の使用
Google アナリティクス API を使用するには、まずデベロッパー コンソールでプロジェクトを作成する必要があります。その過程で、作成するアプリケーションのタイプ（ ウェブ アプリケーション、サービス アプリケーション、インストール済みアプリケーション）を指定する必要があります。Google アナリティクス API は認証と認可に OAuth 2.0 プロトコルを使用するため、デベロッパー コンソールでは適切な認証キーを作成する手順が順を追って示されます。さまざまな言語に対応したクライアント ライブラリも用意されています。クライアント ライブラリを使用すると、ユーザーがアプリケーションを承認し、適切な スコープを使用して Google アナリティクス データにアクセスできるようにするための適切なフローを構築できます。
ドキュメントの利用
このドキュメントと後続のガイドでは、最初にアプリケーションを起動して実行するために役立ちます。その後、ドキュメントでは、API を操作してアカウント、ユーザー、データの管理などを行うのに役立つ、さまざまなトピックについて詳しく説明します。また、 リファレンス ドキュメント一式も用意されており、各 API エンドポイントの各パラメータの詳細や API のサンプルコードを確認できます。
次のステップ
新しい API で機能するアプリケーションを取得するには、常にいくつかの課題が伴います。次のセクションでは、すぐに使い始めるのに役立つクイック スタートガイドを紹介します。以下からプログラム言語とアプリケーションの種類を選択してください。
| サービス アプリケーション | インストール済みのアプリケーション | ウェブ アプリケーション |
|---|---|---|
| Java | Java | -- |
| Python | Python | -- |
| PHP | -- | PHP |
| -- | -- | JavaScript |