如何在Google表格自定义函数中设置OAuth Scope调用Google Contacts API

Google表格的单元格自定义函数（直接输入=GETNAME()调用的那种）运行在无授权的沙箱环境中，平台限制这类函数调用需要用户OAuth授权的服务（比如ContactsApp）——哪怕你修改了appsscript.json的权限配置，也无法突破这个限制，这就是你报错的原因。

方案一：用自定义菜单触发查询 #

放弃单元格直接调用函数的方式，改成通过菜单触发批量处理，代码和配置如下：

1. 替换原有代码为：

/**
 * 打开表格时创建自定义菜单
 */
function onOpen() {
  const ui = SpreadsheetApp.getUi();
  ui.createMenu('联系人工具')
    .addItem('根据邮箱获取姓名', 'getNamesFromEmails')
    .addToUi();
}

/**
 * 批量处理选中的邮箱单元格，把姓名填充到右侧列
 */
function getNamesFromEmails() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const selectedRange = sheet.getActiveRange();
  const emailValues = selectedRange.getValues();

  // 遍历每个邮箱，查询对应姓名
  const nameResults = emailValues.map(row => {
    const email = row[0];
    if (!email || !email.includes('@')) return [''];
    const contacts = ContactsApp.getContactsByEmailAddress(email);
    return contacts.length > 0 ? [contacts[0].getFullName()] : ['未找到联系人'];
  });

  // 把结果写入选中区域的右侧单元格
  selectedRange.offset(0, 1).setValues(nameResults);
}

2. 修正appsscript.json的权限配置（去掉scope末尾的斜杠，并添加表格权限）：

{
  "oauthScopes": [
    "https://www.google.com/m8/feeds",
    "https://www.googleapis.com/auth/spreadsheets"
  ],
  "timeZone": "Europe/Paris",
  "dependencies": {},
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8"
}

3. 使用步骤：

• 保存代码后刷新表格，顶部会出现「联系人工具」菜单
• 选中包含邮箱的单元格范围
• 点击菜单中的「根据邮箱获取姓名」，完成授权后，姓名会自动填充到选中区域的右侧列

方案二：安装式编辑触发器（自动触发） #

如果需要输入邮箱后自动获取姓名，可创建安装式触发器：

1. 添加以下代码：

/**
 * 编辑单元格时自动查询姓名（仅安装式触发器可用）
 */
function handleEdit(e) {
  const editedRange = e.range;
  const sheet = editedRange.getSheet();
  
  // 仅处理A列的邮箱输入（可根据需求修改列号）
  if (editedRange.getColumn() === 1 && e.value && e.value.includes('@')) {
    const contacts = ContactsApp.getContactsByEmailAddress(e.value);
    const fullName = contacts.length > 0 ? contacts[0].getFullName() : '未找到联系人';
    // 把姓名写入同一行的B列
    sheet.getRange(editedRange.getRow(), 2).setValue(fullName);
  }
}

2. 安装触发器：

• 在脚本编辑器左侧点击「触发器」图标
• 点击「添加触发器」，选择handleEdit函数，事件源选「从电子表格」，事件类型选「编辑时」
• 保存并完成授权，之后在A列输入邮箱，B列会自动填充姓名

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