脚本项目

脚本项目在 Google Apps 脚本中表示文件和资源集合,有时简称为“脚本”。脚本项目有一个或多个脚本文件,它们可以是代码文件(具有 .gs 扩展名)或 HTML 文件(.html 扩展名)。您还可以在 HTML 文件中添加 JavaScript 和 CSS。

在任何给定时间,脚本编辑器始终会打开且仅打开一个项目。您可以在多个浏览器窗口或标签页中打开多个项目。

创建和删除项目

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

创建独立项目

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

  1. 前往 script.google.com
  2. 点击 New Project
  3. 在脚本编辑器中,点击未命名项目
  4. 为项目命名,然后点击重命名

从 Google 云端硬盘创建独立项目

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

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

  1. 打开 Google 文档、表格或幻灯片演示文稿。
  2. 依次点击扩展程序 > Google Apps 脚本
  3. 在脚本编辑器中,点击未命名项目
  4. 为项目命名,然后点击重命名

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

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

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

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

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

删除与容器绑定的项目

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

删除独立项目

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

管理项目中的文件

创建文件

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

删除文件

  1. 打开您的 Apps 脚本项目。
  2. 点击左侧的 Editor 图标
  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 脚本编辑器,Google 会提示您选择要继续操作的帐号。

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

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