Was ist die Facebook-API?
Die Facebook-API ist eine Sammlung von Lösungen, die als primärer Weg dienen, Daten in die Plattform hinein- und herauszuholen. Sie ermöglicht Entwicklern und App-Nutzern den Zugriff auf die Funktionen dieses Netzwerks: Nutzerinformationen, Fotos und Videos, Nachrichten und mehr.
BONUS: Erstellen Sie in nur wenigen Minuten Ihr Facebook-Feed-Widget!
So erhalten Sie einen Facebook-API-Schlüssel.
Wenn Sie Zugriff auf den Facebook-API-Schlüssel erhalten möchten, registrieren Sie sich oder melden Sie sich mit Ihrem bestehenden Facebook-Konto im Entwicklerportal an und bestätigen Ihre Identität. Das erfordert nur ein paar einfache Schritte:
- Schritt 1. Anmelden oder Konto erstellen
Gehen Sie zum Facebook-Portal für Entwickler und klicken Sie auf „Anmelden“. Sie können sich mit Ihrem vorhandenen Facebook-Konto anmelden oder ein neues Konto erstellen.
- Schritt 2. Jetzt loslegen
Wenn Sie sich im Service befinden, klicken Sie oben rechts auf der Hauptseite auf “Loslegen”
- Schritt 3. Verifizieren Sie Ihr Konto
Um mit den Entwicklertools zu arbeiten, müssen Sie Ihr Konto freischalten. Klicken Sie im erscheinenden Pop-up auf Weiter.
Sie können Ihr Konto mit Ihrer Telefonnummer oder Kreditkarte verifizieren. Um die Verifizierung per Telefonnummer durchzuführen, wählen Sie Ihr Land aus dem Dropdown-Menü, geben Sie Ihre Nummer inklusive Ländervorwahl ein und klicken Sie auf „Als Text senden“. Geben Sie den erhaltenen Code in das Feld ein und klicken Sie auf „Verifizieren“.
- Schritt 4. Erstellen Sie Ihre App
Anschließend fordert der Dienst Sie auf, Ihre erste App zu erstellen. Alle Facebook-APIs und App-Statistiken werden im Entwickler-Dashboard erfasst, und der Zugriff ist ohne das Erstellen einer App nicht möglich.
- Schritt 5. Apps hinzufügen oder Zugriffstoken für Ihre eigenen Bedürfnisse generieren
Der einfachste und bequemste Weg, Facebook-APIs zu nutzen, besteht darin, die Apps direkt im Dashboard hinzuzufügen. Wählen Sie einfach diejenige aus, die Ihren Anforderungen entspricht.
Gehe zu Tools – Graph API Explorer, um Access Tokens für verschiedene Arten von APIs zu generieren, die du in deiner App verwenden möchtest. Wähle im linken Bereich des Bildschirms die App und die Token-Art aus. Klicke dann auf „Access Token generieren“. Du musst dem Zugriff der App auf deine Seite zustimmen.
So verwenden Sie Facebook-API-Beispiele
Das Hauptprodukt ist die Graph-API, die als Basis für alle anderen Facebook-APIs dient. Sie ist im Wesentlichen eine Erweiterung der Graph-API, und alle Facebook-Produkte greifen in irgendeiner Weise darauf zu.
Welche Nutzungsmöglichkeiten bietet Ihnen die Facebook-Entwicklerkonsole und die dort angebotenen Produkte? Es gibt zahlreiche Wege, Ihre Website oder App mithilfe der Inhalte und Funktionen dieser Social-Media-Plattform zu verbessern.
Sie können verschiedene Arten von Social-Media-Inhalten – Posts, Bilder, Videos – auf Ihrer Website oder App anzeigen, um Nutzer zu engagieren und zu unterhalten.
Beachten Sie jedoch, dass, wenn die Graph-API so implementiert wird, dass sie auch von anderen Nutzern verwendet wird, diese zuerst in einem Pop-up zustimmen müssen. Erst nachdem sich ein Benutzer autorisiert hat, erhält die Anwendung ein Zugriffstoken von diesem Benutzer und kann dessen Informationen aus dem Facebook-Profil verwenden.
Facebook-API-Beschränkungen
Facebook-API-Integration
Die Plattform bietet mehrere fertige Lösungen für Nicht-Entwickler auf Basis der Graph-API. Alle Facebook-Apps und die API sind im Kern eine Sammlung von Graph-API-Knoten. Das bedeutet, dass Sie weiterhin die Schritte 1–3 wie oben beschrieben durchführen müssen, um ein Konto zu erstellen und Zugriff auf das Dashboard zu erhalten. Unten erläutern wir die am häufigsten verwendeten Facebook-Standard-API-Anwendungen.
Facebook-Feed-API-Typen
Facebook-Seiten-API
Facebook-Video-API
Es gibt zwei Typen, die Facebook bereitstellt – Video‑API und Live‑Video‑API. Beide posten Videos auf einer Seite, in einer Gruppe oder bei einem von einem App‑Nutzer verwalteten Event. Die Video‑API dient dem Veröffentlichen kurzer und langer Videos auf einer einzelnen Seite oder mehreren Seiten und Gruppen. Die Live‑Video‑API wird verwendet, um eine Live‑Übertragung zu planen, ein Video im Profil, in einer Gruppe oder bei einem Event zu streamen und auch mit dem zuschauenden Publikum zu interagieren. Und natürlich benötigen Sie Seiten‑, Gruppen‑ oder Events‑Zugriffstoken bzw. eine Kombination davon, je nachdem, wo Sie Ihr Video oder Ihren Livestream platzieren möchten.
Facebook-API-Ereignisse
Diese Art von API wird auch als Graph-API-Funktionalität präsentiert, ist jedoch nur für Facebook Marketing Partner verfügbar. Sie erfordert außerdem ein Zugriffstoken vom Administrator der Veranstaltung oder einer Gruppe, die diese Veranstaltung erstellt hat.
Facebook News Feed API
Sie haben zwei Optionen, um Zugriff auf den Facebook-News-Feed zu erhalten und ihn zu verwenden. Die beschriebene Graph-API ermöglicht den Zugriff auf einen separaten User-Feed mit Status-Updates sowie auf die Posts-API und Links, die vom Benutzer oder einer anderen Person im Profil veröffentlicht wurden. Weitere Informationen finden Sie hier.
Es gibt auch eine Public-Feed-API, die es ermöglicht, Inhalte, die als ‘Public’ gekennzeichnet sind, auf dem Drittanbieter-Service oder der Website anzuzeigen. Allerdings wird dieser API-Schlüssel nur freigegebenen Medienverlegern gewährt, daher müssen Sie sich zuerst bewerben.
Sie benötigen keine Facebook Group API, um Inhalte auf Ihrer Website anzuzeigen. Verwenden Sie das Facebook Feed widget! Damit haben Sie volle Kontrolle über die Inhalte, die Sie benötigen.
Facebook Community API
Facebook-Kommentar-API
Der Zugriff auf Facebook-Kommentare erfolgt über die Graph API. Da Kommentare unter verschiedenen Inhaltstypen hinterlassen werden können, müssen Sie Zugriff auf ein Objekt erhalten, um mit den Kommentaren arbeiten zu können.
Facebook-Bewertungen-API
Dieser Teil der Graph API repräsentiert Objekte, die eine Empfehlung enthalten. Die Standardfelder umfassen Datum, Sternebewertung, Bewertungstext, Benutzerinformationen und ‘positive’ oder ‘negative’ Abzeichen.
Facebook-Tools-APIs
Facebook-Login-API
Beispiel für Facebook-API-Login: Auf vielen Webdiensten, die eine Registrierung erfordern, ist dies zu sehen. Es bietet Benutzern eine schnelle und sichere Möglichkeit, sich bei einer Website oder einer App anzumelden. Diese API sammelt die Zugriffstokens der Benutzer, um Profilinformationen abzurufen, was erst nach Zustimmung des Benutzers möglich ist. Wenn Sie diese Art von API verwenden möchten, muss Ihre App von der Facebook-Administration geprüft und genehmigt werden.
Facebook Places API
Places Graph ist eine eigenständige Facebook-Lösung, die nur für Android- und iOS-Plattformen verfügbar ist. Damit kann Ihre App Informationen über den aktuellen Standort der Nutzer abrufen. Sie ermöglicht außerdem die Suche nach Orten, das Teilen von Standorten und Geo-Tagging. Die Places-API erfordert außerdem Zugriffstokens von Nutzern. Um die Places-API zu integrieren und damit zu arbeiten, müssen Sie zunächst das Facebook SDK für Ihre App erhalten.
Facebook Payments API
Die Zahlungs-API enthält Details zu einer in einer bestimmten App vorgenommenen Zahlung. Diese Zahlungen werden in Facebook-Zahlungen erstellt und plattformbasierend weiterverarbeitet. Diese Art von API erfordert außerdem ein Zugriffstoken für eine App, die eine Zahlung erstellt.
Facebook Messenger API
Messenger API ist eine App, die es Ihnen ermöglicht, über Facebook Messenger einen Gesprächskanal auf Ihrer Website zu organisieren. Die Messenger API-Lösung erlaubt Entwicklern zudem, geführte Unterhaltungen mit Nutzern zu erstellen. Auf diese Weise kann der Messenger Nutzer automatisch per Send API (auch Facebook Bot API genannt) antworten, die Webhooks an die URL des Servers senden, auf dem der Messenger gehostet wird.
Facebook-Marketing-API-Typen
Facebook Ads API
Marketing-API: Eine Reihe von Graph-API-Endpunkten, die Werbung auf Facebook optimieren. Die Facebook Ads-API ermöglicht es Nutzern, Kampagnen, Anzeigengruppen und einzelne Anzeigen zu erstellen und zu verwalten.
Facebook Marketplace-API
Derzeit gibt es auf Facebook Marketplace nur die Kategorien Fahrzeuge und Immobilien. Um auf diesen Bereich der Facebook-Plattform zuzugreifen, müssen Sie ein Entwicklerkonto erstellen und Ihr Unternehmen verifizieren. Diese Lösung nutzt Lead-API zusammen mit Entwickler-Webhooks für eine bessere Leistung. Dafür müssen Sie Ihre App wie oben in diesem Artikel beschrieben erstellen und sie zur Prüfung einreichen, damit Facebook sie genehmigt.
Facebook Analytics-API
Diese Lösung hilft, das Verhalten und den Weg Ihrer Kunden von Mobilgeräten, Web, Bots, Offline und anderen Ressourcen zu verfolgen und zu optimieren. Um es zu implementieren, müssen Sie das Facebook SDK in Ihre App oder Website integrieren. Sie können mehr dazu im Analytics-Hilfezentrum erfahren.
Facebook Business Manager-API
Neueste API-Änderungen
Facebook-API-Änderungen umfassen versionierte Änderungen – die Änderungen, die mit der Veröffentlichung einer neuen API-Version eingeführt werden. Es gibt auch nicht-versionierte Änderungen, die außerhalb der normalen Veröffentlichungen eingeführt werden. Um auf eine neuere Facebook-API-Version upzugraden, gibt es ein spezielles API Upgrade Tool.
Die neueste Version ist v8.0, frisch veröffentlicht im August 2020. Sie bietet jetzt:
- App-Typen – Geschäftlich, Gaming und Keine
- Likes für Live-Videos erhalten
- Produktvorlage im Messenger für Shops, um Produkte als Nachrichten zu senden
Die vorherige Version v7.0, veröffentlicht im Mai 2020, wird bis August 2022 verfügbar sein.
Facebook-API-Status und Fehler
Der aktuelle Plattformstatus ist seit dem 1. Oktober 2020 stabil. Allerdings führen Anfragen manchmal zu unterschiedlichen Facebook-API-Fehlerantworten mit den jeweiligen Codes. Beispielsweise bedeutet der Facebook-API-Fehler 400 – Ungültige Anfrage – dass eine Abfrage nicht mehr unterstützt wird und ein neues Zugriffstoken generiert werden muss. Hier sind noch weitere:
| Code | Name |
| 102 | API-Sitzung |
| 1 | API unbekannt |
| 2 | API-Service |
| 3 | API-Methode |
| 4 | Zu viele API-Aufrufe |
| 17 | Zu viele API-Aufrufe |
| 10 | API-Berechtigung verweigert |
| 190 | Der Zugriffstoken ist abgelaufen |
| 200-299 | API-Berechtigungen (je nach Berechtigung mehrere Werte) |
| 341 | Anwendungsgrenze erreicht |
| 368 | Vorübergehend blockiert wegen Richtlinienverstößen. |
| 506 | Beitrag duplizieren |
| 1609005 | Fehler beim Posten des Links |
Die Dokumentation aller Arten von Facebook-Entwickler-APIs finden Sie im Docs-Bereich des Facebook-Entwicklerportals. Die vollständige Liste der Graph-API-Wurzelknoten finden Sie im Abschnitt Facebook API Reference. Jede API-Dokumentation enthält eine kurze Anleitung zu den erforderlichen Berechtigungen und außerdem Hinweise darauf, wie sie verwendet und implementiert wird. Sie finden diese in den Abschnitten Getting Started und Guides jeder spezifischen Dokumentation.
