如何在GetLeadsByProgramID端点的程序中获得仅1个潜在客户的状态？

Question

我正在使用GetLeadsByProgramID REST API端点在Marketo中的程序下获取带状态的潜在客户。但是，有什么办法可以让我获得一个项目只有1个领导的状态吗？

Answer 1

首先，建议：
由于Marketo应用了一些limits for accessing the API（最重要的是：每日配额，速率限制，并发限制），因此通过一次API调用获取尽可能多的记录并缓存结果被认为是一种很好的做法。您可以根据需要循环遍历并过滤掉结果集。

解决方案：
话虽如此，您仍然可以获取一个特定潜在客户的程序状态，但不是GetLeadsByProgramID端点。不幸的是，该端点不允许基于潜在客户ID进行过滤。

潜在客户的程序状态更改也是活动，幸运的是有一个端点Get Lead Activities来查询。在打电话之前你需要有四件事：

• 从Get Paging Token端点获取的分页令牌，它还定义了从中检索活动的最早日期时间。
• “进度中的更改状态”活动类型的ID，可以从Get Activity Types端点收集。在我的情况下它是 104 ，但并不保证在所有情况下都是相同的。
• 您所涉及的潜在客户的ID。我假设你有记录。
• 您检查状态的程序的ID。我猜你也记录在案。它也可以通过API获取，但是当您单击实例中的程序时，它也会出现在URL中。例如：如果您的链接是https://app-abc01.marketo.com/#ME1234A1，则程序ID为1234。

因此，掌握所有信息后，您可以按照Activities Endpoint Reference页面中的说明拨打电话。从本质上讲，这是您必须致电的网址：

GET /rest/v1/activities.json?nextPageToken=<YOUR_NEXPAGE_TOKEN>&activityTypeIds=104&leadIds=<LEAD_ID>&assetIds=<PROGRAM_ID>

在给定日期时间之后，response将包含所有指定程序中潜在客户的程序状态更改。因此，如果有多个状态更改，您仍可能需要执行循环。

你可以决定这一切是否值得付出努力。