删除记录

目的

从模块中删除实体或记录。

请求URL

https://www.zohoapis.com.cn/crm/v2/{module_api_name}?ids={EntityID}

module_api_name - 模块的API名称

在获取记录列表中支持的记录在这里也支持。

EntityID - 实体或记录的唯一ID

请求方法

DELETE

范围

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

可能的模块名称可能的操作类型
线索，客户，联系人，商机，市场活动，任务，服务支持，事件，解决方案，产品，供货商，价格表，报价单，销售订单，采购订单，发货单，自定义模块和备注ALL - 完全访问记录
WRITE - 编辑模块中的记录
DELETE - 删除模块中的记录

参数

参数名称数据类型描述可能的值
ids (必填)整型指定记录的唯一ID用逗号分隔的实体ID。例如：410405000002264040,410405000002264025

备注：

  • 每次API调用最多可以删除100条记录。

  • 默认情况下，将执行与此API相关的所有工作流。

  • 所有与此API相关的子表单都将被删除。

CurlPythonCsharp

示例请求

在这里请求中，线索ID为"410405000002264040" 和 "410405000002264025" 的记录将被删除。


				curl "https://www.zohoapis.com.cn/crm/v2/Leads?ids=410405000002264040,410405000002264025"
-X DELETE
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

示例响应


				{
    "data": [
       {
            "code": "SUCCESS",
            "details": {
                "id": "410405000002264040"
            },
            "message": "record deleted",
            "status": "success"
        },
       {
            "code": "SUCCESS",
            "details": {
                "id": "410405000002264025"
            },
            "message": "record deleted",
            "status": "success"
        }
    ]
}

示例请求


				def delete_records(self):
    try:
        entityid_list=[1386586000001856020,1386586000001856019]
        resp=ZCRMModule.get_instance('Invoices').delete_records(entityid_list)
        print resp.status_code
        entity_responses=resp.bulk_entity_response
        for entity_response in entity_responses:
            print entity_response.details
            print entity_response.status
            print entity_response.message
            print entity_response.code
            print entity_response.data.entity_id
            print "\n\n"
    except ZCRMException as ex:
        print ex.status_code
        print ex.error_message
        print ex.error_code
        print ex.error_details
        print ex.error_content

示例响应


				{
    "data": [
       {
            "code": "SUCCESS",
            "details": {
                "id": "410405000002264040"
            },
            "message": "record deleted",
            "status": "success"
        },
       {
            "code": "SUCCESS",
            "details": {
                "id": "410405000002264025"
            },
            "message": "record deleted",
            "status": "success"
        }
    ]
}

示例请求


				List<long> entityIDs = new List<long> { 3372164000001622004, 3372164000001632009, 3372164000001622005 }; // 记录ID列表
ZCRMModule moduleIns = ZCRMModule.GetInstance("Products"); //模块API名称
BulkAPIResponse<ZCRMEntity> response = moduleIns.DeleteRecords(entityIDs);
List<EntityResponse> entityResponses = response.BulkEntitiesResponse; //entityResponses - EntityResponses实例的列表

示例响应


				{
    "data": [
       {
            "code": "SUCCESS",
            "details": {
                "id": "410405000002264040"
            },
            "message": "record deleted",
            "status": "success"
        },
       {
            "code": "SUCCESS",
            "details": {
                "id": "410405000002264025"
            },
            "message": "record deleted",
            "status": "success"
        }
    ]
}