部署 Meet 插件

Google Meet 插件是在 Google Cloud 项目中创建和配置的。

创建 Google Cloud 项目

如需生成 Google Cloud 项目,请参阅创建 Google Cloud 项目

启用 Google Workspace Marketplace SDK 和 Google Workspace 插件 API

如需开发 Meet 插件,必须使用 Google Workspace Marketplace SDK 和 Google Workspace Add-ons API。如需启用它们,请输入以下命令:

  1. 打开 Google Cloud 控制台
  2. 如果顶部已打开其他项目,请选择应用项目的项目名称以切换项目。
  3. 在顶部的搜索栏中,输入 Google Workspace Marketplace SDK,然后按 Enter 键。
  4. 打开 Google Workspace Marketplace SDK 页面,点击启用

  5. 重复上述步骤即可查找并启用 Google Workspace Add-ons API

创建部署

如需在 Meet 中使用插件,您需要部署和插件清单文件

  1. 打开 Google Cloud 控制台
  2. 如果顶部已打开其他项目,请选择应用项目的项目名称以切换项目。
  3. 点击 API 和服务
  4. 选择 Google Workspace Marketplace SDK 可查看详情页面。

创建部署

您可以直接在 Google Cloud 控制台中创建部署,方法是创建 HTTP 部署(推荐)或使用 Google Apps Script。

HTTP 部署

  1. 点击 HTTP 部署标签页。
  2. 点击创建新部署,然后输入插件对应的部署 ID。

    部署 ID 是任意字符串,可帮助插件开发者识别包含插件清单的部署。部署 ID 是必填项,并且最多只能包含 100 个字符。

  3. 点击下一步

    系统随即会打开一个侧边栏,以便您以 JSON 格式提交插件清单的规范。这也称为 DEPLOYMENT.JSON。

    插件清单文件是 Google Meet 插件的中央配置。以下代码示例展示了插件清单文件中适用于 Meet 的 Web 字段。

    {
      "addOns": {
        "common": {
          "name": "NAME",
          "logoUrl": "LOGO_URL"
        },
        "meet": {
          "web": {
            "sidePanelUri": "SIDE_PANEL_URI",
            "addOnOrigins": ["ADD_ON_ORIGINS"],
            "darkModeLogoUrl": "DARK_MODE_LOGO_URL",
            "logoUrl": "MEET_WEB_LOGO_URL",
            "supportsScreenSharing": SUPPORTS_SCREENSHARING
          }
        }
      }
    }
    

    替换以下内容:

    • NAME:字符串。您的 Google Meet 插件的名称。
    • LOGO_URL:字符串。Google Workspace 插件徽标的网址。此字段适用于 Google Workspace 各产品中的插件。
    • SIDE_PANEL_URI:字符串。您的插件应用入口点的网址。该网址会显示在侧边栏内的 iframe 中。此网址的来源必须是 ADD_ON_ORIGINS 字段中指定的来源之一。
    • ADD_ON_ORIGINS:字符串列表。托管您的插件的来源列表。如果两个网址具有相同的架构、主机和端口,则具有相同的来源。子来源和通配符子网域也受支持。如需了解详情,请参阅插件安全性
    • DARK_MODE_LOGO_URL:字符串。该插件徽标的深色模式专用网址。提供深色模式徽标可确保您的插件在任何 Meet 主题中都能呈现最佳效果。如需了解徽标设计准则,请参阅最佳实践
    • MEET_WEB_LOGO_URL:可选。字符串。该插件徽标的 Meet 专用网址。此徽标在 Meet 的各个位置都有使用。如果不存在,系统会使用“常规”部分中的 logoUrl。如需了解徽标设计准则,请参阅最佳实践
    • SUPPORTS_SCREENSHARING:可选。布尔值。如果设置为 false,用户必须使用该插件才能查看协作插件会话中发生的情况。如果设为 true,协作插件会话的发起者可以屏幕共享其对插件的视图。
  4. 点击提交

    如需详细了解部署,请参阅创建部署资源

  5. 应用配置标签页的应用集成下,选择 Google Workspace 插件。选择使用云部署资源进行部署,然后选择正确的 HTTP 部署。

Google Apps 脚本

  1. 点击应用配置标签页。

  2. 应用集成下,选择 Google Workspace 插件。 选择使用 Google Apps 脚本部署 ID 进行部署,然后输入脚本的部署 ID。

  3. 点击保存

    如需详细了解如何创建 Apps 脚本项目,请参阅 Apps 脚本文档。Meet 插件完全依赖于 appsscript.json 清单文件(也称为 Apps 脚本项目清单)。确保您的 Apps Script 项目中的清单文件包含 addOnsmeet 部分。addOnsmeet 部分采用与“HTTP 部署”标签页中所述的结构相同的结构。

    与其他 Google Workspace 插件不同,Meet 插件无法完全在 Apps 脚本中构建。您必须通过创建侧边栏和主舞台来构建完整的 Web 应用。然后,您必须在 appsscript.json 清单文件的 SIDE_PANEL_URI 下指定您的 Web 应用的侧边栏网址。

在 Meet 中安装和测试插件

如需在 Meet 中测试您的插件,您必须先为已登录的用户安装该插件:

HTTP 部署

  1. 在 Google Cloud 控制台中前往项目的 Google Workspace Marketplace SDK
  2. 点击 HTTP 部署标签页。
  3. 点击操作列下的安装

Google Apps 脚本

  1. 按照 Google Workspace 插件文档中的说明安装未发布的插件

现在,您应该可以在会议中使用插件了。 如需试用,请访问 meet.google.com 发起会议。已安装的插件现在会显示在“活动”面板中。

除了为已登录的个别用户安装插件之外,您还可以发布该插件。发布 Google Workspace 插件后,其他人便可以找到、安装和使用该插件。