在 Marketo 中进行批量数据导出
在 Marketo 中进行批量数据导出操作,所有步骤主要通过 Marketo 的 REST API 实现,Marketo 自身的 UI 并不提供图形化界面来直接执行这些操作。因此,以下详细说明了如何通过 Marketo 的 API 进行批量数据导出,以及在 Marketo 中如何获取相关信息和工具来支持这些操作。
前提准备
-
获取 API 权限:
- 确保你的 Marketo 账户有足够的 API 权限来访问 Bulk Extract API。管理员需要为你分配合适的角色,并且你的 Marketo 实例中 API 用户需要绑定权限集。
-
找到 API 信息:
- 在 Marketo 的管理界面,你需要获取 API 相关的凭证,包括
Client ID
,Client Secret
, 以及Endpoint URL
(通常是https://{your_instance}.mktorest.com
)。 - 操作路径:
- 在 Marketo UI 中,点击 Admin(管理) -> Integration(集成) -> LaunchPoint,在这里可以找到已经配置的 API 用户信息。
- 进入 Web Services,你可以看到 REST API 的
Endpoint
,并且可以管理你的 API 调用限制。
- 在 Marketo 的管理界面,你需要获取 API 相关的凭证,包括
-
身份验证:
- 在进行任何 API 调用之前,你需要先通过 OAuth 2.0 获取访问令牌。通过
POST
请求发送到以下 URL:https://{your_instance}.mktorest.com/identity/oauth/token?grant_type=client_credentials&client_id={Client_ID}&client_secret={Client_Secret}
- 你会得到一个
access_token
,用于后续所有 API 请求。
- 你会得到一个
- 在进行任何 API 调用之前,你需要先通过 OAuth 2.0 获取访问令牌。通过
1. 创建批量导出作业
在 Marketo 的 UI 中无法直接点击创建批量导出作业,操作需要通过 API 调用来实现。
操作步骤:
- 通过你喜欢的 API 调试工具(如 Postman、cURL 或编写脚本)来发送 API 请求:
- 使用
POST
请求到https://{your_instance}.mktorest.com/bulk/v1/leads/export/create.json
- 在请求体中包含导出的数据格式、字段和筛选条件。
- 使用
使用 Postman 的示例步骤:
- 打开 Postman,点击 New -> HTTP Request。
- 选择
POST
请求,输入 URL 为https://{your_instance}.mktorest.com/bulk/v1/leads/export/create.json
。 - 在 Headers 中添加
Authorization
,值为Bearer {access_token}
。 - 在 Body 中选择
raw
,并将类型设置为JSON
,输入数据:{ "format": "csv", "fields": ["email", "firstName", "lastName"], "filter": { "createdAt": { "startAt": "2023-01-01T00:00:00Z", "endAt": "2023-12-31T23:59:59Z" } } }
- 点击 Send 发送请求,若成功,你会收到一个
exportId
,这个 ID 用于后续的作业管理。
2. 将作业加入队列
将创建的作业加入队列也是通过 API 实现的。
操作步骤:
- 发送
POST
请求到https://{your_instance}.mktorest.com/bulk/v1/leads/export/{export_id}/enqueue.json
Postman 中操作示例:
- 新建一个 HTTP 请求,选择
POST
请求,URL 设置为:
其中https://{your_instance}.mktorest.com/bulk/v1/leads/export/{export_id}/enqueue.json
{export_id}
替换为之前步骤中返回的作业 ID。 - 在 Headers 中同样添加
Authorization
。 - 发送请求,确认作业成功加入队列。
3. 轮询作业状态
执行批量作业的过程中,你可以通过轮询 API 来查询当前作业的状态。
操作步骤:
- 发送
GET
请求到https://{your_instance}.mktorest.com/bulk/v1/leads/export/{export_id}/status.json
Postman 中操作示例:
- 新建一个 HTTP 请求,选择
GET
请求,输入 URL:
替换https://{your_instance}.mktorest.com/bulk/v1/leads/export/{export_id}/status.json
{export_id}
为之前的导出作业 ID。 - 添加
Authorization
,并发送请求。 - 检查返回结果中的
status
字段,看作业是否完成。返回值可能是Queued
,Processing
,Completed
等。
4. 下载导出数据
一旦作业状态变为 Completed
,你可以通过下载数据来获取导出结果。
操作步骤:
- 发送
GET
请求到https://{your_instance}.mktorest.com/bulk/v1/leads/export/{export_id}/file.json
。
Postman 中操作示例:
- 新建一个 HTTP 请求,选择
GET
,URL 为:
替换https://{your_instance}.mktorest.com/bulk/v1/leads/export/{export_id}/file.json
{export_id}
为你的导出作业 ID。 - 添加
Authorization
并发送请求,数据会以文件形式返回,你可以直接下载。
可能遇到的问题和注意事项
-
API 配额限制:Marketo 的 API 每天调用次数有限,频繁使用批量导出 API 可能会快速耗尽配额。建议定时导出,避免不必要的请求。
-
导出作业失败:在一些极端情况下,导出作业可能失败,你可以通过状态轮询判断失败原因,并重试操作。如果作业多次失败,可以联系 Marketo 支持团队。
-
导出文件过大:如果导出记录数量非常大,Marketo 会将文件分块,因此你可能需要多次调用 API 来获取所有数据。
-
字段筛选:确保在导出作业中使用的字段与 Marketo 中实际存在的字段名称一致,否则会导致导出失败。
总结
所有操作都需要通过 API 调用实现,Marketo 本身的 UI 并不支持直接批量导出数据的功能。你需要使用 Postman、cURL 或开发脚本来与 API 交互,并确保 API 权限设置正确。
原文地址:https://blog.csdn.net/m0_64036296/article/details/142742042
免责声明:本站文章内容转载自网络资源,如本站内容侵犯了原著者的合法权益,可联系本站删除。更多内容请关注自学内容网(zxcms.com)!