Zoho crm Logo

更新相关记录

目的

更新记录之间的关系。

端点

  • PUT /{module_api_name}/{record_id}/{related_list_api_name}/{related_record_id}

请求详情

请求 URL

{api-domain}/crm/{version}/{module_api_name}/{record_id}/{related_list_api_name}/{related_record_id}

支持的关系

活动 - 到 - 线索、联系人
产品 - 到 - 线索、Account,
联系人、商机、价格手册
预约 - 到 - 服务

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

scope=ZohoCRM.modules.ALL
(或)
scope=ZohoCRM.modules.{module_name}.{operation_type}

可能的模块名称

线索、交易、联系人、账户、产品、活动、预约、服务和价格表

可能的操作类型

全部 - 完全访问记录
写入 - Edit 相关记录
Update - Update 相关记录

示例请求:添加潜在客户与活动之间的关联

Copiedcurl "https://www.zohoapis.com/crm/v8/Leads/34876876000000376008/Campaigns"
-X PUT
-d @updaterelatedlead.json
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
CopiedSyntax:
zoho.crm.updateRelatedRecord(<module String>,<recordID Long>,<parentModuleName String>,<parentRecordId Long>,<dataMap Map>,<connectionName String>,<userAccess Boolean>);
mandatory : module,recordID,parentModuleName,parentRecordId,dataMap

Sample Request:
resp = zoho.crm.updateRelatedRecord("Related_List_Name_2","7000000037119","Leads","7000000037002", Map());

请求JSON键

  • id字符串,必填

    请指定要关联的相关记录的唯一ID。可参考获取记录API来获取记录的唯一ID。

注意

  • 在为其他模块添加关联时,必须发送样本数据。
  • 若要将某个模块的多个记录关联到父模块,您必须为每个相关记录分别传递一个 JSON 对象,如示例所示。
  • 每次 API 调用最多可更新 100 条关联记录。

示例输入

Copied{
	"data":[
		{
			"id":"3652397000000327001",
			"Member_Status":"Active"
		
		},
		{
			"id":"3652397000001854001",
			"Member_Status":"Planning"
		
		}]
}

可能的错误

  • INVALID_MODULEHTTP 400

    给定的模块名称似乎无效
    解决方法: 您指定了无效的模块名称,或者没有选项卡权限,或者该模块已被从可用模块中移除。请指定一个有效的模块 API 名称。

  • INVALID_MODULEHTTP 400

    所提供的模块在API中不受支持
    解决方法:当前API不支持如“文档”和“项目”等模块。(一旦这些模块被支持,此错误将不会再显示。)请指定一个有效的模块API名称。

  • INVALID_URL_PATTERN HTTP 404

    请检查尝试访问的URL是否正确
    解决方法:指定的请求URL不正确,请指定一个有效的请求URL。请参考上述请求URL部分。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    未授权
    解决方法:客户端没有 ZohoCRM.modules.{module_name}.UPDATE 的权限范围。请创建一个具有有效权限范围的新客户端。请参考上方的权限范围部分。

  • NO_PERMISSIONHTTP 403

    无权更新记录
    解决方法:用户没有权限更新相关记录数据。请联系您的系统管理员。

  • INTERNAL_ERRORHTTP 500

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

  • INVALID_REQUEST_METHODHTTP 400

    HTTP 请求方法类型无效
    解决方法:您为访问 API URL 指定了无效的 HTTP 方法。请指定有效的请求方法。请参阅上方的端点部分。

  • AUTHORIZATION_FAILEDHTTP 400

    用户没有足够的权限来更新相关记录数据
    解决方法:该用户没有权限更新相关记录数据。请联系系统管理员。

  • INVALID_DATAHTTP 400

    所提供的关联ID似乎无效
    解决方案:您指定了错误的关联记录ID。请指定一个有效的记录ID。请参考获取关联记录API以获取有效的记录ID。

  • INVALID_DATAHTTP 400

    无效数据
    解决方法:指定的输入不正确。请指定有效的输入

  • MANDATORY_NOT_FOUNDHTTP 400

    未找到必填字段
    解决方法:您在输入中未指定一个或多个必填字段。请参考字段元数据 API了解必填字段。

示例回应

Copied{
    "data": [
        {
            "code": "SUCCESS",
            "details": {
                "id": "3652397000000327001"
            },
            "message": "relation added",
            "status": "success"
        },
        {
            "code": "SUCCESS",
            "details": {
                "id": "3652397000001854001"
            },
            "message": "relation added",
            "status": "success"
        }
    ]
}