Mit JSON Inhalte von Facebook „entführen“

War Facebook bislang ein geschlossenes System, erlaubt es das soziale Netz mittlerweile, Inhalte auszulesen und auf anderen Websites darstellen zu lassen. Machbar ist das mit der „Graph API“, einer Schnittstelle, die den Zugriff auf Facebook-Inhalte ermöglicht.

Mit „Graph API“ kann man auf die sogenannten Facebook-Objekte zugreifen. Zu diesen Objekten gehören Benutzer, Seiten, Links, Fotos und Veranstaltungen – also alles, womit man befreundet sein kann, was einem gefallen oder was man teilen kann. Jedes dieser Objekte wird über eine ID angesteuert und stellt objektspezifische Werte zum Auslesen bereit. Bei Benutzern lassen sich zum Beispiel Name, Geschlecht oder Herkunft ermitteln. Natürlich stellt die API nur solche Inhalte zur Verfügung, die frei zugänglich sind.

JSON als Austauschformat

Der Austausch der Inhalte solcher Facebook-Objekte erfolgt über das Format JSON, was für JavaScript Object Notation steht. JSON ist es kompaktes Datenformat, welches Daten in Textform zwischen verschiedenen Anwendungen austauschen kann. Es ähnelt von seiner Funktion dem XML-Format, ist allerdings deutlich einfacher und schlanker.

Über JSON können Eigenschaften – dazu zählen Arrays,  Zeichenketten, Zahlen sowie boolsche Werte – ausgetauscht werden. Eigenschaften werden in Objekten, die in geschwungenen Klammern stehen, dargestellt. Jede Eigenschaft hat einen Schlüssel und einen Wert. Während Zeichenketten in Anführungszeichen stehen, werden Zahlen und boolsche Werte ohne Anführungszeichen dargestellt. Arrays stehen in eckigen Klammern.

Objekte lassen sich verschachteln, wobei verschachtelte Objekte wie auch die Eigenschaften über einen Schlüssel verfügen:

{
  "Name": "Manfred Mustermann",
  "Mitgliedsnummer": 1484,
  "Anschrift": {
    "Strasse": "Musterweg 11",
    "Ort": "Musterstadt",
    "PLZ": 57842
  }
  "Hobbys": [ "Reiten", "Lesen", "Schwimmen" ],
  "Alter": 35,
  "Mitgliedsbeitrag": 10,
  "Lastschrift": true
}

Ein JSON-Objekt ist ein gültiges JavaScript, welches über die JavaScript-Funktion eval() ausgelesen werden kann. Aber auch andere Programmiersprachen verfügen über Funktionen, mit denen JSON-Objekte ausgelesen und konvertiert werden können. PHP stellt dazu die Funktion json_decode() zur Verfügung.

Aufruf der „Graph API“

Um ein Facebook-Objekt über die API aufzurufen, benötigt man die ID des Objektes oder den Benutzernamen.

Beispiel: Über den Aufruf von „http://graph.facebook.com/220439“ oder alternativ „http://graph.facebook.com/btaylor“ erhält man als JSON-Objekt die objektspezifischen Daten des Facebook Benutzers Bret Taylor (wird von Facebook für Demozwecke genutzt):

{
  "id": "220439",
  "name": "Bret Taylor",
  "first_name": "Bret",
  "last_name": "Taylor",
  "link": "http://www.facebook.com/btaylor",
  "gender": "m\u00e4nnlich",
  "locale": "en_US"
}

Sonderzeichen wie die deutschen Umlaute werden als Unicode-Escape-Sequenz ausgegeben, also als Backslash gefolgt vom Unicode-Wert. Die über das JSON-Objekt dargestellten Werte des Facebook-Benutzers lassen sich nun zum Beispiel mittels PHP auslesen und weiterverarbeiten.

Über die API lassen sich, wie anfangs bereits erwähnt, alle Facebook-Objekte auslesen (insofern sie frei zugänglich sind).

Beispiel: Über „http://graph.facebook.com/40796308305“ erhält man Zugriff auf die Facebook-Seite „Coca-Cola“:

{
  "id": "40796308305",
  "name": "Coca-Cola",
  "picture": "http://profile.ak.fbcdn.net/profile-ak-snc1/object3/
    1853/100/s40796308305_2334.jpg",
  "link": "http://www.facebook.com/coca-cola",
  "category": "Consumer_products",
  "username": "coca-cola",
  "products": "Coca-Cola is the most ...",
  "fan_count": 10171036
}

Neben den allgemeinen Informationen zu Benutzern, Gruppen und Seiten lassen sich auch die Inhalte der einzelnen Objekte auslesen, etwa die Inhalte einer Pinnwand. Über den Aufruf von „http://graph.facebook.com/40796308305/feed“ erhält man ein JSON-Objekt mit den Meldungen der Pinnwand der Seite „Coca-Cola“.

Die Anzahl der dargestellten Meldungen lässt sich über den Parameter „limit“ ebenso definieren wie die erste darzustellende Meldung über den Parameter „offset“. Über „http://graph.facebook.com/40796308305/feed?limit=10&offset=5“ werden also zehn Meldungen angezeigt, wobei ab Meldung fünf begonnen wird. Insgesamt werden also die Meldungen fünf bis fünfzehn dargestellt.

Über die Parameter „until“ und „since“ lassen sich Meldungen auch aufgrund ihres Datums darstellen. So werden mit „http://graph.facebook.com/40796308305/feed?since=yesterday“ alle Meldungen seit „gestern“ angezeigt.

Jede einzelne Meldung der Pinnwand hat wiederum eine eigene ID und lässt sich separat ansteuern.

Facebook-Inhalte mit PHP darstellen

Eine konkrete Anwendung für die „Graph API“ ist das Darstellen von Facebook-Inhalten auf der eigenen Website. Im folgenden Beispiel werden die Pinnwandmeldungen einer Facebook-Seite über ein PHP-Script ausgelesen und ausgegeben. Wer eine Seite bei Facebook pflegt, kann so die Pinnwandmeldungen, die sonst nur Facebook-Besucher sehen, auf seiner eigene Website darstellen lassen.

Zunächst wird das JSON-Objekt mit den Meldungen der Pinnwand der entsprechenden Seite (wir bleiben bei Coca-Cola) über „fopen()“ eingelesen:

$fb_feed = fopen("http://graph.facebook.com/40796308305/feed", "r");

while (!feof($fb_feed)) {
  $fb = fgets($fb_feed);
}

fclose($fb_feed);

Die Variable $fb enthält nun alle Pinnwandmeldungen der Seite als JSON-Objekt. Anschließend wird das eingelesene JSON-Objekt in eine PHP-Variable konvertiert:

$fb = json_decode($fb, true);

Die Pinnwandmeldungen sind in dem Array data gespeichert. Mit $fb["data"] hat man Zugriff auf das Array, das aus dem JSON-Objekt übernommen wurde. Über eine for-Schleife werden alle Objekte des Arrays ausgelesen. Jeder Wert des Arrays enthält eine Pinnwandmeldung. Je nach Art der Meldung (Statusmeldung, Bild, Veranstaltung) lassen sich objektspezifische Werte abfragen.

In diesem Fall lassen wir den Namen des Posters und den Meldungstext wiedergeben:

for ($i = 0; $i < sizeof($fb["data"]); $i++) {

  $fb_eintrag = $fb_daten[$i];

  echo "<strong>".$fb_eintrag["from"]["name"].":</strong> ";
  echo $fb_eintrag["message"]."</p>";
  echo "<hr />";

}

Die Art der Darstellung lässt sich noch verfeinern, indem man die unterschiedlichen Typen von Meldungen abfragt (in diesem Fall über „$fb_eintrag[„type“]“) und die Ausgabe entsprechend anpasst.

Fazit

Das hier dargestellte Beispiel zeigt nur einen Teil der Möglichkeiten, die man die der „Graph API“ von Facebook hat. Insbesondere beschränkt sich das Beispiel auf Inhalte, die frei verfügbar sind.

Mit der API können Sie auch auf Daten von Benutzern zugegreifen, die sonst nur „Freunden“ dieser Benutzer zugänglich sind. Allerdings bedarf es der Zustimmung des jeweiligen Benutzers. Facebook stellt hierfür ein spezielles Protokoll zur Authentifizierung zur Verfügung.

(mm),