Cara menggunakan openapi-python-client: command not found

This document is intended for developers who want to write applications that can interact with the Books API. Google Books has a mission to digitize the world's book content and make it more discoverable on the Web. The Books API is a way to search and access that content, as well as to create and view personalization around that content.

If you're unfamiliar with Google Books concepts, you should read Getting Started before starting to code.

Authorizing requests and identifying your application

Every request your application sends to the Books API needs to identify your application to Google. There are two ways to identify your application: using an (which also authorizes the request) and/or using the application's . Here's how to determine which of those options to use:

  • If the request requires authorization (such as a request for an individual's private data), then the application must provide an OAuth 2.0 token with the request. The application may also provide the API key, but it doesn't have to.
  • If the request doesn't require authorization (such as a request for public data), then the application must provide either the API key or an OAuth 2.0 token, or both—whatever option is most convenient for you.

About authorization protocols

Your application must use OAuth 2.0 to authorize requests. No other authorization protocols are supported. If your application uses Sign In With Google, some aspects of authorization are handled for you.

Authorizing requests with OAuth 2.0

Requests to the Books API for non-public user data must be authorized by an authenticated user.

The details of the authorization process, or "flow," for OAuth 2.0 vary somewhat depending on what kind of application you're writing. The following general process applies to all application types:

  1. When you create your application, you register it using the Google API Console. Google then provides information you'll need later, such as a client ID and a client secret.
  2. Activate the Books API in the Google API Console. (If the API isn't listed in the API Console, then skip this step.)
  3. When your application needs access to user data, it asks Google for a particular scope of access.
  4. Google displays a consent screen to the user, asking them to authorize your application to request some of their data.
  5. If the user approves, then Google gives your application a short-lived access token.
  6. Your application requests user data, attaching the access token to the request.
  7. If Google determines that your request and the token are valid, it returns the requested data.

Some flows include additional steps, such as using refresh tokens to acquire new access tokens. For detailed information about flows for various types of applications, see Google's OAuth 2.0 documentation.

Here's the OAuth 2.0 scope information for the Books API:

https://www.googleapis.com/auth/books

To request access using OAuth 2.0, your application needs the scope information, as well as information that Google supplies when you register your application (such as the client ID and the client secret).

Tip: The Google APIs client libraries can handle some of the authorization process for you. They are available for a variety of programming languages; check the page with libraries and samples for more details.

Acquiring and using an API key

Requests to the Books API for public data must be accompanied by an identifier, which can be an API key or an access token.

To acquire an API key:

  1. Open the Credentials page in the API Console.
  2. This API supports two types of credentials. Create whichever credentials are appropriate for your project:
    • OAuth 2.0: Whenever your application requests private user data, it must send an OAuth 2.0 token along with the request. Your application first sends a client ID and, possibly, a client secret to obtain a token. You can generate OAuth 2.0 credentials for web applications, service accounts, or installed applications.

      For more information, see the OAuth 2.0 documentation.

    • API keys: A request that does not provide an OAuth 2.0 token must send an API key. The key identifies your project and provides API access, quota, and reports.

      The API supports several types of restrictions on API keys. If the API key that you need doesn't already exist, then create an API key in the Console by clicking Create credentials  > API key. You can restrict the key before using it in production by clicking Restrict key and selecting one of the Restrictions.

To keep your API keys secure, follow the best practices for securely using API keys.

After you have an API key, your application can append the query parameter

https://books.google.com/books?uid=11122233344455566778&source=gbs_lp_bookshelf_list
7 to all request URLs.

The API key is safe for embedding in URLs; it doesn't need any encoding.

Google Books IDs

You need to specify ID fields with certain API method calls. There are three types of IDs used within Google Books:

  • Volume IDs - Unique strings given to each volume that Google Books knows about. An example of a volume ID is
    https://books.google.com/books?uid=11122233344455566778&source=gbs_lp_bookshelf_list
    8. You can use the API to get the volume ID by making a request that returns a Volume resource; you can find the volume ID in its
    https://books.google.com/books?uid=11122233344455566778&source=gbs_lp_bookshelf_list
    9 field.
  • Bookshelf IDs - Numeric values given to a bookshelf in a user's library. Google provides some pre-defined shelves for every user with the following IDs:
    • Favorites: 0
    • Purchased: 1
    • To Read: 2
    • Reading Now: 3
    • Have Read: 4
    • Reviewed: 5
    • Recently Viewed: 6
    • My eBooks: 7
    • Books For You: 8 If we have no recommendations for the user, this shelf does not exist.
    Custom shelves have IDs greater than 1000. A bookshelf ID is unique for a given user, i.e., two users can have a bookshelf with the same ID that refer to different bookshelves. You can use the API to get the bookshelf ID by making a request that returns a Bookshelf resource; you can find the bookshelf ID in its
    https://books.google.com/books?uid=11122233344455566778&source=gbs_lp_bookshelf_list
    9 field.
  • User IDs - Unique numeric values assigned to each user. These values are not necessarily the same ID value used in other Google services. Currently, the only way retrieve the user ID is to extract it from the selfLink in a Bookshelf resource retrieved with an authenticated request. Users can also obtain their own user ID from the Books site. A user cannot obtain the user ID for another user via the API or the Books site; the other user would have to share that information explicitly, by email for example.

IDs on Google Books site

The IDs you use with the Books API are the same IDs used on the Google Books site.

  • Volume ID

    When viewing a particular volume on the site, you can find the volume ID in the

    https://books.google.com/books?uid=11122233344455566778&source=gbs_lp_bookshelf_list
    9 URL parameter. Here is an example:

    https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
  • Bookshelf ID

    When viewing a particular bookshelf on the site, you can find the bookshelf ID in the

    https://www.googleapis.com/books/v1/volumes?q=search+terms
    
    2 URL parameter. Here is an example:

    https://books.google.com/books?hl=en&as_coll=0&num=10&uid=11122233344455566778&source=gbs_slider_cls_metadata_0_mylibrary
  • User ID

    When viewing your library on the site, you can find the user ID in the

    https://www.googleapis.com/books/v1/volumes?q=search+terms
    
    3 URL parameter. Here is an example:

    https://books.google.com/books?uid=11122233344455566778&source=gbs_lp_bookshelf_list

Setting User Location

Google Books respects copyright, contract, and other legal restrictions associated with the end user's location. As a result, some users might not be able to access book content from certain countries. For example, certain books are "previewable" only in the United States; we omit such preview links for users in other countries. Therefore, the API results are restricted based on your server or client application's IP address.

Working with volumes

You can perform a volumes search by sending an HTTP

https://www.googleapis.com/books/v1/volumes?q=search+terms
4 request to the following URI:

https://www.googleapis.com/books/v1/volumes?q=search+terms

This request has a single required parameter:

  • https://www.googleapis.com/books/v1/volumes?q=search+terms
    
    5 - Search for volumes that contain this text string. There are special keywords you can specify in the search terms to search in particular fields, such as:
    • https://www.googleapis.com/books/v1/volumes?q=search+terms
      
      6 Returns results where the text following this keyword is found in the title.
    • https://www.googleapis.com/books/v1/volumes?q=search+terms
      
      7 Returns results where the text following this keyword is found in the author.
    • https://www.googleapis.com/books/v1/volumes?q=search+terms
      
      8 Returns results where the text following this keyword is found in the publisher.
    • https://www.googleapis.com/books/v1/volumes?q=search+terms
      
      9 Returns results where the text following this keyword is listed in the category list of the volume.
    • GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
      0 Returns results where the text following this keyword is the ISBN number.
    • GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
      1 Returns results where the text following this keyword is the Library of Congress Control Number.
    • GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
      2 Returns results where the text following this keyword is the Online Computer Library Center number.

Request

Here is an example of searching for Daniel Keyes' "Flowers for Algernon":

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey

Note: Performing a search does not require authentication, so you do not have to provide the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
3 HTTP header with the
https://www.googleapis.com/books/v1/volumes?q=search+terms
4 request. However, if the call is made with authentication, each Volume will include user-specific information, such as purchased status.

Response

If the request succeeds, the server responds with a

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
5 HTTP status code and the volume results:

200 OK

{
 "kind": "books#volumes",
 "items": [
  {
   "kind": "books#volume",
   "id": "_ojXNuzgHRcC",
   "etag": "OTD2tB19qn4",
   "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
   "volumeInfo": {
    "title": "Flowers",
    "authors": [
     "Vijaya Khisty Bodach"
    ],
   ...
  },
  {
   "kind": "books#volume",
   "id": "RJxWIQOvoZUC",
   "etag": "NsxMT6kCCVs",
   "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
   "volumeInfo": {
    "title": "Flowers",
    "authors": [
     "Gail Saunders-Smith"
    ],
    ...
  },
  {
   "kind": "books#volume",
   "id": "zaRoX10_UsMC",
   "etag": "pm1sLMgKfMA",
   "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
   "volumeInfo": {
    "title": "Flowers",
    "authors": [
     "Paul McEvoy"
    ],
    ...
  },
  "totalItems": 3
}

Optional query parameters

In addition to the , you can use the following query parameters when performing a volumes search.

Download Format

You use the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
6 parameter to restrict the returned results to volumes that have an available download format of
GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
7 by setting theto the value
GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
7.

The following example searches for books with an epub download available:

GET https://www.googleapis.com/books/v1/volumes?q=pride+prejudice&download=epub&key=yourAPIKey
Filtering

You can use the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
9 parameter to restrict the returned results further by setting it the to one of the following values:

  • 200 OK
    
    {
     "kind": "books#volumes",
     "items": [
      {
       "kind": "books#volume",
       "id": "_ojXNuzgHRcC",
       "etag": "OTD2tB19qn4",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Vijaya Khisty Bodach"
        ],
       ...
      },
      {
       "kind": "books#volume",
       "id": "RJxWIQOvoZUC",
       "etag": "NsxMT6kCCVs",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Gail Saunders-Smith"
        ],
        ...
      },
      {
       "kind": "books#volume",
       "id": "zaRoX10_UsMC",
       "etag": "pm1sLMgKfMA",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Paul McEvoy"
        ],
        ...
      },
      "totalItems": 3
    }
    
    0 - Returns results where at least parts of the text are previewable.
  • 200 OK
    
    {
     "kind": "books#volumes",
     "items": [
      {
       "kind": "books#volume",
       "id": "_ojXNuzgHRcC",
       "etag": "OTD2tB19qn4",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Vijaya Khisty Bodach"
        ],
       ...
      },
      {
       "kind": "books#volume",
       "id": "RJxWIQOvoZUC",
       "etag": "NsxMT6kCCVs",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Gail Saunders-Smith"
        ],
        ...
      },
      {
       "kind": "books#volume",
       "id": "zaRoX10_UsMC",
       "etag": "pm1sLMgKfMA",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Paul McEvoy"
        ],
        ...
      },
      "totalItems": 3
    }
    
    1 - Only returns results where all of the text is viewable.
  • 200 OK
    
    {
     "kind": "books#volumes",
     "items": [
      {
       "kind": "books#volume",
       "id": "_ojXNuzgHRcC",
       "etag": "OTD2tB19qn4",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Vijaya Khisty Bodach"
        ],
       ...
      },
      {
       "kind": "books#volume",
       "id": "RJxWIQOvoZUC",
       "etag": "NsxMT6kCCVs",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Gail Saunders-Smith"
        ],
        ...
      },
      {
       "kind": "books#volume",
       "id": "zaRoX10_UsMC",
       "etag": "pm1sLMgKfMA",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Paul McEvoy"
        ],
        ...
      },
      "totalItems": 3
    }
    
    2 - Only returns results that are free Google eBooks.
  • 200 OK
    
    {
     "kind": "books#volumes",
     "items": [
      {
       "kind": "books#volume",
       "id": "_ojXNuzgHRcC",
       "etag": "OTD2tB19qn4",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Vijaya Khisty Bodach"
        ],
       ...
      },
      {
       "kind": "books#volume",
       "id": "RJxWIQOvoZUC",
       "etag": "NsxMT6kCCVs",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Gail Saunders-Smith"
        ],
        ...
      },
      {
       "kind": "books#volume",
       "id": "zaRoX10_UsMC",
       "etag": "pm1sLMgKfMA",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Paul McEvoy"
        ],
        ...
      },
      "totalItems": 3
    }
    
    3 - Only returns results that are Google eBooks with a price.
  • 200 OK
    
    {
     "kind": "books#volumes",
     "items": [
      {
       "kind": "books#volume",
       "id": "_ojXNuzgHRcC",
       "etag": "OTD2tB19qn4",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Vijaya Khisty Bodach"
        ],
       ...
      },
      {
       "kind": "books#volume",
       "id": "RJxWIQOvoZUC",
       "etag": "NsxMT6kCCVs",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Gail Saunders-Smith"
        ],
        ...
      },
      {
       "kind": "books#volume",
       "id": "zaRoX10_UsMC",
       "etag": "pm1sLMgKfMA",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Paul McEvoy"
        ],
        ...
      },
      "totalItems": 3
    }
    
    4 - Only returns results that are Google eBooks, paid or free. Examples of non-eBooks would be publisher content that is available in limited preview and not for sale, or magazines.

The following example restricts search results to those available as free eBooks:

GET https://www.googleapis.com/books/v1/volumes?q=flowers&filter=free-ebooks&key=yourAPIKey
Pagination

You can paginate the volumes list by specifying two values in the parameters for the request:

  • 200 OK
    
    {
     "kind": "books#volumes",
     "items": [
      {
       "kind": "books#volume",
       "id": "_ojXNuzgHRcC",
       "etag": "OTD2tB19qn4",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Vijaya Khisty Bodach"
        ],
       ...
      },
      {
       "kind": "books#volume",
       "id": "RJxWIQOvoZUC",
       "etag": "NsxMT6kCCVs",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Gail Saunders-Smith"
        ],
        ...
      },
      {
       "kind": "books#volume",
       "id": "zaRoX10_UsMC",
       "etag": "pm1sLMgKfMA",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Paul McEvoy"
        ],
        ...
      },
      "totalItems": 3
    }
    
    5 - The position in the collection at which to start. The index of the first item is 0.
  • 200 OK
    
    {
     "kind": "books#volumes",
     "items": [
      {
       "kind": "books#volume",
       "id": "_ojXNuzgHRcC",
       "etag": "OTD2tB19qn4",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Vijaya Khisty Bodach"
        ],
       ...
      },
      {
       "kind": "books#volume",
       "id": "RJxWIQOvoZUC",
       "etag": "NsxMT6kCCVs",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Gail Saunders-Smith"
        ],
        ...
      },
      {
       "kind": "books#volume",
       "id": "zaRoX10_UsMC",
       "etag": "pm1sLMgKfMA",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Paul McEvoy"
        ],
        ...
      },
      "totalItems": 3
    }
    
    6 - The maximum number of results to return. The default is 10, and the maximum allowable value is 40.
Print Type

You can use the

200 OK

{
 "kind": "books#volumes",
 "items": [
  {
   "kind": "books#volume",
   "id": "_ojXNuzgHRcC",
   "etag": "OTD2tB19qn4",
   "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
   "volumeInfo": {
    "title": "Flowers",
    "authors": [
     "Vijaya Khisty Bodach"
    ],
   ...
  },
  {
   "kind": "books#volume",
   "id": "RJxWIQOvoZUC",
   "etag": "NsxMT6kCCVs",
   "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
   "volumeInfo": {
    "title": "Flowers",
    "authors": [
     "Gail Saunders-Smith"
    ],
    ...
  },
  {
   "kind": "books#volume",
   "id": "zaRoX10_UsMC",
   "etag": "pm1sLMgKfMA",
   "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
   "volumeInfo": {
    "title": "Flowers",
    "authors": [
     "Paul McEvoy"
    ],
    ...
  },
  "totalItems": 3
}
7 parameter to restrict the returned results to a specific print or publication type by setting it to one of the following values:

  • 200 OK
    
    {
     "kind": "books#volumes",
     "items": [
      {
       "kind": "books#volume",
       "id": "_ojXNuzgHRcC",
       "etag": "OTD2tB19qn4",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Vijaya Khisty Bodach"
        ],
       ...
      },
      {
       "kind": "books#volume",
       "id": "RJxWIQOvoZUC",
       "etag": "NsxMT6kCCVs",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Gail Saunders-Smith"
        ],
        ...
      },
      {
       "kind": "books#volume",
       "id": "zaRoX10_UsMC",
       "etag": "pm1sLMgKfMA",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Paul McEvoy"
        ],
        ...
      },
      "totalItems": 3
    }
    
    8 - Does not restrict by print type (default).
  • 200 OK
    
    {
     "kind": "books#volumes",
     "items": [
      {
       "kind": "books#volume",
       "id": "_ojXNuzgHRcC",
       "etag": "OTD2tB19qn4",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Vijaya Khisty Bodach"
        ],
       ...
      },
      {
       "kind": "books#volume",
       "id": "RJxWIQOvoZUC",
       "etag": "NsxMT6kCCVs",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Gail Saunders-Smith"
        ],
        ...
      },
      {
       "kind": "books#volume",
       "id": "zaRoX10_UsMC",
       "etag": "pm1sLMgKfMA",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Paul McEvoy"
        ],
        ...
      },
      "totalItems": 3
    }
    
    9 - Returns only results that are books.
  • GET https://www.googleapis.com/books/v1/volumes?q=pride+prejudice&download=epub&key=yourAPIKey
    
    0 - Returns results that are magazines.

The following example restricts search results to magazines:

GET https://www.googleapis.com/books/v1/volumes?q=time&printType=magazines&key=yourAPIKey
Projection

You can use the

GET https://www.googleapis.com/books/v1/volumes?q=pride+prejudice&download=epub&key=yourAPIKey
1 parameter with one of the following values to specify a predefined set of Volume fields to return:

  • 200 OK
    
    {
     "kind": "books#volumes",
     "items": [
      {
       "kind": "books#volume",
       "id": "_ojXNuzgHRcC",
       "etag": "OTD2tB19qn4",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Vijaya Khisty Bodach"
        ],
       ...
      },
      {
       "kind": "books#volume",
       "id": "RJxWIQOvoZUC",
       "etag": "NsxMT6kCCVs",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Gail Saunders-Smith"
        ],
        ...
      },
      {
       "kind": "books#volume",
       "id": "zaRoX10_UsMC",
       "etag": "pm1sLMgKfMA",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Paul McEvoy"
        ],
        ...
      },
      "totalItems": 3
    }
    
    1 - Returns all Volume fields.
  • GET https://www.googleapis.com/books/v1/volumes?q=pride+prejudice&download=epub&key=yourAPIKey
    
    3 - Returns only certain fields. See field descriptions marked with double asterisks in the to find out which fields are included.

The following example returns search results with limited volume information:

https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
0
Sorting

By default, a volumes search request returns 

200 OK

{
 "kind": "books#volumes",
 "items": [
  {
   "kind": "books#volume",
   "id": "_ojXNuzgHRcC",
   "etag": "OTD2tB19qn4",
   "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
   "volumeInfo": {
    "title": "Flowers",
    "authors": [
     "Vijaya Khisty Bodach"
    ],
   ...
  },
  {
   "kind": "books#volume",
   "id": "RJxWIQOvoZUC",
   "etag": "NsxMT6kCCVs",
   "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
   "volumeInfo": {
    "title": "Flowers",
    "authors": [
     "Gail Saunders-Smith"
    ],
    ...
  },
  {
   "kind": "books#volume",
   "id": "zaRoX10_UsMC",
   "etag": "pm1sLMgKfMA",
   "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
   "volumeInfo": {
    "title": "Flowers",
    "authors": [
     "Paul McEvoy"
    ],
    ...
  },
  "totalItems": 3
}
6 results, where 
200 OK

{
 "kind": "books#volumes",
 "items": [
  {
   "kind": "books#volume",
   "id": "_ojXNuzgHRcC",
   "etag": "OTD2tB19qn4",
   "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
   "volumeInfo": {
    "title": "Flowers",
    "authors": [
     "Vijaya Khisty Bodach"
    ],
   ...
  },
  {
   "kind": "books#volume",
   "id": "RJxWIQOvoZUC",
   "etag": "NsxMT6kCCVs",
   "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
   "volumeInfo": {
    "title": "Flowers",
    "authors": [
     "Gail Saunders-Smith"
    ],
    ...
  },
  {
   "kind": "books#volume",
   "id": "zaRoX10_UsMC",
   "etag": "pm1sLMgKfMA",
   "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
   "volumeInfo": {
    "title": "Flowers",
    "authors": [
     "Paul McEvoy"
    ],
    ...
  },
  "totalItems": 3
}
6 is the parameter used in pagination (above), ordered by relevance to search terms.

You can change the ordering by setting the 

GET https://www.googleapis.com/books/v1/volumes?q=pride+prejudice&download=epub&key=yourAPIKey
6 parameter to be one of these values:

  • GET https://www.googleapis.com/books/v1/volumes?q=pride+prejudice&download=epub&key=yourAPIKey
    
    7 - Returns results in order of the relevance of search terms (this is the default).
  • GET https://www.googleapis.com/books/v1/volumes?q=pride+prejudice&download=epub&key=yourAPIKey
    
    8 - Returns results in order of most recently to least recently published.

The following example lists results by published date, newest to oldest:

https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
1

Retrieving a specific volume

You can retrieve information for a specific volume by sending an HTTP

https://www.googleapis.com/books/v1/volumes?q=search+terms
4 request to the Volume resource URI:

https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
2

Replace the

GET https://www.googleapis.com/books/v1/volumes?q=flowers&filter=free-ebooks&key=yourAPIKey
0 path parameter with the ID of the volume to retrieve. See the section for more information on volume IDs.

Request

Here is an example of a

https://www.googleapis.com/books/v1/volumes?q=search+terms
4 request that gets a single volume:

https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
3

Note: Retrieving volume information does not require authentication, so you do not have to provide the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
3 HTTP header with the
https://www.googleapis.com/books/v1/volumes?q=search+terms
4 request. However, if the call is made with authentication, the Volume will include user-specific information, such as purchased status.

Response

If the request succeeds, the server responds with the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
5 HTTP status code and the Volume resource requested:

https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
4

Access Info

The

GET https://www.googleapis.com/books/v1/volumes?q=flowers&filter=free-ebooks&key=yourAPIKey
5 section is of particular interest in determining what features are available for an eBook. An
GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
7 is a flowing text format ebook, the
GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
7 section will have an
GET https://www.googleapis.com/books/v1/volumes?q=flowers&filter=free-ebooks&key=yourAPIKey
8 property indicating if this type of ebook is available. It will have a download link if there is a sample for the book or if the user can read the book either due to having purchased it or due to it being public domain in the user's location. A
GET https://www.googleapis.com/books/v1/volumes?q=flowers&filter=free-ebooks&key=yourAPIKey
9 for Google books indicates a scanned pages version of the ebook with similar details such as if it is available and a download link. Google recommends
GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
7 files for eReaders and SmartPhones, as scanned pages may be hard to read on these devices. If there is no
GET https://www.googleapis.com/books/v1/volumes?q=flowers&filter=free-ebooks&key=yourAPIKey
5 section, the volume is not available as a Google eBook.

Optional query parameters

In addition to the , you can use the following query parameter when retrieving a specific volume.

Projection

You can use the

GET https://www.googleapis.com/books/v1/volumes?q=pride+prejudice&download=epub&key=yourAPIKey
1 parameter with one of the following values to specify a predefined set of Volume fields to return:

  • 200 OK
    
    {
     "kind": "books#volumes",
     "items": [
      {
       "kind": "books#volume",
       "id": "_ojXNuzgHRcC",
       "etag": "OTD2tB19qn4",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Vijaya Khisty Bodach"
        ],
       ...
      },
      {
       "kind": "books#volume",
       "id": "RJxWIQOvoZUC",
       "etag": "NsxMT6kCCVs",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Gail Saunders-Smith"
        ],
        ...
      },
      {
       "kind": "books#volume",
       "id": "zaRoX10_UsMC",
       "etag": "pm1sLMgKfMA",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Paul McEvoy"
        ],
        ...
      },
      "totalItems": 3
    }
    
    1 - Returns all Volume fields.
  • GET https://www.googleapis.com/books/v1/volumes?q=pride+prejudice&download=epub&key=yourAPIKey
    
    3 - Returns only certain fields. See field descriptions marked with double asterisks in the to find out which fields are included.

The following example returns limited volume information for a single volume:

https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
5

Working with bookshelves

Retrieving a list of a user's public bookshelves

You can retrieve a list of a user's public bookshelves by sending an HTTP

https://www.googleapis.com/books/v1/volumes?q=search+terms
4 request to the URI with the following format:

https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
6

Replace the userId path parameter with the ID of the user whose bookshelves you would like to retrieve. See the section for more information on user IDs.

Request

Here is an example:

https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
7

Since a user does not have to be authenticated to retrieve information regarding public bookshelves, you do not have to provide the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
3 HTTP header with the
https://www.googleapis.com/books/v1/volumes?q=search+terms
4 request.

Response

If the request succeeds, the server responds with the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
5 HTTP status code and the list of bookshelves:

https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
8

Optional query parameters

You can use the when retrieving the list of a user's public bookshelves.

Retrieving a specific public bookshelf

You can retrieve a specific public bookshelf by sending an HTTP

https://www.googleapis.com/books/v1/volumes?q=search+terms
4 request to the URI with the following format:

https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
9

Replace the userId and shelf path parameters with the IDs that specify the user and the bookshelf you want to retrieve. See the section for more information.

Request

Here is an example:

https://books.google.com/books?hl=en&as_coll=0&num=10&uid=11122233344455566778&source=gbs_slider_cls_metadata_0_mylibrary
0

Since a user does not have to be authenticated to retrieve information regarding public bookshelves, you do not have to provide the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
3 HTTP header with the
https://www.googleapis.com/books/v1/volumes?q=search+terms
4 request.

Response

If the request succeeds, the server responds with the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
5 HTTP status code and the bookshelf resource:

https://books.google.com/books?hl=en&as_coll=0&num=10&uid=11122233344455566778&source=gbs_slider_cls_metadata_0_mylibrary
1

Optional query parameters

You can use the when retrieving a specific public bookshelf.

Retrieving a list of volumes on a public bookshelf

You can retrieve a list of volumes on a user's public bookshelf by sending an HTTP

https://www.googleapis.com/books/v1/volumes?q=search+terms
4 request the a URI with the following format:

https://books.google.com/books?hl=en&as_coll=0&num=10&uid=11122233344455566778&source=gbs_slider_cls_metadata_0_mylibrary
2

Request

Here is an example:

https://books.google.com/books?hl=en&as_coll=0&num=10&uid=11122233344455566778&source=gbs_slider_cls_metadata_0_mylibrary
3

Replace the userId and shelf path parameters with the IDs that specify the user and the bookshelf you want to retrieve. See the section for more information.

Since a user does not have to be authenticated to retrieve information regarding public bookshelves, you do not have to provide the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
3 HTTP header with the
https://www.googleapis.com/books/v1/volumes?q=search+terms
4 request.

Response

If the request succeeds, the server responds with a

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
5 HTTP status code and the list of the user's bookshelves:

https://books.google.com/books?hl=en&as_coll=0&num=10&uid=11122233344455566778&source=gbs_slider_cls_metadata_0_mylibrary
4

Optional query parameters

In addition to the , you can use the following query parameter when retrieving a list of volumes on a public bookshelf.

Pagination

You can paginate the volumes list by specifying two values in the parameters for the request:

  • 200 OK
    
    {
     "kind": "books#volumes",
     "items": [
      {
       "kind": "books#volume",
       "id": "_ojXNuzgHRcC",
       "etag": "OTD2tB19qn4",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Vijaya Khisty Bodach"
        ],
       ...
      },
      {
       "kind": "books#volume",
       "id": "RJxWIQOvoZUC",
       "etag": "NsxMT6kCCVs",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Gail Saunders-Smith"
        ],
        ...
      },
      {
       "kind": "books#volume",
       "id": "zaRoX10_UsMC",
       "etag": "pm1sLMgKfMA",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Paul McEvoy"
        ],
        ...
      },
      "totalItems": 3
    }
    
    5 - The position in the collection at which to start. The index of the first item is 0.
  • 200 OK
    
    {
     "kind": "books#volumes",
     "items": [
      {
       "kind": "books#volume",
       "id": "_ojXNuzgHRcC",
       "etag": "OTD2tB19qn4",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Vijaya Khisty Bodach"
        ],
       ...
      },
      {
       "kind": "books#volume",
       "id": "RJxWIQOvoZUC",
       "etag": "NsxMT6kCCVs",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Gail Saunders-Smith"
        ],
        ...
      },
      {
       "kind": "books#volume",
       "id": "zaRoX10_UsMC",
       "etag": "pm1sLMgKfMA",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Paul McEvoy"
        ],
        ...
      },
      "totalItems": 3
    }
    
    6 - The maximum number of results to return. The default is 10, and the maximum allowable value is 40.

Working with bookshelves in "My Library"

All "My Library" requests apply to the authenticated user's data.

Retrieving a list of my bookshelves

You can retrieve a listing of all of the authenticated user's bookshelves by sending an HTTP

https://www.googleapis.com/books/v1/volumes?q=search+terms
4 request to the URI with the following format:

https://books.google.com/books?hl=en&as_coll=0&num=10&uid=11122233344455566778&source=gbs_slider_cls_metadata_0_mylibrary
5

Request

Here is an example:

https://books.google.com/books?hl=en&as_coll=0&num=10&uid=11122233344455566778&source=gbs_slider_cls_metadata_0_mylibrary
6

Note: The user must be authenticated to retrieve a listing of "My Library" bookshelves. So you must provide the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
3 HTTP header with the
https://www.googleapis.com/books/v1/volumes?q=search+terms
4 request.

Response

If the request succeeds, the server responds with the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
5 HTTP status code and the list of all bookshelves for the current authenticated user:

https://books.google.com/books?hl=en&as_coll=0&num=10&uid=11122233344455566778&source=gbs_slider_cls_metadata_0_mylibrary
7

Optional query parameters

You can use the when retrieving the list of the authenticated user's bookshelves.

Retrieving a list of volumes on my bookshelf

You can retrieve a listing of the volumes on the authenticated user's bookshelf by sending an HTTP

https://www.googleapis.com/books/v1/volumes?q=search+terms
4 request to the URI with the following format:

https://books.google.com/books?hl=en&as_coll=0&num=10&uid=11122233344455566778&source=gbs_slider_cls_metadata_0_mylibrary
8

Replace the shelf path parameter with the ID of the bookshelf. See the section for more information on bookshelf IDs.

Request

Here is an example:

https://books.google.com/books?hl=en&as_coll=0&num=10&uid=11122233344455566778&source=gbs_slider_cls_metadata_0_mylibrary
9

Note: The user must be authenticated to retrieve a listing of "My Library" volumes. So you must provide the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
3 HTTP header with the
https://www.googleapis.com/books/v1/volumes?q=search+terms
4 request.

Response

If the request succeeds, the server responds with the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
5 HTTP status code and list of bookshelf volumes:

https://books.google.com/books?hl=en&as_coll=0&num=10&uid=11122233344455566778&source=gbs_slider_cls_metadata_0_mylibrary
4

Optional query parameters

In addition to the , you can use the following query parameter when retrieving a list of volumes on one of the authenticated user's bookshelves.

Pagination

You can paginate the volumes list by specifying two values in the parameters for the request:

  • 200 OK
    
    {
     "kind": "books#volumes",
     "items": [
      {
       "kind": "books#volume",
       "id": "_ojXNuzgHRcC",
       "etag": "OTD2tB19qn4",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Vijaya Khisty Bodach"
        ],
       ...
      },
      {
       "kind": "books#volume",
       "id": "RJxWIQOvoZUC",
       "etag": "NsxMT6kCCVs",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Gail Saunders-Smith"
        ],
        ...
      },
      {
       "kind": "books#volume",
       "id": "zaRoX10_UsMC",
       "etag": "pm1sLMgKfMA",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Paul McEvoy"
        ],
        ...
      },
      "totalItems": 3
    }
    
    5 - The position in the collection at which to start. The index of the first item is 0.
  • 200 OK
    
    {
     "kind": "books#volumes",
     "items": [
      {
       "kind": "books#volume",
       "id": "_ojXNuzgHRcC",
       "etag": "OTD2tB19qn4",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/_ojXNuzgHRcC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Vijaya Khisty Bodach"
        ],
       ...
      },
      {
       "kind": "books#volume",
       "id": "RJxWIQOvoZUC",
       "etag": "NsxMT6kCCVs",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/RJxWIQOvoZUC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Gail Saunders-Smith"
        ],
        ...
      },
      {
       "kind": "books#volume",
       "id": "zaRoX10_UsMC",
       "etag": "pm1sLMgKfMA",
       "selfLink": "https://www.googleapis.com/books/v1/volumes/zaRoX10_UsMC",
       "volumeInfo": {
        "title": "Flowers",
        "authors": [
         "Paul McEvoy"
        ],
        ...
      },
      "totalItems": 3
    }
    
    6 - The maximum number of results to return. The default is 10.

Adding a volume to my bookshelf

To add a volume to the authenticated user's bookshelf, send an HTTP

https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
19 request to the URI with the following format:

https://books.google.com/books?uid=11122233344455566778&source=gbs_lp_bookshelf_list
1

Replace the shelf path parameter with the ID of the bookshelf. See the section for more information on bookshelf IDs.

The request has a single required query parameter:

  • GET https://www.googleapis.com/books/v1/volumes?q=flowers&filter=free-ebooks&key=yourAPIKey
    
    0 - The ID of the volume. See the section for more information on volume IDs.

Request

Here is an example to add "Flowers for Algernon" to the "Favorites" bookshelf:

https://books.google.com/books?uid=11122233344455566778&source=gbs_lp_bookshelf_list
2

Note: The user must be authenticated to make modifications to a bookshelf, so you must provide the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
3 HTTP header with the
https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
19 request. No data, however, is required with this
https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
19.

Response

If the request succeeds, the server responds with the

https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
24 HTTP status code.

Optional query parameters

You can use the when adding a volume to one of the authenticated user's bookshelves.

Removing a volume from my bookshelf

To remove a volume from the authenticated user's bookshelf, send an HTTP

https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
19 to the URI with the following format:

https://books.google.com/books?uid=11122233344455566778&source=gbs_lp_bookshelf_list
3

Replace the shelf path parameter with the ID of the bookshelf. See the section for more information on bookshelf IDs.

The request has a single required query parameter:

  • GET https://www.googleapis.com/books/v1/volumes?q=flowers&filter=free-ebooks&key=yourAPIKey
    
    0 - The ID of the volume. Seethe section for more information on volume IDs.

Request

Here is an example to remove "Flowers for Algernon" from the "Favorites" bookshelf:

https://books.google.com/books?uid=11122233344455566778&source=gbs_lp_bookshelf_list
4

Note: The user must be authenticated to make modifications to a bookshelf, so you must provide the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
3 HTTP header with the
https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
19 request. No data, however, is required with this
https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
19.

Response

If the request succeeds, the server responds with a

https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
24 status code.

Optional query parameters

You can use the when removing a volume from one of the authenticated user's bookshelves.

Clearing all volumes from my bookshelf

To remove all of the volumes from the authenticated user's bookshelf, send an HTTP

https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
19 to the URI with the following format:

https://books.google.com/books?uid=11122233344455566778&source=gbs_lp_bookshelf_list
5

Replace the shelf path parameter with the ID of the bookshelf. See the section for more information on bookshelf IDs.

Request

Here is an example to clear the "Favorites" bookshelf:

https://books.google.com/books?uid=11122233344455566778&source=gbs_lp_bookshelf_list
6

Note: The user must be authenticated to make modifications to a bookshelf, so you must provide the

GET https://www.googleapis.com/books/v1/volumes?q=flowers+inauthor:keyes&key=yourAPIKey
3 HTTP header with the
https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
19 request. No data, however, is required with this
https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
19.

Response

If the request succeeds, the server responds with a

https://books.google.com/ebooks?id=buc0AAAAMAAJ&dq=holmes&as_brr=4&source=webstore_bookcard
24 status code.

Optional query parameters

You can use the when clearing all volumes from one of the authenticated user's bookshelves.

Query parameter reference

The query parameters you can use with the Books API are summarized in this section.  All parameter values need to be URL encoded.

Standard query parameters

Query parameters that apply to all Books API operations are documented at System Parameters.

API-specific query parameters

Request parameters that apply only to specific operations in the Books API are summarized in the following table.