如何从Google Books获取流派列表并实现多流派书籍搜索？

我之前也踩过Google Books API的这些坑——官方确实没提供直接的完整流派列表接口，而且多流派搜索的参数用法很容易搞错，下面是我亲测有效的解决方案：

一、获取Google Books可用流派 #

Google Books没有官方的标准化流派分类列表，但可以通过两种可靠方式获取可用流派：

• 从书籍数据中自动收集
  你可以批量调用API获取书籍，提取每本书的volumeInfo.categories字段（这就是书籍所属的流派标签），去重后整理成你的流派列表。示例请求：

  GET https://www.googleapis.com/books/v1/volumes?q=*&maxResults=40&startIndex=0&key=你的API密钥
  

  注意API允许的maxResults最大值是40，所以需要分页多次请求（递增startIndex），收集足够多的书籍数据来覆盖大部分常见流派。这种方式能保证你获取的流派都是API实际支持的有效值。

• 使用社区整理的常见流派
  如果你不想做批量收集，也可以直接用社区公认的常见流派，比如：Fiction、Mystery、Romance、Science Fiction、History、Biography、Self-Help、Cookbooks、Travel等，这些都是Google Books API支持的有效subject值。

二、实现多流派搜索的正确姿势 #

你之前单流派搜索成功是因为用了q=subject:流派名称，但多流派不能直接把多个流派塞到一个subject里，必须用布尔逻辑组合多个subject查询：

1. 同时匹配多个流派（交集） #

如果要找同时属于多个流派的书籍，用AND连接多个subject:条件。比如搜索既属于Fiction又属于Science Fiction的书，请求参数应该是：

GET https://www.googleapis.com/books/v1/volumes?q=subject:Fiction AND subject:Science Fiction&key=你的API密钥

2. 匹配任意一个流派（并集） #

如果要找属于任意选中流派的书籍，把AND换成OR即可：

GET https://www.googleapis.com/books/v1/volumes?q=subject:Fiction OR subject:Mystery&key=你的API密钥

3. 前端参数构建示例 #

假设你的网站用复选框让用户选流派，前端可以这样动态构建查询：

// 假设用户选中了["Fiction", "Science Fiction"]
const selectedGenres = ["Fiction", "Science Fiction"];
// 构建符合API要求的查询字符串
const searchQuery = selectedGenres.map(genre => `subject:${genre}`).join(" AND ");
// 编码后调用API
fetch(`https://www.googleapis.com/books/v1/volumes?q=${encodeURIComponent(searchQuery)}&key=你的API密钥`)
  .then(res => res.json())
  .then(data => {
    // 把返回的书籍数据渲染到页面上
    console.log(data.items);
  });

关键注意事项 #

• 流派名称带空格时，不需要手动转义，encodeURIComponent会帮你处理；也可以直接用+代替空格，比如subject:Science+Fiction
• 不要用逗号分隔多个流派（比如subject:Fiction,Mystery），API会把整个字符串当成一个不存在的subject，自然返回空结果
• 记得带上你的API密钥，否则请求会被频率限制

内容的提问来源于stack exchange，提问作者shijin