批量删除状态
目的
获取之前安排的批量删除任务的状态。
端点
- GET /{module_API_name}/actions/mass_delete?job_id={job_ID}
请求详情
请求 URL
{api-domain}/crm/{version}/{module_API_name}/actions/mass_delete?job_id={job_ID}
支持的模块
潜在客户,Account,联系人,交易,活动,任务,电话,会议,解决方案,产品,Vendors,价格表,报价单,Sales Orders,采购Orders,Invoices,以及自定义模块
标题
授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
范围
ZohoCRM.mass_delete.READ
(或)
ZohoCRM.mass_delete.{module_name}.READ
可能的模块名称
线索、账户、联系人、交易、活动、任务、电话、会议、解决方案、产品、供应商、价格表、报价单、销售订单、采购订单、发票和自定义
参数
- job_id字符串,必填
表示在批量Delete记录的响应中获得的批量Delete作业的唯一ID。
示例请求
Copiedcurl "https://www.zohoapis.com/crm/v8/Leads/actions/mass_delete?job_id= 3652397000009565021"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"响应 JSON 键
- Status字符串
指示批量 Delete API 的 Status。可能的值是 "COMPLETED"、"RUNNING" 和 "FAILED"。
- Total_Count整数
指定计划 Delete的记录总数。
- Failed_Count整数
指定未能 Delete的记录数。
- Delete_Count整数
指定成功 Delete的记录数。
可能的错误
- INVALID_MODULEHTTP 400
您指定了无效的模块 API 名称,没有标签权限,或者该模块已从可用模块列表中移除。
解决方法:使用模块 API获取模块的 API 名称。如果您没有标签权限或模块已被移除,请联系您的系统管理员。 - INVALID_MODULEHTTP 400
所给的模块在API中不受支持。
解决方案:目前,API不支持Documents和Projects等模块。一旦这些模块得到支持,此错误将不会显示。 - INVALID_REQUEST_METHODHTTP 400
请求方法不正确。
解决方法:使用 HTTP GET 方法来进行此 API 调用。使用其他请求方法将导致此错误。 - AUTHORIZATION_FAILEDHTTP 400
您没有足够的权限批量更新记录或获取状态。
解决方法:请联系您的系统管理员。 - MANDATORY_NOT_FOUNDHTTP 400
您在请求中未包含 "job_id" 参数。
解决方法: 在请求 URL 中包含必需的参数 "job_id"。 - OAUTH_SCOPE_MISMATCHHTTP 401
您用于进行此API调用的访问令牌没有所需的范围。
解决方法:生成一个具有范围ZohoCRM.mass_update.{module_name}.READ的新访问令牌。请参阅可能的模块名称和可能的操作类型部分以获取详细信息。 - NO_PERMISSIONHTTP 403
您没有权限检索批量更新状态。
解决方案:请联系您的系统管理员。 - NOT_FOUNDHTTP 404
指定的 "job_id" 未找到或无效。
解决方法:请指定一个有效的 job_id。您可以从 批量Delete API 的响应中获取 job_id。 - INVALID_URL_PATTERNHTTP 404
请求的URL不正确。
解决方法:请指定一个有效的请求URL。请参阅请求URL部分以获取正确的URL。 - INTERNAL_ERRORHTTP 500
服务器中出现意外且未处理的异常。
解决方法:请联系支持团队,邮箱:support@zohocrm.com。
示例响应
Copied{
"data": [
{
"Status": "COMPLETED",
"Failed_Count": 0,
"Deleted_Count": 9,
"Total_Count": 9
}
]
}