Übersicht

Die Pages API ist ein Satz von Facebook Graph API-Endpunkten, die Apps verwenden können, um die Einstellungen und den Inhalt einer Seite zu erstellen und zu verwalten.

Komponenten

Zugriffsschlüssel

Die API-Authentifizierung erfolgt über Zugriffsschlüssel. Die meisten Endpunkte benötigen Seiten-Zugriffsschlüssel, die für jede Seite, jede*n App-Nutzer*in und jede App eindeutig sind und die ablaufen. Um einen Schlüssel von einem*einer App-Nutzer*in abzurufen, muss der*die App-Nutzer*in eine Aufgabe auf der Seite besitzen oder in der Lage sein, eine Aufgabe auszuführen.

Du kannst Zugriffsschlüssel von den App-Nutzer*innen erhalten, indem du Facebook Login implementierst.

Graph API

Wenn du dich noch nicht gut mit der Graph API auskennst, lies bitte die Graph API-Dokumentation, bevor du weitermachst, um mehr über den Social Graph von Meta zu erfahren.

Facebook Login

Facebook Login erlaubt Nutzer*innen, sich bei deiner App anzumelden, und deiner App, Berechtigungen für den Datenzugriff anzufordern.

Facebook Login for Business

Facebook Login for Business ist die bevorzugte Authentifizierungs- und Autorisierungslösung für Tech-Anbieter*innen und Entwickler*innen von Business-Apps, die Zugriff auf die Assets ihrer Geschäftskund*innen benötigen.

Features

Einige Endpunkte benötigen eine Feature, das mittels App-Review genehmigt werden muss, bevor deine App sie im Live-Modus verwenden kann. Mithilfe von Features kannst du auf öffentliche Seitendaten ohne Berechtigung zugreifen oder eine Aufgabe auf der Seite durchführen. In der Referenz zum jeweiligen Endpunkt findest du Informationen dazu, welches Seitenfeature benötigt wird.

Erwähnungen

Über @Erwähnen kann deine Seite einer bestimmten Person, die auf deiner Seite etwas veröffentlicht hat und deinen Seitenbetrag kommentiert hat, in einem Kommentar oder einer Antwort öffentlich antworten.

Seitenspezifische Nutzungs-IDs

Nutzer*innen, die auf Seiten agieren, werden durch Page-Scoped-Nutzer-IDs (PSID) identifiziert. PSIDs sind IDs, die für jedes Nutzungs-Seiten-Paar eindeutig sind. Die Pages API- und Messenger-Plattform-Endpunkte verwenden PSIDs. Daher kannst du mit einer PSID die Interaktion eines*einer Nutzer*in mit einer Seite identifizieren, genauso wie die öffentlichen Messenger-Unterhaltungen des*der Nutzer*in mit dieser Seite.

Berechtigungen

Die meisten Endpunkte benötigen eine oder mehrere Berechtigung(en), die App-Nutzer*innen deiner App gewähren müssen. Dies kann in der Regel durch Facebook Login erfolgen, aber auch über den Business Manager, wenn deine App von einem Unternehmen beansprucht wurde.

Alle Berechtigungen erfordern einen App-Review, bevor App-Nutzer*innen diese deiner App diese im Live-Modus gewähren können. Für Unternehmens-Apps, die nicht über App-Modi verfügen, müssen Berechtigungen für erweiterten Zugriff genehmigt werden, damit App-Nutzer*innen diese deiner App gewähren können, ohne dass sie eine Rolle in der App selbst oder eine Rolle in einem Unternehmen besitzen, das die App beansprucht hat.

Seitensuche

Finde Informationen über Facebook-Seiten wie Namen und Orte und finde Seite für @Erwähnen, Seiten-Locations und markiere eine Seite, um Branded Content zu markieren.

Durchsatzratenbegrenzungen

Alle Anfragen von Seitenendpunkten unterliegen Ratenbegrenzungen. Die aktuell verbrauchte Anzahl von Aufrufen deiner App findest du im App-Dashboard.

Aufgaben

Mit Aufgaben können Nutzer*innen auf einer Seite bestimmte Aktionen durchführen. Wenn ein*e Nutzer*in über eine App mit deiner Seite interagiert, prüfen wir je nach der jeweiligen Handlung zuerst, ob der*die Nutzer*in für eine Aufgabe, die diese Handlungsart zulässt, genehmigt wurde.

Du kannst einzelnen Nutzer*innen die folgenden Aufgaben gestatten:

Wenn eine Person Administrationszugriff auf eine Seite in der Benutzeroberfläche erhält, kann diese Person alle Aufgaben auf dieser Seite ausführen.

Messenger-Plattform

Führe Messenger-Unterhaltungen mit deiner Kundschaft oder mit Personen, die Interesse an deiner Facebook-Seite zeigen.

Meta-Webhooks für Seiten

Erhalte Echtzeit-Benachrichtigungen, wenn ein*e Nutzer*in einen Seitenbeitrag kommentiert oder auf deinen Seitenbeitrag reagiert.

App-Review

Alle seitenbezogenen Berechtigungen und Features müssen über den App-Review genehmigt werden, bevor deine App sie im Live-Modus verwenden kann.

Apps im Entwicklungsmodus können eine beliebige Berechtigung von einem*einer App-Nutzer*in anfordern, der in der App über eine Rolle verfügt.

So funktioniert’s

Es folgt ein typischer Workflow für den Zugriff auf die Pages API:

1. Rufe über Facebook Login einen Nutzungs-Zugriffsschlüssel vom*von der App-Nutzer*in ab.
2. Führe eine Abfrage für den /me/accounts-Endpunkt durch, um die ID und den Seiten-Zugriffsschlüssel der Seite zu erhalten, für die der*die Nutzer*in deiner App den Zugriff gewährt hat.
3. Erfasse die zurückgegebene Seiten-ID und den Seiten-Zugriffsschlüssel.
4. Führe mit der ID und dem Schlüssel eine Abfrage für den Seiten-Knoten durch.

Beachte, dass der*die App-Nutzer*in deiner App in einigen Fällen Zugriff auf mehr als eine Seite gewährt. In diesem Fall musst du alle Seiten-IDs und die entsprechenden Schlüssel erfassen und dem*der App-Nutzer*in ermöglichen, auf die einzelnen Seiten abzuzielen.

Nächste Schritte

Folge unserem Leitfaden für erste Schritte, um zu erfahren, wie du einen Seitenbeitrag mit der Pages API veröffentlichen kannst.

Siehe auch