Alles über die Facebook-API: wie man sie bekommt und verwendet
- 1. Was ist die Facebook-API?
- 2. Wie man den Facebook-API-Schlüssel erhält
- 3. Wie man Beispiele für die Facebook-API verwendet
- 4. Integration der Facebook-API
- 5. Neueste API-Änderungen
- 6. Facebook-API-Status und Fehler
- 7. Facebook-API-Dokumentation
- Bonus: Erstellen Sie ein Widget, um Social-Media-Inhalte auf Ihrer Website anzuzeigen!
Was ist die Facebook-API?
Die Facebook-API ist ein Bündel von Lösungen, die als primärer Weg verwendet werden, um Daten in die Plattform zu bekommen und aus ihr heraus zu erhalten. Sie ermöglicht es Entwicklern und App-Benutzern, auf die Funktionalität dieses Netzwerks zuzugreifen: Benutzerinformationen, Fotos und Videos, Nachrichten und mehr.
BONUS: Erstellen Sie Ihr Facebook-Feed-Widget in nur wenigen Minuten!
Wie man den Facebook-API-Schlüssel erhält.
Wenn Sie Zugriff auf den Facebook-API-Schlüssel erhalten möchten, sollten Sie sich im Entwicklerportal registrieren oder mit Ihrem bestehenden Facebook-Konto anmelden und Ihre Identität bestätigen. Dies erfordert nur einige einfache Schritte:
- Schritt 1. Einloggen oder Konto erstellen
Gehen Sie zum Facebook-Portal für Entwickler und klicken Sie auf „Anmelden“. Sie können sich mit Ihrem bestehenden Facebook-Konto anmelden oder ein neues erstellen.
- Schritt 2. Loslegen
Wenn Sie sich im Service befinden, klicken Sie rechts oben auf der Hauptseite auf „Loslegen“.
- Schritt 3. Konto bestätigen
Um mit den Entwicklertools zu arbeiten, müssen Sie Ihr Konto bestätigen. Klicken Sie in dem Popup, das erscheint, auf „Weiter“.
Sie können Ihr Konto mit Ihrer Telefonnummer oder Ihrer Kreditkarte bestätigen. Um dies über eine Telefonnummer zu tun, wählen Sie Ihr Land im Dropdown-Menü aus, geben Sie Ihre Telefonnummer mit der Ländervorwahl ein und klicken Sie auf „Als Text senden“. Geben Sie den erhaltenen Code in das Feld ein und klicken Sie auf „Bestätigen“.
- Schritt 4. App erstellen
Dann wird Ihnen der Service anbieten, Ihre erste App zu erstellen. Alle Facebook-APIs und App-Statistiken werden im Entwickler-Dashboard erfasst, und darauf kann nicht zugegriffen werden, ohne eine App zu erstellen.
- Schritt 5. Apps hinzufügen oder Zugriffstoken für Ihre eigenen Bedürfnisse generieren
Der einfachste und bequemste Weg, Facebook-APIs zu verwenden, besteht darin, die Apps direkt im Dashboard hinzuzufügen. Wählen Sie einfach diejenige aus, die Ihren Anforderungen entspricht.
Gehen Sie zu Tools – Graph API Explorer, um Zugriffstoken für verschiedene Arten von APIs zu generieren, die Sie in Ihrer App verwenden möchten. Wählen Sie die App und die Art des Tokens, den Sie im Dropdown-Menü links auf dem Bildschirm benötigen. Klicken Sie dann auf „Zugriffstoken generieren“. Sie müssen den Zugriff der App auf Ihre Seite genehmigen.
Wie man Beispiele für die Facebook-API verwendet
Das Hauptprodukt ist die Graph-API, die als Basis für alle anderen Arten von Facebook-APIs dient. Sie sind im Wesentlichen Erweiterungen der Graph-API, und alle Facebook-Produkte interagieren in irgendeiner Weise damit.
Welche Verwendungsmöglichkeiten gibt es für die Facebook-Entwicklerkonsole und die dort bereitgestellten Produkte? Es gibt viele Möglichkeiten, Ihre Website oder App mithilfe des Inhalts und einiger Funktionen dieser sozialen Plattform zu verbessern.
Sie können verschiedene Arten von Social-Media-Inhalten – Beiträge, Bilder, Videos – auf Ihrer Website oder in Ihrer App anzeigen, um die Benutzer zu engagieren und zu unterhalten.
Aber beachten Sie, dass wenn die Graph-API implementiert ist, um von anderen Benutzern verwendet zu werden, diese auch zunächst in einem Popup zustimmen müssen. Erst nachdem ein Benutzer autorisiert hat, erhält die Anwendung einen Zugriffstoken von diesem Benutzer und kann dessen Informationen aus dem Facebook-Profil verwenden.
Facebook-API-Beschränkungen
Denken Sie daran, dass jeder API-Typ immer Einschränkungen hat. Abfragen der Graph-API, die mit dem App-Zugriffstoken durchgeführt werden, werden gegen das Anforderungslimit dieser Anwendung gezählt. Die Anzahl der Aufrufe einer App ist die Anzahl der Anfragen, die sie während eines einstündigen Zeitfensters stellen kann, und wird wie folgt berechnet:Anrufe innerhalb einer Stunde = 200 * Anzahl der App-Benutzer
Integration der Facebook-API
Die Plattform bietet mehrere fertige Lösungen für Nicht-Entwickler auf der Basis ihrer Graph-API. Alle Facebook-Apps und APIs sind im Wesentlichen eine Reihe oder Sammlung von Graph-API-Knoten. Dies bedeutet, dass Sie immer noch die oben beschriebenen Schritte 1-3 ausführen müssen, um ein Konto zu erstellen und Zugriff auf das Dashboard zu erhalten. Im Folgenden werden die am häufigsten verwendeten Standard-API-Anwendungen von Facebook beschrieben.
Arten von Facebook-Feed-APIs
Facebook Page API
Dieser API-Typ ermöglicht den Zugriff auf die Einstellungen, Inhalte und Metriken einer Seite. Sie ermöglicht es Ihnen, Beiträge zu erstellen und anzuzeigen, Kommentare von einer Seite, eigene Inhalte der Seite und mehr. Alle Details finden Sie in der Pages-API-Dokumentation. Vergessen Sie nicht, dass Sie ein Token von einem App-Benutzer benötigen, der die erforderliche Aufgabe auf der Seite besitzt oder ausführen kann.
Facebook Video API
Von Facebook werden zwei Arten bereitgestellt – Video-API und Live-Video-API. Beide veröffentlichen Videos auf einer Seite, Gruppe oder Veranstaltung, die von einem App-Benutzer verwaltet wird. Die Video-API ist darauf ausgelegt, kurze und lange Videos auf einer oder mehreren Seiten und Gruppen zu veröffentlichen. Die Live-Video-API wird wiederum verwendet, um eine Live-Übertragung zu planen, ein Video auf einem Benutzerprofil, einer Gruppe oder einer Veranstaltung zu streamen und auch mit dem Publikum zu interagieren, das zuschaut. Und natürlich benötigen Sie Zugriffstoken für Seiten, Gruppen oder Veranstaltungen oder eine Kombination davon, je nachdem, wo Sie Ihr Video oder Ihren Live-Stream platzieren möchten.
Facebook API Events
Diese Art von API wird auch als Graph-API-Funktionalität präsentiert, ist jedoch nur für Facebook Marketing-Partner verfügbar. Es erfordert auch ein Zugriffstoken vom Administrator der Veranstaltung oder einer Gruppe, die diese Veranstaltung erstellt hat.
Facebook News Feed API
Sie haben zwei Möglichkeiten, auf den Facebook-Newsfeed zuzugreifen und ihn zu verwenden. Die beschriebene Graph-API bietet die Möglichkeit, auf einen separaten Benutzer-Feed mit Statusaktualisierungen zuzugreifen und Beiträge-API und Links zu lesen, die von Benutzern oder anderen Personen im Profil veröffentlicht wurden. Weitere Informationen finden Sie hier.
Es gibt auch eine Public Feed API, die es ermöglicht, Inhalte, die als „Öffentlich“ gekennzeichnet sind, auf dem Drittanbieterdienst oder der Website anzuzeigen. Aber dieser Art von API-Schlüssel wird nur an genehmigte Medienverlage vergeben, sodass Sie sich zuerst bewerben müssen.
Sie benötigen keine Facebook-Group-API, um deren Inhalte auf Ihrer Website anzuzeigen. Verwenden Sie Facebook-Feed-Widget! Damit haben Sie die volle Kontrolle über die Inhalte, die Sie benötigen.
Facebook Community-API
Facebook Comment API
Zugriff auf Kommentare auf Facebook kann über die Graph-API erhalten werden. Da Kommentare unter verschiedenen Arten von Inhalten hinterlassen werden können, müssen Sie Zugriff auf ein Objekt erhalten, um mit den Kommentaren darauf zu arbeiten.
Facebook Reviews API
Dieser Teil der Graph-API stellt Objekte dar, die eine Empfehlung enthalten. Die Standardfelder umfassen Datum, Sternebewertung, Bewertungstext, Benutzerinformationen und „positives“ oder „negatives“ Badge.
Wenn Sie mehr Kontrolle über die angezeigten Bewertungen wünschen, können Sie das Bewertungs-Plugin entsprechend Ihren Vorlieben anpassen.
Facebook-Tools-APIs
Facebook-Anmelde-API
Ein Facebook-API-Anmeldebeispiel ist auf vielen Webdiensten zu sehen, die eine Registrierung erfordern. Dies bietet Benutzern einen schnellen und sicheren Weg, sich auf einer Website oder in einer App anzumelden. Diese API sammelt Zugriffstoken der Benutzer, um ihre Profilinformationen zu erhalten, was nur nach Genehmigung durch den Benutzer möglich ist. Wenn Sie diese Art von API verwenden möchten, müssen Sie Ihre App von der Facebook-Administration überprüfen und genehmigen lassen.
Facebook-Orte-API
Die Places-Graph-API ist eine separate Facebook-Lösung, die nur für die Plattformen Android und iOS verfügbar ist. Damit kann Ihre App Informationen über den aktuellen Standort der Benutzer abrufen. Sie ermöglicht auch die Suche nach und Entdeckung von Orten, das Teilen von Standorten und das Geotagging. Die Places-API erfordert auch den Erhalt von Zugriffstoken von Benutzern. Um die Places-API zu integrieren und damit zu arbeiten, müssen Sie zunächst das Facebook-SDK für Ihre App erhalten.
Facebook-Zahlungs-API
Die Zahlungs-API enthält die Details einer Zahlung, die in einer bestimmten App getätigt wurde. Diese Zahlungen werden in Facebook-Zahlungen erstellt und auf der Grundlage der Plattform abgewickelt. Diese Art von API erfordert auch ein Zugriffstoken für eine App, die eine Zahlung erstellt.
Facebook-Messenger-API
Die Messenger-API ist eine App, mit der Sie einen Konversationskanal auf Ihrer Website über den Facebook Messenger organisieren können. Die Messenger-API-Lösung ermöglicht es einem Entwickler auch, geführte Gespräche mit Benutzern aufzubauen. Auf diese Weise kann der Messenger automatisch auf eine Benutzeranfrage antworten, indem er die Send-API (auch als Facebook Bot API bezeichnet) verwendet, die Webhooks an die URL des Servers sendet, auf dem der Messenger gehostet wird.
Bleiben Sie mit Ihren Kunden und der Website-Zielgruppe mit einem kostenlosen und einfach zu installierenden Messenger-Button verbunden!
Facebook-Marketing-API-Typen
Facebook-Anzeigen-API
Die Marketing-API ist eine Reihe von Graph-API-Endpunkten, die dazu beitragen, Werbung auf Facebook zu optimieren. Die Facebook-Anzeigen-API ermöglicht es Benutzern, Werbekampagnen, Anzeigengruppen und separate Anzeigeneinheiten zu erstellen und zu verwalten.
Facebook-Marktplatz-API
Derzeit gibt es nur die Kategorien Fahrzeuge und Immobilien auf dem Facebook-Marktplatz. Um diesen Abschnitt der Facebook-Plattform zu nutzen, müssen Sie ein Entwicklerkonto erstellen und Ihr Unternehmen verifizieren. Diese Lösung bietet die Verwendung der Lead-API zusammen mit Entwickler-Webhooks für eine bessere Leistung. Dafür müssen Sie Ihre App wie in diesem Artikel beschrieben erstellen und zur Überprüfung bei Facebook einreichen, um sie genehmigen zu lassen.
Facebook-Analyse-API
Diese Lösung hilft dabei, das Verhalten und die Reise Ihrer Kunden von mobilen, Web-, Bot-, Offline- und anderen Ressourcen zu verfolgen und zu optimieren. Um sie zu implementieren, müssen Sie das Facebook-SDK in Ihre App oder Website integrieren. Weitere Informationen finden Sie im Analytics Hilfezentrum.
Facebook-Business-Manager-API
Diese Art von API hilft dabei, mehrere Seiten, Anzeigenkonten und Anwendungen an einem Ort zu verwalten. Im Business Manager können Sie Geschäftsassets und Berechtigungen für die Berechtigungsverwaltung verknüpfen, Kampagnen im Namen eines Unternehmens durchführen, Werbekonten erstellen und Anzeigen schalten.
Neueste API-Änderungen
Zu den Änderungen der Facebook-API gehören versionierte Änderungen – diejenigen, 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 höhere Facebook-API-Version zu aktualisieren, gibt es ein spezielles API-Upgrade-Tool.
Die neueste Version ist v8.0, die im August 2020 frisch veröffentlicht wurde. Es enthält jetzt:
- App-Typen – Business, Gaming und None
- Likes für Live-Videos erhalten
- Produktvorlage im Messenger für Shops, um Produkte als Nachrichten zu senden
Die vorherige Version v7.0, die im Mai 2020 veröffentlicht wurde, bleibt bis August 2022 verfügbar.
Facebook-API-Status und Fehler
Der aktuelle Plattformstatus ist seit dem 1. Oktober 2020 gesund. Manchmal führen jedoch die Anfragen zu verschiedenen Facebook-API-Fehlerantworten mit den entsprechenden Fehlercodes. Zum Beispiel bedeutet der Facebook-API-Fehler 400 – Schlechte Anfrage -, dass eine Abfrage nicht mehr unterstützt wird und Sie ein neues Zugriffstoken generieren müssen. Hier sind einige andere:
| Code | Name |
| 102 | API-Sitzung |
| 1 | API Unbekannt |
| 2 | API Service |
| 3 | API Methode |
| 4 | Zu viele API-Aufrufe |
| 17 | Zu viele API-Aufrufe des Benutzers |
| 10 | Zugriff verweigert API |
| 190 | Zugriffstoken ist abgelaufen |
| 200-299 | Zugriff auf API-Berechtigung (Mehrere Werte je nach Berechtigung) |
| 341 | Anwendungslimit erreicht |
| 368 | Vorübergehend gesperrt wegen Verstoß gegen Richtlinien |
| 506 | Doppelter Beitrag |
| 1609005 | Fehler beim Veröffentlichen des Links |
Facebook API-Dokumentation
Die Dokumentation aller Arten von Facebook-Entwickler-APIs finden Sie im Docs Bereich des Facebook-Entwicklerportals. Die vollständige Liste der Graph-API-Stammknoten finden Sie im Abschnitt Facebook-API-Referenz. Jede API-Dokumentation enthält ein kurzes Tutorial zu den erforderlichen Berechtigungen sowie dazu, wie sie verwendet und implementiert wird. Sie finden sie in den Abschnitten „Erste Schritte“ und „Anleitungen“ jeder spezifischen Dokumentation.