添加 Gmail 应用程序

了解如何将 Gmail 应用程序添加到 IBM RPA。

❕ 重要信息: 此过程仅适用于本地 IBM RPA 。缺省情况下,
IBM RPA SaaS 提供应用程序。 创建与此应用程序的连接以在 IBM RPA SaaS上使用此应用程序。 有关更多信息,请参阅 向应用程序添加连接

准备工作

  • 本地环境中的 IBM RPA
  • 有权 管理应用程序 的用户
  • Google 🡥 帐户
  • 您的服务器必须具有有效的标准域名 (FQDN)。 Google™ 在其 API 服务中不接受公共 IP 地址

过程

执行创建 Google™ Gmail™ 应用程序的步骤:

  1. 启用 Gmail API
  2. "创建 OAuth 同意" 屏幕
  3. 创建凭证
  4. 添加应用程序

启用 Gmail API

  1. 浏览至 Google Cloud™🡥 Web 站点。
  2. 使用您的帐户登录。
  3. 请创建新项目或使用现有项目。 请参阅 创建和管理项目🡥 以获取更多信息。
  4. 单击主仪表板屏幕上的启用 API 和服务
  5. 单击 Gmail API 卡。
  6. 单击 启用 按钮。

创建凭证

  1. 单击返回到仪表板

  2. API 和服务中的左侧菜单上,转至凭证

  3. 单击创建凭证 > OAuth 客户机标识

  4. 应用程序类型 组合框中选择 Web 应用程序 选项。

  5. 为应用程序命名,如 Gmail provider

  6. 授权 JavaScript 源中,单击 添加 URI。 此地址是 IBM RPAAPI 的 URL ,例如 https://192.51.100.38:7790 (其中 7790 是 IBM RPAAPI 所使用的端口)。

  7. 授权重定向 URI 中,单击添加 URI。 此地址是 IBM RPAAPI 的 URL ,例如 https://example.com:7790,其中 example.com 是服务器 FQDN , 7790 是 IBM RPAAPI 使用的端口,具有 OAuth2 规范 /integration/oauth2。 以下是具有 OAuth2 规范的有效 URL 的示例:

    • https://example.com:7790/integration/oauth2
    • https://api.example.com/integration/oauth2 (如果已将 api 子域配置为 API 域转发到相应的 API 端口)。

    🛈 请记住: 将 URL 替换为相应的服务器 API URL。

  8. 单击创建以创建凭证。

创建凭证后,系统会提示您输入 客户机标识客户机密钥

如果无法查看,请执行以下步骤:

  1. 浏览至 Google Cloud Developers 🡥
  2. 在左侧菜单中,转至 凭证
  3. OAuth 2.0 客户机标识下,查找新创建的凭证并单击该凭证。
  4. 右侧列出了 客户机标识客户机密钥

添加应用程序

  1. 登录到 IBM RPA Control Center。

  2. 单击主菜单上的 应用程序

  3. 单击添加应用程序

  4. 名称 字段中,输入应用程序名称。

  5. 描述 字段中,输入应用程序描述。

  6. 应用程序标记 字段中,选择用于标识应用程序的标记。 该标记用于过滤应用程序。

  7. 单击下一步

  8. 客户机标识 字段中,输入您的 客户机标识

  9. 客户机密钥 字段中,输入 客户机密钥

  10. 重定向 URL 字段中,输入先前在 Dropbox 应用程序中配置的 重定向 URL ,例如 https://api.example.com/integration/oauth2

  11. 授权 URL 字段中,输入 https://accounts.google.com/o/oauth2/v2/auth

  12. 授权模板参数 字段中,输入以下代码片段:

    prompt=consent&access_type=offline&client_id={clientId}&response_type=code&redirect_uri={redirectUri}
    

    🛈 请记住: IBM RPA 会将 {clientId}{redirectUri} 的值分别自动替换为 客户机标识重定向 URL中定义的值。

  13. 令牌 URL 字段中,输入 https://www.googleapis.com/oauth2/v4/token

  14. API URL 字段中,输入 https://gmail.googleapis.com/

  15. 作用域 字段中,输入 https://www.googleapis.com/auth/userinfo.email https://mail.google.com/

  16. 单击下一步

  17. 查看您输入的数据的摘要,然后单击 添加

结果

因此,您可以查看声明已成功添加应用程序的通知。 您还可以在应用程序列表中查看应用程序。

如果失败,您还可以查看通知。 在这种情况下,请查看您输入的数据,然后重试创建应用程序。

下一步操作

  • 创建连接
    创建连接以授权应用程序。 有关更多信息,请参阅 连接

  • 编辑应用程序
    如果要编辑应用程序,请执行下列其中一项操作:

    • 如果在 V 21.0.7上,单击主菜单中的 应用程序 ,然后单击 垂直省略号按钮,以进行编辑 > 编辑
    • 如果在 V 21.0.5 或 21.0.6上,请单击主菜单中的 连接 ,然后单击 应用程序 > 垂直省略号按钮,以进行编辑 > 编辑

    ⚠ 注意: 如果更改应用程序数据,那么必须重新授权与其绑定的连接。

    1. 在 IBM RPA Control Center上,执行下列其中一项操作:
      1. 如果在 V 21.0.7上,请单击 连接 菜单。
      2. 如果在 V 21.0.5 或 21.0.6上,请单击主菜单中的 连接 ,然后单击 连接
    2. 在连接上,单击 垂直省略号按钮, > 重新授权
  • 使应用程序过时
    如果要将应用程序标记为过时,请执行下列其中一项操作:

    • 如果在 V 21.0.7上,单击主菜单中的 应用程序 ,然后单击 垂直省略符按钮,即表示 > 使其过时
    • 如果在 V 21.0.5 或 21.0.6上,请单击主菜单中的 连接 ,然后单击 应用程序 > 垂直省略号按钮,以用于 > 使其过时

    ⚠ 注意: 将应用程序标记为过时不会将其永久移除。 使用该应用程序的所有现有连接都保持活动状态,尽管您无法创建与该应用程序的新连接。

  • 重新激活过时的应用程序
    从 21.0.7: 如果要重新激活过时的应用程序,请在 应用程序 菜单中单击 垂直省略符按钮, > 重新激活

  • 删除应用程序
    从 21.0.7: 如果要删除未与之连接的应用程序或过时的应用程序,请在 应用程序 菜单中单击 垂直省略号按钮, > 删除

    ⚠ 注意: 这将从系统中永久除去应用程序。