ZF Zend Framework

Behind the Site

Programmer's Reference Guide

Google Kalender verwenden
Zend_Gdata
Referenzhandbuch für Programmierer

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.

  1. $service = Zend_Gdata_Docs::AUTH_SERVICE_NAME;
  2. $client = Zend_Gdata_ClientLogin::getHttpClient($user, $pass, $service);
  3. $docs = new Zend_Gdata_Docs($client);
  4. $feed = $docs->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.

  1. /**
  2. * Ein spezielles Dokument hochladen
  3. *
  4. * @param Zend_Gdata_Docs $docs Das Service Objekt das für die Kommunikation
  5. *                              mit dem Google Dokument Service verwendet wird
  6. * @param boolean $html True Wenn die Ausgabe für die Ausgabe in einem Web
  7. *                           Browser formatiert sein soll
  8. * @param string $originalFileName Der Name der Datei die hochgeladen werden
  9. *                                 soll. Der MIME-Typ dieser Datei wird von der
  10. *                                 Erweiterung des Dateinamens eruiert. Zum
  11. *                                 Beispiel wird test.csv als Komma geteilter
  12. *                                 Inhalt hochgeladen und in eine
  13. *                                 Tabellenkalkulation konvertiert
  14. * @param string $temporaryFileLocation (Optional) Die Datei in der die Daten
  15. *                                      für das Dokument gespeichert werden.
  16. *                                      Das wird verwendet wenn die Datei von
  17. *                                      der Maschine des Clients zum Server
  18. *                                      hochgeladen und in einer temporären
  19. *                                      Datei gespeichert wurde die keine
  20. *                                      Erweiterung hat. Wenn dieser Parameter
  21. *                                      null ist, wird die Datei von
  22. *                                      originalFileName gelesen.
  23. */
  24. function uploadDocument($docs, $html, $originalFileName,
  25.                         $temporaryFileLocation) {
  26.   $fileToUpload = $originalFileName;
  27.   if ($temporaryFileLocation) {
  28.     $fileToUpload = $temporaryFileLocation;
  29.   }
  30.  
  31.   // Datei hochladen un in ein Google Dokument konvertieren Der originale
  32.   // Dateiname wird als Titel des Dokuments verwendet und der MIME Typ wird
  33.   // basieren auf der erweiterung des originalen Dateinamens eruiert.
  34.   $newDocumentEntry = $docs->uploadFile($fileToUpload, $originalFileName,
  35.       null, Zend_Gdata_Docs::DOCUMENTS_LIST_FEED_URI);
  36.  
  37.   echo "Neuer Titel des Dokuments: ";
  38.  
  39.   if ($html) {
  40.       // Die URL der HTML Ansicht dieses Dokuments finden.
  41.       $alternateLink = '';
  42.       foreach ($newDocumentEntry->link as $link) {
  43.           if ($link->getRel() === 'alternate') {
  44.               $alternateLink = $link->getHref();
  45.           }
  46.       }
  47.       // Den Titellink zum dokument auf docs.google.com erstellen.
  48.       echo "<a href=\"$alternateLink\">\n";
  49.   }
  50.   echo $newDocumentEntry->title."\n";
  51.   if ($html) {echo "</a>\n";}
  52. }

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.

  1. $feed = $docs->getDocumentListFeed(
  2.     '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:

  1. $feed = $docs->getDocumentListFeed(
  2.     '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:

  1. $docsQuery = new Zend_Gdata_Docs_Query();
  2. $docsQuery->setQuery($query);
  3. $feed = $client->getDocumentListFeed($docsQuery);
Google Kalender verwenden
Zend_Gdata
Referenzhandbuch für Programmierer
blog comments powered by Disqus

Select a Version

Languages Available

Components

Search the Manual

    • Navigation