アカウント管理

Google アナリティクス Management API を使用すると、プログラムによってアカウント、プロパティ、ビューにアクセスすることができます。このドキュメントでは、さまざまな API リソースを使用して、Google アナリティクス アカウントを設定する方法を紹介します。

はじめに

Google アナリティクスのアカウント設定を行う際、Management API を 2 つの一般的な用途に使用できます。1 つ目は、アカウント、プロパティ、ビューの階層ツリーによるアカウントの概要を得ることです。2 つ目は、特定の構成の変更です。

アカウントの概要

アカウントの概要エンドポイントは、認証済みユーザーの Google アナリティクスのアカウント、プロパティ、ビューについての簡易情報を、1 回のリクエストで簡単に一覧表示する方法を提供します。

アカウントの概要を使用して、アカウントの階層構造のインデックスの作成が可能です。Google アナリティクスと統合されるアプリケーションでは、ユーザーがアカウント、プロパティ、ビューを選択できるインターフェースを提供することがよくあります。API への 1 回のリクエストで、そうしたセレクタを作成するための関連情報すべてを取得できます。使用例については、Query ExplorerGitHub のコードサンプルをご覧ください。

詳細とコードサンプルについては、アカウントの概要のリソース リファレンスlist メソッド リファレンスをご覧ください。

アカウントの設定

アカウントプロパティビューの各リソースの list メソッドを使用したアカウントの概要とは対照的に、API は各リソースの詳細情報を返します。

アカウント

最上位エンティティであるアカウントは重要です。下位レベルのすべての API リクエストでアカウント ID が必要になるためです。管理 API は、アカウントに対して list 操作のみを許可します。API レスポンスに含まれている childlink プロパティは、すべての子ウェブ プロパティに対する API リクエストを提供します。

プロパティ

ウェブ プロパティとも呼ばれるこの第 2 レベルのエンティティは、すべてのデータ収集がこのレベルで行われる点において重要です。たとえば、ウェブサイトやモバイルアプリにトラッキング コードを追加する場合は、UA-XXXXX-Y のような ID を含める必要があります。この ID はプロパティ ID またはトラッキング ID と呼ばれ、Google アナリティクス アカウントのデータの保存場所を区別します。API を使用してプロパティを作成または更新できます。詳細とコードサンプルについては、プロパティ リソースをご覧ください。

回視聴

アカウント階層内の第 3 レベルのビュー(プロファイル)は、レポートが実行されるレベルであるという点において重要です。Core Reporting API は、ビュー(プロファイル)ID をキーパラメータとして、データを取得するビューを指定します。レポートレベル以外にも、目標テスト非サンプリング レポートフィルタリンクなど、他の多くのリソースがリンクされているか、このリソースの子リソースになっています。API を使用してビューを作成または更新できます。詳細とコードサンプルについては、ビュー(プロファイル)リソースをご覧ください。

次のステップ

このガイドを通して、Management API を使用してアカウント設定のエンティティを横断し操作する方法を理解できたはずです。次のガイドでは、API を使用してユーザー管理を行う方法を学びます。