如何在Google Apps Script中为Google表格仅单次设置文档属性？

一、避免onOpen每次覆盖Document Properties #

你现在的问题根源在于每次打开文档都直接赋值属性，自然会覆盖之前的配置。核心解决思路很简单：先检查目标属性是否已经存在，只有不存在的时候才执行初始化操作。

具体代码可以这么写：

function onOpen() {
  const docProps = PropertiesService.getDocumentProperties();
  
  // 检查配置项是否存在，不存在则初始化
  if (!docProps.getProperty('apiKey')) {
    docProps.setProperty('apiKey', '默认API密钥');
    docProps.setProperty('maxFetchCount', '15');
    // 这里可以添加所有需要初始化的配置项
  }

  // 你的其他onOpen逻辑，比如添加自定义菜单等
}

这样一来，只有第一次打开文档时，因为配置项为空，才会执行初始化；后续打开文档时，代码会跳过赋值步骤，完全保留之前已有的配置。如果之后需要修改默认值，你可以手动在脚本编辑器中运行单独的初始化函数，或者用下面提到的GUI方式修改。

二、通过GUI设置Document Properties #

Google Apps Script本身没有内置的Document Properties可视化界面，但我们可以快速搭建一个简易GUI，通过「自定义菜单+对话框」实现可视化配置：

1. 给文档添加自定义菜单

先在onOpen函数中加入配置管理菜单：

function onOpen() {
  const ui = DocumentApp.getUi();
  // 创建自定义菜单
  ui.createMenu('文档配置')
    .addItem('设置配置项', 'showConfigDialog')
    .addToUi();

  // 上面的初始化逻辑也放在这里
}

2. 实现配置对话框与保存逻辑

接下来写显示对话框和保存配置的函数：

function showConfigDialog() {
  const docProps = PropertiesService.getDocumentProperties();
  // 获取当前配置值，用于对话框回显
  const currentApiKey = docProps.getProperty('apiKey') || '';
  const currentMaxCount = docProps.getProperty('maxFetchCount') || '';

  // 构建HTML对话框
  const html = HtmlService.createHtmlOutput(`
    <div style="padding: 20px;">
      <div style="margin-bottom: 12px;">
        <label for="apiKey">API密钥:</label>
        <input type="text" id="apiKey" value="${currentApiKey}" style="width: 100%; padding: 6px; margin-top: 4px;">
      </div>
      <div style="margin-bottom: 12px;">
        <label for="maxCount">最大获取数量:</label>
        <input type="number" id="maxCount" value="${currentMaxCount}" style="width: 100%; padding: 6px; margin-top: 4px;">
      </div>
      <button onclick="saveConfigs()" style="padding: 8px 16px; background: #4285F4; color: white; border: none; border-radius: 4px;">保存配置</button>
    </div>
    <script>
      function saveConfigs() {
        const apiKey = document.getElementById('apiKey').value;
        const maxCount = document.getElementById('maxCount').value;
        // 调用后端函数保存配置
        google.script.run.withSuccessHandler(() => {
          alert('配置已成功保存！');
          google.script.host.close();
        }).saveDocumentConfigs({
          apiKey: apiKey,
          maxFetchCount: maxCount
        });
      }
    </script>
  `).setWidth(400).setHeight(250);

  // 显示对话框
  DocumentApp.getUi().showModalDialog(html, '文档配置设置');
}

// 后端保存配置的函数
function saveDocumentConfigs(configs) {
  const docProps = PropertiesService.getDocumentProperties();
  // 遍历配置对象，逐个设置属性
  for (const key in configs) {
    if (configs.hasOwnProperty(key)) {
      docProps.setProperty(key, configs[key]);
    }
  }
}

这样用户打开文档后，就能通过顶部的「文档配置」菜单打开对话框，直观查看和修改所有配置项，完全不用接触代码。如果需要添加更多配置项，只需要在对话框的HTML里加对应的输入框，再调整保存函数即可。

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