Business Management APIs

创建、检索和更新系统用户

如果这是您首次创建系统用户，则您还没有管理员级系统用户口令。首先前往商务管理平台，获取真实管理员用户的访问口令。

创建

使用您的管理员级系统用户口令或您自己的管理员用户访问口令来创建一个系统用户。

注意：仅当系统用户和应用都属于同一个公司时，才能为系统用户授予该应用中的身份。如果您的应用需要使用属于另一家企业的系统用户和访问口令访问数据，请改用企业代管 API。

这里列出了为获取系统用户口令和执行 API 调用，您需要发送的请求。您也可以通过商务管理平台设置前三个步骤。创建首个系统用户时，请使用真实用户的访问口令，而且该用户应该是商务管理平台的 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"

系统会返回新系统用户的应用范围 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。之后，您可以按照上述内容，为此系统用户生成新的访问口令。