Gmail 身份验证

先决条件

根据您选择的身份验证类型，您可能需要以下凭据之一：

• OAuth 2.0 授权代码：您的 Google 电子邮件地址以及与您 Google 帐户关联的密码。
• 自带 OAuth 2.0 应用程序: 应用程序的客户端 ID 和客户端密码，以及作用域。
• 服务帐户：“服务帐户密钥”、“帐户电子邮件”。

如果 Google 未启用您的帐户：

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

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

作用域

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

• UiPath 公共应用程序默认作用域： openid 、 https://www.googleapis.com/auth/userinfo.email 、 https://www.googleapis.com/auth/userinfo.profile 、 https://mail.google.com/ 、 https://www.googleapis.com/auth/calendar和https://www.googleapis.com/auth/gmail.settings.basic 。
• 服务帐户默认作用域： openid 、 https://www.googleapis.com/auth/userinfo.email 、 https://www.googleapis.com/auth/userinfo.profile 、 https://mail.google.com/ 、 https://www.googleapis.com/auth/calendar和https://www.googleapis.com/auth/gmail.settings.basic 。
• 自带 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 Cloud ^TM公共部门中选择 Integration Service。

2. 从“连接器”列表中，选择“Gmail”。 您也可以使用搜索栏来查找连接器。
3. 选择“添加连接” 按钮。

4. 现在，您将被重定向到连接页面。 选择您的首选身份验证类型。

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

5. 已添加您的连接。

自带 OAuth 2.0 应用程序

在 Integration Service 中，当创建与某个基于 Google API 的连接器的连接时，您可以在两个身份验证选项之间进行选择：

• OAuth 2.0 授权代码 – 连接到 UiPath 公共应用程序。

• 自带 OAuth 2.0 应用程序 – 它将连接到您创建的私有应用程序。

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

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

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