在 Marketo 中进行批量数据导出

最新推荐文章于 2024-10-07 23:28:44 发布

无冕王中王

最新推荐文章于 2024-10-07 23:28:44 发布

阅读量582

点赞数 15

文章标签： lua 开发语言服务器前端

本文链接：https://blog.csdn.net/m0_64036296/article/details/142742042

版权

在 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 调用限制。
身份验证：
- 在进行任何 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 请求。

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 并发送请求，数据会以文件形式返回，你可以直接下载。