Man kann sowohl auf öffentliche als auch private Feeds zugreifen indem man die Buchsuche Daten API verwendet. Öffentliche Feeds benötigen keine Authentifizierung, aber man kann Sie nur lesen. Wenn man Benutzerbibliotheken verändern oder bewerden will, oder Label hinzufügen will muß der eigene Client authentifiziert werden bevor man private Feeds anfragt. Er kann sich authentifizieren indem einer von zwei Möglichkeiten verwendet wird: AuthSub Proxy Authentifizierung oder ClientLogin Benutzername/Passwort Authentifizierung. Bitte referieren Sie zum » Authentifizierungs Kapitel im PHP Developer Guide für weitere Details.

Die Buchsuche Daten API bietet eine Anzahl an Feeds die Sammlungen von Büchern auflisten.

Die am meisten übliche Aktion ist das empfangen von Bücherlisten die einer Suchanfrage entsprechen. Um das zu tun muß ein VolumeQuery Objekt erstellt und an die Books::getVolumeFeed Methode übergeben werden.

Um zum Beispiel eine Schlüsselwortabfrage, mit einem Filter auf der Sichtbarkeit um die Ergebnisse auf partielle oder komplette sichtbare Bücher zu gegrenzen, durchzuführen müssen die setMinViewability und setQuery Methoden des VolumeQuery Objekts verwendet werden. Der folgende Codeschnipsel zeigt Titel und Sichtbarkeit aller Volumes deren Metadaten oder Texte dem Suchbegriff "domino" entsprechen:

$books = new Zend_Gdata_Books();
$query = $books->newVolumeQuery();

$query->setQuery('domino');
$query->setMinViewability('partial_view');

$feed = $books->getVolumeFeed($query);

foreach ($feed as $entry) {
    echo $entry->getVolumeId();
    echo $entry->getTitle();
    echo $entry->getViewability();
}

        

Die Query Klasse, und Subklassen wie VolumeQuery, sind dafür zuständig das Feed URL erzeugt werden. Der VolumeQuery der vorher gezeigt wurde erzeugt eine URL die der folgenden entspricht:

http://www.google.com/books/feeds/volumes?q=keyword&min-viewability=partial

        

Beachte: Da die Ergebnisse von Buchsuchen öffentlich sind, können Buchsuche Abfragen ohne Authentifizierung durchgeführt werden.

Hier sind einige der üblichsten VolumeQuery Methoden für das Setzen von Suchparametern:

setQuery: Spezifiziert einen Suchabfragebegriff. Buchsuchen durchsuchen alle Metadaten der Bücher und des kompletten Textes nach Büchern die dem Begriff entsprechen. Buchmetadaten enthalten Titel, Schlüsselwörter, Beschreibungen, Namen von Autoren, und Untertitel. Es ist zu beachten das alle Leerzeichen, Hochkomma oder andere Punktierungen im Parameterwert URL-escaped werden müssen. (Verwende ein Plus (+) für ein Leerzeichen.) Um nach einer exakten Phrase zu suchen muß die Phrase in Hochkomma eingeschlossen werden. Um zum Beispiel nach einem Buch zu suchen das der Phrase "spy plane" entspricht, muß der q Parameter auf %22spy+plane%22 gesetzt werden. Man kann jede der » zusätzlichen Suchoperatoren verwenden die von der Buchsuche unterstützt werden. Zum Beispiel gibt jane+austen+-inauthor:austen Entsprechungen zurück die Jane Austen erwähnen (aber nicht von Ihr geschrieben wurden).

setStartIndex: Spezifiziert den Index des ersten passenden Ergebnisses das im Ergebnisset enthalten sein sollte. Dieser Parameter verwendet einen eins-basierenden Index, was bedeutet das das erste Ergebnis 1 ist, das zweite Ergebnis 2 und so weiter. Dieser Parameter arbeitet in Verbindung mit dem max-results Parameter um festzustellen welche Ergebnisse zurückzugeben sind. Um zum Beispiel das dritte Set von 10er Ergebnissen zu erhalten, 21-30-set, muß der start-index Parameter auf 21 und der max-results Parameter auf 10 gesetzt werden. Es ist zu beachten das das kein genereller Cursor Mechanismus ist. Wenn man zuerst eine Abfrage mit ?start-index=1&max-results=10 und anschließend eine andere Anfrage mit ?start-index=11&max-results=10, kann der Service nicht garantieren das die Ergebnisse äquivalent sind, weil zwischen den zwei Anfragen Einfügungen oder Löschungen durchgeführt worden sein können.

setMaxResults: Spezifiziert die maximale Anzahl an Ergebnissen die im Ergebnisset enthalten sein sollen. Dieser Parameter arbeitet in Verbindung mit dem start-index Parameter um festzustellen welche Ergebnisse zurückgegeben werden sollen. Der Standartwert dieses Parameters ist 10 und der Maximalwert ist 20.

setMinViewability: Erlaubt es Ergebnisse entsprechend dem » Status der Sichtbarkeit der Bücher zu filtern. Dieser Parameter akzeptiert einen von drei Werten: 'none' (der Standardwert, der alle passenden Bücher zurückgibt Unabhängigkeit von der Sichtbarkeit), 'partial_view' (was nur Bücher zurückgibt die der Benutzer komplett oder teilweise sehen kann), oder 'full_view' (was nur Bücher zurückgibt die der Benutzer in Ihrer Komplettheit sehen kann).

http://www.google.com/books/p/PARTNER_COBRAND_ID?q=football

            

http://www.google.com/books/feeds/p/PARTNER_COBRAND_ID/volumes?q=football+-soccer

            

$query =
    $books->newVolumeQuery('http://www.google.com/books/p/PARTNER_COBRAND_ID');

            

Die Google Buchsuche bietet eine Anzahl von Benutzerspezifischen Buchsammlungen, jede mit Ihrem eigenen Feed.

The wichtigste Sammlung ist die My Library des Benutzers, die die Bücher repräsentiert die sich der Benutzer merken, organisieren und mit anderen Teilen will. Das ist die Sammlung die der Benutzer sieht wenn er auf seine oder ihre » My Library Seite zugreift.

$feed = $books->getUserLibraryFeed();

                

$query = $books->newVolumeQuery(
    'http://www.google.com/books/feeds/users/USER_ID/collections/library/volumes');
$query->setQuery('Bär');
$feed = $books->getVolumeFeed($query);

                

$query = $books->newVolumeQuery(
    'http://www.google.com/books/feeds/users/USER_ID/collections/library/volumes');
$query->setCategory(
$query->setCategory('favorites');
$feed = $books->getVolumeFeed($query);

                

$entry = new Zend_Gdata_Books_VolumeEntry();
$entry->setId(new Zend_Gdata_App_Extension_Id(VOLUME_ID));
$books->insertVolume(
    $entry,
    Zend_Gdata_Books::MY_LIBRARY_FEED_URI
);

                

$books->insertVolume(
    $entry,
    Zend_Gdata_Books::MY_LIBRARY_FEED_URI
);

                

$books->deleteVolume($entry);