批量邮箱头像检查：准备文件并读取 CSV
准备支持的邮箱 TXT 或 CSV 文件，提交异步头像任务，并仔细解读 identifier、activated、avatar 和 avatar_url 字段。
批量邮箱头像任务在异步运行后会返回特定于来源的 CSV 观测结果。
批量邮箱头像检查始于一个包含 Gmail、Yandex 或 Mail.ru 地址的 TXT 或 CSV 文件，每行一个地址。AvatarLookup 的邮箱头像批量产品以异步方式运行：提交文件，检查任务状态，待任务成功后下载 CSV。CSV 包含 identifier、activated、avatar 和 avatar_url。请在当前邮箱产品的背景下解读每个字段，切勿将空的头像 URL 视为关于邮箱或个人的断言。
准备一份包含受支持邮箱地址的整洁文件
首先准备一份组织已授权处理的列表。在 TXT 或 CSV 文件中保持每行一个邮箱地址。筛选出受支持的 Gmail、Yandex 和 Mail.ru 域系列；AvatarLookup 的产品文档提供了当前支持的范围和输入规则。保留原始列表的副本并附带内部记录键，以便稍后将下载的结果关联到正确的联系人记录。
在上传前，规范化意外的前导或尾随空格，并标记格式错误的地址。第二轮检查应找出重复项，以便团队了解重复的地址是代表一个联系人还是多个记录。不要假设 CSV 电子表格导出格式会自动适用：请检查实际文件，并确保 identifier 字段保持预期的每行一个的格式。XLSX 不是可接受的批量上传格式。
邮箱任务不使用国家/地区字段。当团队同时运行具有不同输入要求的基于电话的批量产品时，这种区别很重要。请在工作日志中明确产品选择和文件名；在电话产品下发送的邮箱文件将无法进行有效的头像检查。请在 API 文档中确认所选产品的当前最小值、最大值和文件规则，而不是将旧的限制带入操作流程中。
提交、监控并下载任务
记录的批量任务端点是 POST /api/v1/bulk-tasks。成功的提交会启动一个异步任务，并为团队提供一个用于查询的引用。使用 GET /api/v1/bulk-tasks/{id} 检查其状态；产品文档建议轮询频率不要超过每 30 秒一次。当任务成功时，从提供的链接下载结果 CSV。如果链接不再可用，请根据记录的行为查询同一任务以获取刷新后的链接。
不要将上传的接受视为检查的完成。任务可能处于进行中或失败状态。简单的操作表可以记录输入文件版本、所选邮箱批量产品、提交时间、任务引用、最后观察到的状态以及 CSV 是否已下载。状态（而非经过的挂钟时间）决定了团队是否拥有完整的数据集。
将 CSV 与任务记录一起存储，以便其他团队成员可以审计是哪个输入产生了该结果。如果下载的行数与准备的输入行数不同，请在将观测结果合并到 CRM 之前进行调查。将错误和无法判定结果与已完成的行分开。该产品的批量工作流具有其自身的字段和结果语义，因此请勿将 WhatsApp 或 Telegram 批量文章中的假设套用到此邮箱任务中。
读取四个邮箱批量 CSV 列
邮箱头像批量 CSV 包含四个记录的列：identifier、activated、avatar 和 avatar_url。Identifier 将行与提交的邮箱地址关联起来。Activated 是此邮箱产品的服务账户存在字段。Avatar 记录了产品的存在头像信号，而 avatar_url 是可用时的相关图像位置。应使用 AvatarLookup 的官方资源获取当前的字段定义和任何更新的示例。
| 列 | 审查问题 | 安全解读 |
|---|---|---|
| identifier | 此行关于哪个提交的地址？ | 与准备好的列表进行匹配 |
| activated | 返回了什么账户存在信号？ | 将其视为特定于来源的信号，而非个人验证 |
| avatar | 是否报告了存在头像可用性？ | 将其与邮箱状态区分开 |
| avatar_url | 是否提供了图像位置？ | 为空并不证明不存在头像 |
空的 avatar_url 特别容易被误读。它本身并不能确定邮箱地址无效、不存在邮箱，甚至不能确定该人没有照片。可见性和来源行为限制了可观察到的内容。Google 的个人资料共享指南说明了用户可以控制个人资料发现和照片可见性的各个方面。审查者应使用实际的产品结果和检查时间，而不是根据空白单元格编造故事。
将 CSV 转换为谨慎的联系人数据更新
在导入结果之前，决定哪些列可以更新联系人系统，哪些应保留在审计视图中。Identifier 应与已知的记录键匹配；可用的公开图像仅应在组织的合规数据处理规则下考虑。缺失或无法判定的图像结果不应擦除客户提供的照片。公开图像与现有记录之间的冲突应提交审查，而不是自动替换。
检查一部分有可用图像的行、没有图像的行以及需要调查的行。确认来源标签、检查日期和任务引用仍然附在观测结果上。这使得在不将旧 CSV 视为永久真理的情况下，可以重新审视有疑问的结果。公开的个人资料信息可能会发生变化，因此以后的检查可能与文件的快照不同。
最后，以操作术语报告运行情况：有多少准备好的地址符合条件，成功 CSV 中出现了多少行，以及哪些行需要后续跟进。不要报告“已验证的人员”或“已确认的真实账户”。该任务为受支持的邮箱来源提供了有限的公开头像和账户存在背景。其价值在于通过明确的未知项实现更清晰的联系人数据工作流。
常见问题解答
团队如何格式化批量邮箱头像输入？
使用 TXT 或 CSV，每行一个受支持的邮箱地址，并遵循当前特定于产品的计数和文件规则。
团队如何知道结果何时准备就绪？
按记录的间隔查询任务状态，仅在任务成功后下载 CSV。
团队如何解读空白的 avatar_url 单元格？
这意味着该行中没有可用的 URL；这并不证明没有邮箱、没有账户或没有公开图片。
团队如何将结果关联到联系人记录？
将 identifier 与准备好的输入进行匹配，并在应用授权的数据更新之前保留任务引用和检查时间。
了解更多
选择适合您工作流下一步的产品信息。