对不起,我无法上传文件。请将需要翻译的内容粘贴到对话框中。
目的
上传一个以ZIP格式的CSV文件以进行批量写入API。响应包含file_id。在进行批量写入请求时使用此ID。
端点
- POST /upload
Request 详情
Request URL
https://content.zohoapis.com/crm/v8/upload
标题
授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
特性:批量写入 - 表示这是一个批量写入任务
X-CRM-ORG: zgid - 通过组织API获取的您的组织的唯一ID(zgid)
范围
scope=ZohoFiles.files.ALL
输入表单数据
- 文件文件,必填
选择你想要上传的zip文件。
对于潜在客户和联系人等模块,你可以在其中ZIP一个CSV文件,最多25,000条记录。如果记录更多,通过一个包含模块中下一个25,000条记录的ZIP文件进行单独的API调用。
请注意,Zoho CRM中的子表单和多模块查找(MxN链接模块)字段被视为单独的模块。这是一个父子模块的情况,例如,联系人模块是父模块,其中的子表单是子模块。所以,为父模块和子模块准备单独的CSV文件,然后将它们一起ZIP成一个ZIP文件并上传。
关于如何准备父子记录导入的输入文件的更多详细信息,请参考Kaizen #131 - 使用Scala SDK进行父子记录的批量写入。
注意
- 在单个批量写入Request中导入父子模块数据:
- 在一个ZIP文件中添加多个CSV文件。
- 字段映射是必须的。
- 要导入子表单或链接模块记录,请在输入Request中指定它们各自的API名称。请参阅创建批量写入作业API以获取更多详细信息。
样本请求
可能的错误
- INVALID_FILE_FORMATHTTP 400
您上传的文件不是zip格式。
解决方案:只上传zip格式的文件。 - FILE_TOO_LARGEHTTP 413
文件大小过大,无法处理。
解决方案:最大文件大小为25MB。 - INVALID_URL_PATTERNHTTP 404
请检查尝试访问的URL是否正确
解决方案:指定的请求URL不正确。请指定一个有效的请求URL。请参考上面的请求URL部分。 - OAUTH_SCOPE_MISMATCHHTTP 401
未经授权
解决方案:客户端没有ZohoFiles.files.ALL。创建一个具有有效范围的新客户端。请参考上面的范围部分。 - NO_PERMISSIONHTTP 403
权限被拒绝创建
解决方案:用户没有上传文件的权限。请联系您的系统管理员。 - INTERNAL_ERRORHTTP 500
内部服务器错误
解决方案:服务器中出现意外且未处理的异常。请联系支持团队。 - INVALID_REQUEST_METHODHTTP 400
HTTP请求方法类型无效
解决方案:您指定了无效的HTTP方法来访问API URL。请指定一个有效的请求方法。请参考上面的端点部分。 - AUTHORIZATION_FAILEDHTTP 400
用户没有足够的权限进行创建。
解决方案:用户没有上传文件的权限。请联系您的系统管理员。
注意
请参考限制页面,了解更多关于CSV文件的限制。