Zoho crm Logo

批量更改所有者状态

目的

要检索先前在Zoho CRM中安排的批量更改所有者任务的状态。

端点

  • GET /{module_API_name}/actions/mass_change_owner?job_id={job_ID}

请求详情

请求 URL

{api-domain}/crm/{version}/{module_API_name}/actions/mass_change_owner?job_id={job_ID}

支持的模块

潜在客户,Account,联系人,交易,活动,任务,案例,会议,电话,解决方案,产品,Vendors,价格表,报价单,Sales Orders,采购Orders,Invoices,以及自定义

标题

授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.change_owner.READ

参数

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/Leads/actions/mass_change_owner?job_id=3652397000009565021"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

响应 JSON 键

  • Total_Countinteger

    计划更改所有者的记录总数。

  • Update_Countinteger

    成功Update所有权的记录数量。

  • Not_Updated_Countinteger

    尚未Update的记录数量。

  • Failed_Countinteger

    所有者变更操作失败的记录数。

  • Statusstring

    表示批量更改所有者任务的Status。 
    可能的值:
    COMPLETED - 任务已成功完成。
    SCHEDULED - 任务已排队,等待执行。
    RUNNING - 任务正在进行中。
    FAILED - 由于错误,任务无法完成。

可能的错误

  • REQUIRED_PARAM_MISSINGHTTP 404

    您在请求中未指定 job_id。
    解决方案: 指定的 job_id 未找到或无效。请指定一个有效的 job_id

  • INVALID_URL_PATTERNHTTP 404

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

  • OAUTH_SCOPE_MISMATCHHTTP 401

    未经授权
    解决方案:您没有ZohoCRM.change_owner.CREATE范围。请创建具有有效范围的新令牌。请参阅上面的范围部分。

  • NO_PERMISSIONHTTP 403

    无权限读取记录
    解决方案:用户没有权限检索批量更改所有者。

示例响应

Copied{
    "data": [
        {
            "Total_Count": 50000,
            "Updated_Count": 49500,
            "Not_Updated_Count": 0,
            "Failed_Count": 500,
            "Status": "COMPLETED"
        }
    ]
}