故障排除

针对插件中看到的消息和状态的快速修复。

对话框无法加载

Could not reach the MailG API

启动对话框无法调用 MailG 后端。

• 确认您已联网
• Marketplace 安装：稍等片刻后重新打开 🚀 Start
• 自托管：检查 Apps Script 属性 APP_URL（公开 HTTPS）和 APP_API_KEY
• 插件无法使用 localhost — 本地 API 测试请使用隧道

Could not read your sheet

MailG 无法读取当前电子表格。

• 确保打开了表格标签页（不仅是 Apps Script 编辑器）
• 重新加载电子表格，然后重新打开对话框
• 确认您对该文件有编辑权限

Loading… 永不结束

关闭对话框，刷新表格，等待约 15 秒让 Extensions 加载，然后再次 🚀 Start。

空表格

No email address found in your sheet

MailG 需要至少一列有效的邮箱地址。

• 在标题下添加邮箱，或点击 Fill with mock data
• 模拟数据创建 Email、First Name、Last Name、Company，并常创建 My First Template

参见启动对话框导览。

模板

• 创建：Creating Template... → Template created successfully! 或 Failed to create template! Try again later.
• 更新：Updating template...
• 删除失败：Failed to delete template. Try again later

参见模板。

发送问题

发送按钮禁用 / Send emails 无数

• 选择 Template
• 选择 Recipient column，每格为有效的单个邮箱
• 可能看到的拦截 toast：Configure your recipient column first、Select a template first.、No valid recipient emails found in the selected column.

活动无法启动

Toast: Failed to create campaign. Please try again.

• 重试一次
• 检查 Daily quota 不为 0
• 确认 API 连通性（见上文）

行显示 ⚠️ Failed

该行遇到发送错误（无效地址、Gmail 拒绝、临时配额等）。修复数据并为剩余行启动新活动，或参见停止活动。

测试邮件失败

• Configure your preview first — 选择模板 + 收件人，使预览有 To
• Failed to send test email. Please check your email settings. — 如需要重新授权 Gmail，然后重试

跟踪

• 打开需要收件人加载远程图片
• 运行 🔄 Refresh Tracking — 预期 Tracking info synced 或 No active campaigns
• 状态 👀 Opened 仅在像素加载时出现

参见邮件跟踪。

配额与品牌

• 侧边栏 N left 为 min(MailG remaining, Gmail remaining)
• 即使在 Professional 上，免费 @gmail.com 通常被 Google 限制在约 500/天
• 付费后仍有水印 → 结账邮箱须与表格账户一致；重新打开对话框

参见每日配额与评价和Remove branding。

定时未延后

早于约 15 秒的时间被视为立即发送（🚀 列），而非延后的 🗓️ 定时。请选择更远的未来时间。

仍无法解决？

完整 FAQ：常见问题 · 邮件 [email protected] · 网站 app.mailg.io/help