書籍の検索を行います。 実習をご覧ください。
リクエスト
HTTP リクエスト
GET https://www.googleapis.com/books/v1/volumes?q={search terms}
パラメータ
パラメータ名 | 値 | 説明 |
---|---|---|
必須パラメータ | ||
q |
string |
全文のクエリ文字列。 |
省略可能なパラメータ | ||
download |
string |
ダウンロードできるかどうかを制限し、ボリュームを制限します。
有効な値は次のとおりです。
|
filter |
string |
検索結果をフィルタします。
有効な値は次のとおりです。
|
langRestrict |
string |
検索結果をこの言語コードの書籍に制限します。 |
libraryRestrict |
string |
検索をこのユーザーのライブラリに限定します。
有効な値は次のとおりです。
|
maxResults |
unsigned integer |
返される結果の最大数。有効な値は 0 ~40 (指定した値を含む)です。
|
orderBy |
string |
検索結果の並べ替え
有効な値は次のとおりです。
|
partner |
string |
パートナー ID の結果をブランド化して制限します。 |
printType |
string |
書籍や雑誌に限定します。
有効な値は次のとおりです。
|
projection |
string |
選択した項目のセットに返される情報を制限します。
有効な値は次のとおりです。
|
showPreorders |
boolean |
true に設定すると、予約購入できる書籍が表示されます。デフォルトは false です。 |
source |
string |
このリクエストの送信元を識別する文字列。 |
startIndex |
unsigned integer |
最初に返される結果のインデックス(0 から開始) |
リクエストの本文
このメソッドをリクエストの本文に含めないでください。
レスポンス
成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。
{
"kind": "books#volumes",
"items": [
volume Resource
],
"totalItems":(value)
}
プロパティ名 | 値 | 説明 | 備考 |
---|---|---|---|
kind |
string |
リソースのタイプ。 | |
items[] |
list |
ボリュームのリスト。 | |
totalItems |
integer |
見つかったボリュームの合計数。結果がページ分けされている場合は、このレスポンスで返されるボリュームの数を超えることがあります。 |
試してみる
以下のエクスプローラを使用してライブデータでこのメソッドを呼び出し、レスポンスを確認します。