このページは Cloud Translation API によって翻訳されました。

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

試してみる

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