Graph API-Version

Business Agencies

Wird gelesen

List all businesses that have access to your business's assets.

Beispiel

Graph API Explorer
GET /v21.0/{business-id}/agencies 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}/agencies',
    '{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}/agencies",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{business-id}/agencies",
    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}/agencies"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
Weitere Informationen zur Verwendung der Graph API findest du in unserem Graph API-Leitfaden.

Parameter

Dieser Endpunkt hat keine Parameter.

Felder

Beim Lesen dieses Edge wird ein Ergebnis im JSON-Format ausgegeben:

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

data

Eine Liste von Business-Nodes.

Die folgenden Felder werden zu jedem Node hinzugefügt, der zurückgegeben wird:

FeldBeschreibung
adaccount_permissions
list<AdAccountPermission>

Adaccount_permissions

application_permissions
list<AppPermission>

Application_permissions

page_permissions
list<PagePermission>

Page_permissions

productcatalog_permissions
list<ProductCatalogPermission>

Productcatalog_permissions

shared_ca_count
int32

Shared_ca_count

paging

Weitere Informationen zur Paginierung findest du im Graph API-Leitfaden.

summary

Gesammelte Informationen zum Edge (z. B. Aufrufe). Gib im Parameter „summary“ an, welche Felder einbezogen werden sollen (z. B. summary=total_count).

FeldBeschreibung
total_count
unsigned int32

Total number of businesses.

Error Codes

FehlerBeschreibung
190Invalid OAuth 2.0 Access Token

Wird erstellt

Diese Handlung kann auf diesem Endpunkt nicht durchgeführt werden.

Wird aktualisiert

Diese Handlung kann auf diesem Endpunkt nicht durchgeführt werden.

Wird gelöscht

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

Parameter

ParameterBeschreibung
business
numeric string or integer

The agency's business.

erforderlich

Rückgabetyp

Struct {
success: bool,
}

Error Codes

FehlerBeschreibung
100Invalid parameter