Zoho crm Logo

限制

值得注意的事项

  • 轮询和回调选项在此API中得到支持。
  • 除了笔记、附件、电子邮件以及相关和交叉模块外,所有模块都支持此API。
  • 排序和分组子句不支持通过此API端点。
  • Response包含一个压缩文件{job_id}.zip,其中包含结果作为 {job_id}.csv 文件。
  • 单个导出任务最多可以导出200,000(二十万)条记录。即,"page"应为"1","per_page"应为"200,000"。
  • 如果有额外的记录需要导出,可以将"page"键设置为"2",这将从200,001开始获取记录。
  • 对于ICS类型的导出,
    • 每个非重复事件都被写入文件作为一个单独的实体。
    • 当一个事件是重复的,所有的重复事件都被压缩成一个单一的实体并只在文件中写入一次。
    • 当你更新一个重复事件的特定实例时,它将以RECURRENCE-ID作为一个单独的实体写入ICS文件。

批量读取API的限制

  • 在一分钟内只允许下载10次请求。超过限制将导致错误(HTTP代码:429)返回给用户作为响应。所有的下载都将不成功,下载请求将在一分钟后才被处理。
  • 使用响应中的"more_records"键来检测是否还有更多的记录。你可以改变"page"键的值以进行额外的导出任务。
  • 完成大量工作后,您只能在一天内访问可下载的文件。之后,您将无法通过端点访问该文件。
  • 通过端点可以提供最多200个选择字段。超过200个,将导出该模块中所有可用字段的数据。
  • 导出请求体中"page"键的最大值为500。
  • 外部字段在任何模块中创建的都不支持在批量读取APIs中。

标准限制

  • 在查询中可以使用的最大条件数是25。这也包括自定义视图或标准视图中的条件数。例如,如果你指定了使用两个条件的标准视图"My converted Leads"的ID,那么你在查询中可以使用的剩余条件将是23。
  • 对于字段,'in' 和 'not_in' 比较器可以接受最多20个值。
    例如:'Lead Status' - 'in' - 'Cold,Warm,Hot,Junk,Contacted,Not Contacted,....(20个值)'
  • 不支持多行文本字段的标准。
  • 活动模块中的自定义视图不受支持。
  • 共同所有者视图,标准视图我共享的和共享给我的在此API中不受支持。

ICS限制

  • 仅支持为事件模块导出ICS文件类型。
  • 您可以将最多每个API调用20000条记录导出为ICS文件。
  • 如果该活动有参与者,活动的主持人也会被添加为参与者。
  • 如果您没有指定任何参与者的电子邮件ID,那么该记录将不会被添加到ICS文件中。
  • 当定期活动的计划超过每批20,000条记录时,该实体甚至会被添加到下一批记录中。