Die Google Picasa API erlaubt erlaubt den Zugriff sowohl auf öffentliche als auch auf private Kalender Feeds. Öffentliche Feeds benötigen keine Authentifizierung sind aber nur-lesend und bieten eine reduzierte Funktionalität. Private Feeds bieten die kompletteste Funktionalität benötigen aber eine authentifizierte Verbindung zum Picasa Server. Es gibt drei Authentifizierungs Schemata die von Google Picasa unterstützt werden:

Die Zend_Gdata Bibliothek bietet Unterstützung für beide Authentifizierungs Schemas. Der Rest dieses Kapitels nimmt an das die vorhandenen Authentifizierungs Schemas geläufig sind und wie eine korrekte Authentifizierte Verbindung erstellt wird. Für weitere Details kann in die Authentifizierungs Sektion dieses Handbuches, oder in die Authentifizierungs Übersicht im Google Data API Entwickler Guide gesehen werden.

Um mit den Servern zu interagieren, bietet diese Bibliothek die Zend_Gdata_Photos Service Klasse. Diese Klasse bietet ein übliches Interface zu den Google Data und Atom Publishing Protocol Modellen und assistiert in der Behandlung der Anfragen zum und von den Kalender Servern.

Sobald ein Authentifizierung Schema ausgewählt wurde, besteht der nächste Schritt darin eine Instanz von Zend_Gdata_Photos zu erstellen. Der Klassen Konstruktor nimmt eine Instanz von Zend_Http_Client als einzelnes Argument. Das bietet ein Interface für AuthSub und ClientAuth Authentifizierungen, da beide von Ihnen die Erstellung eines speziellen authentifizierten HTTP Clients benötigen. Wenn keine Argumente angegeben werden, wird automatisch eine unauthentifizierte Instanz von Zend_Http_Client erstellt.

Das folgende Beispiel zeigt wie man eine Service Klasse erstellt und dabei die ClientAuth Authentifizierung verwendet:

// Parameter für die ClientAuth Authentifizierung
$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$user = "sample.user@gmail.com";
$pass = "pa$$w0rd";

// Erstellt einen authentifizierten HTTP Client
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);

// Erstellt eine Instanz des Kalender Services
$service = new Zend_Gdata_Photos($client);

Eine Service Instanz die AuthSub verwendet, kann ähnlich erstellt werden, aber durch eine etwas längere Schreibweise:

session_start();

/**
 * Gibt die komplette URL der aktuellen Seite zurück, basierend auf den env Variablen
 *
 * Verwendete Env Variablen:
 * $_SERVER['HTTPS'] = (on|off|)
 * $_SERVER['HTTP_HOST'] = Wert des Hosts: header
 * $_SERVER['SERVER_PORT'] = Port Nummer (nur verwendet wenn nicht http/80,https/443)
 * $_SERVER['REQUEST_URI'] = Die URI nach der Methode der HTTP Anfrage
 *
 * @return string Current URL
 */
function getCurrentUrl()
{
    global $_SERVER;

    /**
     * php_self filtern um Sicherheits Lücken zu vermeiden.
     */
    $php_request_uri = htmlentities(substr($_SERVER['REQUEST_URI'], 0,
    strcspn($_SERVER['REQUEST_URI'], "\n\r")), ENT_QUOTES);

    if (isset($_SERVER['HTTPS']) && strtolower($_SERVER['HTTPS']) == 'on') {
        $protocol = 'https://';
    } else {
        $protocol = 'http://';
    }
    $host = $_SERVER['HTTP_HOST'];
    if ($_SERVER['SERVER_PORT'] != '' &&
        (($protocol == 'http://' && $_SERVER['SERVER_PORT'] != '80') ||
        ($protocol == 'https://' && $_SERVER['SERVER_PORT'] != '443'))) {
            $port = ':' . $_SERVER['SERVER_PORT'];
    } else {
        $port = '';
    }
    return $protocol . $host . $port . $php_request_uri;
}

/**
 * Gibt die AuthSub URL zurück welche der Benutzer besuchen muß um Anfrage
 * dieser Anwendung zu authentifizieren
 *
 * Verwendet getCurrentUrl() um die nächste URL zu erhalten zu welcher der
 * Benutzer weitergeleitet wird nachdem er
 * sich erfolgreich beim Google Service authentifiziert hat.
 *
 * @return string AuthSub URL
 */
function getAuthSubUrl()
{
    $next = getCurrentUrl();
    $scope = 'http://picasaweb.google.com/data';
    $secure = false;
    $session = true;
    return Zend_Gdata_AuthSub::getAuthSubTokenUri($next, $scope, $secure,
        $session);
}

/**
 * Gibt ein HTTP Client Objekt mit den richtigen Headern für die Kommunikation
 * with Google zurück wobei
 * AuthSub Authentifizierung verwendet wird
 *
 * Verwendet $_SESSION['sessionToken'] um das AuthSub Session Token zu
 * speichern nachdem es erhalten wurde.
 * Das einmal verwendbare Token das in der URL bei der Umleitung angeboten wird
 * nachdem der Benutzer auf
 * Google erfolgreich authentifiziert wurde, wird von der $_GET['token']
 * Variable empfangen.
 *
 * @return Zend_Http_Client
 */
function getAuthSubHttpClient()
{
    global $_SESSION, $_GET;
    if (!isset($_SESSION['sessionToken']) && isset($_GET['token'])) {
        $_SESSION['sessionToken'] =
            Zend_Gdata_AuthSub::getAuthSubSessionToken($_GET['token']);
    }
    $client = Zend_Gdata_AuthSub::getHttpClient($_SESSION['sessionToken']);
    return $client;
}

/**
 * Erstellt eine neue Instant des Services und leitet den Benutzer zum AuthSub
 * Server um wenn das notwendig ist.
 */
$service = new Zend_Gdata_Photos(getAuthSubHttpClient());

Zuletzt kann ein nicht authentifizierter Server für die Verwendung mit öffentlichen Feeds erstellt werden:

// Erstellt eine Instanz des Services und verwendet einen nicht authentifizierten HTTP Client
$service = new Zend_Gdata_Photos();

Dieser Service unterstützt das Erhalten eines Benutzer Feeds und Listen von Benutzer Inhalten. Wenn der abgefragte Benutzer auch der authentifizierter Benutzer ist, werden auch Einträge die als "hidden" markiert sind, zurückgegeben.

Auf den Benutzer Feed kann durch die Übergabe eines Benutzernamens an die getUserFeed() Methode zugegriffen werden:

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

try {
    $userFeed = $service->getUserFeed("sample.user");
} catch (Zend_Gdata_App_Exception $e) {
    echo "Fehler: " . $e->getMessage();
}

Oder, der auf den Feed kann zugegriffen werden indem zuerst eine Abfrage erstellt wird:

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

$query = new Zend_Gdata_Photos_UserQuery();
$query->setUser("sample.user");

try {
    $userFeed = $service->getUserFeed(null, $query);
} catch (Zend_Gdata_App_Exception $e) {
    echo "Fehler: " . $e->getMessage();
}

Die Erstellung einer Abfrage bietet auch die Möglichkeit ein Benutzer Eintrags Objekt abzufragen:

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

$query = new Zend_Gdata_Photos_UserQuery();
$query->setUser("sample.user");
$query->setType("entry");

try {
    $userEntry = $service->getUserEntry($query);
} catch (Zend_Gdata_App_Exception $e) {
    echo "Fehler: " . $e->getMessage();
}

Der Service unterstützt auch das erhalten eines Album Feeds und von Listen des Inhalts von Alben.

Auf einen Album Feed wird durch die Erstellung eines Abfrage Objekts zugegriffen und dessen Übergabe an getAlbumFeed():

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

$query = new Zend_Gdata_Photos_AlbumQuery();
$query->setUser("sample.user");
$query->setAlbumId("1");

try {
    $albumFeed = $service->getAlbumFeed($query);
} catch (Zend_Gdata_App_Exception $e) {
    echo "Fehler: " . $e->getMessage();
}

Alternativ kann dem Abfrage Objekt ein Album Name mit setAlbumName() angegeben werden. Das Setzen des Album Namens schließt sich gegenseitig mit der Album ID aus und das Setzen des einen entfernt den anderen Wert.

Die Erstellung einer Abfragen bietet auch die Möglichkeit ein Album Eintrags Objekt abzufragen:

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

$query = new Zend_Gdata_Photos_AlbumQuery();
$query->setUser("sample.user");
$query->setAlbumId("1");
$query->setType("entry");

try {
    $albumEntry = $service->getAlbumEntry($query);
} catch (Zend_Gdata_App_Exception $e) {
    echo "Fehler: " . $e->getMessage();
}

Der Service unterstützt auch das erhalten eines Photo Feeds und von Listen von zugeordneten Kommentaren und Tags.

Auf einen Photo Feed wird durch die Erstellung eines Abfrage Objekts zugegriffen und dessen Übergabe an getPhotoFeed():

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

$query = new Zend_Gdata_Photos_PhotoQuery();
$query->setUser("sample.user");
$query->setAlbumId("1");
$query->setPhotoId("100");

try {
    $photoFeed = $service->getPhotoFeed($query);
} catch (Zend_Gdata_App_Exception $e) {
    echo "Fehler: " . $e->getMessage();
}

Die Erstellung einer Abfragen bietet auch die Möglichkeit ein Photo Eintrags Objekt abzufragen:

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

$query = new Zend_Gdata_Photos_PhotoQuery();
$query->setUser("sample.user");
$query->setAlbumId("1");
$query->setPhotoId("100");
$query->setType("entry");

try {
    $photoEntry = $service->getPhotoEntry($query);
} catch (Zend_Gdata_App_Exception $e) {
    echo "Fehler: " . $e->getMessage();
}

Der Service unterstützt den Erhalt von Kommentaren von einem Feed eines anderen Typs. Durch das Setzen der Abfrage das eine Art von "Kommentar" zurückgegeben wird, kann eine Feed Anfrage mit einem speziellen Benutzer, Album oder Photo assoziierte Kommentare zurückgeben.

Die Durchführung von Aktionen auf jedem der Kommentare eines gegebenen Photos kann die folgt vollendet werden:

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

$query = new Zend_Gdata_Photos_PhotoQuery();
$query->setUser("sample.user");
$query->setAlbumId("1");
$query->setPhotoId("100");
$query->setKind("comment");

try {
    $photoFeed = $service->getPhotoFeed($query);

    foreach ($photoFeed as $entry) {
        if ($entry instanceof Zend_Gdata_Photos_CommentEntry) {
            // Mach irgendwas mit dem Kommentar
        }
    }
} catch (Zend_Gdata_App_Exception $e) {
    echo "Fehler: " . $e->getMessage();
}

Der Service unterstützt den Erhalt von Tags von einem Feed eines anderen Typs. Durch das Setzen der Abfrage das eine Art von "Tag" zurückgegeben wird, kann eine Feed Anfrage mit einem speziellen Photo assoziierte Tags zurückgeben.

Das Ausführen einer Aktrion auf jedem Tag an gegebenen Photos kann wie folgt durchgeführt werden:

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

$query = new Zend_Gdata_Photos_PhotoQuery();
$query->setUser("sample.user");
$query->setAlbumId("1");
$query->setPhotoId("100");
$query->setKind("tag");

try {
    $photoFeed = $service->getPhotoFeed($query);

    foreach ($photoFeed as $entry) {
        if ($entry instanceof Zend_Gdata_Photos_TagEntry) {
            // Mach irgendwas mit dem Tag
        }
    }
} catch (Zend_Gdata_App_Exception $e) {
    echo "Fehler: " . $e->getMessage();
}

Der Service unterstützt die Erstellung eines neues Albums für authentifizierte Benutzer:

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

$entry = new Zend_Gdata_Photos_AlbumEntry();
$entry->setTitle($service->newTitle("test album"));

$service->insertAlbumEntry($entry);

Der Service unterstützt die Erstellung eines neuen Photos für authentifizierte Benutzer:

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

// $photo ist der Name der Datei die durch ein HTML Formular hochgeladen wurde

$fd = $service->newMediaFileSource($photo["tmp_name"]);
$fd->setContentType($photo["type"]);

$entry = new Zend_Gdata_Photos_PhotoEntry();
$entry->setMediaSource($fd);
$entry->setTitle($service->newTitle($photo["name"]));

$albumQuery = new Zend_Gdata_Photos_AlbumQuery;
$albumQuery->setUser("sample.user");
$albumQuery->setAlbumId("1");

$albumEntry = $service->getAlbumEntry($albumQuery);

$service->insertPhotoEntry($entry, $albumEntry);

Das Service unterstützt die Erstellung von neuen Kommentaren für ein Photo:

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

$entry = new Zend_Gdata_Photos_CommentEntry();
$entry->setTitle($service->newTitle("comment"));
$entry->setContent($service->newContent("comment"));

$photoQuery = new Zend_Gdata_Photos_PhotoQuery;
$photoQuery->setUser("sample.user");
$photoQuery->setAlbumId("1");
$photoQuery->setPhotoId("100");
$photoQuery->setType('entry');

$photoEntry = $service->getPhotoEntry($photoQuery);

$service->insertCommentEntry($entry, $photoEntry);

Das Service unterstützt die Erstellung von neuen Tags für ein Photo:

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

$entry = new Zend_Gdata_Photos_TagEntry();
$entry->setTitle($service->newTitle("tag"));

$photoQuery = new Zend_Gdata_Photos_PhotoQuery;
$photoQuery->setUser("sample.user");
$photoQuery->setAlbumId("1");
$photoQuery->setPhotoId("100");
$photoQuery->setType('entry');

$photoEntry = $service->getPhotoEntry($photoQuery);

$service->insertTagEntry($entry, $photoEntry);

Der Service unterstützt das Löschen von Alben für authentifizierte Benutzer:

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

$albumQuery = new Zend_Gdata_Photos_AlbumQuery;
$albumQuery->setUser("sample.user");
$albumQuery->setAlbumId("1");
$albumQuery->setType('entry');

$entry = $service->getAlbumEntry($albumQuery);

$service->deleteAlbumEntry($entry, true);

Der Service unterstützt das Löschen von Photos für authentifizierte Benutzer:

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

$photoQuery = new Zend_Gdata_Photos_PhotoQuery;
$photoQuery->setUser("sample.user");
$photoQuery->setAlbumId("1");
$photoQuery->setPhotoId("100");
$photoQuery->setType('entry');

$entry = $service->getPhotoEntry($photoQuery);

$service->deletePhotoEntry($entry, true);

Der Service unterstützt das Löschen von Kommentaren für authentifizierte Benutzer:

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

$photoQuery = new Zend_Gdata_Photos_PhotoQuery;
$photoQuery->setUser("sample.user");
$photoQuery->setAlbumId("1");
$photoQuery->setPhotoId("100");
$photoQuery->setType('entry');

$path = $photoQuery->getQueryUrl() . '/commentid/' . "1000";

$entry = $service->getCommentEntry($path);

$service->deleteCommentEntry($entry, true);

Das Service unterstützt das Löschen eines Tags für authentifizierte Benutzer:

$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
$service = new Zend_Gdata_Photos($client);

$photoQuery = new Zend_Gdata_Photos_PhotoQuery;
$photoQuery->setUser("sample.user");
$photoQuery->setAlbumId("1");
$photoQuery->setPhotoId("100");
$photoQuery->setKind("tag");
$query = $photoQuery->getQueryUrl();

$photoFeed = $service->getPhotoFeed($query);

foreach ($photoFeed as $entry) {
    if ($entry instanceof Zend_Gdata_Photos_TagEntry) {
        if ($entry->getContent() == $tagContent) {
            $tagEntry = $entry;
        }
    }
}

$service->deleteTagEntry($tagEntry, true);

GData Feeds, inklusive denen des Picasa Web Album Services, implementieren optimistische Gleichzeitigkeit, ein Versionsverwaltungs System das vermeidet das Benutzer irrtümlich Änderungen überschreiben. Wenn ein Eintrag durch die Service Klasse gelöscht wird, wenn der Eintrag geändert wurde seit er zuletzt geholt wurde, wird eine Ausnahme geworfen, solange das nicht explizit anders gesetzt wurde (in diesem Fall wird die Löschung auf dem aktualisierten Eintrag durchgeführt).

Ein Beispiel davon wie die Versionierung während einer Löschung handzuhaben ist wird durch deleteAlbumEntry() gezeigt:

// $album ist ein albumEntry der gelöscht werden soll
try {
    $this->delete($album);
} catch (Zend_Gdata_App_HttpException $e) {
    if ($e->getMessage->getStatus() === 409) {
        $entry =
            new Zend_Gdata_Photos_AlbumEntry($e->getMessage()->getBody());
        $this->delete($entry->getLink('edit')->href);
    } else {
        throw $e;
    }
}