限制
值得注意的事项
- 轮询和回调选项在此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条记录时,该实体甚至会被添加到下一批记录中。