ボリューム: list

書籍の検索を行います。 実習をご覧ください。

リクエスト

HTTP リクエスト

GET https://www.googleapis.com/books/v1/volumes?q={search terms}

パラメータ

パラメータ名	価値	説明
必須パラメータ
q	string	全文検索のクエリ文字列。
オプション パラメータ
download	string	ダウンロードの可用性によってボリュームを制限します。 有効な値は次のとおりです。 "epub" - ePub ありのすべてのボリューム。
filter	string	検索結果をフィルタします。 有効な値は次のとおりです。 "ebooks" - すべての Google 電子書籍。 「free-ebooks」 - 全文の視認性が高い Google 電子書籍。 「full」 - 一般公開ユーザーはボリューム テキスト全体を閲覧できます。 「paid-ebooks」 - 価格が記載されている Google 電子書籍。 「partial」 - テキストの一部を表示できます。
langRestrict	string	検索結果を、この言語コードの書籍に限定します。
libraryRestrict	string	検索対象をこのユーザーのライブラリに限定します。 有効な値は次のとおりです。 「my-library」- ユーザーのライブラリ（すべての本棚）に限定します。 "no-restrict" - ユーザーのライブラリに基づいて制限しません。
maxResults	unsigned integer	返される結果の最大数。有効な値は 0～40 です。
orderBy	string	検索結果を並べ替える。 有効な値は次のとおりです。 「newest」 - 最近公開された写真。 "relevance" - 検索語句との関連性。
partner	string	パートナー ID を対象に、検索結果の制限とブランド設定を行います。
printType	string	書籍と雑誌に限定します。 有効な値は次のとおりです。 "all" - すべてのボリューム コンテンツ タイプ。 「books」- 書籍のみ。 「magazines」- 雑誌のみ。
projection	string	選択した一連のフィールドに返される情報を制限します。 有効な値は次のとおりです。 "full" - すべてのボリューム データが含まれます。 「lite」- volumeInfo と accessInfo のフィールドのサブセットが含まれます。
showPreorders	boolean	予約購入可能な書籍を表示するには、true に設定します。デフォルトは false です。
source	string	このリクエストの送信元を識別する文字列。
startIndex	unsigned integer	最初に返される結果のインデックス（0 から始まります）

リクエストの本文

このメソッドをリクエストの本文に含めないでください。

レスポンス

成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。

{
  "kind": "books#volumes",
  "items": [
    volume Resource
  ],
  "totalItems": (value)
}

プロパティ名	価値	説明	メモ
kind	string	リソースのタイプ。
items[]	list	ボリュームのリスト。
totalItems	integer	見つかったボリュームの合計数。結果がページ分けされている場合、この値は、このレスポンスで返されるボリュームの数より大きい可能性があります。

試してみる

以下のエクスプローラを使用してライブデータに対してこのメソッドを呼び出し、レスポンスを確認してください。