• Blogger
• Calendar
• Contacts
• Docs
• Picassa
• YouTube

Unterstützt werden u.a. Eingaben wie “post” zur Veröffentlichung von Content, “list” zur Auflistung von Posts oder “tag” zur Kennzeichnung (taggen) von Content.

Die ExampleScripts zeigen die Einsatzmöglichkeiten für die unterschiedlichen Dienste (siehe auch das Manual)

Das Python-Tool wurde unter einer OpenSource Lizenz bei Google Code veröffentlicht.

Gut, eigentlich hat die Anwendung so keinen Sinn, Bilder können bei Facebook auch sehr einfach über die Pinnwand veröffentlicht werden. Sie ist aber eine weitere beispielhafte Anwendung und den Quellcode werde ich hier demnächst noch hier mit Erklärungen veröffentlichen.

In einem Artikel vor gut einem Jahr habe ich noch die facebook-java-api genutzt. Die Weiterentwicklung ist etwas eingeschlafen, deshalb war ich auf der Suche nach einer anderen API. Fündig geworden bin ich bei der RestFB, ein Open Source Framework, welches direkt auf die GraphAPI von Facebook zugreift.

Der erste Schritt bei der Entwicklung einer Anwendung auf Facebook ist die Anwendung selbst anzulegen. Man erhält dann eine Anwendungsnummer und zwei Schlüssel für die Authentifizierung, den API-Schlüssel und den Anwendungs-Geheimcode. Wichtig ist noch die Canvas-URL unter Facebook-Einbindung in den Einstellungen der Anwendung festzulegen, sowie die URL der Anwendung, die Canvasseite.

Den gesamten Prozess der Authentifizierung hat Facebook ganz gut beschrieben.

Bei dem ersten Aufruf greift meine Anwendung (in Struts entwickelt) als erstes auf die Canvas-URL zu.

Folgendes passiert dann. Man holt sich den Parameter “signed_request” und verarbeitet ihn. Bei dem ersten Aufruf muss der Nutzer sich noch authentifizieren und der Anwendung die Berechtigung erteilen, auf die eigenen Profildaten zugreifen zu können.
Es wird dann erstmal aufgerufen:

if (ret.getOauth_token() == null){
    return new ActionForward(authUrl, true);
}

Es erfolgt einer Weiterleitung auf die Authentifizierungs-URL von Facebook.
Die authUrl sieht so aus:

"https://graph.facebook.com/oauth/authorize" +
"?client_id=123456789" +
"&redirect_uri=http://localhost:8080/mudflat/apps/facebookauth.do?do=authSucess" +
"&scope=user_birthday";

wobei die client_id die Anwendungsnummer der Anwendung ist und unter scope die Berechtigungen stehen, die der Anwendung erteilt werden sollen. Welche Berechtigungen möglich sind, steht hier: Permissions Reference.
Der Benutzer kann die Anwendung nun hinzufügen und wird dann zur redirect_uri weitergeleitet.
Die Weiterleitungsadresse macht bei mir nichts anderes, als auf die eingebettete Anwendung bei Facebook weiterzuleiten (Canvasseite)

public ActionForward authSucess(
		ActionMapping mapping,
		ActionForm form,
		HttpServletRequest request,
		HttpServletResponse response) {		

return new ActionForward("http://apps.facebook.com/smd_auth_example", true);
}

Nun wird der Benutzer wieder zur Canvas-URL weitergeleitet.
Da diesmal gilt
authToken != null
kann dieser verarbeitet und der Benutzer authentifiziert werden.

Facebook schickt den Authentifizierungs-Token verschlüsselt im signed_request-Parameter mit.
Wie dieser verarbeitet wird, habe ich mir hier abgekupfert: Parsing signed_request in Java
Die Methode checkSignature(rawpayload, sig) überprüft dann, ob der Anwendungs-Geheimcode stimmt und stellt damit sicher, dass die Anwendung wirklich von Facebook aufgerufen wurde.

String sigreq = request.getParameter("signed_request");

int idx = sigreq.indexOf(".");
byte[] sig = new Base64(true).decode(sigreq.substring(0, idx).getBytes());
String rawpayload = sigreq.substring(idx+1);
String payload = new String(new Base64(true).decode(rawpayload));

/* parse the JSON payload and do the signature check */
FacebookRequest ret = new Gson().fromJson(payload, FacebookRequest.class);
/* check if it is HMAC-SHA256 */
if (!ret.getAlgorithm().equals("HMAC-SHA256")) {
    System.out.println("Fehler Algorthimus");
}
/* then check the signature */
checkSignature(rawpayload, sig);

if (ret.getOauth_token() == null){
    return new ActionForward(authUrl, true);
}

Ab diesem Punkt ist die Authentifizierung abgeschlossen und man kann mit der RestFB-API auf die Graph-API zugreifen:

FacebookClient facebookClient = new DefaultFacebookClient(ret.getOauth_token());
String query = "SELECT name FROM user WHERE uid=220439";
List users = facebookClient.executeQuery(query, User.class);
for (int i=0;i<users.size();i++){
    User u = users.get(i);
    System.out.println(u.getName());
}

Nun noch mal eine kurze Zusammenfassung:

• Anwendung bei Facebook erstellen und die Canvas URL und die Canvasseite festlegen
• Beim ersten Aufruf Weiterleitung auf die authURL und Parameter festlegen
  • clientId mit der Anwendungsnummer
  • redirect_uri
  • scope mit einer Liste der Berechtigungen
• Durchführung der Authentifizierung mit Entschlüsselung des signed_request Parameters und Bestätigung des Anwendungs-Geheimcodes.

Hilfreich bei der Entwicklung ist noch, wenn man sich etwas in die Dokumentationen von Facebook einliest

• Anwendungen auf facebook.com
• Graph API und Graph API Reference
• Authentication
• Permissions

Und hier der komplette Quellcode

Ansonsten, bei Fragen einfach melden :-)

Der Artikel in dieser Ausgabe ist sozusagen eine Lightversion eines Artikels, welches wir für das Java Magazin geschrieben haben. Dieser wurde bereits in der Oktober Ausgabe veröffentlicht. Zusätzlich zu den oben beschriebenen Themen werden in der Java-Magazin-Version noch Einstiegsmöglichkeiten für Java Entwickler beschrieben und die Vielfalt an Frameworks und SDK’s, die für Java existieren, gezeigt.

Für mich persönlich war es die erste Veröffentlichung in einem Fachmagazin und besonders gefreut hat mich, dass die Redakteurin vom Java Magazin über diesen Blog auf mich aufmerksam geworden ist.

Geld verdienen
60% von neuen eBay Auktionen werden über die eBay API eingestellt. Das Unternehmen verdient bei jeder Transaktion darüber mit.

Geld sparen
Auf der anderen Seite können Unternehmen Geld sparen, wenn sie andere APIs nutzen. Die Amazon S3 API kann Firmen helfen, ihre Speicherkosten zu senken.

Markenaufbau
Google hat mit der eigenen Google Maps API ein Mashup entwickelt, nämlich Google Maps, welches nicht nur eine Bereicherung für das gesamt Web war, sondern auch eine unglaubliche Verbreitung des Googles Logos gebracht hat.

Der Weg in die Cloud
Salesforce bietet mit der Salesforce.com API eine komplette Entwicklungsumgebung für Cloud-Anwendungsentwicklung zur Verfügung. Für andere Unternehmen ist das ein günstiger und schneller Einstieg in die Cloud.

Plattformübergreifend
Hat man bereits ein gutes Produkt oder Service kann eine API den Weg für andere Plattformen öffnen. Mit der Bereitstellung einer API steht der Service von Netflix auf über 200 verschiedenen Geräten zur Verfügung.

Wer sich noch weiter in die Thematik Open API Ecosystem einlesen will, dem sei die Präsentation von John Musser empfohlen

Weitere Links gibt es in meiner Linksammlung Developer Seiten von API Anbietern

Xing hat schon seit längerem externe Anwendungen integriert. Man findet gut den DevBlog, da schreiben aber nur Entwickler von Xing, und das nicht mal sehr aktuell. Einen öffentlichen Zugang zur Schnittstelle sucht man vergeblich.

Auf Lokalisten.de werden Anwendungen mittels OpenSocial entwickelt. Die developer plattform ist komplett auf englisch, bietet aber über eine umfassende Dokumentation, Beispiele und einer Sandbox einen schnellen Einstieg in die Entwicklung.

• Activity Feed
  Der Feed zeigt die letzten Aktivitäten auf der eigenen Webseite
• Comments
  Eine Textbox, in der Besucher Kommentare auf der Webseite hinterlassen können.
• Facepile
  Das Plugin zeigt die Profilbilder der eingeloggten Besucher auf der Webseite
• Like Button
  Klickt ein Besucher den “Gefällt mir” Button erscheint das in dessem News Feed auf Facebook mit einem Link zur Webseite.
• Like Box
  Das Plugin zeigt in einem Überblick wie viele Leute die Webseite mögen, die letzten Posts und bietet einen “Like” Button.
• Live Stream
  Facebook empfiehlt dieses Plugin für den Einsatz bei Live Events. Besucher können über das Plugin Kommentare und Statusupdates abgeben und die Aktivitäten anderer Besucher live mitverfolgen.
• Login Button
  Analog zum Facepile Plugin zeigt dieses Plugin die letzten Logins auf der Webseite an.
• Recommendations
  Das Plugin zeigt dem Besucher angepasste Empfehlungen. Ist er eingeloggt werden diese abhängig von den eigenen Kontakten erstellt. Alle anderen erhalten Empfehlungen abhängig von den Aktivitäten der Webseite auf Facebook.

Verwandte Beiträge
Facebook Freunde mit der facebook-java-api
Authentication mit Facebook Connect

Die wichtigsten Links im Überblick
Facebook Developer Seite: Die Einstiegsseite für Entwickler
Social Plugins von Facebook: Alle Plugins in der Übersicht
Facebooks Showcase: Beispiele für die Verwendung der Plugins

Die ids der Freunde laden

Im ersten Schritt werden die id’s der Freunde geladen:

Document docFriends = client.friends_get();
NodeList friendsList = docFriends.getElementsByTagName("uid");

Durch die Liste kann man dann iterieren und die Profile der Freunde laden. Beispielhaft wird jeweils der Name und das Geburtstagdatum eines Freundes ausgegeben:

Iteration durch die Freundesliste

for (int index = 0; index < friendsList.getLength(); index++)
{
    Collection friendInfo = new ArrayList();
    long fid = Long.valueOf(friendsList.item(index).getFirstChild().getTextContent());
    friendInfo.add(fid);

    EnumSet friendFields =
        EnumSet.of(ProfileField.NAME, ProfileField.BIRTHDAY);

    Document df = client.users_getInfo(friendInfo, friendFields);
    String friendName =
        df.getElementsByTagName("name").item(0).getTextContent();
    String friendBirthday =
        df.getElementsByTagName("birthday").item(0).getTextContent();
    System.out.println(friendName + " (" + friendBirthday + ")");
}

Ähnliche Artikel

Authentication mit Facebook Connect
Twitter, Twitter4J und OAuth

Jetzt geht es um die Grundlagen, wie man mit Java einen Connect über Facebook realisiert.
Für eine kleine Beispielanwendung sind folgende Schritte notwendig:
1. Anwendung bei Facebook registrieren.
2. Grundeinstellungen einer internetbasierten Anwendung festlegen.
3. Entwicklung mit facebook-java-api.

Registrierung der Anwendung
Für die Registrierung einer Anwendung ist natürlich ein Profil bei Facebook nötig. Hat man das, kann man eine neue Anwendung erstellen. Es erfolgt die Vergabe eines Namens und schon findet man sich auf der Einstellungsseite wieder.

Grundeinstellungen

“Allgemeines” zeigt einen API-Schlüssel und ein Geheim, im englischen API-Key und secret. Diese beiden Werte benötigt man für die Entwicklung.
Facebook bietet eine Fülle von Einstellungen für die Anwendung. Wichtig für den Einstieg sind Angaben unter den Punkten “Authentifizierung” und “Leinwand”.
Bei beiden Punkten gibt man eine Callback-Url an: ein Link auf die Facebook nach erfolgreicher Anmeldung zurückleiten soll.

Entwicklung
Der Ablauf der Authentifizierung ist recht simple. Man bietet dem Benutzer einen Login-Link oder -Button an, der ihn zu Facebook führt. Nach erfolgreicher Anmeldung wird er zurück geleitet und über die URL ein Token mitgeliefert. Über diesen Token wird der Benutzer eindeutig identifiziert.

Das Beispiel habe ich mit Java Struts entwickelt, funktioniert aber auch mit JSP, JSF oder anderen Frameworks.
Zuerst wird der Login-Link mit dem API-key und dem secret erzeugt.

FacebookXmlRestClient client = new FacebookXmlRestClient (apiKey, secretToken);
String token = client.auth_createToken();
String url = "http://www.facebook.com/login.php?api_key=" + apiKey + "&v=1.0";
request.setAttribute("facebookUrl", url);

apiKey und secretToken sind die oben genannten Variablen, die man bei der Registrierung erhalten hat.
Auf der JSP-Seite kann man dann ein Bild verlinken oder den Login-Button von Facebook generieren lassen. Dafür bietet Facebook eigene Connect Login Buttons an.

<a href="<bean:write name='facebookUrl'/>">
<img
src="http://wiki.developers.facebook.com/images/6/6f/Connect_iphone.png" border="0">
</a>

<a href="<bean:write name='facebookUrl'/>"
onclick="FB.Connect.requireSession(); return false;"
class="fbconnect_login_button FBConnectButton FBConnectButton_Small">
	<span id="RES_ID_fb_login_text"
class="FBConnectButton_Text">
		Connect with Facebook
	</span>
</a>

Klickt dann der Benutzer auf den Link wird er zu Facebook umgeleitet. Er kann sich dann mit seinen Daten anmelden, oder falls er noch keinen Account hat, auch gleich registrieren.
Nach der Anmeldung wird er auf die Callback-URL umgeleitet.
Über einen Parameter liefert Facebook den Autentifizierungstoken mit.
Diesen ließt man aus und hat dann Zugriff auf die Profildaten des Benutzers oder anders herum, man hat den Benutzer über Facebook auf seiner Anwendung authentifiziert.
Die Action-Klasse ließt den request aus und authentifiziert den Benutzer.

FacebookXmlRestClient client = new FacebookXmlRestClient(apiKey, secretToken);
String authToken = request.getParameter("auth_token");
client.auth_getSession(authToken);

Nun hat man Zugriff auf die Facebookdaten des Benutzers. In diesem Beispiel gebe ich den Namen und den Link zum Profilbild aus

long myid = client.users_getLoggedInUser();
Collection users = new ArrayList();
users.add(myid);
EnumSet fields = EnumSet.of(ProfileField.NAME, ProfileField.PIC);
Document d = client.users_getInfo(users, fields);
String myname =
    d.getElementsByTagName("name").
        item(0).getTextContent();
String pic =
    d.getElementsByTagName("pic").
        item(0).getTextContent();
System.out.println("Name: " + myname);
System.out.println("Pic: " + pic);

Quellcode

Hier der Quellcode der Struts Action-Klasse und der JSP:
FacebookConnectAction.java
jsp-Datei: index.jsp

Weiterlesen

Entwicklung
API-Wiki von Facebook
Facebook Developer Wiki

Homepage von facebook-java-api
facebook-java-api

Drei englischsprachige Artikel über Facebook Connect mit Java
Building a Facebook Application in 15 minutes
Logging in with Facebook Java API
Facebook authentication in Java

Blog-Artikel
Ein Blogartikel über Nutzen und Vor- und Nachteile von Facebook Connect
Facebook Connect verbindet alles

Vergleich zwischen Facebook Connect und Sign in with Twitter
Facebook Connect vs. Sign in with Twitter: Fight!

Artikel von netzwertig über Single-Sign-On im Web 2.0
Single-Sign-On: 2009 ist das Jahr des Durchbruchs

Beispiele für Facebook Connect
Apple nutzt in einer App Facebook Connect um Statusmeldungen abzusetzen
Facebook Connect Beispiel von Apple

Ein Plugin für Wordpress, um Blog Besucher über Facebook zu registrieren
Facebook Connect Wordpress Plugin

Das Nachrichtenportal verbindet sich mit Facebook. Kommentare auf bild.de können im Facebook Profil angezeigt werden oder man kann Artikel seinen Freunden empfehlen
BILD.de vernetzt sich mit Facebook

Ähnliche Artikel

Facebook Freunde mit der facebook-java-api
Twitter, Twitter4J und OAuth