如何使用Google Apps Script为Google Docs中选中的图片调用addBookmark()？

Google Docs原生界面没法直接给图片加书签，要调用addBookmark()方法，得用Google Apps Script来实现，具体操作如下：

核心逻辑说明 #

addBookmark()是Google Docs服务（DocumentApp）的方法，它需要绑定一个文档内的位置对象（Position）。内嵌图片作为文档元素，我们需要先获取它的位置，再调用方法生成书签。

具体实现步骤 #

1. 打开脚本编辑器 #

在你的Google Docs文档里，点击顶部菜单栏的「扩展程序」>「Apps Script」，进入脚本编辑页面。

2. 粘贴执行代码 #

把下面的代码粘贴到编辑器里：

function addBookmarkToSelectedImage() {
  const activeDoc = DocumentApp.getActiveDocument();
  const userSelection = activeDoc.getSelection();

  // 检查是否有选中内容
  if (!userSelection) {
    DocumentApp.getUi().alert("请先选中一张图片");
    return;
  }

  const selectedElements = userSelection.getSelectedElements();
  for (const elem of selectedElements) {
    const element = elem.getElement();
    // 判断选中的是否是内嵌图片
    if (element.getType() === DocumentApp.ElementType.INLINE_IMAGE) {
      // 获取图片的起始位置
      const imgPosition = element.getPosition();
      // 调用addBookmark创建书签
      const newBookmark = activeDoc.addBookmark(imgPosition);
      // 可选：给书签设置自定义名称
      newBookmark.setName("图片书签");
      DocumentApp.getUi().alert("书签已添加完成");
      return;
    }
  }

  DocumentApp.getUi().alert("你选中的不是图片，请重新选择");
}

3. 运行脚本并授权 #

• 给你的脚本项目起个名字（比如「图片书签工具」），点击保存。
• 点击编辑器顶部的运行按钮，首次运行会触发权限验证，按照页面提示完成授权（这是Google的安全验证，放心操作）。
• 返回文档，选中你要加书签的图片，再次运行这个脚本，就能完成书签添加。

操作界面参考 #

验证书签 #

添加完成后，你可以点击文档顶部的「插入」>「书签」，在左侧面板里就能看到刚添加的书签，点击它就能直接跳转到对应的图片。

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