以HTML格式调用Google Apps脚本功能

Question

我指导一个运动队并为它建立一个网站。 我想在管理页面添加一个按钮，我可以点击该按钮快速向团队中的每个人发送电子邮件。 这封电子邮件会说：“今天的时间表已经改变，请访问网站了解更多信息。”

我相信通过Outlook中的分发列表或其他东西可以更容易地实现这一点，但我想使用并更好地理解Google Apps脚本。

我有一个Google电子表格，其中包含电子邮件地址和一个发送电子邮件的简单脚本功能。

当我点击在脚本编辑器中运行它时，这很有效，但是有没有办法从一个带有按钮和一些JavaScript的外部网站调用它？

Answer 1

您需要创建一个可以嵌入网站的Google UI对象 - 您可以通过创建一个将部署为Web应用程序的脚本来完成此操作。 （请参阅Google Apps脚本 - 网络应用 。）该对象将包含一个按钮，该按钮将调用您现有的脚本功能来发送电子邮件。

发布您的Web应用程序以便像您一样执行。 根据您的具体情况，您还可以访问仅限于您的应用。 这意味着您创建的UI Blob将无法为普通公众运行。 这是非常不完整的，但会产生一个带有单个按钮的blob，它会触发您的脚本：

function doGet() {
  var app = UiApp.createApplication();

  var button = app.createButton('Send Schedule Change Email');
  app.add(button);

  var handler = app.createServerHandler('myClickHandler');
  button.addClickHandler(handler);

  return app;
}

function myClickHandler(e) {
  var app = UiApp.getActiveApplication();

  // Call your library function, e.g.
  TeamSpreadsheet.sendScheduleChanged();

  var label = app.createLabel('Message Sent')
                 .setId('statusLabel')
                 .setVisible(false);

  label.setVisible(true);

  app.close();
  return app;
}

您的网络应用需要访问您现有的脚本，我认为该脚本已嵌入您的电子表格中。 这是通过首先保存现有脚本的一个版本（文件 - 管理版本），然后将其作为库添加到新的Web应用程序脚本（资源 - 管理库）来实现的。 在这里阅读更多关于图书馆 由于您的网络应用会像您一样运行，因此您可以将电子表格保密。

注意事项

库中的实用程序脚本需要以从工作表外部开始工作的方式打开电子表格; 使用SpreadsheetApp.openById（） ，而不是SpreadsheetApp.getActiveSpreadsheet（）。 不幸的是，当你使用openKyId打开主机电子表格时，它会让你想要这样的东西：

  var ss = null;
  try {
    // This works for scripts running in the host spreadsheet
    ss = SpreadsheetApp.getActiveSpreadsheet();
  } catch(err) {
    try {
      // This works for web apps
      ss = SpreadsheetApp.openById("SPREADSHEET ID");
    } catch(err) {
      Logger.log("Could not open source spreadsheet.");
      // Well, then, not much sense carrying on, is there?
      return;
    }
  }
  SpreadsheetApp.setActiveSpreadsheet(ss);
  ...

实际上，请注意依赖于从“活动”对象获取信息的调用。 你可能需要做一些体操来绕过它们。

我发现调试这种类型的安排很痛苦，因为当你试图追踪到一个库例程时，app-script调试器经常报告“服务器错误”。

我希望这有助于你开始！

Answer 2

作为Mogsdad答案的补充（这是非常完整和有趣的）我会说你的案例可能会更简单，因为你已经有了一个工作脚本。

拿你的脚本并添加一个doGet()函数，就像在Mogsdad示例中一样，在按钮上定义一个处理程序，它将调用你编写的现有函数来发送邮件，在这个函数中用SpreadsheetApp.OpenById("the ID of the SS")替换getActiveSpreadsheet() SpreadsheetApp.OpenById("the ID of the SS")和OpenByName()的getActiveSheet() OpenByName() ，你完成了修改。

然后遵循Mogsdad说明：将脚本部署为运行的webapp，并使用提供的URL从您站点上的链接访问它。

如果您不想冒任何风险，请在原始电子表格的副本上进行所有这些更改，以便始终保持工作模式。 如果您想要更准确的建议（或者如果您遇到一些困难），请随时显示您现有的脚本以获得有关修改的一些帮助。

PS：请将此视为一个简单的评论，写在一个答案中，以便舒适地形成

Answer 3

只需将您的脚本发布为Web应用程序，然后单击按钮，即可：

window.open("https://script.google.com/macros/s/<id>/exec");

不知道一年前这是否可能。