2010年10月18日月曜日

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 リクエストの
      ヘッダに負荷するほうがよい


 

0 件のコメント:

コメントを投稿