Version API du graphe

Ad Account Account Controls

Lecture

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.

Exemple

Graph API Explorer
GET /v19.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
}];
Pour apprendre à utiliser l’API Graph, consultez notre guide Utiliser l’API Graph.

Paramètres

Ce point de terminaison n’a aucun paramètre.

Champs

La lecture à partir de cette arête renverra un résultat au format JSON :

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

data

Une liste de nœuds AdAccountBusinessConstraints.

paging

Pour plus de détails à propos de la pagination, voir Guide de l’API Graph.

Error Codes

ErreurDescription
100Invalid parameter
190Invalid OAuth 2.0 Access Token
200Permissions error

Création

You can make a POST request to account_controls edge from the following paths:
When posting to this edge, an AdAccountBusinessConstraints will be created.

Paramètres

ParamètreDescription
audience_controls
JSON or object-like arrays

audience_controls

Obligatoire
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}>

Type de retour

Struct {
id: string,
success: bool,
error_code: string,
error_message: string,
}

Error Codes

ErreurDescription
100Invalid parameter
2641Your ad includes or excludes locations that are currently restricted

Mise à jour

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

Vous ne pouvez pas effectuer cette opération sur ce point de terminaison.

Suppression

Vous ne pouvez pas effectuer cette opération sur ce point de terminaison.