图谱 API 版

Ad Account Account Controls

读取

Get default fields on an AdAccountBusinessConstraints node associated with this AdAccount. Refer to the AdAccountBusinessConstraints reference for a list of these fields and their descriptions.

例子

Graph API Explorer

GET /v21.0/{ad-account-id}/account_controls 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(
    '/{ad-account-id}/account_controls',
    '{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(
    "/{ad-account-id}/account_controls",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{ad-account-id}/account_controls",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{ad-account-id}/account_controls"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

如果你希望详细了解如何使用图谱 API，请阅读我们的图谱 API 指南。

参数

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

字段

从这条连线读取将返回一个 JSON 格式的结果：

{
    "data": [],
    "paging": {}
}

`data`

AdAccountBusinessConstraints 节点列表。

`paging`

详细了解分页功能，请见图谱 API 指南。

错误代码

错误	描述
190	Invalid OAuth 2.0 Access Token
100	Invalid parameter
200	Permissions error
613	Calls to this api have exceeded the rate limit.

创建

你可以通过下列路径向 account_controls 连线发出 POST 请求：

/act_{ad_account_id}/account_controls

发布到这个连线会创建 an AdAccountBusinessConstraints 。

参数

参数	描述
`audience_controls` JSON or object-like arrays	audience_controls 必填
`age_min` int64
`geo_locations` JSON or object-like arrays
`excluded_geo_locations` JSON or object-like arrays
`exclusions` JSON or object-like arrays
`placement_controls` JSON or object-like arrays	This field contains another field called placement_exclusion that provides information on which placements need to be excluded while targeting. All the other placements will be included. Each placement is denoted by a string that concatenates the publisher platform of the placement and a position inside the publisher platform, separated by an underscore. What is provided as parameter is a list of placements. For e.g. If we want to exclude the rewarded videos position from the audience network publisher platform, we provide the field as follows: { "placement_controls": { "placement_exclusions": ["audience_network_rewarded_video"] } } Only a few placements are allowed to be excluded: audience_network_classic (native, banner & interstitial positions of audience network) audience_network_rewarded_video (rewarded videos of audience network) audience_network_instream_video (instream videos of audience network) facebook_marketplace (marketplace section inside facebook) facebook_rhc (right hand column inside facebook)
`placement_exclusions` array<enum {AUDIENCE_NETWORK_CLASSIC, AUDIENCE_NETWORK_REWARDED_VIDEO, AUDIENCE_NETWORK_INSTREAM_VIDEO, FACEBOOK_MARKETPLACE, FACEBOOK_RIGHT_HAND_COLUMN}>

返回类型

Struct {

id: string,

success: bool,

error_code: string,

error_message: string,

}

错误代码

错误	描述
100	Invalid parameter
2641	Your ad includes or excludes locations that are currently restricted
200	Permissions error

更新

Use the POST /act_<AD_ACCOUNT_ID>/account_controls endpoint to update the AdAccountBusinessConstraints associated with this AdAccount.

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

删除

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