API Marketing
Version API du graphe

Business Clients

Lecture

List all businesses that gave you access to one or more of their assets.

Exemple

Graph API Explorer
GET /v21.0/{business-id}/clients 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(
    '/{business-id}/clients',
    '{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(
    "/{business-id}/clients",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{business-id}/clients",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{business-id}/clients"
                                      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": {},
    "summary": {}
}

data

Une liste de nœuds Business.

Les champs suivants seront ajoutés à chaque nœud renvoyé :

ChampDescription
adaccount_permissions
list<AdAccountPermission>

Adaccount_permissions

Par défaut
application_permissions
list<AppPermission>

Application_permissions

Par défaut
page_permissions
list<PagePermission>

Page_permissions

Par défaut
productcatalog_permissions
list<ProductCatalogPermission>

Productcatalog_permissions

Par défaut
shared_ca_count
int32

Shared_ca_count

Par défaut

paging

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

summary

Informations agrégées relatives à l’arête, par exemple le nombre. Indiquez les champs à récupérer dans le paramètre récapitulatif (par exemple récapitulatif=total_count).

ChampDescription
total_count
unsigned int32

Total number of businesses.

Error Codes

ErreurDescription
190Invalid OAuth 2.0 Access Token
200Permissions error

Création

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

Mise à jour

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

Suppression

You can dissociate a Business from a Business by making a DELETE request to /{business_id}/clients.

Paramètres

ParamètreDescription
business
numeric string or integer

The client's business.

Obligatoire

Type de retour

Struct {
success: bool,
}

Error Codes

ErreurDescription
100Invalid parameter