Google Apps Script中Slide.shapes调用失败问题求助

你遇到的问题核心是混淆了Google Apps Script的Slides服务（SlidesApp）和Slides REST API（Slides.Presentations）的对象结构，和账号类型无关——普通谷歌账号、受限Workspace账号都能正常运行相关功能，不需要正式Workspace账号。

问题根源 #

你参考的官方文档是Apps Script原生SlidesApp.Slide类的文档，这个类确实有shapes属性；但你的代码用的是Slides.Presentations.get()（Slides REST API），它返回的是REST接口的响应对象，这个对象的slide结构里没有shapes字段，只有pageElements——这就是为什么你能正常访问pageElements，但访问shapes时会报undefined错误。

解决方法 #

有两种方式可以获取幻灯片中的形状数量：

方法1：改用Apps Script原生SlidesApp服务

直接使用SlidesApp类来操作，它的对象结构和你参考的文档一致：

function testWithSlidesApp() {
  const presentationId = '1PCnGJjxRUCuOvcMlTkP_Fs2R0TW0szokdpMZlEuaTHg';
  const presentation = SlidesApp.openById(presentationId);
  const slides = presentation.getSlides();
  console.log('The presentation contains %s slides:', slides.length);
  console.log('Contains %s pageElements.', slides[0].getPageElements().length);
  console.log('Contains %s shapes.', slides[0].getShapes().length);
}

方法2：继续使用Slides REST API，手动筛选形状

如果坚持用REST API，需要从pageElements里筛选出类型为SHAPE的元素：

function testWithSlidesAPI() {
  const presentationId = '1PCnGJjxRUCuOvcMlTkP_Fs2R0TW0szokdpMZlEuaTHg';
  const presentation = Slides.Presentations.get(presentationId);
  const slides = presentation.slides;
  console.log('The presentation contains %s slides:', slides.length);
  console.log('Contains %s pageElements.', slides[0].pageElements.length);
  
  // 从pageElements中筛选出形状类型的元素
  const shapesCount = slides[0].pageElements.filter(element => element.shape).length;
  console.log('Contains %s shapes.', shapesCount);
}

补充说明 #

Slides REST API返回的pageElements包含所有页面元素（形状、图片、文本框、表格等），每个元素的类型由自身的子字段标识（比如shape字段存在则为形状，image字段存在则为图片），不像SlidesApp服务那样直接提供shapes这类封装好的属性。

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