システムユーザーの作成、取得、更新

作成

システムユーザーを作成するには、管理者システムユーザートークンまたは自分の管理者ユーザーのアクセストークンを使います。

注: システムユーザーにアプリの役割を与えることができるのは、システムユーザーとアプリの両方が同じビジネスに属している場合だけです。アプリが別のビジネスに属するシステムユーザーとアクセストークンを使ってデータにアクセスする必要がある場合は、代わりにビジネス代理APIを使ってください。

システムユーザートークンを取得し、API呼び出しを実行するために必要なリクエストは次のとおりです。最初の3つのステップは、ビジネスマネージャでも設定できます。最初のシステムユーザーを作成する場合は、ビジネスマネージャのadminである実ユーザーのアクセストークンを使います。

管理者システムユーザーを作成してトークンを生成する

1. 自分の管理者ユーザーアクセストークンを使って管理システムユーザーを作成します。
2. 管理者ユーザーのアクセストークンを使って、管理者システムユーザーによりアプリをインストールします。
3. 管理者ユーザーのアクセストークンを使って、管理者システムユーザートークンを生成します。

システムユーザーを作成する

1. システムユーザーは、管理者ユーザーのアクセストークンを使って作成します。
2. または、ビジネスマネージャの管理者システムユーザーのアクセストークンが作成済みの場合は、それ使ってシステムユーザーを作成します。

システムユーザーのアクセストークンを生成する

1. 管理者ユーザー、管理者システムユーザー、または別のシステムユーザーのアクセストークンを使って、システムユーザーによりアプリをインストールします。
2. 自分のビジネスマネージャに属するアセット(広告アカウント、ページなど)に、アクセス許可を割り当てます。新しく作成されたシステムユーザーには、管理者ユーザーまたは管理者システムユーザーのアクセストークンを使って、アクセス許可を割り当ててください。
3. 管理者ユーザーまたは管理者システムユーザーのアクセストークンを使って、システムユーザーアクセストークンを生成します。
4. システムユーザーアクセストークンを使って、ビジネスアセットに対するAPI呼び出しを行います。

APIによりシステムユーザーまたは管理者システムユーザーを作成するには、以下が必要です。

• アクセストークン: このビジネスマネージャの管理者ユーザーまたは管理者システムユーザーのアクセストークン
• 役割: ADMINまたはEMPLOYEE
• 名前: このシステムユーザーまたは管理者システムユーザーの識別子

システムユーザーを作成するには、POSTリクエストを発行します。

curl \
-F "name=Ad Server" \
-F "role=EMPLOYEE" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users"

新しいシステムユーザーのapp-scoped idが返されます。

{
  "id" : "100000008899900"
}

これは、システムユーザーのapp-scoped IDです。API呼び出しを実行するには、Business Manager > System UsersのカノニカルIDではなく、このIDを使う必要があります。

取得

システムユーザーのリストを取得するには、管理者ユーザーまたは管理者システムユーザーのアクセストークンが必要です。そのリストには、管理者システムユーザーと、そのapp-scoped IDが含まれています。

GETリクエストを発行します。

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users?access_token=<ACCESS_TOKEN>>"

これは、管理者システムユーザーを含め、ビジネスマネージャが所有するすべてのシステムユーザーのリストを返します。

{
  "data": [
    {
      "id": "1000081799813",
      "name": "Reporting server"
      "role": "ADMIN",
    }, 
  ]
}

更新

システムユーザーまたは管理者システムユーザーの名前を変更することができます。

curl \
-F "system_user_id=<APP_SCOPED_SYSTEM_USER_ID>" \
-F "name=FBX Server" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users"

アクセストークンを無効にする

システムユーザーや管理者システムユーザーを削除することはできませんが、そのユーザーのすべてのアクセストークンを無効にすることはできます。トークンを無効にするには、次の場所に対してDELETEリクエストを送信します。

https://graph.facebook.com/<API_VERSION>/<APP_SCOPED_SYSTEM_USER_ID>/access_tokens

この呼び出しが成功すると、応答としてtrueが返されます。その後、上記のようにして、システムユーザーのための新しいアクセストークンを生成することができます。