脚本项目

脚本项目代表 Google Apps Script 中的一组文件和资源，有时也简称为“脚本”。脚本项目包含一个或多个脚本文件，这些文件可以是代码文件（扩展名为 .gs）或 HTML 文件（扩展名为 .html）。您还可以在 HTML 文件中添加 JavaScript 和 CSS。

脚本编辑器中始终只有一个项目处于打开状态。您可以在多个浏览器窗口或标签页中打开多个项目。

创建和删除项目

本部分介绍了如何创建和删除独立或容器绑定的 Google Apps Script 项目。

创建独立项目

如需通过 Apps 脚本创建独立项目，请执行以下操作：

  1. 前往 script.google.com。
  2. 点击 New Project。
  3. 在脚本编辑器中，点击 Untitled project（无标题项目）。
  4. 为项目命名，然后点击重命名。

通过 Google 云端硬盘创建独立项目

  1. 打开 Google 云端硬盘。
  2. 依次点击新建 > 更多 > Google Apps Script。

通过 Google 文档、表格或幻灯片创建容器绑定型项目

  1. 打开文档、表格或幻灯片。
  2. 依次点击扩展程序 > Google Apps 脚本。
  3. 在脚本编辑器中，点击 Untitled project（无标题项目）。
  4. 为项目命名，然后点击重命名。

通过 Google 表单创建容器绑定项目

  1. 在 Google 表单中打开相应表单。
  2. 依次点击“更多”图标 > 脚本编辑器。
  3. 在脚本编辑器中，点击 Untitled project（无标题项目）。
  4. 为项目命名，然后点击重命名。

使用 clasp 命令行工具创建独立项目

clasp 是一个命令行工具，可让您从终端创建、拉取/推送和部署 Apps 脚本项目。

如需了解详情，请参阅使用 clasp 的命令行界面指南。

删除绑定到容器的项目

  1. 使用上述适当的方法打开绑定到容器的项目。
  2. 点击左上角的概览 。
  3. 在右上角，依次点击“移除”图标 > 永久删除。

删除独立项目

  1. 前往 script.google.com。
  2. 在要删除的项目的右侧，依次点击“更多”图标 > 移除 > 移除。

管理项目中的文件

创建文件

  1. 打开您的 Apps 脚本项目。
  2. 在左侧，依次点击 Editor > 添加 。
  3. 选择要创建的文件类型并为其命名。

删除文件

  1. 打开您的 Apps 脚本项目。
  2. 点击左侧的编辑器图标 。
  3. 在要删除的文件旁边，依次点击“更多”图标 > 删除。

从 Apps 脚本项目中导出文件

如需将代码文件从 Apps 脚本中移出，您可以将每个文件中的代码复制并粘贴到您首选的文本编辑器中，也可以在命令行中使用 clasp。如需使用 clasp，请参阅下载脚本项目。

为项目设置时区

您可以为 Apps 脚本项目设置时区。脚本执行的函数会使用此时区。

  1. 打开您的 Apps 脚本项目。
  2. 点击左侧的项目设置 项目设置的图标。
  3. 在时区部分，选择您要使用的时区。

如果您希望某个特定函数使用与脚本项目不同的时区，请在函数中明确输入时区。例如，在以下示例中，每个函数都会在 Google 日历中创建一个新活动。第一个函数默认为项目时区。第二个函数指定了太平洋时区，因此无论项目的时区如何，事件都会按太平洋时间进行调度。

function createEvent(){
// Creates an event in the script project's time zone and logs the ID
var event = CalendarApp.getDefaultCalendar().createEvent('New test event',
   new Date('December 20, 2022 17:00:00'),
   new Date('December 20, 2022 18:00:00'));
console.log('Event ID: ' + event.getId());
}
function createEventPacific(){
// Creates an event with a specified time zone and logs the event ID.
var event = CalendarApp.getDefaultCalendar().createEvent('New sample event',
   new Date('December 20, 2022 17:00:00 PDT'),
   new Date('December 20, 2022 18:00:00 PDT'));
console.log('Event ID: ' + event.getId());
}

解决多个 Google 账号的问题

如果您同时登录多个 Google 账号，则可能会无法访问您的插件和 Web 应用。Apps 脚本、插件或 Web 应用不支持多重登录或同时登录多个 Google 账号。

  • 如果您在登录多个账号的情况下打开 Apps Script 编辑器，Google 会提示您选择要继续操作的账号。

  • 如果您打开 Web 应用或插件时遇到多重登录问题，请尝试以下解决方案之一：

    • 退出您所有的 Google 账号，然后仅登录包含您要访问的插件或 Web 应用的账号。
    • 在 Google Chrome 中打开无痕式窗口或等效的无痕浏览窗口，然后登录包含您要访问的插件或 Web 应用的 Google 账号。