借助高级幻灯片服务,您可以使用 Apps 脚本访问 Slides API。此服务允许脚本读取和编辑 Google 幻灯片中的内容。
参考
如需详细了解此服务,请参阅 Slides API 的参考文档。与 Apps 脚本中的所有高级服务一样,高级幻灯片服务使用与公共 API 相同的对象、方法和参数。如需了解详情,请参阅如何确定方法签名。
如需报告问题和寻求其他支持,请参阅幻灯片支持指南。
示例代码
以下示例代码使用的是 API 的版本 1。
创建新演示文稿
以下示例演示了如何使用 Google 幻灯片高级服务创建新的演示文稿。这相当于创建新演示文稿食谱示例。
创建新的幻灯片
以下示例演示了如何在特定索引下使用预定义布局在演示文稿中创建新幻灯片。这相当于创建新幻灯片食谱示例。
读取页面元素对象 ID
以下示例演示了如何使用字段掩码检索特定幻灯片上每个页面元素的对象 ID。这相当于从页面中读取元素对象 ID 配方示例。
添加新的文本框
以下示例演示了如何在幻灯片中添加新文本框并向其中添加文本。这相当于 Add a text box to a slide 方法示例。
设置形状内文字的格式
以下示例演示了如何设置形状文本的格式,以及如何更新其颜色、字体和为文本添加下划线。这相当于在形状或文本框中设置文本格式食谱示例。
最佳实践
批量更新
使用幻灯片高级服务时,请将多个请求合并成一个数组,而不是在一个循环中调用 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
});