Zoho crm Logo

对不起,我无法上传文件。请将需要翻译的内容粘贴到对话框中。

目的

上传一个以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文件的限制。

样本回应