磁碟區:清單

執行書籍搜尋。 立即試用

要求

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 要傳回的結果數上限。 可接受的值為 040 (含頭尾)。
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 找到的磁碟區總數。如果結果已分頁,這個值可能會大於這個回應中傳回的磁碟區數量。

歡迎試用!

您可以使用下方的檔案總管,針對即時資料呼叫這個方法,然後查看回應。