ボリューム: 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	検出されたボリュームの合計数。結果がページ分割されている場合、この値はレスポンスで返されるボリュームの数より大きくなることがあります。

試してみる

以下のエクスプローラを使用して、ライブデータでこのメソッドを呼び出し、レスポンスを確認します。