Benchmark Email

通过您的 OOMOL 连接账户操作 Benchmark Email。本技能调用 benchmark_email 连接器（通过 oo CLI）；OOMOL 在服务端注入凭据，因此您无需直接处理原始令牌。

执行操作

假设用户已安装 oo CLI、完成登录，并已连接 Benchmark Email。请勿主动执行 oo auth login 或打开连接 URL — 直接运行操作即可。仅当命令因身份验证或连接错误而实际失败时，才回退至首次设置流程。

1. 检查契约（contract）：在构建请求载荷（payload）前，使用以下命令获取该操作权威的输入/输出 Schema：

oo connector schema "benchmark_email" --action ""

2. 执行操作：传入符合输入 Schema 的 JSON 载荷：

oo connector run "benchmark_email" --action "" --data '' --json

• --data 接受 JSON 对象字符串，或以 @path/to/file.json 格式指定本地文件路径；若省略该参数，则默认发送空对象 {}。
• 响应格式为 { "data": ..., "meta": { "executionId": "..." } }；其中执行 ID 位于 meta.executionId 字段下。

下方列出了所有可用操作，每项附有一行简要说明；会对 Benchmark Email 状态产生变更的操作会标注 [write] 或 [destructive]。在构造 --data 前，请务必先使用 oo connector schema 获取该操作的实时 Schema，以确认其权威输入字段。

可用操作

• get_account_summary — 获取当前 Benchmark Email 账户概览及图片存储方案详情。
• get_contact_details — 获取特定联系人邮箱在指定 Benchmark Email 联系人列表中的详细信息。
• get_contact_list_summary — 获取 Benchmark Email 联系人列表的统计摘要，包括活跃、退回、待确认及退订联系人数量。
• get_contacts_in_list — 分页获取 Benchmark Email 列表中的联系人，支持可选的搜索、过滤与排序参数。

安全性

• 未标注的操作均为只读类（get / list / search），可安全直接执行。
• 标注为 [write] 的操作会修改 Benchmark Email 状态 — 执行前须向用户明确确认请求载荷内容及其具体影响。
• 标注为 [destructive] 的操作将删除或覆盖数据 — 执行前必须确认目标对象，并获得用户的显式批准。

首次设置

以下为一次性步骤 — 请勿在每次调用时重复执行。仅当某条命令因对应原因失败时，才运行相应步骤。

• oo: command not found — 安装 oo CLI（其他平台安装指南：https://cli.oomol.com/install-guide.md）：

  curl -fsSL https://cli.oomol.com/install.sh | bash    # macOS / Linux
  

  irm https://cli.oomol.com/install.ps1 | iex           # Windows PowerShell
  

• 未登录 / 身份验证错误 — 一次性登录您的 OOMOL 账户：

  oo auth login
  

• scope_missing / credential_expired / app_not_ready / app_not_found — Benchmark Email 尚未连接，或连接已过期、缺少必要权限范围（scope）。请通过以下链接完成一次性连接（认证类型：API key）：

  https://console.oomol.com/app-connections?provider=benchmark_email
  

• HTTP 402 / OOMOL_INSUFFICIENT_CREDIT — 账户余额不足导致服务暂停。请前往 https://console.oomol.com/billing/token-recharge 充值后重试。

资源

• Benchmark Email 官网：https://www.benchmarkemail.com