Google Apps Script复制幻灯片后调用截图API报错排查

问题根源 #

• 本地修改未同步云端：createSlides中复制模板、修改内容、删除原幻灯片的操作都在SlidesApp内存中完成，未立即同步到云端服务器。此时调用generateScreenshots通过Slides API请求截图时，云端幻灯片状态未更新，导致本地获取的页面ID（如SLIDES_API28088814_0）在云端不存在，触发「The specified object with pageObjectId ... is not a page」错误。
• 空URL引发后续报错：API请求失败后返回的response无contentUrl字段，执行UrlFetchApp.fetch(response.contentUrl)时就会抛出「Exception: Attribute provided with no value: url」错误。
• 手动调用正常的原因：手动执行时，之前的幻灯片修改已通过SlidesApp自动保存机制同步到云端，API能正确识别页面ID，因此运行正常。

解决方案 #

方案1：强制同步本地修改到云端 #

在调用generateScreenshots前，添加SlidesApp.flush()或deck.saveAndClose()，确保所有修改立即同步到云端：

修改后的createSlides关键代码段：

//remove template slides
masterSlide.remove();
masterSlide2.remove();

// 强制将本地修改同步到云端
SlidesApp.flush();
// 也可以使用 deck.saveAndClose();

// 调用截图函数
generateScreenshots(masterDeckID);

方案2：通过Slides API获取最新页面ID（更可靠） #

若方案1仍存在同步延迟问题，可直接通过Slides API获取云端最新页面列表，避免依赖本地SlidesApp的对象ID：

修改后的generateScreenshots函数：

function generateScreenshots(presentationId) {
  var parameters = {
    method: 'GET',
    headers: { Authorization: 'Bearer ' + ScriptApp.getOAuthToken() },
    contentType: 'application/json',
    muteHttpExceptions: true,
  };

  // 通过API获取云端最新的页面列表
  var presentationResponse = JSON.parse(UrlFetchApp.fetch(`https://slides.googleapis.com/v1/presentations/${presentationId}`, parameters));
  var pages = presentationResponse.slides;

  var screenshots = [];

  pages.forEach(function (page, index) {
    var thumbnailUrl = `https://slides.googleapis.com/v1/presentations/${presentationId}/pages/${page.objectId}/thumbnail`;
    var response = JSON.parse(UrlFetchApp.fetch(thumbnailUrl, parameters));

    // 检查contentUrl是否存在，避免报错
    if (response.contentUrl) {
      var blob = UrlFetchApp.fetch(response.contentUrl).getBlob();
      DriveApp.createFile(blob).setName('Image ' + (index + 1) + '.png');
      screenshots.push(response.contentUrl);
    }
  });

  return screenshots;
}

额外优化建议 #

• 在generateScreenshots中增加contentUrl存在性判断，避免因API返回异常导致脚本崩溃。
• 若模板幻灯片数量固定，可直接操作新复制的幻灯片，跳过删除原模板幻灯片的步骤，降低同步冲突概率。

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