Abfrage
Die Abfrage von Kontolisten ist einfach und unkompliziert. Derzeit gibt es nur zwei gültige Filtertypen für die Abfrage benannter Kontolisten: „dedupeFields“ und „idField“. Das Feld, nach dem gefiltert werden soll, wird im filterType-Parameter der Abfrage festgelegt, und die Werte werden in filterValues as kommagetrennten Liste festgelegt. Die nextPageToken- und batchSize sind ebenfalls optionale Parameter.
GET /rest/v1/namedAccountLists.json?filterType=idField&filterValues=dff23271-f996-47d7-984f-f2676861b5fb,dff23271-f996-47d7-984f-f2676861b5fc
{
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fb",
"name": "Saas List",
"createdAt": "xxxxxxxx",
"updatedAt": "xxxxxxxx",
"type": "default",
"updateable": true
},
{
"seq": 1,
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fc",
"name": "My Account List",
"createdAt": "xxxxxxxx",
"updatedAt": "xxxxxxxx",
"type": "default",
"updateable": true
}
]
}
Erstellen und aktualisieren
Das Erstellen und Aktualisieren von Datensätzen mit benannten Kontolisten folgt den etablierten Mustern für andere Vorgänge zum Erstellen und Aktualisieren von Lead-Datenbanken. Beachten Sie, dass die Listen für benannte Konten nur ein aktualisierbares Feld name haben.
Der Endpunkt lässt die beiden Standardaktionstypen zu: „createOnly“ und „updateOnly“. Die action defaults zu „createOnly“.
Die optionale dedupeBy parameter kann angegeben werden, wenn die Aktion updateOnly ist. Zulässige Werte sind „dedupeFields“ (entspricht „name„) oder „idField“ (entspricht „marketoGUID„). In createOnly Modi ist nur „name“ als dedupeBy zulässig. Sie können bis zu 300 Datensätze gleichzeitig senden.
POST /rest/v1/namedAccountLists.json
{
"action": "createOnly",
"dedupeBy": "dedupeFields",
"input": [
{
"name": "SAAS List"
},
{
"name": "Manufacturing (Domestic)"
}
]
}
{
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"status": "created",
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fb"
},
{
"seq": 1,
"status": "created",
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fc"
}
]
}
Löschen
Das Löschen von Listen benannter Konten ist einfach und kann entweder auf der Grundlage der name oder der marketoGUID der Liste erfolgen. Um den Schlüssel auszuwählen, den Sie verwenden möchten, übergeben Sie entweder „dedupeFields“ für den Namen oder „idField“ für marketoGUID im deleteB Ihrer Anfrage. Wenn nicht festgelegt, werden standardmäßig deduplizierte Felder verwendet. Sie können bis zu 300 Datensätze gleichzeitig löschen.
POST /rest/v1/namedAccountLists/delete.json
{
"deleteBy": "dedupeFields",
"input": [
{
"name": "Saas List"
},
{
"name": "B2C List"
},
{
"name": "Launchpoint Partner List"
}
]
}
{
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fb",
"status": "deleted"
},
{
"seq": 1,
"id": "dff23271-f996-47d7-984f-f2676861b5fc",
"status": "deleted"
},
{
"seq": 2,
"status": "skipped",
"reasons": [
{
"code": "1013",
"message": "Record not found"
}
]
}
]
}
Falls für einen bestimmten Schlüssel kein Datensatz gefunden werden kann, weist das entsprechende Ergebniselement den status „übersprungen“ und einen Grund mit einem Code und einer Meldung auf, die den Fehler beschreiben, wie im obigen Beispiel gezeigt.
Verwalten der Mitgliedschaft
Abfrage-Zugehörigkeit
Die Abfrage der Mitgliedschaft in einer benannten Kontoliste ist einfach und erfordert nur die i der Kontoliste. Optionale Parameter sind:
-field: Eine kommagetrennte Liste von Feldern, die in die Antwortdatensätze aufgenommen werden sollen
-nextPageToke - für das Paging durch den Ergebnissatz
-batchSiz - zum Angeben der Anzahl der zurückzugebenden Datensätze
Wennfield nicht festgelegt istmarketoGUI werden nam, createdA und updatedA zurückgegeben. batchSiz hat einen maximalen und einen standardmäßigen Wert von 300.
GET /rest/v1/namedAccountList/{id}/namedAccounts.json
{
"requestId": "e42b#14272d07d78",
"success": true,
"result": [
{
"seq": 0,
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fb",
"name": "Saas List",
"createdAt": "2017-02-01T00:00:00Z",
"updatedAt": "2017-03-05T17:21:15Z"
},
{
"seq": 1,
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fc",
"name": "My Account List",
"createdAt": "2017-02-01T00:00:00Z",
"updatedAt": "2017-03-05T17:21:15Z"
}
]
}
Mitglieder hinzufügen
Benannte Konten können einfach zu einer Liste benannter Konten hinzugefügt werden. Konten können nur mit ihrer marketoGUID hinzugefügt werden. Sie können bis zu 300 Datensätze gleichzeitig hinzufügen.
POST /rest/v1/namedAccountList/{id}/namedAccounts.json
{
"input": [
{
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fb"
},
{
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fb"
}
]
}
{
"requestId": "string",
"result": [
{
"seq": 0,
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fb",
"status": "added"
},
{
"seq": 1,
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fb",
"status": "added"
}
],
"success": true,
}