部署 Meet 插件

Google Meet 插件是作为 Google Cloud 项目的一部分创建和配置的。

创建 Google Cloud 项目

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

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

开发 Meet 插件需要 Marketplace SDK 和 Google Workspace 插件 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 以查看详情页面。

创建部署

您可以通过创建 HTTP 部署（推荐）或使用 Google Apps 脚本直接在 Google Cloud 控制台中创建部署。

HTTP 部署

  1. 点击 HTTP 部署 标签页。

  2. 点击创建新部署 ，然后输入插件的部署 ID。

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

  3. 点击下一步 。

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

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

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

    替换以下内容：

    • NAME：字符串。Google Meet 插件的名称。
    • LOGO_URL：字符串。Google Workspace 插件的徽标网址。此网址用于 Google Workspace 产品中的插件。
    • SIDE_PANEL_URL：字符串。指向插件应用入口点的网址。此网址显示在侧边栏内的 iframe 中。此网址的 来源必须是 ADD_ON_ORIGINS字段中指定的来源之一。
    • SUPPORTS_SCREENSHARING：可选。布尔值。如果设置为 false，用户必须使用插件才能查看协作插件会话中发生的情况。如果设置为 true，协作插件会话的发起者可以分享其插件视图的屏幕。
    • ADD_ON_ORIGINS：字符串列表。插件托管的 来源列表。如果两个网址具有相同的架构、主机和端口，则它们具有相同的来源。此外，还允许使用子来源和通配符子网域。如需了解详情， 请参阅 插件安全性。
    • MEET_WEB_LOGO_URL：可选。字符串。插件的 Meet 特定徽标网址。 此徽标在整个 Meet 中使用。如果不存在，则使用通用部分中的 logoUrl。如需了解徽标设计指南， 请参阅最佳实践。
    • DARK_MODE_LOGO_URL：字符串。插件的深色模式特定徽标网址。 提供深色模式徽标可确保您的插件在任何 Meet 主题中都能呈现最佳效果。如需了解徽标设计 指南，请参阅最佳实践。

  4. 点击提交 。

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

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

Google Apps 脚本

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

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

  3. 点击保存 。

    如需详细了解如何创建 Apps 脚本项目，请参阅 Apps 脚本文档。Meet 插件完全依赖于 appsscript.json 清单文件，也称为 Apps 脚本项目清单。 请确保 Apps 脚本项目中的清单文件包含 addOns 和 meet 部分。

    以下代码示例展示了插件清单文件中可用的 Meet 字段。

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

    替换以下内容：

    • NAME：字符串。Google Meet 插件的名称。
    • LOGO_URL：字符串。Google Workspace 插件的徽标网址。此网址用于 Google Workspace 产品中的插件。
    • SIDE_PANEL_URL：字符串。指向插件应用入口 点的网址。此网址显示 在 侧边栏内的 iframe 中。此网址的 来源必须是 ADD_ON_ORIGINS字段中指定的来源之一。
    • SUPPORTS_SCREENSHARING：可选。布尔值。如果设置为 false，用户必须使用插件才能查看协作插件会话中发生的情况。如果设置为 true，协作插件会话的发起者可以分享其插件视图的屏幕。
    • ADD_ON_ORIGINS：字符串列表。插件托管的 来源列表。如果两个网址具有相同的架构、主机和端口，则它们具有相同的来源。此外，还允许使用子来源和通配符子网域。如需了解详情， 请参阅 插件安全性。
    • MEET_WEB_LOGO_URL：可选。字符串。插件的 Meet 特定徽标网址。 此徽标在整个 Meet 中使用。如果不存在，则使用通用部分中的 logoUrl。如需了解徽标设计指南， 请参阅最佳实践。
    • DARK_MODE_LOGO_URL：字符串。插件的深色模式特定徽标网址。 提供深色模式徽标可确保您的插件在任何 Meet 主题中都能呈现最佳效果。如需了解徽标设计 指南，请参阅最佳实践。

在 Meet 中安装和测试插件

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

HTTP 部署

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

Google Apps 脚本

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

现在，您应该能够在会议中使用插件了。 如需试用，请在 meet.google.com 上发起会议。安装的插件现在会显示在“活动”面板中。

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