如何通过Google Sites API同时获取新版与经典版Google Sites站点

根本原因 #

SitesApp 的设计目标就只对接经典版Google Sites的元数据服务，从接口层面根本没有纳入新版Sites的查询逻辑，不管怎么调整分页参数、域名参数，都不可能通过这个方法拉到不带/a/前缀的新版站点，这是产品能力的边界，不是代码写的问题。

实操实现步骤 #

1. 拆成两个独立数据源分别拉取，别指望一个接口搞定全部
   • 经典版站点：现有的基于SitesApp.getAllSites()的分页拉取逻辑完全可以继续用，这部分本身逻辑没错，只要保持分页起始值按实际返回的站点数动态累加，就不会出现漏拉。
   • 新版站点：换用Drive服务拉就行。新版Google Sites本质是存在Drive里的特殊格式文件，对应的MIME类型是application/vnd.google-apps.site，在Apps Script里开启Drive高级服务后，通过Drive的文件查询接口筛选这个MIME类型的所有文件，把每个文件的webViewLink字段提出来，就是需要找的不带/a/前缀的新版站点地址。
2. 合并结果做去重
   把两边拉到的站点地址凑成统一列表后，要做交叉校验去重。不少经历过版本迁移的站点会同时在两个服务里留记录，别光靠URL字符串匹配，要结合站点创建人、最后修改时间核对，不然会把同一个站点重复列出来。
3. 权限要配全
   • 拉取经典版站点时，给运行脚本的账号开对应域下的Sites域级读权限即可
   • 拉取新版站点时，要给账号开Drive跨用户文件读权限，不然会漏掉大部分不在脚本所有者名下、域内共享的站点

避坑提醒 #

• 别白费功夫调整getAllSites()的参数想拉新版站点，这个接口从上线开始就没接新版Sites的数据源，怎么调参数都不会返回新版站点的内容
• 原有代码里有个小疏漏：日志语句Logger.log("Loading sites starting at %s", pageStart, pageSize)的字符串模板只留了一个占位符，却传了两个参数，会导致分页大小的信息打不进日志，稍微调整下模板格式就能修正

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