|
|
@@ -5,85 +5,90 @@
|
|
|
<title>Picasa Web Alben verwenden</title>
|
|
|
|
|
|
<para>
|
|
|
- Picasa Web Alben ist ein Service der es Benutzer erlaubt Alben von Ihren eigenen Bildern zu verwalten,
|
|
|
- und die Alben und Bilder von anderen anzusehen. Die API bietet ein programmtechnisches Interface für
|
|
|
- diesen Service, der es Benutzer erlaubt hinzuzufügen, zu aktualisieren, und von Ihren Alben zu löschen,
|
|
|
- genauso wie die Möglichkeit Tags und Kommentare auf Fotos zu gestatten.
|
|
|
+ Picasa Web Alben ist ein Service der es Benutzer erlaubt Alben von Ihren eigenen Bildern zu
|
|
|
+ verwalten, und die Alben und Bilder von anderen anzusehen. Die API bietet ein
|
|
|
+ programmtechnisches Interface für diesen Service, der es Benutzer erlaubt hinzuzufügen, zu
|
|
|
+ aktualisieren, und von Ihren Alben zu löschen, genauso wie die Möglichkeit Tags und
|
|
|
+ Kommentare auf Fotos zu gestatten.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Der Zugriff auf öffentliche Alben und Photos ist nicht durch einen Zugang beschränkt. Trotzdem muß
|
|
|
- ein Benutzer angemeldet sein für einen nicht-nur-lesenden Zugriff.
|
|
|
+ Der Zugriff auf öffentliche Alben und Photos ist nicht durch einen Zugang beschränkt.
|
|
|
+ Trotzdem muß ein Benutzer angemeldet sein für einen nicht-nur-lesenden Zugriff.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Für weitere Informationen über die API, inklusive Anleitungen für das Aktivieren des API Zugriffs, sollte
|
|
|
- in die
|
|
|
- <ulink url="http://code.google.com/apis/picasaweb/overview.html">Picasa Web Alben Daten API Übersicht</ulink>
|
|
|
- gesehen werden.
|
|
|
+ Für weitere Informationen über die API, inklusive Anleitungen für das Aktivieren des API
|
|
|
+ Zugriffs, sollte in die
|
|
|
+ <ulink url="http://code.google.com/apis/picasaweb/overview.html">Picasa Web Alben Daten API
|
|
|
+ Übersicht</ulink> gesehen werden.
|
|
|
</para>
|
|
|
|
|
|
<note>
|
|
|
<title>Authentifizierung</title>
|
|
|
<para>
|
|
|
- Die API bietet Authentifizierung über AuthSub (vorgeschlagen) und ClientAuth. HTTP Verbindungen
|
|
|
- müssen für einen Lesezugriff authentifiziert sein, aber nicht-authentifizierte Verbindungen haben
|
|
|
- nur-lesenden Zugriff.
|
|
|
+ Die API bietet Authentifizierung über AuthSub (vorgeschlagen) und ClientAuth. HTTP
|
|
|
+ Verbindungen müssen für einen Lesezugriff authentifiziert sein, aber
|
|
|
+ nicht-authentifizierte Verbindungen haben nur-lesenden Zugriff.
|
|
|
</para>
|
|
|
</note>
|
|
|
|
|
|
<sect2 id="zend.gdata.photos.connecting">
|
|
|
<title>Zum Service verbinden</title>
|
|
|
<para>
|
|
|
- Die Picasa Web Album API basiert, wie alle GData APIs, auf dem Atom Publishing Protokoll (APP),
|
|
|
- einem XML basierenden Format für gemanagte web-basierende Ressourcen. Der Verkehr zwischen
|
|
|
- Client und den Servers tritt über HTTP auf, und erlaubt sowohl authentifizierte als auch
|
|
|
- nicht authentifizierte Verbindungen.
|
|
|
+ Die Picasa Web Album API basiert, wie alle GData APIs, auf dem Atom Publishing Protokoll
|
|
|
+ (APP), einem XML basierenden Format für gemanagte web-basierende Ressourcen. Der Verkehr
|
|
|
+ zwischen Client und den Servers tritt über HTTP auf, und erlaubt sowohl authentifizierte
|
|
|
+ als auch nicht authentifizierte Verbindungen.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Bevor irgendeine Transaktion stattfinden kann muß diese Verbindung hergestellt werden. Die
|
|
|
- Erstellung einer Verbindung zum Picasa Servern beinhaltet zwei Schritte:
|
|
|
- Erstellung eines HTTP Clients und Binden einer <classname>Zend_Gdata_Photos</classname> Instanz an diesen Client.
|
|
|
+ Bevor irgendeine Transaktion stattfinden kann muß diese Verbindung hergestellt werden.
|
|
|
+ Die Erstellung einer Verbindung zum Picasa Servern beinhaltet zwei Schritte:
|
|
|
+ Erstellung eines HTTP Clients und Binden einer <classname>Zend_Gdata_Photos</classname>
|
|
|
+ Instanz an diesen Client.
|
|
|
</para>
|
|
|
|
|
|
<sect3 id="zend.gdata.photos.connecting.authentication">
|
|
|
<title>Authentifikation</title>
|
|
|
<para>
|
|
|
- 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 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:
|
|
|
</para>
|
|
|
|
|
|
<itemizedlist>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <firstterm>ClientAuth</firstterm> bietet direkte Benutzername/Passwort Authentifizierung
|
|
|
- zu den Picasa Servern. Da dieses Schema erfordert das Benutzer die Anwendung mit Ihrem
|
|
|
- Passwort versorgen, ist diese Authentifizierung nur zu empfehlen wenn andere
|
|
|
- Authentifizierungs Schemas nicht anwendbar sind.
|
|
|
+ <firstterm>ClientAuth</firstterm> bietet direkte Benutzername/Passwort
|
|
|
+ Authentifizierung zu den Picasa Servern. Da dieses Schema erfordert das
|
|
|
+ Benutzer die Anwendung mit Ihrem Passwort versorgen, ist diese
|
|
|
+ Authentifizierung nur zu empfehlen wenn andere Authentifizierungs Schemas
|
|
|
+ nicht anwendbar sind.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <firstterm>AuthSub</firstterm> erlaubt die Authentifizierung zu den Picasa Servern über
|
|
|
- einen Google Proxy Server. Das bietet den gleichen Level von Bequemlichkeit wie
|
|
|
- ClientAuth aber ohne die Sicherheits Risiken, was es zu einer idealen Wahl für Web
|
|
|
- basierende Anwendungen macht.
|
|
|
+ <firstterm>AuthSub</firstterm> erlaubt die Authentifizierung zu den Picasa
|
|
|
+ Servern über einen Google Proxy Server. Das bietet den gleichen Level von
|
|
|
+ Bequemlichkeit wie ClientAuth aber ohne die Sicherheits Risiken, was es zu
|
|
|
+ einer idealen Wahl für Web basierende Anwendungen macht.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|
|
|
|
|
|
<para>
|
|
|
- Die <classname>Zend_Gdata</classname> 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 <link linkend="zend.gdata.introduction.authentication">Authentifizierungs Sektion</link>
|
|
|
+ Die <classname>Zend_Gdata</classname> 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 <link
|
|
|
+ linkend="zend.gdata.introduction.authentication">Authentifizierungs Sektion</link>
|
|
|
dieses Handbuches, oder in die
|
|
|
- <ulink url="http://code.google.com/apis/gdata/auth.html">Authentifizierungs Übersicht im Google Data API Entwickler Guide</ulink>.
|
|
|
- gesehen werden.
|
|
|
+ <ulink url="http://code.google.com/apis/gdata/auth.html">Authentifizierungs
|
|
|
+ Übersicht im Google Data API Entwickler Guide</ulink> gesehen werden.
|
|
|
</para>
|
|
|
</sect3>
|
|
|
|
|
|
@@ -91,18 +96,20 @@
|
|
|
<title>Erstellen einer Service Instanz</title>
|
|
|
<para>
|
|
|
Um mit den Servern zu interagieren, bietet diese Bibliothek die
|
|
|
- <classname>Zend_Gdata_Photos</classname> 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.
|
|
|
+ <classname>Zend_Gdata_Photos</classname> 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.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Sobald ein Authentifizierung Schema ausgewählt wurde, besteht der nächste Schritt darin eine
|
|
|
- Instanz von <classname>Zend_Gdata_Photos</classname> zu erstellen. Der Klassen Konstruktor nimmt eine
|
|
|
- Instanz von <classname>Zend_Http_Client</classname> 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 <classname>Zend_Http_Client</classname> erstellt.
|
|
|
+ Sobald ein Authentifizierung Schema ausgewählt wurde, besteht der nächste Schritt
|
|
|
+ darin eine Instanz von <classname>Zend_Gdata_Photos</classname> zu erstellen. Der
|
|
|
+ Klassen Konstruktor nimmt eine Instanz von <classname>Zend_Http_Client</classname>
|
|
|
+ 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
|
|
|
+ <classname>Zend_Http_Client</classname> erstellt.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -123,8 +130,8 @@ $service = new Zend_Gdata_Photos($client);
|
|
|
]]></programlisting>
|
|
|
|
|
|
<para>
|
|
|
- Eine Service Instanz die AuthSub verwendet, kann ähnlich erstellt werden, aber durch eine etwas
|
|
|
- längere Schreibweise:
|
|
|
+ Eine Service Instanz die AuthSub verwendet, kann ähnlich erstellt werden, aber durch
|
|
|
+ eine etwas längere Schreibweise:
|
|
|
</para>
|
|
|
<programlisting role="php"><![CDATA[
|
|
|
session_start();
|
|
|
@@ -167,9 +174,11 @@ function getCurrentUrl()
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
- * Gibt die AuthSub URL zurück welche der Benutzer besuchen muß um Anfrage dieser Anwendung zu authentifizieren
|
|
|
+ * 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 der der Benutzer weitergeleitet wird nachdem er
|
|
|
+ * Verwendet getCurrentUrl() um die nächste URL zu erhalten zu der der Benutzer
|
|
|
+ * weitergeleitet wird nachdem er
|
|
|
* sich erfolgreich beim Google Service authentifiziert hat.
|
|
|
*
|
|
|
* @return string AuthSub URL
|
|
|
@@ -185,12 +194,16 @@ function getAuthSubUrl()
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
- * Gibt ein HTTP Client Objekt mit den richtigen Headern für die Kommunikation with Google zurück wobei
|
|
|
+ * 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.
|
|
|
+ * 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
|
|
|
*/
|
|
|
@@ -206,14 +219,15 @@ function getAuthSubHttpClient()
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
- * Erstellt eine neue Instant des Services und leitet den Benutzer zum AuthSub Server um wenn das notwendig ist.
|
|
|
+ * Erstellt eine neue Instant des Services und leitet den Benutzer zum AuthSub
|
|
|
+ * Server um wenn das notwendig ist.
|
|
|
*/
|
|
|
$service = new Zend_Gdata_Photos(getAuthSubHttpClient());
|
|
|
]]></programlisting>
|
|
|
|
|
|
<para>
|
|
|
- Zuletzt kann ein nicht authentifizierter Server für die Verwendung mit öffentlichen Feeds
|
|
|
- erstellt werden:
|
|
|
+ Zuletzt kann ein nicht authentifizierter Server für die Verwendung mit öffentlichen
|
|
|
+ Feeds erstellt werden:
|
|
|
</para>
|
|
|
<programlisting role="php"><![CDATA[
|
|
|
// Erstellt eine Instanz des Services und verwendet einen nicht authentifizierten HTTP Client
|
|
|
@@ -225,29 +239,30 @@ $service = new Zend_Gdata_Photos();
|
|
|
<sect2 id="zend.gdata.photos.queries">
|
|
|
<title>Verstehen und Erstellen von Abfragen</title>
|
|
|
<para>
|
|
|
- Die primäre Methode um Daten vom Service anzufragen ist die Erstellung einer Abfrage. Es gibt
|
|
|
- Abfrage Klassen für jede der folgenden Typen:
|
|
|
+ Die primäre Methode um Daten vom Service anzufragen ist die Erstellung einer Abfrage.
|
|
|
+ Es gibt Abfrage Klassen für jede der folgenden Typen:
|
|
|
</para>
|
|
|
|
|
|
<itemizedlist>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <firstterm>User</firstterm> wird verwendet um den Benutzer zu spezifizieren dessen
|
|
|
- Daten gesucht werden, und wird als EMail Adresse spezifiziert. Wenn kein Benutzer
|
|
|
- angegeben wurde, wird stattdessen "default" verwendet um den aktuellen authentifizierten
|
|
|
- Benutzer zu bezeichnen (wenn er authentifiziert wurde).
|
|
|
+ <firstterm>User</firstterm> wird verwendet um den Benutzer zu spezifizieren
|
|
|
+ dessen Daten gesucht werden, und wird als EMail Adresse spezifiziert. Wenn kein
|
|
|
+ Benutzer angegeben wurde, wird stattdessen "default" verwendet um den aktuellen
|
|
|
+ authentifizierten Benutzer zu bezeichnen (wenn er authentifiziert wurde).
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <firstterm>Album</firstterm> wird verwendet um das Album zu spezifizieren das gesucht
|
|
|
- werden soll, und wird entweder als ID oder als Name des Albums spezifiziert.
|
|
|
+ <firstterm>Album</firstterm> wird verwendet um das Album zu spezifizieren das
|
|
|
+ gesucht werden soll, und wird entweder als ID oder als Name des Albums
|
|
|
+ spezifiziert.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <firstterm>Photo</firstterm> wird verwendet um das Photo zu spezifizieren das gesucht werden
|
|
|
- soll, und wird als ID spezifiziert.
|
|
|
+ <firstterm>Photo</firstterm> wird verwendet um das Photo zu spezifizieren das
|
|
|
+ gesucht werden soll, und wird als ID spezifiziert.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|
|
|
@@ -263,80 +278,88 @@ $query->setUser("sample.user");
|
|
|
]]></programlisting>
|
|
|
|
|
|
<para>
|
|
|
- Für jede Abfrage kann eine Anzahl an Parameter, welche die Suche limitieren, abgefragt, oder
|
|
|
- mit get(Parameter) und set(Parameter) spezifiziert werden. Diese sind wie folgt:
|
|
|
+ Für jede Abfrage kann eine Anzahl an Parameter, welche die Suche limitieren, abgefragt,
|
|
|
+ oder mit get(Parameter) und set(Parameter) spezifiziert werden. Diese sind wie folgt:
|
|
|
</para>
|
|
|
|
|
|
<itemizedlist>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <firstterm>Projection</firstterm> setzt das Format der im Feed zurückgegebenen Daten
|
|
|
- entweder "api" oder "base". Normal wird "api" gewählt. "api" ist auch der Standardwert.
|
|
|
+ <firstterm>Projection</firstterm> setzt das Format der im Feed zurückgegebenen
|
|
|
+ Daten entweder "api" oder "base". Normal wird "api" gewählt. "api" ist auch der
|
|
|
+ Standardwert.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <firstterm>Type</firstterm> setzt den Typ der Elemente die zurückgegeben werden, entweder
|
|
|
- "feed" oder "entry". Der Standardwert ist "feed".
|
|
|
+ <firstterm>Type</firstterm> setzt den Typ der Elemente die zurückgegeben werden,
|
|
|
+ entweder "feed" oder "entry". Der Standardwert ist "feed".
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <firstterm>Access</firstterm> setzt die Sichtbarkeit von Teilen die zurückgegeben werden,
|
|
|
- mit "all", "public", oder "private". Der Standardwert ist "all". Nicht-öffentliche Elemente
|
|
|
- werden nur zurückgegeben wenn die Abfrage durch authentifizierte Benutzer gesucht wird.
|
|
|
+ <firstterm>Access</firstterm> setzt die Sichtbarkeit von Teilen die
|
|
|
+ zurückgegeben werden, mit "all", "public", oder "private". Der Standardwert ist
|
|
|
+ "all". Nicht-öffentliche Elemente werden nur zurückgegeben wenn die Abfrage
|
|
|
+ durch authentifizierte Benutzer gesucht wird.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <firstterm>Tag</firstterm> setzt einen Tag Filter for zurückgegebenen Teile. Wenn ein Tag
|
|
|
- gesetzt ist werden nur Teile mit so einem Tag im Wert zurückgegeben.
|
|
|
+ <firstterm>Tag</firstterm> setzt einen Tag Filter für zurückgegebenen Teile.
|
|
|
+ Wenn ein Tag gesetzt ist werden nur Teile mit so einem Tag im Wert
|
|
|
+ zurückgegeben.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <firstterm>Kind</firstterm> setzt die Art von Elementen die zurückgegeben wird. Wenn eine
|
|
|
- Art spezifiziert wird, werden nur Einträge zurückgegeben die auf diesen Wert passen.
|
|
|
+ <firstterm>Kind</firstterm> setzt die Art von Elementen die zurückgegeben wird.
|
|
|
+ Wenn eine Art spezifiziert wird, werden nur Einträge zurückgegeben die auf
|
|
|
+ diesen Wert passen.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <firstterm>ImgMax</firstterm> setzt das Maximum der Bildgröße für zurückgegebene Einträge.
|
|
|
- Nur Bildeinträge die kleiner als dieser Wert sind werden zurückgegeben.
|
|
|
+ <firstterm>ImgMax</firstterm> setzt das Maximum der Bildgröße für zurückgegebene
|
|
|
+ Einträge. Nur Bildeinträge die kleiner als dieser Wert sind werden
|
|
|
+ zurückgegeben.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <firstterm>Thumbsize</firstterm> setzt die Vorschaugröße von Einträgen die zurückgegeben
|
|
|
- werden. Jeder empfangene Eintrag wird eine Vorschaugröße haben die diesem Wert entspricht.
|
|
|
+ <firstterm>Thumbsize</firstterm> setzt die Vorschaugröße von Einträgen die
|
|
|
+ zurückgegeben werden. Jeder empfangene Eintrag wird eine Vorschaugröße haben die
|
|
|
+ diesem Wert entspricht.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <firstterm>User</firstterm> setzt den Benutzer nach dessen Daten gesucht werden soll.
|
|
|
- Der Standardwert ist "default".
|
|
|
+ <firstterm>User</firstterm> setzt den Benutzer nach dessen Daten gesucht werden
|
|
|
+ soll. Der Standardwert ist "default".
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <firstterm>AlbumId</firstterm> setzt die ID des Albums nachdem gesucht wird. Dieses Element
|
|
|
- ist nur für Album und Photo Abfragen gültig. Im Fall von Photo Abfragen spezifiziert dieser
|
|
|
- Wert das Album das die angefragten Photos enthält. Die Album ID schließt sich gegenseitig
|
|
|
- mit dem Album Namen aus. Das Setzen des einen Entfernt den anderen.
|
|
|
+ <firstterm>AlbumId</firstterm> setzt die ID des Albums nachdem gesucht wird.
|
|
|
+ Dieses Element ist nur für Album und Photo Abfragen gültig. Im Fall von Photo
|
|
|
+ Abfragen spezifiziert dieser Wert das Album das die angefragten Photos enthält.
|
|
|
+ Die Album ID schließt sich gegenseitig mit dem Album Namen aus. Das Setzen des
|
|
|
+ einen Entfernt den anderen.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <firstterm>AlbumName</firstterm> setzt den Namen des Albums nachdem gesucht wird. Dieses
|
|
|
- Element ist nur für Album und Photo Abfragen gültig. Im Fall von Phofo Abfragen spezifiziert
|
|
|
- dieser Wert das Album das die angefragten Photos enthält. Der Album Name schließt sich
|
|
|
- gegenseitig mit der Album ID aus. Das Setzen des einen Entfernt den anderen.
|
|
|
+ <firstterm>AlbumName</firstterm> setzt den Namen des Albums nachdem gesucht
|
|
|
+ wird. Dieses Element ist nur für Album und Photo Abfragen gültig. Im Fall von
|
|
|
+ Photo Abfragen spezifiziert dieser Wert das Album das die angefragten Photos
|
|
|
+ enthält. Der Album Name schließt sich gegenseitig mit der Album ID aus. Das
|
|
|
+ Setzen des einen Entfernt den anderen.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <firstterm>PhotoId</firstterm> setzt die ID des Photos nachdem gesucht wird. Dieses
|
|
|
- Element ist nur für Photo Abfragen gültig.
|
|
|
+ <firstterm>PhotoId</firstterm> setzt die ID des Photos nachdem gesucht wird.
|
|
|
+ Dieses Element ist nur für Photo Abfragen gültig.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|
|
|
@@ -345,16 +368,16 @@ $query->setUser("sample.user");
|
|
|
<sect2 id="zend.gdata.photos.retrieval">
|
|
|
<title>Feeds und Einträge erhalten</title>
|
|
|
<para>
|
|
|
- Das Service besitzt Funktionen um einen Feed oder individuelle Einträge für Benutzer, Alben, und
|
|
|
- individuelle Photos zu erhalten.
|
|
|
+ Das Service besitzt Funktionen um einen Feed oder individuelle Einträge für Benutzer,
|
|
|
+ Alben, und individuelle Photos zu erhalten.
|
|
|
</para>
|
|
|
|
|
|
<sect3 id="zend.gdata.photos.user_retrieval">
|
|
|
<title>Einen Benutzer erhalten</title>
|
|
|
<para>
|
|
|
- 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 "<code>hidden</code>" markiert sind, zurückgegeben.
|
|
|
+ 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 "<code>hidden</code>" markiert sind, zurückgegeben.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -374,7 +397,8 @@ try {
|
|
|
]]></programlisting>
|
|
|
|
|
|
<para>
|
|
|
- Oder, der auf den Feed kann zugegriffen werden indem zuerst eine Abfrage erstellt wird:
|
|
|
+ Oder, der auf den Feed kann zugegriffen werden indem zuerst eine Abfrage erstellt
|
|
|
+ wird:
|
|
|
</para>
|
|
|
<programlisting role="php"><![CDATA[
|
|
|
$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
|
|
|
@@ -392,7 +416,8 @@ try {
|
|
|
]]></programlisting>
|
|
|
|
|
|
<para>
|
|
|
- Die Erstellung einer Abfrage bietet auch die Möglichkeit ein Benutzer Eintrags Objekt abzufragen:
|
|
|
+ Die Erstellung einer Abfrage bietet auch die Möglichkeit ein Benutzer Eintrags
|
|
|
+ Objekt abzufragen:
|
|
|
</para>
|
|
|
<programlisting role="php"><![CDATA[
|
|
|
$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
|
|
|
@@ -414,12 +439,13 @@ try {
|
|
|
<sect3 id="zend.gdata.photos.album_retrieval">
|
|
|
<title>Ein Album erhalten</title>
|
|
|
<para>
|
|
|
- Der Service unterstützt auch das erhalten eines Album Feeds und von Listen des Inhalts von Alben.
|
|
|
+ Der Service unterstützt auch das erhalten eines Album Feeds und von Listen des
|
|
|
+ Inhalts von Alben.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Auf einen Album Feed wird durch die Erstellung eines Abfrage Objekts zugegriffen und dessen
|
|
|
- Übergabe an <code>getAlbumFeed</code>:
|
|
|
+ Auf einen Album Feed wird durch die Erstellung eines Abfrage Objekts zugegriffen und
|
|
|
+ dessen Übergabe an <code>getAlbumFeed</code>:
|
|
|
</para>
|
|
|
<programlisting role="php"><![CDATA[
|
|
|
$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
|
|
|
@@ -438,13 +464,14 @@ try {
|
|
|
]]></programlisting>
|
|
|
|
|
|
<para>
|
|
|
- Alternativ kann dem Abfrage Objekt ein Album Name mit <code>setAlbumName</code> 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.
|
|
|
+ Alternativ kann dem Abfrage Objekt ein Album Name mit <code>setAlbumName</code>
|
|
|
+ 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.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Die Erstellung einer Abfragen bietet auch die Möglichkeit ein Album Eintrags Objekt abzufragen:
|
|
|
+ Die Erstellung einer Abfragen bietet auch die Möglichkeit ein Album Eintrags Objekt
|
|
|
+ abzufragen:
|
|
|
</para>
|
|
|
<programlisting role="php"><![CDATA[
|
|
|
$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
|
|
|
@@ -467,13 +494,13 @@ try {
|
|
|
<sect3 id="zend.gdata.photos.photo_retrieval">
|
|
|
<title>Ein Photo erhalten</title>
|
|
|
<para>
|
|
|
- Der Service unterstützt auch das erhalten eines Photo Feeds und von Listen von zugeordneten
|
|
|
- Kommentaren und Tags.
|
|
|
+ Der Service unterstützt auch das erhalten eines Photo Feeds und von Listen von
|
|
|
+ zugeordneten Kommentaren und Tags.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Auf einen Photo Feed wird durch die Erstellung eines Abfrage Objekts zugegriffen und dessen
|
|
|
- Übergabe an <code>getPhotoFeed</code>:
|
|
|
+ Auf einen Photo Feed wird durch die Erstellung eines Abfrage Objekts zugegriffen und
|
|
|
+ dessen Übergabe an <code>getPhotoFeed</code>:
|
|
|
</para>
|
|
|
<programlisting role="php"><![CDATA[
|
|
|
$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
|
|
|
@@ -493,7 +520,8 @@ try {
|
|
|
]]></programlisting>
|
|
|
|
|
|
<para>
|
|
|
- Die Erstellung einer Abfragen bietet auch die Möglichkeit ein Photo Eintrags Objekt abzufragen:
|
|
|
+ Die Erstellung einer Abfragen bietet auch die Möglichkeit ein Photo Eintrags Objekt
|
|
|
+ abzufragen:
|
|
|
</para>
|
|
|
<programlisting role="php"><![CDATA[
|
|
|
$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
|
|
|
@@ -517,14 +545,15 @@ try {
|
|
|
<sect3 id="zend.gdata.photos.comment_retrieval">
|
|
|
<title>Ein Kommentar erhalten</title>
|
|
|
<para>
|
|
|
- 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.
|
|
|
+ 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.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Die Durchführung von Aktionen auf jedem der Kommentare eines gegebenen Photos kann die folgt
|
|
|
- vollendet werden:
|
|
|
+ Die Durchführung von Aktionen auf jedem der Kommentare eines gegebenen Photos kann
|
|
|
+ die folgt vollendet werden:
|
|
|
</para>
|
|
|
<programlisting role="php"><![CDATA[
|
|
|
$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
|
|
|
@@ -554,12 +583,15 @@ try {
|
|
|
<sect3 id="zend.gdata.photos.tag_retrieval">
|
|
|
<title>Ein Tag erhalten</title>
|
|
|
<para>
|
|
|
- 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.
|
|
|
+ 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.
|
|
|
</para>
|
|
|
|
|
|
- <para>Performing an action on each of the tags on a given photo can be accomplished as follows:</para>
|
|
|
+ <para>
|
|
|
+ Das Ausführen einer Aktrion auf jedem Tag an gegebenen Photos kann wie folgt
|
|
|
+ durchgeführt werden:
|
|
|
+ </para>
|
|
|
<programlisting role="php"><![CDATA[
|
|
|
$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
|
|
|
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
|
|
|
@@ -589,11 +621,16 @@ try {
|
|
|
|
|
|
<sect2 id="zend.gdata.photos.creation">
|
|
|
<title>Einträge erstellen</title>
|
|
|
- <para>Der Service hat Funktionen für die Erstellung von Alben, Photos, Kommentaren und Tags.</para>
|
|
|
+ <para>
|
|
|
+ Der Service hat Funktionen für die Erstellung von Alben, Photos, Kommentaren und Tags.
|
|
|
+ </para>
|
|
|
|
|
|
<sect3 id="zend.gdata.photos.album_creation">
|
|
|
<title>Ein Album erstellen</title>
|
|
|
- <para>Der Service unterstützt die Erstellung eines neues Albums für authentifizierte Benutzer:</para>
|
|
|
+ <para>
|
|
|
+ Der Service unterstützt die Erstellung eines neues Albums für authentifizierte
|
|
|
+ Benutzer:
|
|
|
+ </para>
|
|
|
<programlisting role="php"><![CDATA[
|
|
|
$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
|
|
|
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
|
|
|
@@ -608,7 +645,10 @@ $service->insertAlbumEntry($entry);
|
|
|
|
|
|
<sect3 id="zend.gdata.photos.photo_creation">
|
|
|
<title>Ein Photo erstellen</title>
|
|
|
- <para>Der Service unterstützt die Erstellung eines neuen Photos für authentifizierte Benutzer:</para>
|
|
|
+ <para>
|
|
|
+ Der Service unterstützt die Erstellung eines neuen Photos für authentifizierte
|
|
|
+ Benutzer:
|
|
|
+ </para>
|
|
|
<programlisting role="php"><![CDATA[
|
|
|
$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
|
|
|
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
|
|
|
@@ -688,7 +728,9 @@ $service->insertTagEntry($entry, $photoEntry);
|
|
|
|
|
|
<sect3 id="zend.gdata.photos.album_deletion">
|
|
|
<title>Ein Album löschen</title>
|
|
|
- <para>Der Service unterstützt das Löschen von Alben für authentifizierte Benutzer:</para>
|
|
|
+ <para>
|
|
|
+ Der Service unterstützt das Löschen von Alben für authentifizierte Benutzer:
|
|
|
+ </para>
|
|
|
<programlisting role="php"><![CDATA[
|
|
|
$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
|
|
|
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
|
|
|
@@ -707,7 +749,9 @@ $service->deleteAlbumEntry($entry, true);
|
|
|
|
|
|
<sect3 id="zend.gdata.photos.photo_deletion">
|
|
|
<title>Löschen eines Photos</title>
|
|
|
- <para>Der Service unterstützt das Löschen von Photos für authentifizierte Benutzer:</para>
|
|
|
+ <para>
|
|
|
+ Der Service unterstützt das Löschen von Photos für authentifizierte Benutzer:
|
|
|
+ </para>
|
|
|
<programlisting role="php"><![CDATA[
|
|
|
$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
|
|
|
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
|
|
|
@@ -727,7 +771,9 @@ $service->deletePhotoEntry($entry, true);
|
|
|
|
|
|
<sect3 id="zend.gdata.photos.comment_deletion">
|
|
|
<title>Ein Kommentar löschen</title>
|
|
|
- <para>Der Service unterstützt das Löschen von Kommentaren für authentifizierte Benutzer:</para>
|
|
|
+ <para>
|
|
|
+ Der Service unterstützt das Löschen von Kommentaren für authentifizierte Benutzer:
|
|
|
+ </para>
|
|
|
<programlisting role="php"><![CDATA[
|
|
|
$service = Zend_Gdata_Photos::AUTH_SERVICE_NAME;
|
|
|
$client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
|
|
|
@@ -779,17 +825,17 @@ $service->deleteTagEntry($tagEntry, true);
|
|
|
<sect3 id="zend.gdata.photos.optimistic_concurrenty">
|
|
|
<title>Optimistische Gleichzeitigkeit (Notizen für das Löschen)</title>
|
|
|
<para>
|
|
|
- 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).
|
|
|
+ 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).
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Ein Beispiel davon wie die Versionierung wärend einer Löschung handzuhaben ist wird durch
|
|
|
- <code>deleteAlbumEntry</code> gezeigt:
|
|
|
+ Ein Beispiel davon wie die Versionierung wärend einer Löschung handzuhaben ist wird
|
|
|
+ durch <code>deleteAlbumEntry</code> gezeigt:
|
|
|
</para>
|
|
|
<programlisting role="php"><![CDATA[
|
|
|
// $album ist ein albumEntry der gelöscht werden soll
|