概要
システムユーザーを持つには、ビジネスマネージャに次のことが必要です。
- 管理者ユーザーとして実在の人物がいる。
- システムユーザーがアクセスしたいアクセス許可について、Metaアプリのアプリレビュー(およびビジネス認証)を行ってください。
Metaでは、アプリのアクセスレベルに基づき、ビジネスマネージャあたりのシステムユーザー数を制限しています。
このbashスクリプトサンプルは、システムユーザートークンを作成し、そのトークンを使用してマーケティングAPI呼び出しを行うAPI呼び出しを示します。
システムユーザーの種類
システムユーザーには、管理者システムユーザーとシステムユーザーの2種類があります。
- 管理者システムユーザーは、システムユーザーや広告アカウントの作成、アクセス許可の割り当てなどができます。
- システムユーザーは、アクセス許可を持つアセットにのみアクセスできます。
必要なアクセスタイプごとに1つのシステムユーザーを作成するべきです。管理者システムユーザーを使用して、プログラムで適切な役割を確保します。こうすることで、システムユーザートークンが不正利用された場合でも、影響範囲が制限され、これ以上アクセス許可の不正利用ができなくなります。
システムユーザーにアセットへのアクセスを許可し、大部分のAPI呼び出しにシステムユーザーを使用します。管理者システムユーザーの使用は、アクセス許可の割り当てなど、管理アクションだけに用いるよう制限する必要があります。管理者システムユーザーは大部分のアクセスが許可されているため、管理者システムユーザートークンは慎重に保護する必要があります。
しくみは次のとおりです。
ビジネスアセットへのアクセス
ビジネスアセットへのアクセス権を取得するための要件とアクションは次のとおりです。
ビジネス
マーケティングAPIでビジネスマネージャのインスタンスがビジネスとして指定されます。ビジネスマネージャを使用して、マーケティングAPIで開発されるFacebookアプリを申請、作成、共有する必要があります。システムユーザーアクセストークンを作成するには、このアプリにスタンダードアクセスが必要です。トークンの作成が許可されているビジネスのリストに追加するために、Facebook担当者に連絡することもできます。
アセット
ビジネスマネージャに属するアセット。例: ページ、広告アカウントなど。
管理者ユーザー
ビジネスマネージャのすべてのインスタンスに管理者ユーザーがいます。通常、これは元々ビジネスマネージャオブジェクトを作成し、これまで管理しているのと同じ人物です。
管理者システムユーザー
管理者ユーザーはこの特別なタイプのユーザーを作成できます。管理者システムユーザーは新しいユーザーを作成し、ビジネスに属するすべてのアセットにアクセスできます。管理システムユーザーは通常のシステムユーザーよりもパワーがあるため、このユーザータイプを使ってビジネスのアセット管理を行うことは推奨されません。管理者システムユーザーの使用を他のシステムユーザーの作成に制限し、アセットへのアクセスには使わないでください。
システムユーザー
管理者ユーザーまたは管理者システムユーザーがシステムユーザーを作成できます。この人はアセットすべてにアクセスできます。このタイプのユーザーを使用して、ビジネスのアセットの管理を行います。
注: システムユーザーにアプリの役割を与えることができるのは、システムユーザーとアプリの両方が同じビジネスに属している場合だけです。アプリが別のビジネスに属するシステムユーザーとアクセストークンを使ってデータにアクセスする必要がある場合は、代わりにビジネス代理APIを使ってください。
アクセス許可
システムユーザーは、ビジネスが所有するアセットへのアクセス許可をユーザーに付与する必要があります。
システムユーザーアクセストークン
標準アクセスがあるマーケティングAPIのアプリが必要です。ない場合は、Facebook担当者が許可リストにアプリを追加する必要があります。必要なアクセス許可のためにアプリレビュー(および当てはまる場合は認証)を行っていることを確認してください。システムユーザーとこのアプリを使用すると、システムユーザーアクセストークンを生成できます。このトークンを所持しており、システムユーザーからアセットへのアクセス許可を与えられた場合、プログラム的にそれらのアセットにアクセスできます。
システムユーザーとカスタムオーディエンス
システムユーザーがビジネスでカスタムファイルのカスタムオーディエンスに関する操作を行うには、システムユーザー以外のユーザーがビジネスのカスタムオーディエンスの利用規約に同意する必要があります。承認は、そのビジネスに属する広告アカウントから行う必要があります。
カスタムオーディエンス利用規約とシステムユーザーで利用可能なオプションについてご覧ください。
制限
マーケティングAPIのアプリは、特定のアクセスレベルを持ちます。アクセスレベルによって、アプリを所有するビジネスマネージャに対して作成できるシステムユーザーの人数が決まります。
| レベル | システムユーザー | 管理者システムユーザー |
|---|---|---|
標準 | 1 | 1 |
詳細 | 10 | 1 |
クライアントごと、または読み取り/書き込みごとに、応答内のシステムユーザーで広告アカウントをグループ分けできます。多数の広告アカウントを管理している場合は、すべてのUIに読み込むのに時間がかかる場合があります。