數量：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" - 包含音量資訊及 accessInfo 中的部分欄位。
showPreorders	boolean	設為 true 即可顯示預購的書籍。預設值為 false。
source	string	用於識別此要求來源之字串的字串。
startIndex	unsigned integer	第一個要傳回的結果索引 (從 0 開始)

要求主體

請不要透過此方法提供請求主體。

回應

如果成功的話，這個方法會傳回回應內文，其結構如下：

{
  "kind": "books#volumes",
  "items": [
    volume Resource
  ],
  "totalItems": (value)
}

資源名稱	值	說明	Notes
kind	string	資源類型。
items[]	list	磁碟區清單。
totalItems	integer	找到的磁碟區總數。如果結果有分頁後的結果，結果可能大於此回應傳回的磁碟區。

動手操作

使用下方的多層檢視，針對即時資料呼叫這個方法並查看回應。