磁碟區：清單

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

要求

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，針對即時資料呼叫這個方法，然後查看回應。