借助高级幻灯片服务,您可以使用 Apps 脚本访问 Slides API。此服务允许脚本读取和编辑 Google 幻灯片中的内容。
参考
如需详细了解此服务,请参阅幻灯片 API 的参考文档。与 Apps 脚本中的所有高级服务一样,高级幻灯片服务使用与公共 API 相同的对象、方法和参数。如需了解详情,请参阅如何确定方法签名。
如需报告问题并寻求其他支持,请参阅幻灯片支持指南。
示例代码
以下示例代码使用了该 API 的版本 1。
创建新演示文稿
以下示例演示了如何使用幻灯片高级服务新建演示文稿。它相当于创建新演示文稿配方示例。
创建新的幻灯片
以下示例演示了如何在演示文稿中以特定索引和预定义的布局创建新幻灯片。它相当于创建新幻灯片配方示例。
读取页面元素对象 ID
以下示例演示了如何使用字段掩码检索特定幻灯片上每个页面元素的对象 ID。它相当于从页面中读取元素对象 ID 配方示例。
添加新的文本框
以下示例演示了如何向幻灯片添加新的文本框并在其中添加文本。它相当于向幻灯片添加文本框配方示例。
设置形状内文字的格式
以下示例演示了如何设置形状文本的格式,更新其颜色、字体以及为其文本添加下划线。它相当于设置形状或文本框中文本的格式配方示例。
最佳实践
批量更新
使用幻灯片高级服务时,请将多个请求合并到一个数组中,而不是在循环中调用 batchUpdate
。
错误做法 - 循环调用 batchUpdate
。
var titles = ["slide 1", "slide 2"];
for (var i = 0; i < titles.length; i++) {
Slides.Presentations.batchUpdate(preso, {
requests: [{
createSlide: ...
}]
});
}
正确做法 - 使用一个更新数组调用 batchUpdate
。
var requests = [];
var titles = ["slide 1", "slide 2"];
for (var i = 0; i < titles.length; i++) {
requests.push({ createSlide: ... });
}
Slides.Presentations.batchUpdate(preso, {
requests: requests
});