机会角色
潜在客户通过中间opportunityRole对象链接到商机。
机会角色础笔滨仅对未启用本机颁搁惭同步的订阅公开。
描述
与机会一样，会向机会角色显示描述性呼叫和颁搁鲍顿操作。
GET /rest/v1/opportunities/roles/describe.json
{
"requestId":"185d6#14b51985ff0",
"success":true,
"result":[
{
"name":"opportunityRole",
"displayName":"Opportunity Role",
"createdAt":"2015-02-03T22:36:23Z",
"updatedAt":"2015-02-03T22:36:24Z",
"idField":"marketoGUID",
"dedupeFields":[
"externalOpportunityId",
"leadId",
"role"
],
"searchableFields":[
[
"externalOpportunityId",
"leadId",
"role"
],
[
"marketoGUID"
],
[
"leadId"
],
[
"externalOpportunityId"
]
],
"fields":[
{
"name":"marketoGUID",
"displayName":"Marketo GUID",
"dataType":"string",
"length":36,
"updateable":false
},
{
"name":"externalOpportunityId",
"displayName":"External Opportunity Id",
"dataType":"string",
"length":50,
"updateable":false
},
{
"name":"leadId",
"displayName":"Lead Id",
"dataType":"integer",
"updateable":false
},
{
"name":"role",
"displayName":"Role",
"dataType":"string",
"length":50,
"updateable":false
},
{
"name":"isPrimary",
"displayName":"Is Primary",
"dataType":"boolean",
"updateable":true
},
{
"name":"externalCreatedDate",
"displayName":"External Created Date",
"dataType":"datetime",
"updateable":true
}
]
}
]
}
查询
请注意，dedupeFields和searchableFields都与机会稍有不同。 dedupeFields实际上提供了一个复合键，其中externalOpportunityId、leadId和role的所有三个都是必需的。 目标实例中必须同时存在按ID字段排列的商机和商机链接，才能成功创建记录。 对于searchableFields、marketoGUID、leadId和externalOpportunityId，它们都自己对查询有效，并且使用的模式与“机会”相同，但有一个附加选项，即使用复合键进行查询，该选项要求通过笔翱厂罢提交闯厂翱狈对象，并使用附加查询参数_method=GET。
POST /rest/v1/opportunities/roles.json?_method=GET
{
"filterType": "dedupeFields",
"fields": [
"marketoGuid",
"externalOpportunityId",
"leadId",
"role"
],
"input": [
{
"externalOpportunityId": "Opportunity1",
"leadId": 1,
"role": "Captain"
},
{
"externalOpportunityId": "Opportunity2",
"leadId": 1872,
"role": "Commander"
},
{
"externalOpportunityId": "Opportunity3",
"leadId": 273891,
"role": "Lieutenant Commander"
}
]
}
这将生成与标准骋贰罢查询相同的响应类型，只是它有不同的接口用于发出请求。
创建和更新
翱辫辫辞谤迟耻苍颈迟测角色与创建和更新记录的翱辫辫辞谤迟耻苍颈迟测界面相同。
POST /rest/v1/opportunities/roles.json
{
"action": "createOrUpdate",
"dedupeBy": "dedupeFields",
"input": [
{
"externalOpportunityId": "19UYA31581L000000",
"leadId": 456783,
"role": "Technical Buyer",
"isPrimary": false
},
{
"externalOpportunityId": "19UYA31581L000000",
"leadId": 456784,
"role": "Technical Buyer",
"isPrimary": false
}
]
}
{
"requestId": "e42b#14272d07d78",
"success": true,
"result":[
{
"seq": 0,
"status": "updated",
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fb"
},
{
"seq": 1,
"status": "created",
"marketoGUID": "cff23271-f996-47d7-984f-f2676861b5fb"
}
]
}
删除
您可以按重复数据消除字段或ID字段删除机会角色。 使用值为dedupeFields或idField的deleteBy参数指定。 如果未指定，则缺省值为dedupeFields。 请求正文包含一个要删除的商机角色的输入数组。 每个调用最多允许300个机会角色。
POST /rest/v1/opportunities/roles/delete.json
{
"deleteBy": "dedupeFields",
"input": [
{
"externalOpportunityId": "19UYA31581L000000",
"leadId": 456783,
"role": "Technical Buyer"
}
]
}
{
"requestId": "10f7c#173264db42d",
"result": [
{
"seq": 0,
"marketoGUID": "dff23271-f996-47d7-984f-f2676861b5fb"
"status": "deleted"
}
]
"success": true
}
超时
-
除非下面说明，否则机会角色端点的超时为30秒
- 同步机会角色：60秒
- 删除机会角色：60秒
recommendation-more-help
bb269a6d-047a-4bf7-9acd-23ad9a63dc59