Graph 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
}];

如果想了解如何使用 Graph API，請參閱我們的使用 Graph API 指南。

參數

這個端點沒有任何參數。

欄位

由此關係連線進行的閱讀將回傳 JSON 格式結果：

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

`data`

AdAccountBusinessConstraints 節點的清單。

`paging`

如需更多有關分頁的詳細資料，請參閱 Graph API 指南。

Error Codes

錯誤	說明
190	Invalid OAuth 2.0 Access Token
100	Invalid parameter
200	Permissions error
613	Calls to this api have exceeded the rate limit.

建立中

You can make a POST request to account_controls edge from the following paths:

/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,

}

Error Codes

錯誤	說明
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.

你無法在此端點執行此操作。

正在刪除

你無法在此端點執行此操作。