批量更改所有者状态
目的
要检索先前在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
参数
- job_idstring,mandatory
使用批量更改所有者API调度的批量更改所有者作业的唯一ID。
示例请求
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"
}
]
}