このドキュメントでは、Google アナリティクスの Provisioning API の概要を説明します。
はじめに
Provisioning API を使うと、新しい Google アナリティクス アカウントをまとめて作成し、大規模な顧客基盤に対して Google アナリティクスを利用可能にすることができます。Provisioning API は、正規サービス プロバイダや大企業のパートナーなどを対象としています。
たとえば、新規ユーザー登録手続きの一環として、Provisioning API を使ってクライアントの新しい Google アナリティクス アカウントを作成し、さらに Management API リソースを使ってプログラムでアカウントの設定を行い、Google 広告 にリンクすることができます。これらの操作は、すべて自身の管理画面またはレポート画面内で自動化して開始できます。
概要
サービス プロバイダは Provisioning API を使用して、プログラムによって新しい Google アナリティクス アカウントを作成できます。Provisioning API では、次の 2 つの事例をサポートしています。
- ユーザーが独自のウェブサイト(またはウェブ プロパティ)を管理している場合は、ユーザー管理のアナリティクス アカウントを作成します。アカウント作成者にも管理アクセス権は与えられますが、このアカウントを所有、管理するのはエンドユーザーとなります。
- ユーザーに代わってウェブサイト(またはウェブ プロパティ)を所有または管理している場合は、パートナー管理のアナリティクス アカウントを作成します。デフォルトでエンドユーザーはこのアカウントに直接アクセスできないようになっていますが、後でアクセスを許可することはできます。
ユーザー管理のアカウント
Provisioning API を使用して新しいユーザー管理アカウントを作成するための要件と大まかな手順は次のとおりです。
- エンドユーザーは、Google アカウントを持っているか、Google アナリティクスのプロビジョニング フロー中にアカウントを作成する必要があります。
- Google アナリティクスのプロビジョニング フローは、次の 2 つのステップで構成されます。
- エンドユーザーが、自身に代わってアカウントをプロビジョニングする権限をアプリケーションに許可します。
- パートナーが、アカウント チケットを作成する API 呼び出しを行います。
- エンドユーザーが、Google アナリティクス利用規約(TOS)とデータ共有設定ポリシーに同意します。
- アプリケーションがエンドユーザーに代わってアカウントを作成します。
新しく作成されたアカウントは、アプリケーションから管理され、アプリケーションからアクセスできるようになります。
ユーザー管理のアナリティクス アカウントを作成する方法については、ユーザー管理アカウント API デベロッパー ガイドをご覧ください。
パートナー管理アカウント
パートナー管理のアナリティクス アカウントを作成するための大まかな手順は次のとおりです。
- パートナーが Provisioning API サービスの利用規約に同意します。なお、すべてのパートナー管理アカウントに適用される Google アナリティクスの利用規約にも同意する必要があります。この手順を行うのは一度だけです。
- 関連する API 呼び出しを実行してアカウントを作成します。
パートナー管理のアナリティクス アカウントを作成する方法については、パートナー管理アカウント API デベロッパー ガイドをご覧ください。