建立、擷取和更新系統用戶

如果這是您首次建立系統用戶，則表示您尚未取得管理員系統用戶權杖。開始時請先在企業管理平台中取得真實管理員用戶的存取權杖。

建立

使用您的管理系統用戶權杖或您自己的管理員用戶的存取權杖來建立系統用戶。

注意：只有當系統用戶和應用程式屬於同一企業時，才能授予應用程式的角色給系統用戶。如果您的應用程式需要使用系統用戶和屬於其他企業的存取權杖來存取資料，請改用 Business On Behalf Of API。

以下是取得系統用戶權杖並發出 API 呼叫的必要條件。前三個步驟也可在企業管理平台中進行設定。當您建立第一個系統用戶時，會使用真實用戶的存取權杖，此用戶是企業管理平台的 admin。

建立管理員系統用戶並產生權杖

使用您自己的管理員用戶存取權杖建立管理員系統用戶。
使用管理員用戶的存取權杖透過管理員系統用戶安裝應用程式。
使用管理員用戶的存取權杖產生管理員系統用戶權杖。

建立系統用戶

使用管理員用戶的存取權杖建立系統用戶。
或者，使用企業管理平台的管理系統用戶的存取權杖（如果已建立）建立系統用戶。

產生系統用戶的存取權杖

使用管理員用戶、管理員系統用戶或其他系統用戶的存取權杖透過系統用戶安裝應用程式。
指派權限給屬於您的企業管理平台的素材（例如廣告帳號、粉絲專頁）。應使用管理員用戶或管理員系統用戶的存取權杖將權限指派給新建立的系統用戶。
使用管理員用戶或管理員系統用戶的存取權杖產生系統用戶存取權杖。
現在，使用系統用戶存取權杖對商家素材發出 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"

這會傳回新系統用戶的應用程式範圍 id：

{
  "id" : "100000008899900"
}

這是系統用戶的應用程式範圍編號。您應使用此編號來進行 API 呼叫，而非使用 Business Manager > System Users 中的標準編號。

擷取

若要取得系統用戶清單，您需要管理員用戶或管理員系統用戶存取權杖。此清單包含管理系統用戶及其應用程式範圍編號。

發出 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。之後，您便能為系統用戶產生新的存取權杖，方式如上所述。