设置 Google OAuth 客户端

为了向 Google 请求只读访问权限，SaaSMaestro 需要一个来自 Google Cloud 项目的 OAuth 客户端。每个工作区都有自己的客户端，在其“数据连接”标签页上设置；一个 Google Cloud 项目可以服务所有工作区。

请先检查：打开工作区的“设置 → 数据连接”，查看“Google OAuth 设置”框。如果显示“已配置”或“已在 .env 中配置”，说明已经完成设置，您可以直接连接 Google 账号。

谁可以执行此操作

您正在查看的工作区的所有者和管理员。由于此更改会影响工作区中所有人登录 Google 的方式，如果您在过去 15 分钟内没有输入过密码，系统会要求您再次输入。

在工作区的“数据连接”标签页上点击“Google OAuth 设置”框。设置窗口会引导您完成同样的五个步骤：

创建或选择一个 Google Cloud 项目。任何项目都可以。
启用三个 API：Google Analytics Admin API、Google Analytics Data API 和 Google Search Console API。
配置同意屏幕。如果您要连接的每个 Google 账号都属于您自己的 Google Workspace，请选择“内部”。否则请选择“外部”，并在应用处于测试模式期间，将要连接的每个 Google 账号添加为测试用户。
创建 OAuth 客户端，类型选择“Web 应用”，并添加设置窗口中显示的重定向 URI。请使用其“复制”按钮，以确保完全一致。
粘贴客户端凭据：填写客户端 ID 和客户端密钥，然后点击“保存凭据”。

客户端密钥以加密形式存储。如果只想更改客户端 ID，请将密钥字段留空，已保存的密钥会保留。“移除已保存的凭据”会将其删除。

Google 提示	处理方法
`redirect_uri_mismatch`	Google Cloud 中的重定向 URI 不完全一致。请从设置窗口重新复制，包括 http 或 https 以及末尾的路径。
`access_denied`	同意屏幕为“外部”且处于测试模式，而此 Google 账号不是测试用户。请在同意屏幕的测试用户中添加该账号。
API 未启用	项目中有一个 API 未启用。请启用它，等待一分钟后重试。
`invalid_client`	客户端 ID 或密钥错误，或客户端已被删除。请粘贴新的凭据。