使用连接 action 与 Google 服务器建立连接,以便使用同一 package 中的其他 actions 来自动执行任务。 此 action 中的所有字段均接受来自 Credential Vault的凭据、变量或用户输入值。

注: Google 软件包目前不支持使用全局会话变量在父级和子级 bots 之间共享会话。

先决条件

Google Cloud Platform 中配置 OAuth 设置,并获取将 Automation Anywhere 与您的 Google G Suite 应用程序连接所需的凭据。
  1. 如果您还未配置,创建一个项目
  2. 为您想要自动化的 Google G Suite 应用程序启用 API,例如 Google Drive API、Google Calendar API 和 Google Sheets API。
  3. 按照设置 OAuth 2.0中的步骤生成客户端 ID 和密钥。
    注:
    • 选择网页应用程序选项并输入名称。
    • 根据身份验证模式,输入以下提供的相关重定向 URL:
      • 授权码(默认身份验证模式): 添加此授权重定向 URL http://localhost:8888/Callback
      • Control Room 管理: 从Control Room > 管理 > OAuth 连接 > 连接设置页面添加回调 URL。 请参阅 创建 OAuth 连接

过程

  1. Actions 面板中,从您想要使用的 package 双击或拖动连接 action
  2. 用户名字段中,您可以提供一个有效的用户名或选择包含您 Google 用户名的凭据或凭据变量。 要输入值,请单击不安全字符串
  3. 如果您正在为 Google CalendarGoogle Sheets package 配置连接 action,请输入会话名称。
  4. 单击 OAuth2 身份验证模式下拉菜单,选择以下身份验证模式之一:

    对于有人值守的身份验证模式,请选择授权码,这是一种传统流程,并不安全。 对于无人值守的身份验证模式,选择 Control Room 管理 OAuth2 身份验证,这是一种更安全和标准的自动化模型。

    • 授权码
      • 客户端 ID 字段中,选择包含客户端 ID 的凭据或凭据变量。 要输入值,请单击不安全字符串
      • 重定向 URL 字段中,输入 http://localhost:8888/Callback
        注: 对于 Google Sheets package,不支持重定向 URL 属性。 直接在 Google Cloud Platform 中输入固定重定向 URL:http://localhost:8888/Callback
      • 客户端密钥字段中,选择包含访问令牌的凭据或凭据变量。 要输入值,请单击不安全字符串
    • Control Room 管理

      要在 Google packages 中使用 Control Room 管理的 OAuth2,您必须在 Control Room 中配置 OAuth 连接。 请参阅 创建 OAuth 连接

      在以下字段中更新信息:

      • 连接: 单击选择按钮以选择连接类型。
      • 提供者类型字段中选择自定义
      • 选择您在 Control Room 中为 Google Workspace 应用设置的连接名称。

      • 使用令牌类型字段选择以下选项之一:

        有关 Google Workspace 应用程序访问和刷新令牌的信息,请参阅 配置企业应用程序

        • 共享: 当所有运行自动化的用户共享 OAuth2 访问令牌时,选择此选项。 请注意,这需要由 Control Room 管理员或任何用户(在 OAUTH CONNECTIONS 中启用了管理连接和查看连接选项)在 Control Room 中设置一个 OAuth 连接。 将登录凭据保存一次,以生成一个共享访问令牌,供所有运行自动化的用户使用。
        • 用户专用: 当 OAuth2 访问令牌特定于运行自动化的每个用户时,选择此选项。 请注意,这需要由 Control Room 管理员或任何用户(在 OAUTH CONNECTIONS 中启用了管理连接和查看连接选项)在 Control Room 中设置一个 OAuth 连接。 确保您不保存登录凭据,以便每个运行自动化的用户都可以提供他们的登录凭据并生成只能由该特定用户使用的访问令牌。
        • 单击确认

          使用 Control Room 管理的 OAuth2 选项

      注: 当您使用用户专用选项时,您必须登录到您的 Google 账户以进行身份验证并生成用户特定的令牌。 执行以下步骤以使用此选项:
      1. Control Room 中,导航到您的个人资料我的设置 > OAuth 连接
      2. 单击登录进行身份验证
      3. 登录到您的 Google 账户,然后选择继续
      4. 验证您可以访问的服务,然后单击继续

        如果连接成功,它将显示活动状态。

        OAuth 身份验证成功状态

  5. 对于 Google Sheets,在执行诸如获取设置删除之类的 actions 时,您可以在等待操作完成(以分钟为单位)字段中指定等待时间(以分钟为单位)。 默认情况下,等待时间为 10 分钟。
    如果 Google 表格未在指定时间内打开,则任务将继续执行下一组 actions
    注: 当您使用连接 action 连接到 Google 服务器时,选项等待操作完成(以分钟为单位)仅在 Google Sheets package 中受支持。
  6. 单击保存
  7. 在您添加特定 Google 软件包中的操作后,使用同一 Google 软件包中的断开连接操作来终止连接。

后续步骤

第一次运行 bot 时,会显示 Google 登录窗口。 您必须选择 Google 账户并批准请求的访问权限。

在部署 bot 时提供访问权限后第一次生成令牌文件。 根据您在用户名客户端 ID客户端密钥字段中提供的值创建,并且仅在第一次请求凭据以提供访问权限。 下次它将使用相同的令牌文件连接到 Google Sheets

令牌文件位于 C:\\Users\\<username>\\AppData\\Local\\AutomationAnywhere\\G-SuitAuth,其中 C:\\Users\\<username> 是相应系统的用户主目录。

如果您在第一次提供访问权限时输入了正确的凭据并且可以成功连接 Google Sheets,那么下次如果仅密码发生变化,则无需删除令牌文件,因为它将按预期工作。

使用来自同一 Google package 的其他 actions 来自动化任务。 若要使用另一个 Google packagesactions,请使用来自该 package连接 action 建立连接。