Zoho crm Logo

批量删除标签状态

目的

使用批量删除标签API获取之前安排的批量标签删除任务的状态。

端点

  • GET /settings/tags/actions/mass_delete?job_ID={mass_tags_deletion_job_ID}

请求详情

Request URL

{api-domain}/crm/{version}/settings/tags/actions/mass_delete

头部

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.settings.ALL 
(或) 
ZohoCRM.settings.tags.{operation_type}

可能的操作类型

ALL - 完全数据访问
READ - 读取标签数据

参数

  • job_id字符串,必填

    代表您之前使用批量删除标签API预定的批量删除作业的唯一标识符。

样本请求

Response JSON 

  • job_id整数

    代表之前安排的大规模删除作业的唯一标识符。

  • total_count整数

    代表在作业中打算删除的标签数量。

  • failed_count整数

    代表在作业过程中未能删除的标签数量。

  • deleted_count整数

    代表在作业过程中成功删除的标签数量。

  • status字符串

    代表大规模删除作业的状态。例如:"status": "COMPLETED"。 

    可能的值:COMPLETED(已完成),SCHEDULED(已安排),和 FAILED(失败),

可能的错误

  • INVALID_DATAHTTP 400

    job_id无效 
    解决方案:指定一个有效的工作ID。您可以使用批量删除标签API来获取工作ID。

  • REQUIRED_PARAM_MISSINGHTTP 401

    请求中的job_id参数
    解决方案:在响应中包含一个有效值的job_id键,您可以在批量删除标签API的响应中获取。

示例回应