このページは 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`	見つかったボリュームの合計数。結果がページ分けされている場合、この値は、このレスポンスで返されるボリュームの数より大きい可能性があります。

試してみる

以下のエクスプローラを使用してライブデータに対してこのメソッドを呼び出し、レスポンスを確認してください。