跳到主要内容

Google 控制台配置

在 Google Workspace 模块能够与 Google 服务通信之前，您需要创建一个 Google Cloud 项目、启用所需的 API 并生成 OAuth 凭据。本指南将引导您完成每个步骤。

步骤 1：创建 Google Cloud 项目​

  1. 前往 Google API Console。
  2. 点击顶部导航栏中的 Select a project，然后点击 New Project。
  3. 输入 项目名称（例如，"Concord CRM Integration"）。
  4. 点击 Create 并等待项目创建完成。
  5. 确保在项目下拉列表中选中了新项目。
信息

如果您已有想要复用的 Google Cloud 项目，请从项目列表中选择它，无需创建新项目。

步骤 2：启用所需的 API​

选中项目后，逐个启用以下 API：

  1. 导航到 APIs & Services → Library。
  2. 逐个搜索并启用以下 API：
    • Google Drive API
    • Google Docs API
    • Google Sheets API
    • Google Slides API

对于每个 API：

  1. 在搜索结果中点击 API 名称。
  2. 点击 Enable。
  3. 等待确认后再继续下一个。
注意

所有四个 API 都必须启用，模块才能正常工作。如果缺少任何 API，相应的 Google 服务将无法从 CRM 中访问。

步骤 3：配置 OAuth 同意屏幕​

  1. 导航到 APIs & Services → OAuth consent screen。
  2. 选择 用户类型：
    • External -- 适用于大多数设置。允许任何 Google 账户进行授权。
    • Internal -- 仅适用于 Google Workspace（付费）账户。仅限组织内的用户访问。
  3. 点击 Create。
  4. 填写必填字段：
    • App Name -- 用户在授权期间看到的名称（例如，"Concord CRM"）。
    • User Support Email -- 您的支持邮箱地址。
    • Developer Contact Information -- 您的邮箱地址。
  5. 在 Scopes 和 Test Users 步骤中点击 Save and Continue（基本设置无需更改）。
  6. 从摘要标签页点击 Back to Dashboard。

发布状态​

状态需要 HTTPS说明
Testing否限制为 100 个测试用户；显示额外的同意警告
Production是对所有用户可用；您的网站必须使用 HTTPS
提示

在初始设置和测试阶段，保持应用处于 Testing 模式。确认一切正常后，切换到 Production 以获得无缝的授权体验。

步骤 4：创建 OAuth 凭据​

  1. 导航到 APIs & Services → Credentials。
  2. 点击 Create Credentials → OAuth client ID。
  3. 选择 Web application 作为应用类型。
  4. 输入凭据的 名称（例如，"Concord CRM OAuth"）。
  5. 在 Authorized redirect URIs 下，添加以下内容：
https://yourdomain.com/google-workspace/callback

将 yourdomain.com 替换为您 Concord CRM 安装的实际域名。

  1. 点击 Create。
  2. 对话框将显示您的 Client ID 和 Client Secret。请复制这两个值。
注意

重定向 URI 必须与您的 Concord CRM 安装 URL 完全匹配，包括协议（HTTPS）和路径。不正确的重定向 URI 将导致授权失败。

步骤 5：连接到 Concord CRM​

  1. 以管理员身份登录 Concord CRM。
  2. 导航到 Google Workspace 模块设置。
  3. 粘贴上一步中获取的 Client ID 和 Client Secret。
  4. 点击 Save & Authorize。
  5. 将出现 Google 同意屏幕。选择您的 Google 账户并授予所请求的权限。
  6. 您将被重定向回 Concord CRM。连接状态现在应显示为 Authorized。
信息

如果您的 Google Cloud 应用处于 Testing 模式，授权期间将看到一个额外的警告屏幕。点击 Continue 继续。此警告在 Production 模式下不会出现。

故障排除​

问题解决方案
"Error 400: redirect_uri_mismatch"确认 Google Cloud 中的重定向 URI 与您的 CRM URL 完全匹配
授权静默失败确保 Google Cloud 项目中所有四个 API 均已启用
"Access blocked: App not verified"切换到 Production 模式或将您的账户添加为测试用户
连接一段时间后断开从模块设置中重新授权；检查令牌刷新设置

安全建议​

  • 限制 OAuth 凭据 使用授权重定向 URI 将其限制到您的特定域名。
  • 使用 HTTPS 安装 Concord CRM，以保护传输中的 OAuth 令牌。
  • 定期审查 API 访问权限，在 Google Cloud Console 中确保没有授予不必要的权限。
  • 轮换凭据，如果怀疑凭据已被泄露。
支持

如果您需要配置 Google Cloud 项目的帮助，请访问 Themesic 支持工单区获取协助。