如何通过Oracle Eloqua API批量提取全量联系人详情？

当然有高效的Bulk API方案可以替代单ID查询，你需要用到Eloqua Bulk API的联系人导出作业功能，具体操作步骤如下：

核心操作流程 #

1. 创建导出作业
   发送POST请求到/bulk/2.0/contacts/exports，在请求体里指定你需要提取的字段映射关系（对应你要的字段）。

2. 触发数据同步
   作业创建成功后，会返回一个作业ID，用这个ID发送POST请求到/bulk/2.0/contacts/exports/{作业ID}/sync，启动全量数据导出任务。

3. 检查作业状态
   定期发送GET请求到/bulk/2.0/contacts/exports/{作业ID}，直到返回的status字段变为success，表示数据准备完成。

4. 下载全量数据
   状态成功后，发送GET请求到/bulk/2.0/contacts/exports/{作业ID}/data，即可获取CSV格式的全量联系人数据。

你需要的字段对应Eloqua Bulk API内部名称（含中文翻译） #

创建导出作业的请求体示例 #

{
  "name": "全量联系人指定字段导出",
  "fields": {
    "Id": "contactid",
    "Company": "company",
    "Employees": "employees",
    "CompanyRevenue": "company_revenue",
    "BusinessPhone": "business_phone",
    "EmailAddress": "email_address",
    "WebDomain": "web_domain",
    "CreatedAt": "date_created",
    "UpdatedAt": "date_modified",
    "Address1": "address_1",
    "Address2": "address_2",
    "City": "city",
    "StateOrProvince": "state_or_province",
    "PostalCode": "zip_or_postal_code",
    "MobilePhone": "mobile_phone",
    "FirstName": "first_name",
    "LastName": "last_name",
    "Title": "title"
  },
  "filter": null,
  "format": "csv"
}

注意事项 #

• 权限验证：确保你的API账号拥有Contacts - Read的Bulk API权限，否则会触发权限错误。
• 大数据量处理：如果联系人数量极多，建议添加时间范围过滤（比如按CreatedAt分段导出），或者选择在业务低峰时段执行，避免影响系统性能。
• 字段确认：如果遇到字段无法识别的情况，可以通过GET请求/bulk/2.0/contacts/fields查询所有可用的联系人字段及其API名称，确保映射正确。

内容的提问来源于stack exchange，提问作者Andrew Hicks