Gmail 身份验证

先决条件

要创建连接，您需要以下凭据：

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

如果 Google 未启用您的帐户：

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

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

作用域

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

• 自带 OAuth 2.0 应用程序:
  • 创建连接的最小作用域： openid和https://www.googleapis.com/auth/gmail.readonly 。
  • Gmail 触发器所需的最小作用域列表:
    • openid 、 https://www.googleapis.com/auth/gmail.readonly – 适用于邮箱事件。
    • openid 、 https://www.googleapis.com/auth/calendar.readonly – 适用于日历上的事件。

备注：

如果您使用“自带 OAuth 2.0 应用程序”进行身份验证，则默认情况下，您可以受益于创建应用程序时配置的作用域。如果要使用默认的应用程序权限，可以声明common作用域。这意味着您只能使用为该应用程序配置的权限。您还可以在创建连接时使用“作用域”字段声明其他作用域。然后，系统在登录期间会要求您授予其他同意。

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

添加 Gmail 连接

1. 从 Automation Suite 中选择“Integration Service”。
2. 从“连接器”列表中，选择“Gmail”。您还可以使用搜索栏来查找连接器。
3. Select the Add connection button.
4. 现在，您已重定向到连接页面。选择您的首选身份验证类型。如果您选择“自带 OAuth 2.0 应用程序”，则必须提供客户端 ID 和客户端密码，以及与不同活动交互时可能需要的作用域。查看活动文档，了解它们所需的作用域。
5. 已添加您的连接。

自带 OAuth 2.0 应用程序

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

• 配置应用程序时，请将“授权重定向 URI”字段设置为: 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 官方文档。

重要提示：

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