Google Apps Script操作Google Docs复选框/下拉列表的问题求助

问题背景 #

我正在开发一个基于Google Apps Script的Google Docs项目，需求是通过读取文档中复选框的勾选状态，以及下拉列表（Smart Chips）的选中值，来保留或移除文档的特定章节。但目前遇到了Google Apps Script API的限制：复选框被识别为UnsupportedElement，下拉列表的选中值也难以提取。我尝试遍历文档读取状态，但元素要么被标记为不支持，要么无法返回预期值；考虑过用文本标记替代，但会影响用户体验，现在想找可行的解决方法或替代方案。

示例截图 #

• 复选框示例
• 下拉列表示例
• 最终效果示例

当前使用代码 #

// 将DEBUG设为true以启用调试日志，设为false则关闭
var DEBUG = true;

function onOpen() {
  var ui = DocumentApp.getUi();
  ui.createMenu('自定义操作')
      .addItem('更新文档', 'processTableChoices')
      .addToUi();
}


function processTableChoices() {
  var doc = DocumentApp.getActiveDocument();
  var body = doc.getBody();
  var tables = body.getTables();

  if (DEBUG) {
    Logger.log('开始处理表格...');
    Logger.log('表格总数: ' + tables.length);
  }

  tables.forEach(function(table, tableIndex) {
    if (DEBUG) {
      Logger.log('处理第 ' + (tableIndex + 1) + ' 个表格');
    }

    var numRows = table.getNumRows();

    for (var i = numRows - 1; i >= 0; i--) {
      var row = table.getRow(i);
      var cell = row.getCell(0);
      var dropdownText = getDropdownValue(cell);

      if (DEBUG) {
        Logger.log('处理第 ' + (i + 1) + ' 行: 值 : ' + dropdownText);
      }

      if (dropdownText === '保留') {
        // 复制单元格的复杂内容
        copyCellContent(body, row, i);
        table.removeRow(i);
      } else if (dropdownText === '删除') {
        if (DEBUG) {
          Logger.log('删除第 ' + (i + 1) + ' 行');
        }
        table.removeRow(i);
      }
    }

    if (table.getNumRows() === 0) {
      if (DEBUG) {
        Logger.log('删除第 ' + (tableIndex + 1) + ' 个表格');
      }
      table.removeFromParent();
    }
  });
}

function copyCellContent(body, row, rowIndex) {
  var numCells = row.getNumCells();
  for (var j = 1; j < numCells; j++) {
    var cell = row.getCell(j);
    var numChildren = cell.getNumChildren();
    for (var k = 0; k < numChildren; k++) {
      var child = cell.getChild(k);
      if (child.getType() === DocumentApp.ElementType.TABLE) {
        // 复制整个表格
        var table = child.asTable();
        var copiedTable = body.insertTable(body.getChildIndex(row.getParentTable()), table.copy());
        body.insertParagraph(body.getChildIndex(copiedTable) + 1, ''); // 在表格后插入空段落用于分隔
      } else if (child.getType() === DocumentApp.ElementType.PARAGRAPH) {
        // 复制段落
        body.insertParagraph(body.getChildIndex(row.getParentTable()), child.asParagraph().copy());
      }
      // 如有需要，可在此添加其他元素类型的处理逻辑
    }
  }
}


function getDropdownValue(cell) {
  if (DEBUG) {
    Logger.log('处理单元格...');
  }

  try {
    var numChildren = cell.getNumChildren();
    if (DEBUG) {
      Logger.log('单元格内子元素数量: ' + numChildren);
    }

    for (var i = 0; i < numChildren; i++) {
      var child = cell.getChild(i);
      if (child.getType() === DocumentApp.ElementType.LIST_ITEM) {
        var listItem = child.asListItem();
        var glyphType = listItem.getGlyphType();

        if (DEBUG) {
          Logger.log('找到的符号类型: ' + glyphType);
        }

        // 检查符号类型是否为项目符号
        if (glyphType === DocumentApp.GlyphType.BULLET || glyphType === DocumentApp.GlyphType.HOLLOW_BULLET || glyphType === DocumentApp.GlyphType.SQUARE_BULLET) {
          return '保留'; // 可替换为你需要关联的值
        }
      }
    }

    // 未找到项目符号，判定为需要删除该行
    return '删除';
  } catch (e) {
    if (DEBUG) {
      Logger.log('检查项目符号时出错: ' + e.toString());
    }
    return '';
  }
}

可行解决方法 #

1. 替换为Google Docs原生复选框 #

如果可以将Smart Chips复选框替换为Google Docs原生复选框（通过段落格式设置），可直接通过ListItem的isChecked()方法获取状态，示例：

function getNativeCheckboxStatus(listItem) {
  return listItem.isChecked();
}

在你的getDropdownValue函数中可修改为检测原生复选框状态，替代当前的符号判断逻辑。

2. 通过Drive API解析文档JSON获取Smart Chips数据 #

Google Apps Script的DocumentApp API不直接支持Smart Chips，但可通过Drive API将文档导出为JSON格式，解析其中的Smart Chips配置：

1. 在脚本编辑器的「服务」中启用Drive API
2. 使用以下代码解析数据：

function getSmartChipsData() {
  const docId = DocumentApp.getActiveDocument().getId();
  // 导出文档为JSON格式
  const response = Drive.Files.export(docId, 'application/vnd.google-apps.document+json');
  const docJson = JSON.parse(response);

  // 遍历文档内容查找Smart Chips
  docJson.body.content.forEach(block => {
    if (block.paragraph && block.paragraph.elements) {
      block.paragraph.elements.forEach(element => {
        if (element.inlineObjectElement) {
          const objId = element.inlineObjectElement.inlineObjectId;
          const inlineObj = docJson.inlineObjects[objId];
          
          if (inlineObj.inlineObjectProperties?.smartChip) {
            const smartChip = inlineObj.inlineObjectProperties.smartChip;
            
            // 处理复选框状态
            if (smartChip.checkbox) {
              const isChecked = smartChip.checkbox.checked;
              Logger.log('复选框状态: ' + isChecked);
            }
            
            // 处理下拉列表选中值
            if (smartChip.choiceChipSet) {
              const selectedChoice = smartChip.choiceChipSet.choices.find(choice => choice.selected);
              if (selectedChoice) {
                const selectedValue = selectedChoice.textRun.content.trim();
                Logger.log('下拉列表选中值: ' + selectedValue);
              }
            }
          }
        }
      });
    }
  });
}

你可以将此逻辑整合到processTableChoices函数中，替换原有的getDropdownValue逻辑。

3. 自定义属性替代方案 #

若不想依赖Smart Chips，可通过给表格行/单元格添加自定义属性，结合自定义菜单让用户选择操作：

// 设置单元格自定义属性
function setCellAction(cell, action) {
  const attrs = cell.getAttributes();
  attrs['customAction'] = action; // action为'retain'或'remove'
  cell.setAttributes(attrs);
}

// 获取单元格自定义属性
function getCellAction(cell) {
  return cell.getAttributes()['customAction'] || 'remove';
}

可配合侧边栏UI让用户直观设置属性，避免影响体验。

内容的提问来源于stack exchange，提问作者Mélanie GAULT