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

試してみる

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