Google 文档身份验证

使用 OAuth 2.0 授权代码、您自己的 OAuth 2.0 应用程序或服务帐户将 UiPath 连接到 Google 文档。

先决条件

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

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

如果 Google 未启用您的帐户：

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

备注：

有关不同身份验证类型的更多详细信息，请参阅如何连接到 Google Workspace 365 活动指南。

如需了解关于 Google 文档的更多信息，请参阅Google 文档开发者文档。

作用域

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

• 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/drive.readonly 。
  • Google 文档触发器所需的最小作用域列表:
    • openid, https://www.googleapis.com/auth/drive.readonly

备注：

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

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

添加 Google 文档连接

1. 从产品启动器中选择“Orchestrator”。

2. 选择一个文件夹，然后导航到“连接”选项卡。

3. 选择“添加连接”。

4. 要打开连接创建页面，请从列表中选择连接器。您可以使用搜索栏查找连接器。

5. 选择您的首选身份验证类型。

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

6. 输入所需的凭据，然后选择“连接” 。

   在可用的情况下，选择字段旁边的菜单，然后选择“使用凭据资产”或“使用 Orchestrator 资产”以引用 Orchestrator 资产，而不是直接输入值。有关更多信息，请参阅使用凭据资产进行连接。

7. 已添加您的连接。

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 官方文档。

备注：

在 Google 中注册 OAuth 应用程序时，请确保将回调 URL设置为连接创建页面上显示的值，例如https://cloud.uipath.com/provisioning_/callback表示 Automation Cloud。

备注：

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