セールス担当者
営業担当者APIは、Microsoft Dynamics SyncまたはSFDC Syncが有効になっているサブスクリプションに対して、読み取り専用アクセスを提供します。
セールスパーソンは、リードレコードのセールスオーナーを表す個人レコードです。 各リードレコードのexternalSalesPersonId フィールドは、リードを営業担当者に関連付けます。 このフィールドが入力されると、Marketoはリードレコードの対応するリード所有者のルックアップフィールドに入力します。 その後、関連するフィルターとトークンを使用できます。
externalSalesPersonId属性を対応するエンドポイントに渡すことにより、セールス担当者を他のレコードに関連付けます。
セールス担当者レコードは、API 経由でのみ編集可能です。
説明
リードデータベースオブジェクトの標準パターンを使用して、セールス担当者のレコードを記述します。
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
}
]
}
]
}
デフォルトでは、営業担当者idFieldは「id」で、dedupeFieldsは「externalSalesPersonId」です。
クエリ
シンプルなキーに対して標準のクエリパターンを使用して、営業担当者に対してクエリを実行します。 次の例では、ユーザーのメールをexternalSalesPersonIdとして使用します。
デフォルトでは、クエリは、一致するレコードの入力されたすべてのフィールドを返します。
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"
}
]
}
作成と更新
標準の更新パターンを使用して、営業担当者を作成または更新します。
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
}
]
}
削除
標準の削除パターンを使用して営業担当者を削除します。
「使用中」の営業担当者を削除することはできません。 次の場合、リクエストは営業担当者をスキップします。
- セールス担当者は、アクティブなリードに関連付けられています。
- 営業担当者は、削除された会社に関連付けられています。
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"
}
]
}
]
}
タイムアウト
- 特に明記されていない限り、営業担当者のエンドポイントのタイムアウトは30秒です。
- Sync Sales Personのタイムアウトは60秒です。
- 営業担当者の削除のタイムアウトは60秒です。
recommendation-more-help
marketo-developer-help