图谱 API 版

System User

读取

Represents a system user

例子

Graph API Explorer
GET /v19.0/{system-user-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{system-user-id}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{system-user-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{system-user-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{system-user-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
如果你希望详细了解如何使用图谱 API,请阅读我们的图谱 API 指南

参数

这个端点不包含任何参数。

字段

字段描述
id
numeric string

System user ID.

created_by

The creator of this system user.

created_time
datetime

The creation time of this system user.

finance_permission
string

Financial permission role of the user in business manager, such as Editor, Analyst, and so on.

ip_permission
string

Ads right permission role of the user in business manager, such as Reviewer, and so on.

name
string

Name used to identify this system user.

连线

连线描述
Edge<BusinessAssetGroup>

Business asset groups that are assign to this business scoped user

Edge<Page>

Pages that are assigned to this business scoped user

Edge<ProductCatalog>

Product catalogs that are assigned to this business scoped user

错误代码

错误描述
100Invalid parameter
110Invalid user id

创建

你可以通过下列路径向 system_users 连线发出 POST 请求:
发布到这个连线时,将会创建 a SystemUser

参数

参数描述
name
string

Name of system user to be added to this business.

必填
role
enum {FINANCE_EDITOR, FINANCE_ANALYST, ADS_RIGHTS_REVIEWER, ADMIN, EMPLOYEE, DEVELOPER, PARTNER_CENTER_ADMIN, PARTNER_CENTER_ANALYST, PARTNER_CENTER_OPERATIONS, PARTNER_CENTER_MARKETING, PARTNER_CENTER_EDUCATION, MANAGE, DEFAULT, FINANCE_EDIT, FINANCE_VIEW}

Role of system user to be added to this business.

system_user_id
int

ID of system user.

返回类型

这个端点支持先写后读,并会读取返回类型中 id 代表的节点。
Struct {
id: numeric string,
}

错误代码

错误描述
104001In order to create a system user, an app must be part of this business. Please add an app and then try again.
3965This Business Manager has reached maximum number of admin system user limit.
3949This Business Manager has reached maximum number of system user limit.
3972System users can not have duplicate names. Use another name.
100Invalid parameter
200Permissions error
102Session key invalid or no longer valid

更新

你无法在此端点执行该操作。

删除

你无法在此端点执行该操作。