通过 ColdSend 共享 OAuth 连接 Google Workspace

ColdSend Shared 是接入 Gmail 或 Google Workspace 邮箱最快的方式。你会直接通过 Google 完成认证，使用的是 ColdSend 预先配置、已通过 CASA Tier 2 认证的 OAuth 应用——无需搭建 Google Cloud 项目，也不用管理凭据。

什么时候该用 ColdSend Shared

如果你的情况符合以下任一条件，就选这个方式：

• 想在一分钟内完成收件箱连接
• 不需要自定义品牌的 OAuth 同意屏幕
• 你是个人用户或小团队
• 没有强制要求使用自有 OAuth 应用的合规规定

需要完全掌控？ 如果你的组织出于品牌、安全审查或更高 API 配额的要求，需要自己的 Google Cloud OAuth 应用，请查看私有 OAuth 设置指南。

前置条件

• 一个 Google Workspace 或个人 Gmail 账户
• 你的 Google 账户凭据（邮箱和密码）
• 如果账户开启了两步验证，请准备好身份验证器应用或手机
• 浏览器允许弹窗（Google 同意屏幕会在弹窗中打开）

第 1 步：进入 Google 连接页面

1. 登录你的 ColdSend 账户。
2. 在左侧边栏进入 Sender Accounts。
3. 点击 Create Email Account 下拉菜单，选择 Google Workspace。
4. 你会进入 Connect Google Account 页面。

第 2 步：选择 ColdSend Shared

在 Choose connection type 下，选择 ColdSend Shared：

• 找到标有 "ColdSend Shared" 且带有 "Quick Setup" 徽标的选项
• 点击选中它

第 3 步：使用 Google 登录

1. 点击 Sign in with Google 按钮。
2. 会弹出一个窗口，显示 Google 的登录页面。
3. 输入你的 Google 账户邮箱和密码。
4. 如有提示，完成两步验证。
5. 查看 ColdSend 请求的权限，然后点击 Allow。

请求的权限： ColdSend 请求代你发送邮件（gmail.send）、读取你的邮箱（gmail.readonly）以及查看你的基本资料。你的密码不会被存储。

第 4 步：验证连接

授权完成后：

1. Google 会将你重定向回 ColdSend。
2. ColdSend 会自动验证连接。
3. 成功后你会看到确认提示，收件箱会出现在 Connected Accounts 区块中。

Google Workspace 管理员审批（如需要）

个人 Gmail 用户： 可以跳过本节。ColdSend 的 OAuth 应用已通过 CASA Tier 2 认证，个人 Gmail 账户可直接连接，无需管理员操作。

如果你的组织使用 Google Workspace，且对第三方应用有严格限制，连接时可能会看到 "This app is blocked" 提示。这说明你的 Workspace 管理员需要先批准 ColdSend 的应用。

这意味着什么

• ColdSend 的 OAuth 应用已通过 CASA Tier 2 认证——它通过了 Google 的安全评估，被认定为可信应用。
• 你的 Workspace 管理员只需在 Google Admin Console 中批准一次。
• 批准后，你域名下的所有用户都不会再看到该提示。

Workspace 管理员操作步骤

1. 打开 Google Admin Console。
2. 进入 Security → Access and data control → API controls → Manage app access。
3. 点击 Configure new app。
4. 搜索 ColdSend 应用，或粘贴你的 ColdSend 客户经理提供的 OAuth Client ID。
5. 选择要应用此设置的组织单位或域名。
6. 选择 Trusted，点击 Continue，然后点击 Finish。

注意： 变更最多可能需要 10 分钟才能在你的 Workspace 域名内生效。批准后，回到 ColdSend 再次点击 Sign in with Google。

背后发生了什么

当你通过 ColdSend Shared 连接时：

• 认证：ColdSend 使用 OAuth 2.0 与 Google 完成认证。你的密码既不会被共享，也不会被 ColdSend 存储。
• 令牌：ColdSend 会获得一个访问令牌（短期）和一个刷新令牌（长期）。刷新令牌会被加密并安全存储，以维持连接的持续有效。
• 发送：邮件通过 Google 的 Gmail API，以 OAuth 认证的请求发出。
• 回复追踪：ColdSend 通过 Gmail API 监控你的收件箱，以追踪回复并更新营销活动状态。

故障排查

“This app is blocked by your organization”
你的 Google Workspace 管理员限制了第三方 OAuth 应用。请按上文的管理员审批步骤操作，或使用私有 OAuth 方式，配合你组织自己的 Google Cloud 应用。

“Access blocked: ColdSend's request is invalid”

• 确认浏览器已允许弹窗
• 尝试清除 accounts.google.com 的 cookie 后重试
• 使用无痕/隐私窗口，以排除扩展冲突

“Sign-in was blocked”

• 仔细核对邮箱和密码
• 确认你的 Google 账户未被锁定或停用
• 先在 mail.google.com 登录一次，以验证凭据是否正确

认证后连接测试失败

• 确认你的 Workspace 账户没有被限制使用 Gmail API（可询问管理员）
• 确认账户未被限制访问第三方应用
• 尝试断开该收件箱后重新连接

常见问题

ColdSend 会存储我的密码吗？
不会。ColdSend 使用 OAuth 2.0——认证完全在 Google 的服务器上完成。ColdSend 只存储加密后的访问令牌和刷新令牌。

可以连接多个 Google 账户吗？
可以。只要你的 ColdSend 套餐允许，你可以连接任意数量的 Google 账户，每个账户独立连接。

访问令牌过期了怎么办？
ColdSend 会用已存储的刷新令牌自动刷新访问令牌。除非刷新令牌被撤销，否则你无需重新认证。

以后可以换成自己的 OAuth 应用吗？
可以。你可以断开该收件箱，配置私有 OAuth 应用，然后重新连接。你的营销活动和发送历史都不会受影响。

个人 Gmail 账户（非 Workspace）也能用吗？
可以。ColdSend Shared 同时支持 Google Workspace（工作/学校）和个人 Gmail 账户。个人 Gmail 用户无需任何管理员审批。

CASA Tier 2 认证是什么意思？
ColdSend 的 OAuth 应用已通过 Google 云应用安全评估（CASA）Tier 2 级别的审核。这意味着 Google 已独立审计并验证了 ColdSend 的安全实践，Workspace 管理员可以放心快速批准该应用。

我该用 OAuth 还是应用专用密码？
OAuth 是推荐的连接方式。它更安全（不存储密码）、更可靠（令牌自动刷新），并支持更高的发送限额。如果 OAuth 不可用，可以用应用专用密码作为备选方案——见应用专用密码指南。