微应用

集成 Google Meet

部署 Google Meet 集成以安排 Google Meet 会议并列出来自任何设备或内联网的录制内容。此集成解决了两个用例:

  • 使用 Create Meeting 微应用,用户可以主持一次/定期会议、添加被邀请者以及选择不同的时区。还会向所有受邀者发送一封后续电子邮件,其中包含相应的会议对象,以便轻松集成日历
  • 使用会议录制微应用,用户可以查看他们有权访问的所有会议录制文件。

注意:

我们希望得到你的反馈!请在使 用此集成模板时提供反馈 。对于任何问题,我们的团队还将每天监控我们的 专门论坛

有关适用于 Google Meet 的开箱即用微应用的全面详细信息,请参阅 使用 Google Meet 微应用。

查看必备项

这些先决条件假定管理员是组织的 Google Meet 集成设置的一部分。此 Google Meet 管理员帐户必须具有用户信息的完全读取权限。在与 Google Meet 设置此集成后,您需要以下工件才能在 Citrix Workspace 微应用中添加集成:

  • 基本 URL:https://www.googleapis.com/
  • 令牌 URL:https://oauth2.googleapis.com/token
  • 授权 URL:https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent
  • CLIENT ID:客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。
  • SECRET:客户端密钥是设置目标应用程序集成时发出的唯一字符串。

注意:

我们建议您始终使用 OAuth 2.0 作为可用的服务身份验证方法。OAuth 2.0 可确保您的集成符合配置的微应用的最高安全性合规性。

将 Citrix Gateway 配置为支持 Google Meet 的单点登录,这样一旦用户登录,他们将自动重新登录,而无需再次输入凭据。有关配置 SSO 的更多信息,请参阅 Citrix Gateway 服务 https://docs.citrix.com/en-us/citrix-gateway-service/

集成需要定期访问您的 Google Meet 实例,因此我们建议您创建一个专用的用户帐号。此账户必须具有以下权限:

  • 服务帐户所需的权限:完全管理员权限

  • 服务帐号所需的范围:

    https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/calendar.events https://www.googleapis.com/auth/admin.directory.user

可以对特定资源发出的 API 请求数量有限,因此我们建议您执行以下操作:

创建一个新的服务帐号

在这里登录: https://workspace.google.co.in/intl/en_in/pricing.html

启用 API

默认情况下,Google Meet API 可以通过网络服务访问付费帐户。

配置 OAuth

  1. 使用服务帐号登录以: https://console.cloud.google.com
  2. 在左侧菜单中选择 API 和服务
  3. 从导航菜单的项目列表中选择相应的项目。
  4. 选择 启用 API 和服务,然后从 G-Suite 启用所有必需的 API。推荐的 API:Google 日历 API管理 SDK
  5. 返回 API 和服务 页面,然后在左侧 屏幕上选择 OAuth 同意 屏幕。
  6. 根据您的要求选择 用户类型 (我们建议: 内部),然后选择 创建
  7. 填写必填字段,包括 服务帐户所需的范围,然后保存详细信息。这些是必需的范围:

配置回调 URL 服务器

将 OAuth 服务器配置为通过 Google Meet 集成读取数据。

  1. 使用服务帐号登录以: https://console.cloud.google.com
  2. 在左侧菜单中选择 API 和服务
  3. 从导航菜单的项目列表中选择相应的项目。
  4. 在左侧屏幕上选择凭据
  5. 选择 创建凭据,然后从列表中选择 OAuth 客户端 ID
  6. 应用程序类型列表中选择 Web应用程序,然后输入名称
  7. 授权的重定向URI 下选择添加 URI
  8. UR I 字段中输入此集成的以下授权重定向 URL:

    • https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
  9. 选择 Create(创建)。
  10. 复制并保存屏幕上显示的 clientId 和 S ecret 。配置集成时,可以将这些详细信息用于 服务身份验证

配置回调 URL 客户端

配置 OAuth 客户端以通过 Google Meet 集成写回数据。

  1. 使用服务帐号登录以: https://console.cloud.google.com
  2. 在左侧菜单中选择 API 和服务
  3. 从导航菜单的项目列表中选择相应的项目。
  4. 在左侧屏幕上选择凭据
  5. 选择 创建凭据,然后从列表中选择 OAuth 客户端 ID
  6. 应用程序类型列表中选择 Web应用程序,然后输入名称
  7. 授权的重定向URI 下选择添加 URI
  8. UR I 字段中输入此集成的以下授权重定向 URL:

    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
  9. 选择 Create(创建)。
  10. 复制并保存屏幕上显示的 clientId 和 S ecret 。配置集成时,可以将这些详细信息用于 服务操作身份验证

将集成添加到 Citrix Workspace 微应用

将 Google Meet 集成添加到 Citrix Workspace 微应用程序以连接到您的应用程序。这样可以提供带有预配置通知和操作的开箱即用的微应用程序,这些通知和操作可在工作区中使用

请按照以下步骤进行操作:

  1. 微应用集成 页面中,选择 添加新集成,然后 从 Citrix 提供的模板中添加新集成。
  2. 选择 Google Meet 磁贴。
  3. 输入集成的名称。
    • 输入实例 基本 URLhttps://www.googleapis.com/
    • 图标 库中选择用于集成的图标,或将其保留为默认图标。

    名称和基本 URL

  4. 服务身份验证下,从身份验证 方法 菜单中选择 OAuth 2.0 ,然后填写身份验证详细信息。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为可用的服务身份验证方法。OAuth 2.0 可确保您的集成符合配置的微应用的最大安全合规性。

    1. 授权类型菜单中选择授权码。这会授予客户端用来交换访问令牌的临时代码。该代码从授权服务器获取,您可以在其中查看客户端请求的信息。只有这种授权类型才能启用安全的用户模拟。这将显示您在注册应用程序时使用的 回调 URL
    2. 令牌授权菜单中选择请求正文
    3. 授权 URL 是预先填写的: https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent
    4. 令牌 URL 已预先填充:https://oauth2.googleapis.com/token
    5. 确保为 Scope 输入以下内容: https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/calendar.events https://www.googleapis.com/auth/admin.directory.user
    6. 输入您的 客户 ID。客户端 ID 是表示授权服务器特有的客户端注册信息的字符串。您在配置 OAuth 服务器时收集此密钥和密钥。您需要添加在集成配置页面上看到的 回调 URL
    7. 输入您的 客户端密钥。客户端密钥是设置目标应用程序集成时发出的唯一字符串。

    服务验证

  5. 服务操作身份验证下,启用在操作使用单独的用户身份验证开关。服务操作身份验证在服务操作级别进行身份验证。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。

    1. 身份验证方法菜单中选择 OAuth 2.0,然后填写身份验证详细信息。
    2. 授权类型菜单中选择授权码。这会授予客户端用来交换访问令牌的临时代码。该代码从授权服务器获取,您可以在其中查看客户端请求的信息。只有这种授权类型才能启用安全的用户模拟。这将显示您在注册应用程序时使用的 回调 URL
    3. 令牌授权菜单中选择请求正文
    4. 授权 URL 是预先填写的: https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent
    5. 令牌 URL 已预先填充:https://oauth2.googleapis.com/token
    6. 确保为 Scope 输入以下内容: https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/calendar.events
    7. 输入您的 客户 ID。客户端 ID 是表示授权服务器特有的客户端注册信息的字符串。您在配置 OAuth 客户端时收集此密钥和密钥。您需要添加在集成配置页面上看到的 回调 URL
    8. 输入您的 客户端密钥。客户端密钥是设置目标应用程序集成时发出的唯一字符串。

    服务操作身份验证

  6. 启用 启用请求速率限制 开关。在 请求数 中输入 100 ,在 时间间隔 中输入 1 分钟
  7. (可选)启用 日志记录 切换以保留 24 小时的日志记录以用于支持目的。

    速率限制和日志记录切换

  8. 选择 保存 以继续。
  9. OAuth 授权下,选择 授权 以使用您的服务帐户登录。出现一个带有 Google 登录屏幕的弹出窗口。
    1. 输入您的服务帐户用户名和密码,然后选择 登录
    2. 选择 接受

    授权

微应用集成 页面随即打开,其中包含您添加的集成及其微应用。在这里,您可以添加另一个集成,继续设置开箱即用的微应用,或为此集成创建新的微应用。

现在,您已准备好设置和运行第一次数据同步。由于可以将大量数据从集成应用程序提取到微应用平台,因此我们建议您使用 “ ” 页面筛选实体以进行首次数据同步,以加快同步速度。有关更多信息,请参阅验证所需实体。有关同步规则、不符合其计划的同步和否决规则的完整信息,请参阅同步数据

注意:

Citrix Google Meet 集成使用 “ 操作后数据更新 ” 通过 “ 会议录制文件” 服务操作中的 “刷新列表” 按钮为登录 用户提取最新数据。我们建议按原样使用这种方法。每两 (2) 个月手动使用一次完全同步,为用户保留最佳数据量。此外,该集成不支持增量同步,仅依赖于 操作后的数据更新 来提取最新数据。

有关 API 端点和表实体的更多详细信息,请参阅 Google Meet 连接器规范

使用 Google Meet 微应用

现有的应用程序集成随现成的微应用程序一起提供。从这些微应用开始,然后根据您的需求自定义它们。

创建会议: 根据用户偏好安排会议。

通知或页面 用例工作流
“创建会议” 页 提供安排会议的表单,其中包含会议标题、开始和结束时间、时区、周期(一次、每天、每周、每月)、密码和会议与会者等详细信息。

会议录制文件: 查看可供用户使用的所有会议录制文件的列表并观看录制的视频。

通知或页面 用例工作流
“录音” 页 提供可供用户使用的会议录制文件的列表和用于 刷新列表 的 “刷新列表” 按钮。通过单击列表中的可用录制文件来查看录制详细信息。
录音详细信息页面 会议录制文件的详细页面和用于观看 录制视频的播放录制 文件选项。点击按钮观看录音
集成 Google Meet