Graph API

Erste Schritte

In diesem Leitfaden wird erklärt, wie du Daten vom Facebook Social Graph erhalten kannst.

Bevor du beginnst

Voraussetzungen:

Deine erste Anfrage

Schritt 1: Öffne das Graph API Explorer-Tool

Öffne den Graph API Explorer in einem neuen Browser-Fenster. Auf diese Weise kannst du die Beispiele ausführen, während du dieses Tutorial liest.

Der Explorer wird mit einer Standardabfrage mit der GET-Methode, der aktuellen Version der Graph API, dem /me-Node und den Feldern id und name im Abfrage-String-Feld und deiner Facebook-App geladen.

Schritt 2: Generiere den Zugriffsschlüssel

Klicke auf den Button Zugriffsschlüssel generieren. Das Fenster Mit Facebook anmelden wird angezeigt. Mit diesem Pop-up fordert deine App von dir die Berechtigung an, deinen Namen und dein Profilbild von Facebook abzurufen.

Dieser Vorgang ist unser Facebook Login-Produkt, mit dem sich eine Person anhand ihrer Facebook-Anmeldedaten bei einer App anmelden kann. Mit Facebook Login kann eine App eine Person um Zugriff auf ihre Facebook-Daten bitten, und die Person kann den Zugriff zulassen oder ablehnen. Dein Name und dein Profilbild sind öffentlich, damit man dich auf Facebook finden kann. Es sind also keine zusätzlichen Anforderungen erforderlich, um diese Anfrage auszuführen.

Klicke auf Als … fortfahren

Ein Nutzer-Zugriffsschlüssel wird erstellt. Dieser Zugriffsschlüssel enthält Informationen wie die App, die die Anfrage stellt, die Person, die mit der App eine Anfrage stellt, ob der Zugriffsschlüssel noch gültig ist (er läuft in etwa einer Stunde ab), den Ablaufzeitpunkt und den Umfang der Daten, die die App anfordern kann. Der Umfang dieser Anfrage ist public_profile, was deinen Namen und dein Profilbild umfasst.

Klicke auf das runde Info-Icon neben dem Zugriffsschlüssel, um die Informationen des Zugriffsschlüssels anzuzeigen.

Schritt 3: Sende die Anfrage

Klicke oben rechts auf Senden.

Folgendes sollte dir angezeigt werden

Im Antwortfenster wird dir eine JSON-Antwort mit deiner Facebook-Nutzer-ID und deinem Namen angezeigt.

Wenn du ?fields=id,name aus dem Abfrage-String-Feld entfernst und auf Senden klickst, wird dir das gleiche Ergebnis angezeigt, da name und id die Nutzer-Node-Felder sind, die standardmäßig zurückgegeben werden.

Deine zweite Anfrage

Schritt 1: Fügen wir ein Feld hinzu

Gestalten wir die erste Anfrage ein wenig komplexer, indem wir ein weiteres Feld hinzufügen: email. Es gibt zwei Möglichkeiten, Felder hinzuzufügen:

  • Klicke im Node-Field-Viewer rechts im Antwortfenster auf das Dropdown-Menü „Suche“.
  • Beginne mit der Eingabe in das Abfrage-String-Feld.

Wir fügen das Feld email hinzu und klicken auf Senden.

Folgendes sollte dir angezeigt werden

Der Aufruf ist zwar nicht fehlgeschlagen, aber es wurden nur die Felder name und id sowie eine Debug-Meldung zurückgegeben. Klicke auf den Link (Anzeigen), um die Anfrage zu debuggen.

Für den Zugriff auf fast alle Nodes und Felder ist eine bestimmte Berechtigung erforderlich. Die Debug-Meldung besagt, dass du deiner App die Erlaubnis erteilen musst, auf die E-Mail-Adresse zuzugreifen, die du mit deinem Facebook-Konto verknüpft hast.

Schritt 2: Füge eine Berechtigung hinzu

Klicke in der Seitenleiste rechts unter Berechtigungen auf das Dropdown-Menü Eine Berechtigung hinzufügen. Klicke auf Berechtigungen zu Nutzerdaten und wähle email aus.

Einen neuen Nutzer-Zugriffsschlüssel generieren

Da du den Umfang des Zugriffsschlüssels änderst, musst du einen neuen erstellen. Klicke auf Zugriffsschlüssel generieren. Wie bei der ersten Anfrage musst du deiner App im Facebook Login-Dialog die Erlaubnis geben, auf deine E-Mail zuzugreifen.

Sobald der neue Zugriffsschlüssel erstellt wurde, klicke auf Senden. Jetzt werden alle Felder in deiner Anfrage zurückgegeben.

Versuche, deine Facebook-Beiträge abzurufen.

Hier erfährst du, wie das funktioniert.

Links in der Antwort

Beachte, dass die id-Werte, die in der Antwort zurückgegeben werden, Links sind. Diese Links können Nodes wie Benutzer, Seite oder Beitrag darstellen. Wenn du auf einen Link klickst, wird der Inhalt des Abfrage-String-Felds durch die ID ersetzt. Jetzt kannst du Anfragen auf diesem Node ausführen. Da dieser Node mit dem übergeordneten Node, einem Beitrag eines Nutzers, verbunden ist, brauchst du möglicherweise keine Berechtigungen hinzuzufügen. Du kannst jetzt auf eine Beitrags-ID klicken, da wir sie im nächsten Beispiel verwenden.

Beachte: Einige IDs sind eine Kombination aus der übergeordneten ID und einem neuen ID-String. Der Beitrag eines Nutzers hat z. B. eine Beitrags-ID, die etwa so aussieht: 1028223264288_102224043055529, wobei 1028223264288 die Nutzer-ID ist.

Sehen wir uns eine Edge an

Der Nutzer-Node weist nicht viele Edges auf, die Daten zurückgeben können. Der Zugriff auf Nutzerobjekte kann nur vom Nutzer erteilt werden, dem das Objekt gehört. In den meisten Fällen gehört einem Nutzer ein Objekt, wenn es von diesem erstellt wurde.

Wenn du etwa einen Beitrag veröffentlichst, werden Informationen zu diesem Beitrag angezeigt, wie z. B. das Erstellungsdatum, Text, Fotos und Links, die im Beitrag geteilt wurden, sowie die Anzahl der Reaktionen auf den Beitrag. Wenn du deinen Beitrag kommentierst, kannst du diesen Kommentar sehen. Wenn jedoch eine andere Person einen Kommentar zu deinem Beitrag veröffentlicht, kannst du den Kommentar nicht sehen und auch nicht, wer ihn veröffentlicht hat.

Versuche, die Anzahl der Reaktionen auf einen deiner Beiträge zu ermitteln. Du solltest dir die

Referenz zu Objektreaktionen

ansehen.

Hier erfährst du, wie das funktioniert.

Rufe den Code für deine Anfrage ab

Mit dem Explorer-Tool kannst du Anfragen testen, und sobald du eine erfolgreiche Antwort erhältst, kannst du den Code in deinen App-Code einfügen. Klicke unten im Antwortfenster auf Code erhalten. Der Explorer bietet Android-, iOS-, JavaScript-, PHP- und cURL-Code. Der Code ist schon ausgewählt, sodass du ihn einfach kopieren und einfügen kannst.

Wir empfehlen dir, das Facebook-SDK für deine App zu implementieren. Dieses SDK enthält Facebook Login, mit dem deine App nach Berechtigungen fragen und Zugriffsschlüssel erhalten kann.

Mehr dazu

Mit dem Graph API Explorer kannst du jede Anfrage für Nutzer*innen, Seiten, Gruppen und mehr testen. In der Referenz zu jedem Node und jeder Edge findest du Informationen dazu, welche Art von Berechtigung und Zugriffstoken erforderlich sind.