使用AppsScript的ContactsApp获取联系人群组时报Server Error如何解决

排查解决步骤 #

• 核对联系人群组属性
  ContactsApp.getContactGroup()仅支持读取用户自定义创建的联系人群组，不支持读取系统默认生成的分组（如“我的联系人”“星标联系人”等），首先确认你的「Cards」分组是手动创建的自定义分组，而非系统默认分组。
• 补全appsscript.json配置
  现有配置缺少必要的权限scope和运行时声明，替换为以下配置：

{
  "timeZone": "Europe/London",
  "dependencies": {},
  "oauthScopes": [
    "https://www.google.com/m8/feeds",
    "https://www.googleapis.com/auth/contacts.readonly"
  ],
  "runtimeVersion": "V8"
}

• 验证群组名称准确性
  运行以下代码输出所有自定义联系人群组的名称，确认「Cards」的名称完全匹配，无大小写差异、前后空格或隐藏特殊字符：

function listAllGroups() {
  const groups = ContactsApp.getContactGroups();
  groups.forEach(group => Logger.log(group.getName()));
}

• 重置账号授权
  进入你的Google账号安全设置，删除当前Apps Script项目的授权记录，回到脚本编辑器重新运行代码触发授权流程，避免旧授权残留导致的权限异常。
• 企业账号权限排查
  如果你使用的是Google Workspace企业账号，确认管理员没有限制普通用户的联系人API访问权限，个人账号无需此项检查。

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