scriptotek/google-books

Package for interacting with the Google Books API

, _(*1)

php-google-books

Simple PHP package for working with the Google Books API. With Laravel5 integration. Doesn't yet support authentication, so it only works with public data. PRs are welcome., _(*2)

Install using Composer

Make sure you have Composer installed, then run, _(*3)

composer require scriptotek/google-books

in your project directory to get the latest stable version of the package., _(*4)

Usage

Start by creating a new client:, _(*5)

require_once('vendor/autoload.php');
use Scriptotek\GoogleBooks\GoogleBooks;

$books = new GoogleBooks(['key' => 'YOUR_API_KEY_HERE']);

Note that you can also use the API without specifying an API key, but you will then get a lower request quota. A UsageLimitExceeded exception is thrown when you reach the quota., _(*6)

Working with volumes

Getting a single volume by id:, _(*7)

$volume = $books->volumes->get('kdwPAQAAMAAJ');

or by ISBN:, _(*8)

$volume = $books->volumes->byIsbn('0521339057');

Search:, _(*9)

foreach ($books->volumes->search('Hello world') as $vol) {
    echo $vol->title . "\n";
}

Note that the search() method returns a generator that automatically fetches more results until the result list is depleted. If there are thousands of results this will of course take a long time to fetch, so you probably want to define a limit. Limits can be defined as an option: ['maxResults' => 10] inside the GoogleBooks class., _(*10)

Working with bookshelves

Getting a single bookshelf by user id and shelf id:, _(*11)

$shelf = $books->bookshelves->get('113555231101190020526', '1002');

List the public bookshelves of a user, and their volumes:, _(*12)

foreach ($books->bookshelves->byUser('113555231101190020526') as $shelf) {
    echo "<h2>$shelf->title</h2>\n";
    echo "<ul>\n";
    foreach ($shelf->getVolumes() as $vol) {
        echo "  <li>$vol->title</li>\n";
    }
    echo "</ul>\n";
}

Laravel 5 integration

This project ships with a service provider that you can add to the $providers array in your config/app.php:, _(*13)

Scriptotek\GoogleBooks\GoogleBooksServiceProvider::class,

There's also a facade you can add to the $aliases array if you like:, _(*14)

'GoogleBooks' => Scriptotek\GoogleBooks\GoogleBooksFacade::class,

Run, _(*15)

$ php artisan vendor:publish --provider="Scriptotek\GoogleBooks\GoogleBooksServiceProvider"

to create the config/googlebooks.php configuration file., _(*16)

Troubleshooting

If you get 403 Forbidden with, _(*17)

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "unknownLocation",
    "message": "Cannot determine user location for geographically restricted operation."
   }
  ],
  "code": 403,
  "message": "Cannot determine user location for geographically restricted operation."
 }
}

it means the Books API failed to locate you based on your ip address. Fix this by specifying the 2 letter ISO639 country code manually using the country option to the constructor:, _(*18)

$books = new GoogleBooks(['country' => 'NO']);