Google Apps 脚本:如何在 Google 幻灯片上创建幻灯片并使用数组中的信息填充其中的占位符?

Google Apps Script: How to create slides on Google Slides and fill the placeholders in it with information from an array?

我有一个数组,我正在尝试使用其中的信息来创建 Google 幻灯片演示文稿。我需要一些帮助,如果可能的话,还请给我指出一些 material 我可以阅读以更好地理解这些问题的可能解决方案。

数组如下:

var myArray = [[Project1,Status1,Info1],[Project2,Status2,Info2],...,[ProjectN,StatusN,InfoN]]

数组中的每个元素都引用不同的项目并包含:

都是字符串。数组中的元素数量可能会有所不同,但它们将始终遵循此结构。

在演示文稿中,我在我命名为 "NEW LAYOUT" 的主布局中创建了一个新布局。该布局有 4 个组,每个组中有 3 个占位符。每组占位符应该填充不同项目的信息,这意味着一组占位符将填充 myArray[i][1]myArray[i][2]myArray[i][3].

到目前为止我的代码如下:

function CreatingSlides() {

var displayName = "NEW LAYOUT"; // Name of the layout that I created
var presentationId = SlidesApp.openById(PageId).getId(); //It is an existing presentation, so I just get its ID
var layouts = Slides.Presentations.get(presentationId).layouts;
var layout = {};

//The following is the array of elements. In this example,
//I only used 4 projects, but it may vary and may not be
//a multiple of 4.
var myArray = [["Project1","Status1","Info1"],["Project2","Status2","Info2"],["Project3","Status3","Info3"],["Project4","Status4","Info4"]];


//This loop searches for the layout that I created
for (i in layouts) {
  layout[layouts[i].layoutProperties.displayName] = layouts[i].objectId;
  }

//In the slide created, this loop will fill the information in it using the myArray
for (i in myArray) {
  var resource = {"requests": [{"createSlide": {"slideLayoutReference": {"layoutId": layout[displayName]},
                                                "placeholderIdMappings": [{"layoutPlaceholder": {"type": "SUBTITLE","index": 0},"objectId":myArray[i][1],},],
                                                "placeholderIdMappings": [{"layoutPlaceholder": {"type": "BODY","index": 0},"objectId":myArray[i][2],},],
                                                "placeholderIdMappings": [{"layoutPlaceholder": {"type": "BODY","index": 1},"objectId":myArray[i][3],},],
                                                "placeholderIdMappings": [{"layoutPlaceholder": {"type": "SUBTITLE","index": 1},"objectId":myArray[i+1][1],},],
                                                "placeholderIdMappings": [{"layoutPlaceholder": {"type": "BODY","index": 2},"objectId":myArray[i+1][2],},],
                                                "placeholderIdMappings": [{"layoutPlaceholder": {"type": "BODY","index": 3},"objectId":myArray[i+1][3],},],
                                                "placeholderIdMappings": [{"layoutPlaceholder": {"type": "SUBTITLE","index": 2},"objectId":myArray[i+2][1],},],
                                                "placeholderIdMappings": [{"layoutPlaceholder": {"type": "BODY","index": 4},"objectId":myArray[i+2][2],},],
                                                "placeholderIdMappings": [{"layoutPlaceholder": {"type": "BODY","index": 5},"objectId":myArray[i+2][3],},],
                                                "placeholderIdMappings": [{"layoutPlaceholder": {"type": "SUBTITLE","index": 3},"objectId":myArray[i+3][1],},],
                                                "placeholderIdMappings": [{"layoutPlaceholder": {"type": "BODY","index": 6},"objectId":myArray[i+3][2],},],
                                                "placeholderIdMappings": [{"layoutPlaceholder": {"type": "BODY","index": 7},"objectId":myArray[i+3][3],},],
                                                }
                                },
                 {"insertText": {"objectId": myArray[i][1],"text": myArray[i][1],},
                  "insertText": {"objectId": myArray[i][2],"text": myArray[i][2],},
                  "insertText": {"objectId": myArray[i][3],"text": myArray[i][3],},
                  "insertText": {"objectId": myArray[i+1][1],"text": myArray[i+1][1],},
                  "insertText": {"objectId": myArray[i+1][2],"text": myArray[i+1][2],},
                  "insertText": {"objectId": myArray[i+1][3],"text": myArray[i+1][3],},
                  "insertText": {"objectId": myArray[i+2][1],"text": myArray[i+2][1],},
                  "insertText": {"objectId": myArray[i+2][2],"text": myArray[i+2][2],},
                  "insertText": {"objectId": myArray[i+2][3],"text": myArray[i+2][3],},
                  "insertText": {"objectId": myArray[i+3][1],"text": myArray[i+3][1],},
                  "insertText": {"objectId": myArray[i+3][2],"text": myArray[i+3][2],},
                  "insertText": {"objectId": myArray[i+3][3],"text": myArray[i+3][3],}},
                               ]};

Slides.Presentations.batchUpdate(resource, presentationId);   

}

}

问题 1:当数组中的元素数量可能不同时如何做到这一点?

在这段代码中,我只使用了 myArray 中的 4 个元素,因此创建的幻灯片中的所有占位符都将被填充。但是,我不明白如果元素的数量大于 4,我怎么能告诉它创建一个新幻灯片。此外,元素的数量可能不是 4 的倍数(可能是 5,可能是 60,可能72 岁...).

问题 2:我不知道如何在请求中正确使用 objectIds

我从 Google Apps 脚本参考中看到的另一个代码中获得了这一部分。在其中,我了解到,在请求中,if 首先为 objectId 设置一个名称,然后它使用该名称在该占位符中写入一些内容。然而,这会产生一些问题:objectId 有时不接受我试图给它的名称,或者 objectId 说它不能使用我建议的名称,因为它应该是唯一的。有更好的方法吗?

问题 3:是否可以不必写 12 行来填充占位符?

我认为这只是因为我不知道如何正确使用 objectId(问题 2)。因此,我必须单独命名幻灯片中的每个 objectId。我相信有一些方法可以使用循环来做到这一点,但到目前为止我还没有找到解决方案或理解它。

首先是一个建议:您混合使用 Advanced Google Service for Slides and the built-in Slides service (SlidesApp)。如果你只使用 SlidesApp 会简单很多,因为它应该做你需要的,你不需要担心 objectIds 是否正确。

正在回答您的问题:

问题 1:当数组中的元素数量可能不同时如何解决?

这里的问题是您的布局中只有 12 个占位符。尝试填充超过该数量的它们是行不通的,因为您将要 运行 占位符来填充。您的选择是:不使用占位符,而是创建和定位文本框,或者以不同的方式呈现您的数据。例如,每个项目使用 1 张幻灯片,其中包含 3 个占位符,一个用于项目名称、状态和信息。

我建议您手动创建一个示例幻灯片来设计您希望最终幻灯片的外观,然后反向编写代码来生成它。通常在带有 {{project_1}}: {{status_1}} 等可变字符串的幻灯片上执行 ReplaceAllText 会非常有效。

问题 2:我不知道如何在请求中正确使用 objectIds

尝试为占位符提供对象 ID,然后使用 InsertText 设置内容,您的做法是正确的。我认为您的问题是 placeholderIdMappings 不正确,您想要一个映射对象列表,而不是多次指定 placeholderIdMappings 键(参见 sample)。

{
  "createSlide": {
    "objectId": pageId,
    "slideLayoutReference": {
      "layoutId": "layoutId"
    },
    "placeholderIdMappings": [
      {
        "layoutPlaceholder": {
          "type": "SUBTITLE",
          "index": 0
        },
        "objectId": "project1Id",
       },
      {
        "layoutPlaceholder": {
          "type": "BODY",
          "index": 0
        },
        "objectId": "project1Id",
       },
    ],
  }
}

问题 3:是否可以不必编写 12 行来填充占位符?

我认为这主要是由于您构建项目数据的方式、幻灯片的布局以及 placeholderIdMappings 问题。解决这些问题应该会让这件事更容易处理。

用SlidesApp应该也更容易对付(使用Slide#getPlaceholder