Ich empfehle folgendes vorgehen: Einfach folgenden Code mittels Cronjob etwa alle 55 Minuten ausführen. Dadurch wird ein neues Access-Token generiert und dieses in einer Datenbank oder (wie im folgenden Beispiel) in einer Textdatei abgelegt:

<?php

// Tutorial: GooglePlus via OAuth mit PHP Bordmitteln
// (Teil 2)  

echo "GooglePlus mit OAuth: Tutorial (Teil 2)";
echo "\n\n";

// OAuth Tokens
$refreshtoken = "???";
$clientid="???;
$clientsecret="???";

$APIurl = "https://accounts.google.com/o/oauth2/token";

$params="client_id=".$clientid;
$params.="&client_secret=".$clientsecret;
$params.="&refresh_token=".$refreshtoken;
$params.="&grant_type=refresh_token";

// Der Request ist fertig und sieht so aus:
echo "\nRequest: $params\n\n";

// mit file_get_contents versenden
$opts = array('http' =>
    array(
        'method'  => 'POST',
        'header'  => 'Content-type: application/x-www-form-urlencoded',
        'content' => $params
    )
);

$result = file_get_contents($APIurl, false, stream_context_create($opts));

//ggf. das Result ausgegeben
//echo "\nResult:\n" . $result;

//json decoden
$daten=json_decode($result);

//ausgeben und speichern
echo "neues Access-Token: ". $daten->access_token;
file_put_contents("accesstoken.txt", $daten->access_token);

echo "\n... das war's!\n";
?>

In dem Codebeispiel des 1. Teils meines Tutorials ist dann folgende Zeile zu ändern:

// OAuth Token
$accesstoken = file_get_contents("accesstoken.txt");

Ein eigentlich selbstverständlicher Hinweis: „acesstoken.txt“ sollte natürlich an einem „sicheren“ Ort abgespeichert werden.

Zudem verwende ich hier in diesem Tutorial wieder nur „PHP-Bordmittel“ – auch wenn es eine Vielzahl von SDKs und Tools gibt sind diese m.E. für kleinere Aufgaben wie diese meist nicht unbedingt notwendig – so geht’s eigentlich schneller.

Hier nun die Schritt-für-Schritt-Anleitung:

1. Zuerst muss die Applikation bei Google registriert werden (hierfür ist ein Google-Account erforderlich). Mit Googles API-Console (https://code.google.com/apis/console) muss ein neues Application „Project“ angelegt werden, der Name des Projekts spielt keine Rolle.

2. Unter „All Services“ ist dann „Google+“ zu aktivieren.

3. Unter „API Access“ klickt man auf „Create an OAuth 2.0 client id“

4. Hier muss ein „Product Name“ eingetragen werden, z. B. „MeinGooglePlusTool“.

5. Als nächstes wählt man „Installed application“.

6. Nun erhält man die Client ID, das Client Secret sowie die Redirect URL (dabei ist nur die erste Zeile wichtig „http://localhost“ gehört nicht dazu)

7. Mit Hilfe dieser drei Werte kann man nun das Access-Token generieren. Ich empfehle hier mein open source Tool „Access-Token-Manager“ – alternativ kann man sich auch selbst etwas basteln, hier ist die Anleitung dazu bei Google: http://code.google.com/apis/accounts/docs/OAuth2InstalledApp.html

8. Nun hat man das Access Token (sowie das Refresh Token, da der Token nur  eine Stunde gültig ist; mehr dazu im 2. Teil meines Tutorials).

9. Mit folgendem PHP-Code lässt sich nun auf Google+ zugreifen (mit den Berechtigungen des Benutzers, den man bei Punk 7 zum generieren des Access-Tokens verwendet hat). In meinem Beispiel werden die „activities“ (d.h. die eigenen Posts) ausgelesen:

#!/usr/local/bin/php5

<?php

// Tutorial: GooglePlus via OAuth mit PHP Bordmitteln

echo "GooglePlus mit OAuth: Tutorial (Teil 1)";
echo "\n\n";

// OAuth Tokens
$accesstoken = "???";

//z.B. meine letzten Aktivitäten auslesen
$APIurl = "https://www.googleapis.com/plus/v1/people/me/activities/public";

// oder meine ("me") Daten:
//$APIurl = "https://www.googleapis.com/plus/v1/people/me";

//Request aufbauen
$srequest=$APIurl."?access_token=".$accesstoken;

// Der Request ist fertig und sieht so aus:
echo "\nRequest: $srequest\n\n";

// GET vorbereiten & ausführen
$opts = array('http' =>
            array(
                'method'  => 'GET'
            )
);
$result = file_get_contents($srequest, false, stream_context_create($opts));

// Falls gewünscht das Ergebnis ausgeben
//echo "\nResult:\n" . $result;

// Json umwandeln
$daten=json_decode($result);

// jetzt können die Daten ausgegeben werden, hier
// z. B. Titel, Datum und Inhalt meiner Aktiviäten
for ($i = 0; $i < count($daten->items); $i++) {
    echo "$i.-----------------------------------------------\n";
    echo "Titel: " . $daten->items[$i]->title."\n";
    echo "Datum: " . $daten->items[$i]->published."\n";
    echo "Inhalt: " . $daten->items[$i]->object->content."\n";
    echo "\n\n\n";
}

echo "\n\n... das war's!\n";

?>

Hinweise:

• Was mit der API noch alles möglich ist kann man in der offiziellen Doku nachlesen: https://developers.google.com/+/api/
• derzeit (Januar 2012) ist die Google+ API noch „read-only“, d.h. man kann nur Daten lesen, aber nichts schreiben (also z. B. keinen neuen Post versenden).
• Statt „me“ in der API-Url kann die ID eines Users angegeben werden.

Schritt 1-5: identisch wie in meinem Tutorial zu C#

Schritt 6: So sieht dies in PHP aus:

#!/usr/local/bin/php5

<?php

// Tutorial: Facebook API mit PHP Bordmitteln

echo "Tutorial: Facebook API mit PHP Bordmitteln";
echo "\n\n";

// OAuth Tokens
$accesstoken = "???";

//z.B. mein Feed:
$APIurl = "https://graph.facebook.com/me/feed";

$nachricht="Hallo dies ist ein Test!";

//Request aufbauen
$params="message=".rawurlencode($nachricht);
$params.="&access_token=".$accesstoken;

echo "\nParameter: $params\n\n";

// POST vorbereiten & ausführen
$opts = array('http' =>
    array(
        'method'  => 'POST',
        'header'  => 'Content-type: application/x-www-form-urlencoded',
        'content' => $params
    )
);
$result = file_get_contents($APIurl, false, stream_context_create($opts));

// Falls gewünscht das Ergebnis ausgeben
echo "\nResult:\n" . $result;

// und ggf. json umwandeln
$daten=json_decode($result);

//um z. B. die ID auszugeben:
echo "ID des neues Posts: " . $daten->id;

echo "\n\n... das war's!\n";

?>

1. Die Vorarbeiten werden in Teil 1, Teil 2 und Teil 3 dieses Tutorials erklärt. Jetzt habe ich das Formular mit einem Feld für den Dateinamen und Pfad sowie einer Taste „Fotoupload“ ergänzt (Wer es etwas komfortabler haben möchte und den Dateinamen nicht tippen möchte kann noch den „OpenFileDialog“ bedienen, auf das ich hier verzichtet habe).

2. Statt WebClient.UploadData verwende ich nun UploadFile und poste dies an „https://graph.facebook.com/me/photos“. Statt „me“ kann ich auch die Nummer eines meiner Alben angeben oder sogar den Namen eines meiner Freunde (falls die eine Upload zulassen).

3. Der Parameter „message“ dient zu Bildbeschreibung. Zudem kann man noch Tags, Beschreibungen usw. angeben, Details siehe in der Doku von Facebook Developer.

4. Der komplette Code für das Click-Event auf die Taste  „Fotouplaod“ sieht dann folgendermaßen aus:

private void buttonUpload_Click(object sender, EventArgs e)
{
 byte[] Nachricht = null;
 byte[] Antwort = null;
 string AccessToken = null;
 string u = "";

 AccessToken = txtAccessToken.Text;

 if (string.IsNullOrEmpty(AccessToken))
 {
   MessageBox.Show("Bitte erst auf 'Login' klicken");
   return;
 }

  //postet das Foto unter "Fotos" des ausgewählten Users:            
  string GraphURL = "https://graph.facebook.com/me/photos";

  //WebClient anlegen
  System.Net.WebClient myWebClient = new System.Net.WebClient();

  //Except100 ausschalten, sonst gibt es u. U. Fehlermeldungen
  System.Net.ServicePointManager.Expect100Continue = false;

  u = "?message=" + txtStatusupdate.Text + "&access_token=" + AccessToken;
  Nachricht = Encoding.UTF8.GetBytes(u);

  try
  {
   Antwort = myWebClient.UploadFile(GraphURL+u, "POST", textBoxDateiname.Text);
   //MessageBox.Show(System.Text.Encoding.ASCII.GetString(Antwort));
   MessageBox.Show("Foto erfogreich hochgeladen!");
  }
  catch (Exception ex)
  {
    MessageBox.Show(ex.Message);
  }
}

Alternative: FileUploadAsync

In einem Kommentar zum meinem letzten Tutorials wurde ich gefragt, ob dies mit „Async“ nicht schöner wäre – natürlich! Ich wollte es nur nicht unnötig kompliziert machen. Aber wenn hier ein großes Foto hochgeladen wird wäre es natürlich besser, wenn die Anwendung solange nicht „einfriert“ und stattdessen z. B. den Fortschritt anzeigt. Dafür erweitere ich das Formular um eine Taste „Fotoupload (async)“ sowie ein Label, in dem der Fortschritt des Uploads angezeigt werden soll:

Der Code für einen „async“-Upload dazu sieht dann so aus:

private void buttonAsyncUpload_Click_1(object sender, EventArgs e)
{
  byte[] Nachricht = null;            
  string AccessToken = null;
  string u = "";

  AccessToken = txtAccessToken.Text;

  if (string.IsNullOrEmpty(AccessToken))
  {
    MessageBox.Show("Bitte erst auf 'Login' klicken");
    return;
  }

  string GraphURL = "https://graph.facebook.com/me/photos";

  //WebClient anlegen
  System.Net.WebClient myWebClient = new System.Net.WebClient();

  //Except100 ausschalten, sonst gibt es u. U. Fehlermeldungen
  System.Net.ServicePointManager.Expect100Continue = false;

  u = "?message=" + txtStatusupdate.Text + "&access_token=" + AccessToken;
  Nachricht = Encoding.UTF8.GetBytes(u);

  //hier werden die Callbacks festgelegt:
  myWebClient.UploadProgressChanged +=
   new UploadProgressChangedEventHandler(UploadProgessChange);
  myWebClient.UploadFileCompleted +=
   new UploadFileCompletedEventHandler(UploadFertig);

  try
  {
    myWebClient.UploadFileAsync(new Uri(GraphURL + u),
     "POST", textBoxDateiname.Text);
  }
  catch (Exception ex)
  {
    MessageBox.Show(ex.Message);
  }

}

private void UploadProgessChange(object sender,
  UploadProgressChangedEventArgs e)
{
  LabelUpload.Text = e.ProgressPercentage.ToString() + "%";
  // Alternativen: e.UserState, e.BytesReceived, e.TotalBytesToReceive,...
}

private void UploadFertig(object sender, UploadFileCompletedEventArgs e)
{            
  MessageBox.Show("Upload fertig!");
  //ggf. Rückgabewert auslesen:
  //byte[] data = (byte[])e.Result;
  //string textData = System.Text.Encoding.UTF8.GetString(data);
  //MessageBox.Show("Result: " + textData);  
}

Codebeispiele in Visual Basic folgen!

In den nächsten Tagen werde ich ein Tutorial zu Google+ API schreiben und dann auch die Funktionen genauer erklären.

Download „setup.exe“ Access Token Manager

Interessierte können den Quelltext ebenfalls einsehen und nach eigenen Wünschen verändern und weiterentwickeln (Lizenz: CC BY 3.0, also mit Namensnennung). Auf Wunsch eines Kollegens habe ich das nicht in C# sondern in Visual Basic geschrieben – (was mich inzwischen auch schon ärgert, aber nun ist es zu spät). Visual Studio 2010 Express Editon ist ausreichend:

Quellcode AccessTokenManager (Lizenz: CC 3.0 BY): frmMain.vb (und frmMain.Designer.vb)

Facebook-API Programmierer können damit sehr schnell für die unterschiedlichsten Apps und Dienste Access Token „in Serie“ generieren und sich auch komfortabel mit einem Klick die Access-Tokens für Seiten beim Scope „manage_pages“ holen (Details zu den Permissions finden Sie in der offiziellen Doku).

Neu in der Version 1.1:

• die Schaltfläche „Test Access Token“ – diese ruft die „ME“ Seite des aktuellen Users auf und stellt das Ergebnis (JSON) dar – wenn es also mit Ihrem Script nicht klappt können Sie prüfen, ob es an dem Access Token oder an Ihrer Programmierkunst liegt
• die Schaltfläche „to facebook“ – ich brauche diese, um Benutzer auszuloggen – Sie auch?

Das Tool „FB Access Token Manager“ kann hier kostenlos heruntergeladen werden:

Download „setup.exe“ FB Access Token Manager

Interessierte können den Quelltext ebenfalls einsehen und nach eigenen Wünschen verändern und weiterentwickeln (Lizenz: CC BY 3.0, also mit Namensnennung). Auf Wunsch eines Kollegens habe ich das nicht in C# sondern in Visual Basic geschrieben – (was mich inzwischen auch schon ärgert, aber nun ist es zu spät). Visual Studio 2010 Express Editon ist ausreichend:

Quellcode FB AccessTokenManager: frmMain.vb (und frmMain.Designer.vb)

Update am 14.10.2011: Eine neue Version ist erschienen – jetzt mit Google+ API Unterstüzung, Details dazu hier.

<?php

// Tutorial: Eine einfache Twitter-Wall im Eingenbau
// http://frank-it-beratung.com/blog/

session_start();

// Suche nach Hashtag...
$hashtag="design";
$APIurl = "http://search.twitter.com/search.json";

// Refreh-Url mit since_id ggf aus Session laden
if (!isset($_SESSION['refresh_url'])) {
    $param="?q=%23".$hashtag;    
} else {
    $param=$_SESSION['refresh_url'];
}
$APIurl.=$param;

// weitere Paramter für die Suche siehe
// https://dev.twitter.com/docs/using-search

// GET vorbereiten
$opts = array('http' =>
            array(
                'method'  => 'GET'
            )
        );

// mit file_get_contents versenden
$result = file_get_contents($APIurl, false, stream_context_create($opts));
$json=json_decode($result);

// since_id in Session speichern
$_SESSION['refresh_url']=$json->refresh_url;

// neue Ergebnisse seit der letzten Suche
$neueergebnisse="";
for ($i = 0; $i < count($json->results); $i++) {
    $neueergebnisse.="<img src='".$json->results[$i]->profile_image_url;
    $neueergebnisse.="' align='left' width='48' height='48' hspace='5' />";    
    $neueergebnisse.=$json->results[$i]->from_user;
    $neueergebnisse.=" (ID: " .$json->results[$i]->from_user_id .")<br/>";    
    $neueergebnisse.="<strong style='font-size:20pt;'>";
    $neueergebnisse.=utf8_decode($json->results[$i]->text)."</strong>";
    $neueergebnisse.="<br/>";    
    $neueergebnisse.="Datum: ". $json->results[$i]->created_at;
    $neueergebnisse.=" (Tweet-ID: " . $json->results[$i]->id_str.")";    
    $neueergebnisse.="<hr/>";
}

// Alte Ergebnisse aus Session holen
// besser wäre hier u. U. Speicherung in einer Datenbank
if (isset($_SESSION['altetreffer'])) {
    $altetreffer=$_SESSION['altetreffer'];
} else {
    $altetreffer="";
}

// Alte und neue zusammenfügen und in Session legen
$alletreffer=$neueergebnisse . $altetreffer;
$_SESSION['altetreffer']=$alletreffer;

?>

<!DOCTYPE html>
<html>
<head>
<meta charset="ISO-8859-1">
<title>Twitter-Wall Tutorial</title>
<?php
// optimal wäre eine Ajax-Lösung, aber hier ganz einfach
// mit einem Refresh alle 60 Sekunden (Achtung: Rate Limit!)
?>
<meta http-equiv="refresh" content="60; URL=Twitterwall-Tutorial.php">
</head>
<body>
<h1>Twitter-Wall für #<?php echo $hashtag ?></h1>
Anzahl neuer Treffer: <?php echo count($json->results); ?>
am <?php echo date("d.m.Y H:m:i"); ?> Uhr
<hr/>
<?php echo $alletreffer; ?>
</body>
</html>

<?php

// Suche in Twitter mit PHP Bordmitteln - Ein kurzes Tutorial
// www.Frank-IT-Beratung.com/blog/

// Suche nach Hashtag "design"
$hashtag="design";
$APIurl = "http://search.twitter.com/search.json";

// weitere Paramter für die Suche siehe
// https://dev.twitter.com/docs/using-search
$param="?q=%23".$hashtag;    
$APIurl.=$param;

// GET vorbereiten
$opts = array('http' =>
            array(
                'method'  => 'GET'
            )
        );

// mit file_get_contents versenden
$result = file_get_contents($APIurl, false, stream_context_create($opts));
$json=json_decode($result);
$ergebnisse="";
for ($i = 0; $i < count($json->results); $i++) {
    $ergebnisse.="<img src='".$json->results[$i]->profile_image_url;
    $ergebnisse.="' align='left' width='48' height='48' hspace='5' />";    
    $ergebnisse.=$json->results[$i]->from_user;
    $ergebnisse.=" (ID: " .$json->results[$i]->from_user_id .")<br/>";    
    $ergebnisse.="<strong style='font-size:20pt;'>";
    $ergebnisse.=utf8_decode($json->results[$i]->text)."</strong>";
    $ergebnisse.="<br/>";    
    $ergebnisse.="Datum: ". $json->results[$i]->created_at;
    $ergebnisse.=" (Tweet-ID: " . $json->results[$i]->id_str.")";    
    $ergebnisse.="<hr/>";
}
?>

<!DOCTYPE html>
<html>
<head>
<meta charset="ISO-8859-1">
<title>Tutorial: Suche in Twitter</title>
</head>
<body>
<h1>Suche nach #<?php echo $hashtag ?></h1>
Anzahl Treffer: <?php echo count($json->results); ?>
am <?php echo date("d.m.Y H:m:i"); ?> Uhr
<hr/>
<?php echo $ergebnisse; ?>
</body>
</html>

PHP: rawurlencode+utf8_encode ist die Lösung:

$params=rawurlencode(utf8_encode("Hallöchen Simon wie geht's?"));

C#: Hier sind es einige Zeilen, die Idee ist von Andre Arnott, Details siehe hier

string[] UriRfc3986CharsToEscape = new[] { "!", "*", "'", "(", ")" };
 StringBuilder escaped =
   new StringBuilder(Uri.EscapeDataString(txtTweet.Text.ToString()));

 for (int i = 0; i < UriRfc3986CharsToEscape.Length; i++)
 {
   escaped.Replace(UriRfc3986CharsToEscape[i],
    Uri.HexEscape(UriRfc3986CharsToEscape[i][0]));
 }
 Parameters = "&text=" + escaped.ToString();

VB/Visual Basic: wie in C# (vgl. oben)

Dim UriRfc3986CharsToEscape As String() = _
 New () {"!", "*", "'", "(", ")"}
Dim escaped As New _
  StringBuilder(Uri.EscapeDataString(txtTweet.Text.ToString()))
For i As Integer = 0 To UriRfc3986CharsToEscape.Length - 1
  escaped.Replace(UriRfc3986CharsToEscape(i), _
   Uri.HexEscape(UriRfc3986CharsToEscape(i)(0)))
Next i
Parameters = "&text=" & escaped.ToString()

Perl: Hier ist ein decode_utf8 ausreichend, z. B. bei Net::OAuth

extra_params => {
       text => decode_utf8($nachricht)
}

#!/usr/local/bin/php5

<?php

// Tutorial: Twitter via OAuth mit PHP Bordmitteln

echo "OAuth Tutorial";
echo "\n\n";

// OAuth Tokens User
$accesstoken = "???";
$accesssecret = "???";

// OAuth Keys App
$consumerkey ="???";
$consumerkeysecret="???";

// 1. Beispiel direct message an Simon_A_Frank
// $APIurl = "https://api.twitter.com/direct_messages/new.xml";
// $params="user=Simon_A_Frank&text=";
// doppelt codieren, sonst gehen Umlaute, Sonder und Leerzeichen nicht
// $params.=rawurlencode(utf8_encode("Hallöchen Simon wie geht's?"));
// $reqmethod = "POST";

// 2. Beispiel: Einen Tweet versenden
// $APIurl = "http://api.twitter.com/1/statuses/update.xml";
// $params ="trim_user=true&status=".
//     rawurlencode(utf8_encode("@Simon_A_Frank ok, wunderbar!"));
// $reqmethod = "POST";

// 3. Beispiel: Mit method=get Mentions lesen
$APIurl = "http://api.twitter.com/1/statuses/mentions.xml";
$params ="trim_user=true&count=5";
$reqmethod = "GET";

// Request bauen ...
$srequest="oauth_consumer_key=".$consumerkey;
$srequest.="&oauth_nonce=".rand(10000001,99999999);            
$srequest.="&oauth_signature_method=HMAC-SHA1";
$srequest.="&oauth_timestamp=" . time();        
$srequest.="&oauth_token=" . $accesstoken;
$srequest.="&oauth_version=1.0";
if ($params!="") {
    $srequest.="&".$params;
}    

// Alle Parameter müssen sortiert sein
$sr=explode("&",$srequest);
sort($sr);    
$srequestSorted=implode("&",$sr);    

// Basestring und Key:
$key=$consumerkeysecret."&".$accesssecret;      
$basestring=strtoupper($reqmethod)."&".rawurlencode($APIurl).
  "&".rawurlencode($srequestSorted);

// Signatur erzeugen
$sig=rawurlencode(base64_encode(hash_hmac('sha1', $basestring, $key, true)));    

// Signatur einfügen - für den Request muss diese nicht sortiert sein    
$srequest.="&oauth_signature=$sig";

// Der Request ist fertig und sieht so aus:
echo "\nRequest: $srequest\n\n";

// POST oder GET?
if ($reqmethod=="POST") {
    $opts = array('http' =>
        array(
            'method'  => 'POST',
            'header'  => 'Content-type: application/x-www-form-urlencoded',
            'content' => $srequest
        )
    );
} else
{
    $opts = array('http' =>
        array(
            'method'  => 'GET'
        )
    );
    $APIurl=$APIurl."?".$srequest;    
}

// mit file_get_contents versenden
$result = file_get_contents($APIurl, false, stream_context_create($opts));
// Das Ergebnis ausgeben
echo "\nResult:\n" . $result;
echo "\n... das war's!\n";

?>