大量潛在客戶擷取
大量銷售機會擷取REST API會從Marketo擷取大量銷售機會/人員記錄。 您也可以根據記錄建立日期、最近更新、靜態清單成員資格或智慧清單成員資格，以增量方式擷取銷售機會。
使用大量潛在客戶擷取，以在Marketo和外部系統（包括ETL、資料倉儲和封存工作流程）之間持續交換資料。
權限
擁有工作的API使用者必須具有角色具有唯讀銷售機會許可權、讀寫銷售機會許可權，或同時具有這兩項許可權。
篩選器
潛在客戶匯出作業支援多種篩選器型別。 每個匯出作業只能使用一個篩選型別。
updatedAt、smartListName和smartListId篩選器需要並非所有訂閱都可用的基礎結構。
startAt和endAt成員的JSON物件。 startAt是低浮水印日期時間，endAt是高浮水印日期時間。 使用ISO-8601日期和時間值（不含毫秒）。 範圍必須為31天或更少。 此工作會傳回在日期範圍內建立的所有可存取記錄。startAt和endAt成員的JSON物件。 startAt是低浮水印日期時間，endAt是高浮水印日期時間。 使用ISO-8601日期和時間值（不含毫秒）。 範圍必須為31天或更少。 此篩選器未使用可見的updatedAt欄位，這僅反映標準欄位的更新。 相反地，它會使用潛在客戶記錄最近一次欄位更新的時間。 此作業會傳回日期範圍內最近更新的所有可存取記錄。某些訂閱無法使用以星號標示的篩選型別。 如果您的訂閱無法使用篩選器型別，則「建立匯出潛在客戶工作」端點會傳回錯誤「1035，目標訂閱不支援的篩選器型別」。 請聯絡Marketo支援，為您的訂閱啟用此功能。
選項
「建立匯出潛在客戶作業」端點提供選項，用於選取匯出的欄位、重新命名欄標題及設定檔案格式。
columnHeaderNames覆寫它。 Adobe Experience Cloud Audience Sharing功能啟用時，Cookie同步程式會將Adobe Experience Cloud ID (ECID)與Marketo銷售機會建立關聯。 指定ecids欄位，將ECID包含在匯出檔案中。建立工作
使用建立匯出潛在客戶作業端點來定義匯出作業。 指定要匯出的fields、一個filter型別及其引數、檔案format以及任何自訂資料行標頭名稱。
POST /bulk/v1/leads/export/create.json
{
"fields": [
"firstName",
"lastName",
"id",
"email"
],
"format": "CSV",
"columnHeaderNames": {
"firstName": "First Name",
"lastName": "Last Name",
"id": "Marketo Id",
"email": "Email Address"
},
"filter": {
"createdAt": {
"startAt": "2017-01-01T00:00:00Z",
"endAt": "2017-01-31T00:00:00Z"
}
}
}
此請求會針對2017年1月1日至2017年1月31日期間建立的潛在客戶建立匯出工作。 匯出包含來自firstName、lastName、id及email欄位的值。
{
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"exportId": "ce45a7a1-f19d-4ce2-882c-a3c795940a7d",
"status": "Created",
"createdAt": "2017-01-21T11:47:30-08:00",
"queuedAt": "2017-01-21T11:48:30-08:00",
"format": "CSV"
}
]
}
回應會確認工作已建立但尚未啟動。 若要啟動工作，請從建立回應呼叫具有exportId的排入佇列匯出潛在客戶工作端點。
POST /bulk/v1/leads/export/{exportId}/enqueue.json
{
"requestId": "147e4#16b24d9b913",
"result": [
{
"exportId": "fad2cd1b-e822-4025-be1e-9caa9cf1d4b8",
"format": "CSV",
"status": "Queued",
"createdAt": "2019-06-04T23:35:43Z",
"queuedAt": "2019-06-04T23:36:17Z"
}
],
"success": true
}
排入佇列回應有status個「已排入佇列」。 當匯出槽可供使用時，狀態會變更為「正在處理」。
輪詢工作狀態
您只能擷取相同API使用者所建立之工作的狀態。
潛在客戶匯出工作會非同步執行。 輪詢取得匯出潛在客戶工作狀態端點以追蹤工作進度。
狀態每60秒僅更新一次。 請勿更頻繁地輪詢；在幾乎所有情況下，該間隔仍然過大。
GET /bulk/v1/leads/export/{exportId}/status.json
{
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"exportId": "ce45a7a1-f19d-4ce2-882c-a3c795940a7d",
"status": "Processing",
"createdAt": "2017-01-21T11:47:30-08:00",
"queuedAt": "2017-01-21T11:48:30-08:00",
"format": "CSV"
}
]
}
此回應顯示工作仍在處理中，因此檔案無法使用。 當工作狀態變更為「已完成」時，檔案就可供下載。
status欄位可傳回下列任何值：
- 建立日期
- 已排入佇列
- 處理中
- 已取消
- 已完成
- 失敗
正在擷取您的資料
若要擷取已完成的銷售機會匯出，請使用exportId呼叫取得匯出銷售機會檔案端點。
GET /bulk/v1/leads/export/{exportId}/file.json
回應內文包含為工作設定的格式的檔案。
如果要求的潛在客戶欄位不含任何資料，則匯出檔案中的對應欄位會包含null。 在以下範例中，傳回的潛在客戶具有空白電子郵件欄位。
firstName,lastName,email,cookies
Russell,Wilson,null,_mch-localhost-1536605780000-12105
對於部分或可恢復擷取，檔案端點支援具有bytes型別的選用HTTP Range標頭。 如果您未設定標頭，端點會傳回所有內容。 深入瞭解如何搭配Marketo 大量擷取使用Range標頭。
取消工作
若要取消設定錯誤或不必要的工作，請呼叫取消匯出潛在客戶工作端點。
POST /bulk/v1/leads/export/{exportId}/cancel.json
{
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"exportId": "ce45a7a1-f19d-4ce2-882c-a3c795940a7d",
"status": "Cancelled",
"createdAt": "2017-01-21T11:47:30-08:00",
"format": "CSV"
}
]
}
回應會確認工作已取消。