Google Books Search API : Data API - Searching for books -

Boo Search Data API は書籍リストの feed を提供する

最も一般的なのは検索クエリにマッチする本のリストを引き出すアクション
このアクションは、次の URL に適切なクエリパラメータを付加して HTTP GET リクエストを投げればいい

http://books.google.com/books/feeds/volumes

注: Book Search では、本を参照するのによく "volume" term を使う
　　volumes feed は本の feed である。

次の例は、メタデータやテキストが "football" にはマッチするが、"soccer" にはマッチしない検索結果の、10冊づつセットでの2番目を取得する

http://books.google.com/books/feeds/volumes?
    q=football+-soccer
    &start-index=11
    &max-results=10

GET リクエストを送った後、Book Search はファクターに応じたリダイレクトを返す。その場合、リダイレクト URL に別の GET リクエストを送る。GET リクエストを送ると、Book Search は HTTP 200 OK status code を返し、その feed にクエリにマッチした本のリストが含まれる。

注: Book Search の結果は public なので、認証なしで Book Search query を発行できる


Book Search Data API のクエリパラメータ

　　q
　　　　検索クエリタームを指定する
　　　　Book Search は全ての本のメタデータと term にマッチした本の
　　　　全テキストを検索する
　　　　本のメタデータには、タイトル、キーワード、説明、著者名、題目
　　　　が含まれる

　　　　注: URL エンコードすること

　　　　特定のフレーズを検索する場合は、クオーテーションマーク(")でくくる
　　　　クオーテーションマークも URL エンコードすること

　　　　advanced search operators

　　start-index
　　　　検索結果リストの最初のインデックスを指定する
　　　　
　　max-results
　　　　検索結果リストの最大数を指定する
　　　　
　　min-viewability
　　　　本の viewability status に応じて結果をフィルターする
　　　　指定できる値は noview (デフォルト、viewability に関係なく
　　　　全ての本を返す）、partial (preview できる、もしくは全体を
　　　　見れる本を返す)、full (全体が見れる本のみ返す)

　　　　注: viewability はユーザーの location によるので、正確な
　　　　　　結果を得るために、end-user の IP を HTTP リクエストの
　　　　　　ヘッダに負荷するほうがよい