GSuite 应用程序作用域

UiPath.GSuite.Activities.GSuiteApplicationScope

描述

处理 Google Workspace 活动的连接客户端和身份验证。Google Workspace 活动使用应用程序作用域内指定的帐户。有多种身份验证类型可用。

从 2.5.5 版开始，您可以在“作用域”活动中使用较新的 Google Workspace 活动。要了解如何将 Integration Service 活动与 Google Workspace 应用程序作用域一起使用，请参阅如何在没有 Integration Service 的情况下使用 Google Workspace 活动。

已知问题

重要提示：

在 Google Workspace 作用域中使用 UiPath OAuth 客户端（UiPath 公共应用）的 OAuthClientID 身份验证类型当前不可用。使用 UiPath 公共应用程序进行身份验证的自动化可能会停止工作，并引发以下错误消息：“此应用程序已被阻止”。我们正在努力解决此问题并恢复应用程序。

在我们恢复公共应用程序之前，您可以将 OAuth 客户端 ID 身份验证与您的组织创建的自定义 Google 应用程序一起使用。要从 UiPath 公共 Google 应用程序切换到自定义 Google 应用程序，请执行以下步骤：

创建您自己的 Google Cloud 应用程序，分配必要的作用域，并创建 OAuth 客户端 ID 凭据，如在 Google Cloud 中设置应用程序所述。
- UiPath 公共应用程序使用以下作用域：https://www.googleapis.com/auth/calendar、https://www.googleapis.com/auth/spreadsheets、https://www.googleapis.com/auth/documents、https://www.googleapis.com/auth/drive、https://mail.google.com。您可以根据需要使用相同的作用域，也可以分配自定义作用域。
如果选择“OAuth 客户端 ID”身份验证类型，请将“OAuth 客户端”字段设置为自定义。在“客户端 ID”和“客户端密码”字段中，添加自定义应用程序的凭据。
测试您的自动化，重新发布项目，然后运行该项目。

项目兼容性

Windows - Legacy | Windows

配置

“连接方法”- 选择要使用的连接方法。下拉菜单中的可用选项包括：
- “属性面板”- 在“属性”面板中配置连接详细信息。
- “资产” - 使用 Orchestrator 凭据资产。我们建议您使用此选项。

资产连接方法

选择此选项时，“属性面板”选项中显示的身份验证字段将隐藏，因为所有身份验证信息都存储在资产中。

资产方法支持与属性面板方法相同的身份验证类型：OAuth 客户端 ID、API 密钥或服务帐户密钥。

连接资产- 浏览 Orchestrator 文件夹以选择资产。此字段支持IResource变量。选择“管理资产” 按钮以打开 Orchestrator。可用资产列表取决于 Studio 和机器人连接到的 Orchestrator。
- 如果您已在 Orchestrator 中更新资产，请使用加号按钮菜单选择“重新加载资产”。请注意，如果您在使用 Studio Desktop 时在 Orchestrator 中添加新资产，则无法立即在“作用域”活动中使用该资产。

常见

TimeoutMS - 如果设置，则活动在设置的毫秒数后超时，并出现异常。

选项

“连接数据存储位置”- 此为下拉列表，用于指定令牌响应的存储位置。可用的属性值为“本地磁盘”、“ Orchestrator ”或“从不存储” 。
- 本地磁盘- 连接令牌存储在计算机上的本地文件夹中。同一个连接可用于同一台计算机上的多个流程。
- Orchestrator - 连接令牌作为资产存储在 Orchestrator 中的指定文件夹中。只要同一连接有权访问指定的 Orchestrator 文件夹，就可以在多台计算机上的多个流程中使用。
- 从不存储- 从不存储连接令牌。
连接 Orchestrator 文件夹路径- 发生操作的 Orchestrator 文件夹。如果未启用新式文件夹，请留空。有关更多信息，请参阅《Orchestrator 指南》中的关于文件夹。

服务帐户密钥

“用户电子邮件” - 如果您已向服务帐户授予域范围访问权限，则该服务帐户需要模拟域中的用户。使用此字段输入模拟用户的电子邮件地址。

运行时

运行时连接资产- 浏览以选择资产。此字段可用于为运行时选择不同的资产。使用加号按钮菜单以选择“相对路径”，然后输入包含连接详细信息的 Orchestrator 资产的完整路径。

属性面板连接方法

连接- 从列表中选择一个帐户。您可以添加、删除连接，以及选择要使用的连接。
身份验证作用域- 请参阅下面的使用身份验证作用域向导部分。

使用身份验证作用域向导

“作用域”活动包含一个通用权限选取器，可提供活动正常运作所需的所有已使用的身份验证作用域的清晰画面。

Google WorkSpace 应用程序作用域活动中包含的所有子活动都会自动检测为必需的作用域。

如果未从“作用域”向导中手动选择任何作用域，则默认情况下会在运行时应用“自动检测”功能，并且无需配置向导。在运行时选择所有最低要求的作用域。

将子活动添加到Google Workspace 应用程序作用域后，您也可以手动添加作用域。

注意：有关 API 作用域和权限的详细信息，请参阅 Microsoft 365 和 Google WorkSpace 卡 - API 权限和作用域。

身份验证

身份验证类型- 一个下拉列表，用于指定要用于访问 Google Workspace 服务的身份验证类型。可用的属性值包括： APIKey 、 OAuthClientID和ServiceAccountKey 。根据身份验证类型选择，可能需要其他属性字段。

OAuth 客户端 ID

注意：这与 Integration Service 中支持的身份验证方法相同，即通过公共 UiPath 应用程序或私有自定义应用程序（自带应用程序方法）进行身份验证。

仅当“身份验证类型”值为“OAuth 客户端 ID”时，以下属性字段才为必填项。

客户端 ID - 用户帐户的凭据 ID。此属性支持 String 变量和字符串格式的值。
客户端密码 - 用户帐户的凭据密码。此属性支持 String 变量和字符串格式的值。
OAuth 客户端 - 指定要使用的应用程序（客户端）。如果选择了“UiPath”，则不应提供客户端 ID 和客户端密码。默认值为 UiPath。
安全客户端密码 - 用户帐户的客户端密码，作为安全字符串。此属性支持 String 变量和字符串格式的值。

备注：
使用 UiPath Apps 时，您将允许 UiPath 机器人访问您的 Gmail 帐户中的数据。随后，您允许 UiPath 机器人仅根据您的指示操作数据。UiPath 绝不会以任何方式访问、存储或处理您使用 UiPath 机器人操作的数据，并且不允许在用户指示之外使用机器人。UiPath 在使用从 Google API 收到的信息时将遵守Google API 服务用户数据策略”，包括限制使用要求。

您可以查看完整的 UiPath 隐私策略以获取更多信息。

“连接数据存储位置”- 此为下拉列表，用于指定令牌响应的存储位置。可用的属性值为“本地磁盘”、“ Orchestrator ”或“从不存储” 。仅当所选的“身份验证类型”为“OAuth 客户端 ID”时，此属性才适用。
连接 Orchestrator 文件夹路径- 发生操作的 Orchestrator 文件夹。如果未启用新式文件夹，请留空。有关更多信息，请参阅《Orchestrator 指南》中的关于文件夹。
用户 - 分配给授权用户的标识符。系统会为每个标识符生成唯一的响应令牌，您可以存储这些标识符，以便日后使用。此属性支持 String 变量和字符串格式的值。仅当所选的“身份验证类型”为“OAuth 客户端 ID”时，此属性才适用。

服务帐户密钥

仅当“身份验证类型”值为“服务帐户密钥”时，以下属性字段才为必填项。

“密钥类型”- 此为下拉列表，用于根据密钥文件指定服务帐户类型。可用的属性值为JSON或P12 。对于 P12 服务帐户类型，“密码”和“服务帐户电子邮件”属性为必填项。
服务帐户电子邮件- 为服务帐户自动生成的电子邮件地址。此属性支持String变量和字符串格式的值，并且仅当“密钥类型” 值为P12时才为必填项。
“用户电子邮件” - 如果选择了“在域范围内访问” ，则服务帐户将模拟域中的用户；使用此字段输入模拟用户的电子邮件地址。
拥有全域访问权限- 如果选中，该活动将向服务帐户授予全域访问权限。布尔值。
密钥路径 - 服务帐户密钥文件的路径。此属性支持 String 变量和字符串格式的值。在 Google Cloud Platform 上创建服务帐户会生成可供下载的密钥文件。
“密码” - 服务帐户的密码。此属性支持String变量和字符串格式的值，并且仅当“密钥类型” 值为P12时才为必填项。
Orchestrator 密钥存储桶 - 用于检索由密钥路径指定的凭据的存储桶。如果选择了存储桶，则“密钥路径”字段必须指定所选存储桶中的文件路径。如果未设置存储桶，则“密钥路径”将使用本地存储。如果选择“完整路径”输入模式，则可以以字符串形式输入存储桶的路径，也可以使用变量。
注意：使用此选项，您可以更轻松地在无人值守模式下使用服务帐户密钥身份验证。您不再需要在项目文件夹中添加 P12 或 JSON 文件。