在此 Codelab 中，我们将向您介绍一种最简单的方法来编写用于访问 Google 开发者技术的代码。这一切都是通过应用 JavaScript（一种主流 Web 开发语言）完成的。您可以使用 Google Apps 脚本编写代码，从 Google 表格的单元格中提取街道地址，根据地址生成 Google 地图，然后使用 Gmail 以附件形式发送地图。最难得的是，只有四行代码。

　　Google Apps 脚本是一个开发平台，可让您快速轻松地创建与 Google Workspace 集成的脚本和小型应用。借助 Apps 脚本，您可以：

　　注意：如何编写 JavaScript 代码不在此特定 Codelab 的讨论范围内。我们的目标是让您能熟练使用 Apps 脚本开发环境，并了解您可以使用该环境构建的应用类型。

　　如果您刚开始接触 JavaScript，Codecademy提供了免费的JavaScript 入门课程。虽然 Google 并未制作此课程，但应包含您有必要知道的一切。

　　Apps 脚本可用于创建各种应用，从聊天机器人到 Web 应用，不一而足。最常见的用途之一是扩展 Google 表格电子表格的功能。在此 Codelab 的其余部分，您将学习如何使用 Apps 脚本从电子表格获取数据并将其连接到其他 Google 服务。

　　在空白的电子表格中，转到左上角的第一个单元格 (A1)。它位于 A 列第 1 行。如果您需要重新熟悉一下，可以参阅A1 表示法说明。

　　在单元格中输入有效的街道地址。使用街道地址、邮政编码或城市和州/省/自治区/直辖市的组合，选择世界上具有确切位置的地址。以下是纽约市的地址示例：

　　在新的浏览器标签页中，代码编辑器会显示工作表的默认与容器绑定的脚本。系统会自动创建名为myFunction()的默认函数，并将光标放置在该函数内，以便您开始使用。

　　我们来看一下构成整个应用的sendMap()函数的 4 行代码。有趣的是谷歌上网需要翻墙吗，该代码引用了 3 种不同的 Google 产品。

　　大多数脚本会先要求用户提供一些权限，然后才能运行。这些权限控制着用户允许脚本执行的操作。第一行是包含可选注释的注释，用于指示 Apps 脚本限制对当前电子表格（而不是用户的所有电子表格）的访问。如果您只处理一个文件，最好始终添加此注释。

　　下一行代码会调用可通过SpreadsheetApp对象可从 Apps 脚本访问的电子表格服务。返回的工作表被分配给同名变量。getActiveSheet()方法可获取对当前工作表对象的引用，并将其存储在变量sheet中。

　　借助sheet对象，我们会使用getRange()引用（采用A1 表示法表示的单个单元格）的单元格范围。“range”（范围）是一组单元格，包括一个单元格，例如单元格A1（我们在其中输入地址的单元格）。为了提取范围内的内容，getValue()方法会返回范围内左上角单元格的值，并将该值赋值给变量address。您还可以尝试添加更多地址，并从其他单元格中读取数据。

　　第三行代码使用Maps对象连接到 Google地图服务。newStaticMap()用于创建静态地图对象，addMarker()方法用于添加“图钉”使用工作表中的地址映射到地图。

　　最后，Gmail 服务通过MailApp对象调用sendEmail()方法，发送同时包含文本“如下所示”的电子邮件。并将地图图像作为附件

　　命名并保存函数后，就可以运行该函数了。在编辑器的顶部，确保从函数列表中选择sendMap()，然后点击Run。

　　Apps 脚本功能是开发者青睐的一大优势，即您无需编写授权代码来授予程序访问用户数据的权限。尽管 Apps 脚本可以做到这一点，但您应用的用户仍然需要授权该脚本访问他们的电子表格并通过 Gmail 发送电子邮件。第一个授权对话框如下所示：

　　注意：如果您使用的是号，则首次使用脚本时，可能会出现“此应用未进行验证”对话框。Google 使用此消息来警告可能正在使用未知或不可信作者的代码的用户。如果您看到此对话框，您可以继续操作，因为您是脚本作者。按照屏幕上的提示继续为脚本授权：

　　在整个 Codelab 中，您可能会收到多项权限提示。如需详细了解此过程，请参阅授权 Google 服务。

　　接下来，您会看到一个 OAuth2 对话框窗口，请求您授予访问工作表和代表您发送电子邮件的权限：

　　检查您发送邮件的目标电子邮件，应该会看到一封包含“地图”的电子邮件作为主题，并提供类似如下的消息：

　　当您打开电子邮件中的附件时，应该会看到一个 Google 地图，其中您在工作表中输入的地址上有一个图钉：

　　如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据Apache 2.0 许可获得了许可。有关详情，请参阅Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。