获取实体评分
目的
获取记录的实体分数。
端点
- GET /{module_api_name}/{record_ID}/Entity_Scores__s?fields={field1,field2,..}
Request 详情
Request URL
{api-domain}/crm/{version}/{module_api_name}/{record_ID}/Entity_Scores__s?fields={field1, field2,..}
支持的模块
潜在客户,账户,联系人,交易和自定义
标题
授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
范围
ZohoCRM.modules.entity_scores.READ
(和)
ZohoCRM.modules.{module_name}.{operation_type}
可能的模块名称
潜在客户,账户,联系人,交易和自定义
Possible operation types
ALL - 对模块数据的完全访问
READ - 获取模块数据
参数
- fields字符串,必填
指定您希望在响应中接收其详细信息的字段的API名称。
可能的值:Positive_Score, Negative_Score, Touch_Point_Score, Touch_Point_Positive_Score, Touch_Point_Negative_Score, Score, Scoring_Rule
注意
对于非人员模块,接触点分数将始终为空。
样本请求
Response JSON
- Positive_Score整数
代表记录的正面评分。
- Negative_Score整数
代表记录的负分。
- Touch_Point_Score整数
代表记录的综合触点分数。
- Touch_Point_Positive_Score整数
代表记录的正面接触点分数。
- Touch_Point_Negative_Score整数
代表记录的负触点分数。
- 得分整数
代表记录的总得分。
- idstring
代表实体分数ID。
- Scoring_RuleJSON 对象
代表评分规则的ID和名称。
样本回应
可能的错误
- INVALID_REQUEST_METHODHTTP 400
请求方法不正确。
解决方案:使用HTTP GET方法来进行此API调用。任何其他请求方法都会导致此错误。 - REQUIRED_PARAM_MISSINGHTTP 400
缺少预期的参数之一
解决方案: 指定字段参数。请参阅参数部分以获取更多详细信息。 - INVALID_DATAHTTP 400
给出的相关ID似乎无效
解决方案: 指定一个有效的记录ID。 - OAUTH_SCOPE_MISMATCHHTTP 401
您用来进行此API调用的访问令牌没有所需的范围。
解决方案:生成具有此API所需范围的新访问令牌。请参阅此页面开头的范围部分,以获取所需范围的列表。 - NO_PERMISSIONHTTP 403
您没有权限读取实体分数。
解决方案:联系您的系统管理员。 - INVALID_URL_PATTERNHTTP 404
请求的URL不正确。
解决方案:指定一个有效的请求URL。请参考本页开头的请求URL部分以获取更多详细信息。 - INTERNAL_ERRORHTTP 500
内部服务器错误
解决方案:服务器中出现意外且未处理的异常。请联系支持团队。