Säljare
Slutpunktsreferens för säljare
API:er för säljare är skrivskyddade för prenumerationer som har SFDC Sync eller Microsoft Dynamics Sync aktiverat. Säljare är en typ av personpost som är säljare av lead-poster. De är relaterade till Lead-poster av fältet externalSalesPersonId på varje Lead-post. När en lead är relaterad till en säljare via ett ifyllt externalSalesPersonId-fält fylls motsvarande sökfält för lead-ägare i för den lead-posten i Marketo, vilket tillåter användning av motsvarande filter och tokens.
Säljare är relaterade till Lead-poster genom att använda slutpunkten Synkronisera leads och skicka attributet externalSalesPersonId.
Säljare är relaterade till säljprojektsposter genom att använda slutpunkten Synkroniseringsmöjligheter och skicka attributet externalSalesPersonId.
Säljare är relaterade till företagsposter genom att använda slutpunkten Synkronisera företag och skicka attributet externalSalesPersonId.
Försäljningspersonsposter kan bara redigeras via API:t.
Beskriv
Beskrivningen av poster för säljare följer standardmönstret för lead-databasobjekt.
GET /rest/v1/salespersons/describe.json
{
"requestId":"185d6#14b51985ff0",
"success":true,
"result":[
{
"name":"SalesPerson",
"createdAt":"2015-02-03T22:36:23Z",
"updatedAt":"2015-02-03T22:36:24Z",
"idField":"id",
"dedupeFields":[
"externalSalesPersonId"
],
"searchableFields":[
[
"email"
],
[
"id"
],
[
"externalSalesPersonId"
]
],
"fields":[
{
"name":"id",
"displayName":"Marketo Id",
"dataType":"integer",
"updateable":false
},
{
"name":"createdAt",
"displayName":"Created At",
"dataType":"datetime",
"updateable":false
},
{
"name":"updatedAt",
"displayName":"Updated At",
"dataType":"datetime",
"updateable":false
},
{
"name":"email",
"displayName":"Email",
"dataType":"string",
"length":255,
"updateable":false
},
{
"name":"externalSalesPersonId",
"displayName":"External Sales Person Id",
"dataType":"string",
"length":255,
"updateable":false
}
]
}
]
}
Som standard är idField för Sales People "id" och dedupeFields bara "externalSalesPersonId".
Fråga
Säljare som använder standardfrågemönstret för enkla nycklar. I det här exemplet visas användarens e-postadress som används som externalSalesPersonId. Som standard returnerar frågan alla fält som fylls i för de returnerade posterna.
GET /rest/v1/salespersons.json?filterType=dedupeFields&filterValues=david@test.com,sam@test.com
{
"requestId":"e42b#14272d07d78",
"success":true,
"result":[
{
"seq":0,
"id":53453,
"externalSalesPersonId":"sam@test.com",
"createdAt":"2015-02-03T22:36:23Z",
"updatedAt":"2015-02-03T22:36:23Z"
},
{
"seq":1,
"id":53454,
"externalSalesPersonId":"david@test.com",
"createdAt":"2015-02-03T22:36:23Z",
"updatedAt":"2015-02-03T22:36:23Z"
}
]
}
Skapa och uppdatera
Uppdateringsmönstret är standard.
POST /rest/v1/salespersons.json
{
"action":"createOrUpdate",
"dedupeBy":"dedupeFields",
"input":[
{
"externalSalesPersonId":"sam@test.com",
"email":"sam@test.com",
"firstName":"Sam",
"lastName":"Sanosin"
},
{
"externalSalesPersonId":"david@test.com",
"email":"david@test.com",
"firstName":"David",
"lastName":"Aulassak"
}
]
}
{
"requestId":"e42b#14272d07d78",
"success":true,
"result":[
{
"seq":0,
"status": "updated",
"id":45232
},
{
"seq":1,
"status": "created",
"id":45236
}
]
}
Ta bort
Mönstret för borttagningar är standard.
Det är inte tillåtet att ta bort säljare när de används. I det här fallet hoppas säljaren över. Exempel:
- När säljaren är associerad med aktiva leads
- När säljaren är associerad med ett företag som har tagits bort
POST /rest/v1/salespersons/delete.json
{
"deleteBy":"dedupeFields",
"input":[
{
"externalSalesPersonId":"sam@test.com"
},
{
"externalSalesPersonId":"david@test.com"
},
{
"externalSalesPersonId":"raj@test.com"
}
]
}
{
"requestId":"e42b#14272d07d78",
"success":true,
"result":[
{
"seq":0,
"id":56343,
"status": "deleted"
},
{
"seq":1,
"id":53453,
"status": "deleted"
},
{
"seq":2,
"status": "skipped"
"reasons":[
{
"code":"1013",
"message":"Record not found"
}
]
}
]
}
Timeout
-
Slutpunkter för säljare har en timeout på 30 sekunder om inget annat anges nedan
- Synkronisera säljare: 60-tal
- Ta bort säljare: 60-tal