磁碟區：清單

執行書籍搜尋。立即試用。

要求

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	找到的音量總數。如果結果已分頁，這個值可能會大於此回應中傳回的卷數。

歡迎試用！

您可以使用下方的 Explorer，針對即時資料呼叫這個方法，然後查看回應。