添加 Gmail 应用程序
了解如何将 Gmail 应用程序添加到 IBM RPA。
❕ 重要信息: 此过程仅适用于本地 IBM RPA 。缺省情况下,
IBM RPA SaaS 提供应用程序。 创建与此应用程序的连接以在 IBM RPA SaaS上使用此应用程序。 有关更多信息,请参阅 向应用程序添加连接。
准备工作
过程
执行创建 Google™ Gmail™ 应用程序的步骤:
启用 Gmail API
- 浏览至 Google Cloud™🡥 Web 站点。
- 使用您的帐户登录。
- 请创建新项目或使用现有项目。 请参阅 创建和管理项目🡥 以获取更多信息。
- 单击主仪表板屏幕上的启用 API 和服务。
- 单击 Gmail API 卡。
- 单击 启用 按钮。
创建 OAuth 同意屏幕
- 在 API 和服务中的左侧菜单上,转至 OAuth 同意屏幕。
- 选择外部选项,然后单击创建按钮。
- 对应用程序进行命名,如
Gmail connection。 - 在 用户支持电子邮件 组合框中选择您的电子邮件。
- 可选: 上载图像文件以成为应用程序的徽标。
- 输入应用程序主页,公共隐私策略和服务条款的 URL。
- 如果您正在使用定制域,请设置授权域。
- 在开发者联系信息中添加您的电子邮件地址,然后单击保存并继续。
- 在 作用域 选项卡上,单击 添加或除去作用域。
- 在 过滤器 字段上,搜索
Gmail。 - 选中所有 Gmail API 复选框。
- 单击 更新 按钮。
- 在 过滤器 字段上,搜索
- 配置作用域完成后,请单击保存并继续。
- 可选: 在 测试用户 选项卡上,可以将用户添加到测试应用程序。
- 单击保存并继续。
创建凭证
单击返回到仪表板。
在 API 和服务中的左侧菜单上,转至凭证。
单击创建凭证 > OAuth 客户机标识。
在 应用程序类型 组合框中选择 Web 应用程序 选项。
为应用程序命名,如
Gmail provider。在 授权 JavaScript 源中,单击 添加 URI。 此地址是 IBM RPAAPI 的 URL ,例如
https://192.51.100.38:7790(其中7790是 IBM RPAAPI 所使用的端口)。在授权重定向 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/oauth2https://api.example.com/integration/oauth2(如果已将api子域配置为 API 域转发到相应的 API 端口)。
🛈 请记住: 将 URL 替换为相应的服务器 API URL。
单击创建以创建凭证。
创建凭证后,系统会提示您输入 客户机标识 和 客户机密钥。
如果无法查看,请执行以下步骤:
- 浏览至 Google Cloud Developers 🡥。
- 在左侧菜单中,转至 凭证。
- 在 OAuth 2.0 客户机标识下,查找新创建的凭证并单击该凭证。
- 右侧列出了 客户机标识 和 客户机密钥 。
添加应用程序
登录到 IBM RPA Control Center。
单击主菜单上的 应用程序 。
单击添加应用程序。
在 名称 字段中,输入应用程序名称。
在 描述 字段中,输入应用程序描述。
在 应用程序标记 字段中,选择用于标识应用程序的标记。 该标记用于过滤应用程序。
单击下一步。
在 客户机标识 字段中,输入您的 客户机标识。
在 客户机密钥 字段中,输入 客户机密钥。
在 重定向 URL 字段中,输入先前在 Dropbox 应用程序中配置的 重定向 URL ,例如
https://api.example.com/integration/oauth2。在 授权 URL 字段中,输入
https://accounts.google.com/o/oauth2/v2/auth。在 授权模板参数 字段中,输入以下代码片段:
prompt=consent&access_type=offline&client_id={clientId}&response_type=code&redirect_uri={redirectUri}🛈 请记住: IBM RPA 会将
{clientId}和{redirectUri}的值分别自动替换为 客户机标识 和 重定向 URL中定义的值。在 令牌 URL 字段中,输入
https://www.googleapis.com/oauth2/v4/token。在 API URL 字段中,输入
https://gmail.googleapis.com/。在 作用域 字段中,输入
https://www.googleapis.com/auth/userinfo.email https://mail.google.com/。单击下一步。
查看您输入的数据的摘要,然后单击 添加。
结果
因此,您可以查看声明已成功添加应用程序的通知。 您还可以在应用程序列表中查看应用程序。
如果失败,您还可以查看通知。 在这种情况下,请查看您输入的数据,然后重试创建应用程序。
下一步操作
创建连接
创建连接以授权应用程序。 有关更多信息,请参阅 连接。编辑应用程序
如果要编辑应用程序,请执行下列其中一项操作:- 如果在 V 21.0.7上,单击主菜单中的 应用程序 ,然后单击 垂直省略号按钮,以进行编辑 > 编辑。
- 如果在 V 21.0.5 或 21.0.6上,请单击主菜单中的 连接 ,然后单击 应用程序 > 垂直省略号按钮,以进行编辑 > 编辑。
⚠ 注意: 如果更改应用程序数据,那么必须重新授权与其绑定的连接。
- 在 IBM RPA Control Center上,执行下列其中一项操作:
- 如果在 V 21.0.7上,请单击 连接 菜单。
- 如果在 V 21.0.5 或 21.0.6上,请单击主菜单中的 连接 ,然后单击 连接。
- 在连接上,单击 垂直省略号按钮, > 重新授权。
使应用程序过时
如果要将应用程序标记为过时,请执行下列其中一项操作:- 如果在 V 21.0.7上,单击主菜单中的 应用程序 ,然后单击 垂直省略符按钮,即表示 > 使其过时。
- 如果在 V 21.0.5 或 21.0.6上,请单击主菜单中的 连接 ,然后单击 应用程序 > 垂直省略号按钮,以用于 > 使其过时。
⚠ 注意: 将应用程序标记为过时不会将其永久移除。 使用该应用程序的所有现有连接都保持活动状态,尽管您无法创建与该应用程序的新连接。
重新激活过时的应用程序
从 21.0.7: 如果要重新激活过时的应用程序,请在 应用程序 菜单中单击 垂直省略符按钮, > 重新激活。删除应用程序
从 21.0.7: 如果要删除未与之连接的应用程序或过时的应用程序,请在 应用程序 菜单中单击 垂直省略号按钮, > 删除。⚠ 注意: 这将从系统中永久除去应用程序。