Google Apps Script 教学课程 2：设置和环境

内容：

• 创建第一个 Google Apps Script 项目
• 编辑器界面介绍
• 脚本项目结构
• 脚本运行和授权

1. 创建第一个 Google Apps Script 项目

步骤 1.1：访问 Google Apps Script 编辑器

• 打开浏览器，访问 Google Apps Script 编辑器。
• 如果未登录 Google 账号，请先登录。

步骤 1.2：创建新项目

• 在 Google Apps Script 首页，点击 新建项目 按钮。
• 选择 新建脚本项目 以创建一个新的脚本项目。

步骤 1.3：命名项目

• 在编辑器顶部，点击项目名称（默认是“无标题项目”）。
• 输入新的项目名称，例如 My First Script，然后点击 确定。

2. 编辑器界面介绍

步骤 2.1：了解编辑器布局

• 文件菜单：用于创建、打开、保存脚本文件。
• 编辑菜单：包含常用的编辑操作，如撤销、重做、查找和替换。
• 视图菜单：用于切换脚本文件和查看执行日志。
• 帮助菜单：提供文档和支持资源链接。
• 代码编辑区：编写和编辑脚本代码的主要区域。
• 日志和输出区域：显示日志和脚本运行的输出信息。

步骤 2.2：文件菜单

• 新建：创建新的脚本文件。
• 打开：打开现有的脚本项目。
• 保存：保存当前脚本项目。
• 重命名：重命名当前脚本文件或项目。

步骤 2.3：编辑菜单

• 撤销：撤销上一步操作。
• 重做：重做上一步撤销的操作。
• 查找和替换：查找和替换代码中的文本。

步骤 2.4：视图菜单

• 切换文件：在多个脚本文件之间切换。
• 执行日志：查看脚本运行时的日志和输出信息。

3. 脚本项目结构

步骤 3.1：了解项目结构

• 每个 Google Apps Script 项目包含一个或多个脚本文件和资源文件（如 HTML、CSS 文件）。
• Code.gs：默认的脚本文件，用于编写 Google Apps Script 代码。
• 创建新文件：在左侧导航栏中，点击 + 按钮，选择 脚本文件，输入文件名（如 Utilities.gs）。

步骤 3.2：组织脚本代码

• 在项目中创建多个脚本文件以组织代码。
• 例如，将常用的函数放在 Utilities.gs 中，将主要逻辑放在 Main.gs 中。

4. 脚本运行和授权

步骤 4.1：编写示例代码

• 在 Code.gs 文件中，输入以下示例代码：function myFirstFunction() { Logger.log("Hello, world!"); }

步骤 4.2：运行脚本

• 点击编辑器顶部的 运行 按钮。
• 在下拉菜单中选择 myFirstFunction。

步骤 4.3：首次运行授权

• 第一次运行脚本时，会弹出授权请求窗口。
• 点击 查看权限，选择你的 Google 账号。
• 点击 允许 授权脚本访问你的 Google 账号。

步骤 4.4：查看执行日志

• 脚本运行完成后，点击编辑器顶部的 查看 菜单。
• 选择 执行日志 查看脚本的输出日志。
• 在日志中你会看到 Hello, world! 的输出。

步骤 4.5：处理常见错误

• 如果脚本运行时出现错误，检查代码中的拼写和语法问题。
• 使用 Logger 记录调试信息，例如：function myFirstFunction() { Logger.log("Function started"); Logger.log("Hello, world!"); Logger.log("Function ended"); }

总结

• 回顾本课程的学习内容：创建 Google Apps Script 项目、熟悉编辑器界面、了解项目结构、运行和授权脚本。
• 尝试创建自己的脚本项目，进一步熟悉开发环境。

通过以上详细的教学步骤，我们将能够创建第一个 Google Apps Script 项目，熟悉编辑器界面和项目结构，并了解脚本的运行和授权流程。