脚本项目是指 Google Apps 脚本中的文件和资源集合,有时也简称为“脚本”。一个脚本项目包含一个或多个脚本文件,这些文件可以是代码文件(具有 .gs
扩展名)或 HTML 文件(具有 .html
扩展名)。您还可以在 HTML 文件中添加 JavaScript 和 CSS。
脚本编辑器在任何给定时间始终只打开一个项目。 您可以在多个浏览器窗口或标签页中打开多个项目。
创建和删除项目
本部分介绍了如何创建和删除独立或容器绑定的 Apps 脚本项目。
创建独立项目
如需通过 Apps 脚本创建独立项目,请执行以下操作:
- 前往
script.google.com
。 - 点击 New Project。
- 在脚本编辑器中,点击无标题项目。
- 为项目命名,然后点击重命名。
通过 Google 云端硬盘创建独立项目
- 打开 Google 云端硬盘。
- 依次点击新建 > 更多 > Google Apps 脚本。
从 Google 文档、表格或幻灯片创建容器绑定项目
- 打开 Google 文档、表格或幻灯片。
- 依次点击扩展程序 > Google Apps 脚本。
- 在脚本编辑器中,点击无标题项目。
- 为项目命名,然后点击重命名。
通过 Google 表单创建容器绑定项目
- 在 Google 表单中打开相应表单。
- 依次点击“更多”图标 > 脚本编辑器。
- 在脚本编辑器中,点击无标题项目。
- 为项目命名,然后点击重命名。
使用 clasp
命令行工具创建独立项目
clasp
是一款命令行工具,可让您通过终端创建、拉取/推送和部署 Apps 脚本项目。
如需了解详情,请参阅使用 clasp
的命令行界面指南。
删除容器绑定的项目
- 使用上述相应方法打开容器绑定项目。
- 点击左上角的概览 。
- 依次点击右上角的“移除”图标 > 永久删除。
删除独立项目
- 前往
script.google.com
。 - 在要删除的项目右侧,依次点击“更多”图标 > 移除 > 移除。
管理项目中的文件
创建文件
- 打开您的 Apps 脚本项目。
- 在左侧,依次点击编辑器 > 添加 。
- 选择要创建的文件类型并为其命名。
删除文件
- 打开您的 Apps 脚本项目。
- 点击左侧的编辑器图标 。
- 在要删除的文件旁边,依次点击“更多”图标 > 删除。
将文件导出到 Apps 脚本项目之外
如需将代码文件从 Apps 脚本中导出,您可以将每个文件中的代码复制并粘贴到自己喜欢的文本编辑器中,也可以在命令行中使用 clasp。 如需使用 clasp,请参阅下载脚本项目。
为项目设置时区
您可以为 Apps 脚本项目设置时区。脚本执行的函数会使用此时区。
- 打开您的 Apps 脚本项目。
- 点击左侧的项目设置图标
。
- 在时区部分中,选择要使用的时区。
如果您希望特定函数使用不同于脚本项目的时区,请在函数中明确输入时区。例如,在下面的示例中,每个函数都会在 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 账号。