Zoho crm Logo

获取实体评分

目的

获取记录的实体分数。

端点

  • 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

    内部服务器错误
    解决方案:服务器中出现意外且未处理的异常。请联系支持团队。