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);
]]>