音量: 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	見つかったボリュームの合計数。結果がページ分けされている場合は、このレスポンスで返されるボリュームの数を超えることがあります。

試してみる

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