跳到主要内容

将 Google OAuth 集成到 NebulaAIFlow

NebulaAIFlow 与 Google OAuth 集成，用于验证 Gmail loader、Google Drive loader 和 Google Drive Search 组件。

了解如何在 Google Cloud 中创建 OAuth 应用，获取必要的凭据和访问令牌，并将它们添加到 NebulaAIFlow 的 Google 组件中。

在 Google Cloud 中创建 OAuth 应用程序​

  1. 导航到 Google Cloud Console。

  2. 点击 选择项目，然后点击 新建项目 创建新项目。

OAuth 客户端 ID 和密钥

  1. 要为项目启用 API，选择 API 和服务，然后点击 库。启用您项目需要的 API。例如，如果您的流程使用 Google Drive 组件，请启用 Google Drive API。
  2. 要导航到 OAuth 同意屏幕，点击 API 和服务，然后点击 OAuth 同意屏幕。
  3. 在 OAuth 同意屏幕中填写应用程序名称、受众群体和用户支持电子邮件。 对于受众群体，选择 外部。 这将创建一个您可以添加用户的测试应用程序环境。
  4. 要向您的 OAuth 受众群体添加用户，点击 受众群体。 在 测试用户 下，点击 添加用户。 输入您打算用于通过 OAuth 验证 NebulaAIFlow 的任何电子邮件地址。 这些电子邮件地址在应用程序处于 测试 发布状态时可以访问应用程序。 更多信息，请参阅 Google 文档。
  5. 要创建 OAuth 客户端 ID，导航到 客户端，然后点击 创建客户端。
  6. 选择 桌面应用 作为应用程序类型，然后为您的客户端 ID 命名。
  7. 点击 创建。 系统会创建客户端 ID 和客户端密钥。 将凭据下载为 JSON 文件到您的本地计算机并安全保存。

OAuth 客户端 ID 和密钥

获取访问和刷新令牌​

在配置好 OAuth 应用程序并创建凭据 JSON 文件后，按照以下步骤验证 NebulaAIFlow 应用程序。

  1. 在 NebulaAIFlow 中创建新项目。
  2. 将 Google OAuth Token 组件添加到您的流程中。
  3. 在 Google OAuth Token 组件的 Credentials File 字段中，输入您的 凭据文件 路径，即您在前面步骤中从 Google 下载的包含客户端 ID 凭据的 JSON 文件。
  4. 在 Google OAuth Token 组件的 Scopes 字段中，输入访问您资源所需的范围。 例如，要允许您的 NebulaAIFlow 应用程序访问用户的 Google Drive，范围是 https://www.googleapis.com/auth/drive。 更多信息，请参阅 Google 文档。
  5. 要验证您的应用程序，在 Google OAuth Token 组件中，点击 播放。 浏览器中会打开一个新标签页，使用您的 Google Cloud 账号验证您的应用程序。您必须使用创建 OAuth 凭据的同一个 Google 账号进行验证。
信息

如果新标签页没有自动打开，请检查 NebulaAIFlow 日志 中的 Google 验证 URL。在浏览器中打开此 URL 以完成验证。

  1. 成功验证后，您的 NebulaAIFlow 应用程序可以请求和刷新令牌。 这些令牌使 NebulaAIFlow 能够代表您与 Google 服务交互并执行您指定的请求。

创建带有 Google Drive loader 的流程​

要获取使用 Google Drive loader 组件的预构建流程 JSON 文件，请将 Google Drive 文档翻译示例流程 JSON 下载到您的本地计算机。

在此示例中，Google Drive loader 组件加载托管在 Google Drive 上的文本文件，将文本翻译成西班牙语，并将其返回到聊天输出。

  1. 将 Google Drive 文档翻译示例流程 JSON 下载到您的本地计算机。
  2. 要将下载的 JSON 导入到 NebulaAIFlow，点击 选项，然后选择 导入。
  3. 在 Google OAuth Token 组件的 Credentials File 字段中，输入您的 凭据文件 路径，即您在前面步骤中从 Google 下载的包含客户端 ID 凭据的 JSON 文件。
  4. 在 Google OAuth Token 组件的 Scopes 字段中，输入访问您资源所需的范围。 例如，要允许您的 NebulaAIFlow 应用程序访问用户的 Google Drive，范围是 https://www.googleapis.com/auth/drive。 更多信息，请参阅 Google 文档。 示例流程包括一个 Parse data 组件，用于将 Google OAuth Token 组件的 data 输出转换为 JSON Cleaner 组件的 text 输入。
  5. 要允许 NebulaAIFlow 组件访问 Google Drive 中的文档，从文档的 URL 复制 Google Drive documentID。
信息

documentID 位于 Google Drive 文档 URL 中的 /d/ 和 /edit 之间。 例如，在 URL https://drive.google.com/file/d/1a2b3c4D5E6F7gHI8J9klmnopQ/edit 中，documentID 是 1a2b3c4D5E6F7gHI8J9klmnopQ。

  1. 在 Google Drive loader 组件中，在 Document ID 字段中，粘贴文档 URL。
  2. 要查看翻译后的文档，打开 Playground。