Seiten

Unternehmen können Seiten beanspruchen, die ihnen gehören. So können Administrator*innen ganz einfach Personen den Seiten zuweisen, auf die sie Zugriff benötigen.

Seiten beanspruchen

Unternehmen können eine ihnen gehörende Seite als Eigentümer beanspruchen, sodass sie alle Aspekte der Seite verwalten können und auch Agenturen oder andere Unternehmen, denen Zugriff gewährt wurde, entfernen können. Alternativ können Unternehmen auch den Agenturzugriff auf eine Seite beantragen, sodass sie über Werbekonten, auf die sie Zugriff haben, Anzeigen auf der Seite schalten können.

Seiten als Eigentümer beanspruchen

Um eine Seite für dein Unternehmen als OWNER zu beanspruchen, benötigst du die Seiten-ID und die Unternehmens-ID. Sende dann eine POST-Anfrage:

Der Anfordernde benötigt Folgendes:

• Admin-Berechtigung für die Seite
• Berechtigung für das Eigentümerunternehmen oder Eigentümer*in des Eigentümerunternehmens muss die Anfrage genehmigen

Um diese Anfrage zu stellen, musst du den Zugriffsschlüssel eines Admin-Nutzers oder Admin-Systemnutzers deines Unternehmens verwenden. Wenn der*die Nutzer*in, der*die den Aufruf tätigt, seit mehr als 7 Tagen Seitenadministrator*in oder MANAGER der Seite ist, wird das Unternehmen sofort zum Besitzer der Seite. Facebook gibt access_status in der Antwort mit dem Wert CONFIRMED zurück. Wenn der*die Nutzer*in seit 7 Tagen oder weniger Seitenadministrator*in oder MANAGER der Seite ist, wird die API-Anfrage nicht automatisch genehmigt.

Wenn der*die Nutzer*in, der*die einen OWNER-Beanspruchungsaufruf tätigt, nicht die richtigen Berechtigungen für die Seite hat, schlägt der Aufruf fehl. Im Gegensatz zum Beanspruchen eines Werbekontos wird hierbei keine Anfrage an die Seitenadministrator*innen zur Genehmigung gesendet.

curl \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

Seiten als Agentur beanspruchen

Um eine Seite für dein Unternehmen als AGENCY zu beanspruchen, benötigst du die Seiten-ID. Sende dann eine POST-Anfrage:

Wenn der Anfordernde eine Admin-Berechtigung für die Seite besitzt, wird diese Anfrage automatisch genehmigt. Wenn nicht, muss der Seiten-Admin die Anfrage genehmigen

Die Agentur kann die Seite nicht erneut mit einem anderen Unternehmen teilen.

Die Agentur kann sofort (über Werbekonten, auf die sie Zugriff haben) Anzeigen auf der Seite schalten.

curl \
  -F "page_id=<PAGE_ID>" \
  -F "permitted_tasks=['ADVERTISE', 'ANALYZE']" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

Bei Verwendung von AGENCY gilt Folgendes:

• Du musst permitted_tasks angeben.
• Ein Unternehmen muss die Seite besitzen.
• Der Zugriffsschlüssel muss über die Berechtigungen pages_manage_metadata und pages_show_list verfügen.

Wenn du AGENCY-Zugriff beanspruchst, aber nicht über die richtigen Seitenberechtigungen verfügst, lautet die Antwort PENDING. Der*die Administrator*in dieser Seite kann sich anmelden und den Zugriff gewähren, ihn ablehnen oder die Beanspruchung als Spam melden. Wenn ein Unternehmen zu viele Seitenzugriffsanfragen als Spam gemeldet hat, sperren wir den Business Manager.

Tätige diesen GET-Aufruf, um alle Kundenseiten zu sehen, für die du Zugriff beantragt, aber noch keine Genehmigung erhalten hast. Du benötigst den Zugriffsschlüssel für den Admin-Systemnutzer:

curl -G \
-d "access_token=<ADMIN_SYSTEM_USER_ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_client_pages"

Seiten eines Unternehmens oder Seiten, die Kund*innen des Unternehmens gehören, anzeigen

Verwende diesen GET-Aufruf, um alle Seiten deines Unternehmens zu sehen:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

Verwende diesen GET-Aufruf, um alle Seiten zu sehen, für die dein Unternehmen eine Agentur ist:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

Dadurch wird eine Liste der Seiten zurückgegeben, die den Kunden eines Business Manager gehören.

Mehrere Seiten auf einmal hinzufügen

Mit der Business Manager-UI kannst du einzelne Seiten zu einem Business Manager hinzufügen. Wenn du einem Business Manager mehrere Seiten auf einmal hinzufügen möchtest, tätige die folgenden POST-Aufrufe:

curl \
-F 'access_token=<ACCESS_TOKEN>' \
-F 'batch=[
  {
    "method":"POST",
    "name":"test1",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_1>"
  }, 
  {
    "method":"POST",
    "name":"test2",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_2>"
  }, 
  {
    "method":"POST",
    "name":"test3",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_3>"
  }, 
]' \
"https://graph.facebook.com/<API_VERSION>"

Hierbei gilt:

• <ACCESS_TOKEN> ist ein Zugriffsschlüssel mit der Berechtigung business_management.
• <BUSINESS_ID> ist die ID des Business Managers, für den die Seiten beansprucht werden sollen.
• <PAGE_ID_n> sind die zu beanspruchenden Seiten-IDs.

Seiten entfernen

Tätige diesen DELETE-Aufruf, um eine Seite vom Unternehmen zu entfernen:

curl \
  -X DELETE \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pages"

Personen zu Seiten hinzufügen

Wenn dein Unternehmen über eine Seite verfügt, kannst du Personen Aufgaben für die Seite zuweisen. Zu den Aufgaben gehören:

Voraussetzungen:

• page_id – ID der Seite
• user_id – hinzuzufügende Nutzer*in-ID
• Zuzuweisende Aufgaben

Tätige diesen POST-Aufruf, um jemanden mit den Aufgaben ['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE'] hinzuzufügen:

Die Unternehmens-ID muss die ID des Unternehmens sein, das die Seite besitzt

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

Seitenzugriff ändern

Um die Aufgaben vorhandener Nutzer*innen zu ändern, tätige den gleichen POST-Aufruf, den zum Hinzufügen eines*einer neuen Nutzer*in mit Aufgaben verwendest:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

Seitenberechtigungen ansehen

Tätige diesen GET-Aufruf, um die Seiten zu sehen, für die ein*e Nutzer*in Berechtigungen hat:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_pages"

Tätige diesen GET-Aufruf, um bestimmte Berechtigungen für eine Seite zu sehen:

curl -G 
  -d "access_token=ACCESS_TOKEN"  
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users?business=<BUSINESS_ID>"

Seitenzugriff entfernen

Bevor du eine Seite von einem Business Manager entfernen kannst, musst du auch die Administratoren dieser Seite von deinem Unternehmen entfernen.

Du benötigst Folgendes, um den Zugriff einer Person von einer Seite zu entfernen:

• page_id – ID der Seite
• user_id — ID des*der zu entfernenden Nutzer*in

Der DELETE-Aufruf lautet:

curl \
  -X DELETE \
  -F "user=BUSINESS_SCOPED_USER_ID" \
-F "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"