Google Apps 脚本快速入门

创建一个 Google Apps 脚本 ，向 Google Chat API 发出请求。

快速入门介绍了如何设置和运行调用 Google Workspace API 的应用。此快速入门使用一种简化的身份验证方法，适用于测试环境。对于生产环境，我们建议您先了解 身份验证和授权 ，然后再 选择适合您应用的访问凭据 。

在 Apps 脚本中，Google Workspace 快速入门使用 高级 Google 服务来调用 Google Workspace API，并处理身份验证 和授权流程的一些详细信息。

目标

  • 配置环境。
  • 创建和配置脚本。
  • 运行脚本。

前提条件

配置云项目

如果您使用新的 Google Cloud 项目来完成此快速入门，则需要对其进行配置，并将自己添加为测试用户。如果您已为 Cloud 项目完成这些步骤，请跳到下一部分。

在 Google Cloud 控制台中打开云项目

如果尚未打开，请打开您打算用于此示例的 Cloud 项目：

  1. 在 Google Cloud 控制台中，前往选择项目 页面。

    选择 Cloud 项目

  2. 选择您要使用的 Google Cloud 项目。或者，点击创建项目 ，然后按照屏幕上的说明操作。如果您创建了 Google Cloud 项目，可能需要为该项目启用结算功能。

启用 Chat API

在使用 Google API 之前，您需要在 Google Cloud 项目中启用它们。 您可以在单个 Google Cloud 项目中启用一个或多个 API。

  • 在 Google Cloud 控制台中，启用 Google Chat API。

    启用 API

  1. 在 Google API 控制台中，依次前往“菜单”菜单 > Google Auth 平台 > 品牌塑造。

    前往“品牌塑造”

  2. 如果您已配置 Google Auth 平台，则可以在品牌塑造、受众群体和数据访问权限中配置以下 OAuth 权限请求页面设置。如果您看到一条消息，指出尚未配置 Google Auth 平台，请点击开始使用：
    1. 在应用信息 下的应用名称 中，输入应用的名称。
    2. 在用户支持邮箱中，选择一个支持邮箱地址，以便用户在对权限请求有疑问时与您联系。
    3. 点击下一步 。
    4. 在受众群体 下，选择内部 。
    5. 点击下一步 。
    6. 在联系信息下，输入一个邮箱地址，以便您接收有关项目变更的通知。
    7. 点击下一步 。
    8. 在完成 部分，查看 Google API 服务用户数据政策，如果您同意，请选择我同意 Google API 服务：用户数据政策。
    9. 点击继续 。
    10. 点击创建 。
  3. 目前，您可以跳过添加范围。 将来，当您创建应用以供您的 Google Workspace 组织外部使用时，必须将 用户类型 更改为 外部。然后， 添加应用所需的授权范围。如需了解详情，请参阅完整的 配置 OAuth 权限请求页面指南。

配置 Google Chat 应用

如需执行创建、更新和删除 Google Chat API 调用，您必须配置 Google Chat 应用。对于任何写入请求，Google Chat 都会使用以下信息在界面中归因 Google Chat 应用。

  1. 在 Google API 控制台中，前往 Chat API 配置 页面：

    前往 Chat API 配置页面

  2. 在应用信息 下，输入以下信息：

    1. 在应用名称 字段中，输入 Chat API quickstart app。
    2. 在头像网址 字段中，输入 https://developers.google.com/chat/images/quickstart-app-avatar.png。
    3. 在说明 字段中，输入 Quickstart for calling the Chat API。

  3. 在互动功能下，点击启用互动功能 开关，将其切换到关闭位置，以停用 Chat 应用的互动功能。

  4. 点击保存 。

创建脚本

  1. 在 Apps 脚本编辑器中创建一个新脚本，方法是前往 script.google.com/create。
  2. 将脚本编辑器的内容替换为以下代码：

chat/quickstart/Code.gs
/**
 * This quickstart sample shows how to list spaces with user credential
 *
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.spaces.readonly'
 * referenced in the manifest file (appsscript.json).
 */
function listSpaces() {
  // Initialize request argument(s)
  // Filter spaces by space type (SPACE or GROUP_CHAT or DIRECT_MESSAGE)
  const filter = 'space_type = "SPACE"';

  // Iterate through the response pages using page tokens
  let responsePage;
  let pageToken = null;
  do {
    // Request response pages
    responsePage = Chat.Spaces.list({
      filter: filter,
      pageToken: pageToken,
    });
    // Handle response pages
    if (responsePage.spaces) {
      for (const space of responsePage.spaces) {
        console.log(space);
      }
    }
    // Update the page token to the next one
    pageToken = responsePage.nextPageToken;
  } while (pageToken);
}

  1. 点击“保存”图标 。
  2. 点击未命名项目，输入 Quickstart，然后点击重命名。

配置脚本

复制 Cloud 项目编号

  1. 在 Google API 控制台中，依次前往“菜单”菜单 > IAM 和管理 > 设置。

    前往“IAM 和管理”设置

  2. 在项目编号 字段中，复制相应值。
  1. 打开 Apps 脚本项目。
  2. 点击项目设置 。
  3. 在 Google Cloud Platform (GCP) 项目 下，点击 更改项目 。
  4. 在 GCP 项目编号 中，粘贴 Google Cloud 项目编号。
  5. 点击设置项目 。

启用 Google Chat API

打开 Apps 脚本项目。

  1. 点击项目设置 。
  2. 在常规设置下，启用显示“appsscript.json”清单文件 在编辑器中。
  3. 点击编辑器 ，选择 文件appscript.json，然后将内容替换为以下代码：

chat/quickstart/appsscript.json
{
  "timeZone": "America/New_York",
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": ["https://www.googleapis.com/auth/chat.spaces.readonly"],
  "chat": {},
  "dependencies": {
    "enabledAdvancedServices": [
      {
        "userSymbol": "Chat",
        "version": "v1",
        "serviceId": "chat"
      }
    ]
  }
}

运行示例

在 Apps 脚本编辑器中，点击运行 。

首次运行示例时，系统会提示您授权访问：

  1. 点击查看权限 。
  2. 选择账号。
  3. 点击允许 。

脚本的执行日志会显示在窗口底部。

后续步骤