- Harry Potter Deathly Hallows Part 1 Google Docs
- Google Drive Harry Potter English
- Harry Potter Book 1 Google Docs
Harry Potter and the Sorcerer's Stone, Chamber of Secrets, Prisoner of Azkaban, Goblet of Fire, Order of the Phoenix, Half-Blood Prince, Deathly Hallows and Ron Weasley, Hermione Granger, Albus. This map was created by a user. Learn how to create your own.
Download
|
This document details the background knowledge that you need in order to usethe Google Books API.
- Before you start
- Books API background
- Calling style
- Data format
Introduction
This document is intended for developers who want to write applications thatcan interact with the Google Books API. Google Bookshas a vision to digitize the world's books. You can use the Google Books API tosearch content, organize an authenticated user's personal library and modify itas well.
Before you start
Get a Google account
You need a Google accountfor testing purposes. If you already have a test account, then you're all set;you can visit the Google Books userinterface to set up, edit, or view your test data.
Get familiar with Books
If you're unfamiliar with Google Books concepts, you should read thisdocument and experiment with the user interfacebefore starting to code. This document assumes that you're familiar with webprogramming concepts and web data formats.
Learn about authorizing requests and identifying your application
When your application requests private data, the request must be authorized by an authenticated user who has access to that data.
In particular, all operations under 'My Library' in the Google Books API are considered to be private and require authentication and authorization. In addition, any operation that modifies Google Books data can be performed only by the user who owns that data.
When your application requests public data, the request doesn't need to authorized, but does need to be accompanied by an identifier, such as an API key.
For information about how to authorize requests and use API keys, see Authorizing requests and identifying your application in the Using the API document.
Books API background
Books concepts
Google Books is built upon four basic concepts:
- Volume: A volume represents the data that Google Books hosts about a book or magazine. It is the primary resource in the Books API. All other resources in this API either contain or annotate a volume.
- Bookshelf: A bookshelf is a collection of volumes. Google Books provides a set of predefined bookshelves for each user, some of which are completely managed by the user, some of which are automatically filled in based on user's activity, and some of which are mixed. Users can create, modify or delete other bookshelves, which are always filled with volumes manually. Bookshelves can be made private or public by the user.
Note: Creating and deleting bookshelves as well as modifying privacy settings on bookshelves can currently only be done through the Google Books site.
- Review: A review of a volume is a combination of a star rating and/or text. A user can submit one review per volume. Reviews are also available from outside sources and are attributed appropriately.
- Reading Position: A reading position indicates the last read position in a volume for a user. A user can only have one reading position per volume. If the user has not opened that volume before, then the reading position does not exist. The reading position can store detailed position information down to the resolution of a word. This information is always private to the user.
Books API data model
A resource is an individual data entity with a unique identifier. The BooksAPI operates on two types of resources, based on the concepts describedabove:
- Volume resource: Represents a volume.
- Bookshelf resource: Represents a single bookshelf for a particular user.
The Books API data model is based on groups of resources, called collections:
Google provides a set of pre-defined bookshelves for each user:
- Favorites: Mutable bookshelf.
- Purchased: Populated with volumes the user has purchased. The user cannot manually add or remove volumes.
- To Read: Mutable bookshelf.
- Reading Now: Mutable bookshelf.
- Have Read: Mutable bookshelf.
- Reviewed: Populated with volumes the user has reviewed. The user cannot manually add or remove volumes.
- Recently Viewed: Populated with volumes the user has recently opened in a web reader. The user cannot manually add volumes.
- My eBooks: Mutable bookshelf. Purchased books are automatically added, but can be manually removed.
- Books For You: Populated with personalized volume recommendations. If we have no recommendations for the user, this bookshelf does not exist.
Example bookshelves:
- 'Favorites'
- 'Harry Potter'
- 'My eBooks'
- 'Switch'
- 'Twilight'
- 'The Girl with the Dragon Tattoo'
Books API operations
You can invoke five different methods on collections and resources in theBooks API, as described in the following table.
Operation | Description | REST HTTP mappings |
---|---|---|
list | Lists a specified subset of resources within a collection. | GET on a collection URI. |
insert | Inserts a new resource into a collection (creating a new resource). | POST on a collection URI, where you pass in data for a new resource. |
get | Gets a specific resource. | GET on resource URI. |
update | Updates a specific resource. | PUT on resource URI, where you pass in data for the updated resource. |
delete | Deletes a specific resource. | DELETE on resource URI, where you pass in data for the resource to be deleted. |
The operations that are supported for the various types of resources aresummarized in the table below. Operations that apply to a user's private data arecalled 'My Library' operations, and they all require authentication.
Supported Operations | |||||
---|---|---|---|---|---|
list | insert | get | update | delete | |
Volumes | yes* | yes | |||
Bookshelves | yes* | yes, AUTHENTICATED | yes* | yes, AUTHENTICATED | yes, AUTHENTICATED |
Reading Positions | yes, AUTHENTICATED | yes, AUTHENTICATED | yes, AUTHENTICATED | yes, AUTHENTICATED |
*Both AUTHENTICATED andunauthenticated versions of these operations are available, where theauthenticated requests operate on the user's private 'My Library' data, andunauthenticated requests operate on public data only.
Calling styles
There are several ways to invoke the API:
- Using REST directly
- Using REST from JavaScript (no server-side code required)
REST
REST is a style of software architecture that provides a convenient and consistent approach to requesting and modifying data.
The term REST is short for 'Representational State Transfer.' In the context of Google APIs, it refers to using HTTP verbs to retrieve and modify representations of data stored by Google.
In a RESTful system, resources are stored in a data store; a client sends a request that the server perform a particular action (such as creating, retrieving, updating, or deleting a resource), and the server performs the action and sends a response, often in the form of a representation of the specified resource.
In Google's RESTful APIs, the client specifies an action using an HTTP verb such as POST
, GET
, PUT
, or DELETE
. It specifies a resource by a globally-unique URI of the following form:
Because all API resources have unique HTTP-accessible URIs, REST enables data caching and is optimized to work with the web's distributed infrastructure.
You may find the method definitions in the HTTP 1.1 standards documentation useful; they include specifications for GET
, POST
, PUT
, and DELETE
.
REST in the Books API
The supported Books operations map directly to REST HTTP verbs, as describedin Books API operations.
Harry Potter Deathly Hallows Part 1 Google Docs
The specific format for Books API URIs are:
where resourceID
is the identifier for a volumeor bookshelf resource, and parameters
areany parameters to apply to the query. See Query parameter reference for details.
The format of the resourceID
path extensions lets you identify the resource you're currently operating on, for example:
Note that operations with mylibrary
in the URI apply only to thecurrently authenticated user's private library data. The full set of URIs usedfor each supported operation in the API is summarized in the Books API Reference document.
Here are a couple of examples of how this works in the Books API.
Perform a search for quilting:
Get information on volume s1gVAAAAYAAJ:
REST from JavaScript
You can invoke the Books API using REST from JavaScript (also called JSON-P), using the callback
query parameter and a callback function. This allows you to write rich applications that display Books data without writing any server side code.
Note: You can call authenticated methods by passing an OAuth 2.0 token using the access_token
parameter. To obtain an OAuth 2.0 token for use with JavaScript, follow the instructions described in OAuth 2.0 for client-side web applications. In the 'API Access' tab of the APIs Console, be sure set up a Client ID for web applications, and to use those OAuth 2.0 credentials when getting your token.
The following example uses this approach to display search results for 'harry potter':
Data format
Google Drive Harry Potter English
JSON
Harry Potter Book 1 Google Docs
JSON (JavaScript Object Notation) is a common, language-independent data format that provides a simple text representation of arbitrary data structures. For more information, see json.org.