integration-service
2024.10
true
UiPath logo, featuring letters U and I in white
Integration Service for Automation Suite User Guide
Automation CloudAutomation Cloud Public SectorAutomation Suite
Last updated 2024年11月11日

Gmail 身份验证

先决条件

要创建连接,您需要以下凭据:

  • 自带 OAuth 2.0 应用程序: 应用程序的客户端 ID 和客户端密码,以及作用域。

如果 Google 未启用您的帐户:

  • 请您的管理员批准创建连接。
  • 通过选中允许创建连接的可用选项来启用权限。

有关 Gmail 的更多信息,请访问Gmail 文档网站。

作用域

连接器请求以下权限/作用域:

  • 自带 OAuth 2.0 应用程序:
    • 创建连接的最小作用域: openidhttps://www.googleapis.com/auth/gmail.readonly
    • Gmail 触发器所需的最小作用域列表:
      • openidhttps://www.googleapis.com/auth/gmail.readonly – 适用于邮箱事件, https://www.googleapis.com/auth/calendar.readonly – 适用于日历事件。
注意:如果您使用“自带 OAuth 2.0 应用程序”进行身份验证,则默认情况下,您将从创建应用程序时配置的作用域受益。 如果要使用默认的应用程序权限,可以声明common作用域。 这意味着您只能使用为该应用程序配置的权限。 您还可以在创建连接时使用“作用域”字段声明其他作用域。 然后,系统会在登录时要求您授予其他同意权限。

“连接”允许 UiPath 产品代表您与 Gmail 数据交互。 这可能包括读取、写入、修改和删除数据,具体取决于您的 Gmail 权限。 您随时可以删除Google 帐户中的任何访问权限。

添加 Gmail 连接

  1. Select Integration Service from Automation Suite.

  2. 从“连接器”列表中,选择“Gmail”。 您也可以使用搜索栏来查找连接器。
  3. 选择“添加连接” 按钮。
  4. 现在,您将被重定向到连接页面。 选择您的首选身份验证类型。

    如果您选择“自带 OAuth 2.0 应用程序”,则必须提供客户端 ID 和客户端密码,以及与不同活动交互时可能需要的作用域。 查看活动的文档,以了解其需要的作用域。

  5. 已添加您的连接。

自带 OAuth 2.0 应用程序

要了解如何创建应用程序,请转到 Google 的官方文档并按照其中描述的步骤操作:身份验证 – 使用 Google 登录网页

  • When configuring your application, set the Authorized redirect URIs field to: https://{yourDomain}/provisioning_/callback
配置作用域

使用自带 OAuth 2.0 应用程序创建连接时,您必须选择自定义应用程序作用域。

OAuth 应用程序的刷新令牌

Google 对单个 OAuth 2.0 客户端 ID 具有刷新令牌限制。 如果达到限制,则创建新的刷新令牌会自动使最早的刷新令牌失效,而不会发出警告。 此限制不适用于服务帐户(请参阅将 OAuth 2.0 用于服务器到服务器应用程序)。 如需了解详情,请参阅 Google 官方文档

可能导致令牌过期的原因列表:
  • 您已撤销应用程序的访问权限
  • 刷新令牌已六个月未使用。
  • 您需要更改密码,并且刷新令牌包含 Gmail 作用域。
  • 您的帐户已超过授予的 (实时) 刷新令牌的最大数量。
    • 如果您在超出限制后请求新令牌,则基于先前授予的令牌的旧连接将过期。 只有新连接或最新编辑/重新进行身份验证的连接(使用最新的令牌)才能正常工作。
  • 管理员已将您应用程序作用域内请求的任何服务设为“受限”(错误为“ admin_policy_enforced ”)。
  • 对于Google Cloud Platform API :可能已超过管理员设置的会话时长。
注意:此限制当前设置为每个 Google 帐户每个 OAuth 2.0 客户端 ID 100 个刷新令牌。 此数字可能会发生变化。 如需最新信息,请随时查看 Google 文档。

一个用户帐户或服务帐户可以在所有客户端上拥有的刷新令牌总数有一个更大的限制。 普通用户不会超过此限制,但用于测试实施的开发者帐户可能会超过此限制。

为确保不超过此限制,UiPath 允许用户创建自己的 OAuth 应用程序并使用“自带应用程序”身份验证类型进行连接。 创建 OAuth 应用程序时,请务必遵循 Google 的最佳实践。 有关如何创建 OAuth 应用程序的详细信息,请参阅 Google 的官方文档

警告:令牌失效会导致连接失败,并且在不修复连接的情况下,自动化将无法运行。

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
信任与安全
© 2005-2024 UiPath。保留所有权利。