如何同步Google Apps Script中Slides API与内置Slides类的异步调用？

AI 小北

2026-10-2

问题解决方法

首先要明确：Google Apps Script中调用Slides高级服务的batchUpdate方法本身是同步执行的，你遇到的执行顺序异常本质是SlidesApp的本地实例缓存没有同步API端的变更，导致调用getSlideById时找不到刚创建的页面。

方案1：最简适配（无需回调/Promise）

调用完batchUpdate后主动刷新presentation实例即可，代码修改如下：

Slides.Presentations.batchUpdate({'requests': requests}, presentationId);
// 新增一行：重新获取presentation实例，同步API端的最新变更
var presentation = SlidesApp.openById(presentationId);
var shape = presentation.getSlideById(newpageId).insertShape(SlidesApp.ShapeType.TEXT_BOX, 0, 0, width, height/4);

方案2：封装为Promise适配异步逻辑

如果你需要统一异步逻辑的调用风格，可以把操作封装为Promise，确保创建操作完成后再执行文本框插入：

function createSlideThenAddTextBox(presentationId, requests, newpageId, width, height) {
  return new Promise((resolve, reject) => {
    try {
      // 执行幻灯片创建请求
      Slides.Presentations.batchUpdate({'requests': requests}, presentationId);
      // 刷新实例后执行插入操作
      const presentation = SlidesApp.openById(presentationId);
      const shape = presentation.getSlideById(newpageId).insertShape(SlidesApp.ShapeType.TEXT_BOX, 0, 0, width, height/4);
      resolve(shape);
    } catch (err) {
      reject(err);
    }
  })
}

// 调用示例
createSlideThenAddTextBox(presentationId, requests, newpageId, width, height)
  .then(shape => {
    // 后续对文本框的操作可以写在这里
    shape.getText().setText("示例文本");
  })
  .catch(err => {
    console.log("操作失败：" + err.message);
  })