Puede acceder tanto a feeds públicos como privados usando la API de datos de Book Search API. Los feeds públicos no requieren ninguna autenticación, pero son de solo lectura. Si desea modificar bibliotecas de usuarios, enviar reseñas o calificaciones, o añadir etiquetas, entonces su cliente necesita autenticarse antes de solicitar feeds privados. Puede autenticarse usando cualquiera de dos enfoques: autenticación por proxy AuthSub o autenticación por nombre de usuario/contraseña con ClientLogin. Consulte la sección de autenticación en la Guía para desarrolladores de PHP para más detalles.

La API de datos de Book Search API proporciona una serie de feeds que enumeran colecciones de libros.

La acción más común es recuperar una lista de libros que coincidan con una consulta de búsqueda. Para ello, crea un objeto VolumeQuery y lo pasa al método Books::getVolumeFeed().

Por ejemplo, para realizar una consulta por palabra clave, con un filtro sobre la visibilidad para restringir los resultados a libros de vista parcial o completa, use los métodos setMinViewability() y setQuery() del objeto VolumeQuery. El siguiente fragmento de código imprime el título y la visibilidad de todos los volúmenes cuyos metadatos o texto coinciden con el término de búsqueda "domino":

$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();
}

La clase Query, y sus subclases como VolumeQuery, se encargan de construir URLs de feeds. El VolumeQuery mostrado arriba construye una URL equivalente a la siguiente:

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

Nota: Dado que los resultados de Book Search son públicos, puede realizar una consulta de Book Search sin autenticación.

Estos son algunos de los métodos más comunes de VolumeQuery para establecer parámetros de búsqueda:

setQuery(): Especifica un término de consulta de búsqueda. Book Search busca en todos los metadatos de libros y el texto completo de los libros que coincidan con el término. Los metadatos del libro incluyen títulos, palabras clave, descripciones, nombres de autores y temas. Tenga en cuenta que cualquier espacio, comilla u otra puntuación en el valor del parámetro debe estar escapado para URL (Use un signo más (+) para un espacio). Para buscar una frase exacta, encierre la frase entre comillas. Por ejemplo, para buscar libros que coincidan con la frase "spy plane", establezca el parámetro q a %22spy+plane%22. También puede usar cualquiera de los operadores de búsqueda avanzada compatibles con Book Search. Por ejemplo, jane+austen+-inauthor:austen devuelve coincidencias que mencionan (pero no están escritas por) Jane Austen.

setStartIndex(): Especifica el índice del primer resultado coincidente que debe incluirse en el conjunto de resultados. Este parámetro usa un índice basado en uno, lo que significa que el primer resultado es 1, el segundo resultado es 2 y así sucesivamente. Este parámetro funciona junto con el parámetro max-results para determinar qué resultados devolver. Por ejemplo, para solicitar el tercer conjunto de 10 resultados—resultados 21-30—establezca el parámetro start-index a 21 y el parámetro max-results a 10. Nota: Esto no es un mecanismo general de cursor. Si primero envía una consulta con ?start-index=1&max-results=10 y luego envía otra consulta con ?start-index=11&max-results=10, el servicio no puede garantizar que los resultados sean equivalentes a ?start-index=1&max-results=20, porque podrían haberse producido inserciones y eliminaciones entre las dos consultas.

setMaxResults(): Especifica el número máximo de resultados que deben incluirse en el conjunto de resultados. Este parámetro funciona junto con el parámetro start-index para determinar qué resultados devolver. El valor predeterminado de este parámetro es 10 y el valor máximo es 20.

setMinViewability(): Permite filtrar los resultados según el estado de visibilidad de los libros. Este parámetro acepta uno de tres valores: 'none' (el predeterminado, que devuelve todos los libros coincidentes sin importar la visibilidad), 'partial_view' (que devuelve solo libros que el usuario puede previsualizar o ver en su totalidad), o 'full_view' (que devuelve solo libros que el usuario puede ver en su totalidad).

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

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

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

Google Book Search proporciona varias colecciones de libros específicas del usuario, cada una con su propio feed.

La colección más importante es My Library del usuario, que representa los libros que el usuario desea recordar, organizar y compartir con otros. Esta es la colección que el usuario ve al acceder a su página de My Library.

$feed = $books->getUserLibraryFeed();

$query = $books->newVolumeQuery(
    'http://www.google.com/books/feeds/users' .
    '/USER_ID/collections/library/volumes');
$query->setQuery('bear');
$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);