Verwenden der Google Dokumente Listen Daten API
Die Google Dokumente Listen Daten API erlaubt es Client Anwendungen Dokumente zu Google
Dokumente hochzuladen und diese in der Form von Google Daten API ("GData") Feeds
aufzulisten. Die Client Anwendung kann eine Liste von Benutzer Dokumenten anfragen, und den
Inhalt in einem existierenden Dokument abfragen.
Siehe
http://code.google.com/apis/documents/overview.html
für weitere Informationen über die Google Dokumente Listen API.
Eine Liste von Dokumenten erhalten
Man kann eine Liste von den Google Dokumenten für einen bestimmten Benutzer erhalten
indem die getDocumentListFeed Methode des Docs Services verwendet wird.
Das Service gibt ein Zend_Gdata_Docs_DocumentListFeed Objekt
zurück das eine Liste von dokumenten enthält die mit dem authentifizierten Benutzer
assoziiert sind.
getDocumentListFeed();
]]>
Das sich ergebende Zend_Gdata_Docs_DocumentListFeed Objekt
repräsentiert die Antwort des Servers. Dieser Feed enthält eine Liste von
Zend_Gdata_Docs_DocumentListEntry Objekten
($feed->entries), wobei jeder von Ihnen ein einzelnes Google Dokument
repräsentiert.
Ein Dokument hochladen
Man kann ein neues Google Dokument erstellen indem ein Wortverarbeitungs Dokument, eine
Tabellenkalkulation oder eine Präsentation hochgeladen wird. Dieses Beispiel ist vom
interaktiven Docs.php Beispiel welches mit der Bibliothek kommt. Es demonstriert das
Hochladen einer Datei und das Ausdrucken der Information über das Ergebnis vom Server.
uploadFile($fileToUpload, $originalFileName,
null, Zend_Gdata_Docs::DOCUMENTS_LIST_FEED_URI);
echo "Neuer Titel des Dokuments: ";
if ($html) {
// Die URL der HTML Ansicht dieses Dokuments finden.
$alternateLink = '';
foreach ($newDocumentEntry->link as $link) {
if ($link->getRel() === 'alternate') {
$alternateLink = $link->getHref();
}
}
// Den Titellink zum dokument auf docs.google.com erstellen.
echo "\n";
}
echo $newDocumentEntry->title."\n";
if ($html) {echo "\n";}
}
]]>
Den Dokumenten Feed durchsuchen
Die Dokumenten Liste kann durchsucht werden indem einer der
standardmäßigen
Google Daten API Abfrageparameter verwendet wird. Kategorien werden verwendet um
den Typ des Dokuments das zurückgegeben wird (Wortverarbeitungs Dokument,
Tabellenkalkulation) einzuschränken. Detailiertere Informationen über Parameter die
speziell in der Dokumenten Liste vorhanden sind können in der
Dokumenten
Listen Daten API Referenz Anleitung gefunden werden.
Eine Liste von Wortverarbeitungs Dokumenten erhalten
Ein Feed der alle Dokumente eines speziellen Typs enthält kann auch angefragt
werden. Um zum Beispiel eine Liste von eigenen Wortverarbeitungs Dokumenten zu
sehen, würde man eine Kategorieanfrage wie folgt durchführen.
getDocumentListFeed(
'http://docs.google.com/feeds/documents/private/full/-/document');
]]>
Eine Liste von Tabellenkalkulationen erhalten
Um eine Liste aller eigenen Google Tabellenkalkulationen zu erhalten kann die
folgende Abfrage verwendet werden:
getDocumentListFeed(
'http://docs.google.com/feeds/documents/private/full/-/spreadsheet');
]]>
Eine Textabfrage durchführen
Der Inhalt von Dokumenten kann durch Verwendung von
Zend_Gdata_Docs_Query in der Abfrage durchsucht werden. Ein
Abfrage Objekt kann verwendet werden um eine Abfrage URI zu erstellen, wobei der
Suchbegriff als Parameter übergeben wird. Hier ist eine Beispielmethode welche die
Dokumenten Liste nach Dokumenten abfrage die den Suchstring enthalten:
setQuery($query);
$feed = $client->getDocumentListFeed($docsQuery);
]]>