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

試してみる

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