石墨文档支持批量导入导出及API自动化操作：一、ZIP包导入多种格式并自动转换；二、多选文档导出为PDF/Word/Markdown/Excel并打包；三、通过API实现授权、批量导入导出及状态轮询。

如果您需要在石墨文档中一次性处理多个文档的迁移或归档，批量导入与导出是关键操作。以下是完成该任务的具体步骤：

一、批量导入文档到石墨文档

石墨文档支持通过 ZIP 压缩包方式将多个本地文档（如 Markdown、Word、Excel、PDF 等格式）一次性上传并自动转换为可协作的在线文档。该方式适用于从其他平台迁移内容或集中初始化团队资料库。

1、将需导入的文档整理至同一文件夹，确保文件名不含特殊字符（如 * ? " | / \ : ;），且单个文件大小不超过 100 MB。

2、选中全部文档，右键选择“发送到 → 压缩文件夹”，生成一个 ZIP 文件（Windows）或使用归档实用工具生成（macOS）。

3、登录石墨文档网页端，进入目标文件夹或工作区，点击右上角“+ 新建”按钮，选择“从压缩包导入”。

4、拖入 ZIP 文件或点击上传区域选择该文件，系统开始解析并自动创建对应文档，Markdown 和 Word 文件会保留标题结构与基础格式，Excel 生成表格文档，PDF 转为只读阅读文档。

二、批量导出石墨文档为本地文件

当需要将多个石墨文档保存为本地副本用于备份、交付或离线审阅时，可通过多选后统一导出功能实现。导出结果为 ZIP 包，内含按原始名称命名的独立文件。

1、在石墨文档网页端的文件列表页，按住 Ctrl（Windows）或 Command（macOS）键，逐个点击需导出的文档缩略图或文档名以多选。

2、选中后，页面顶部出现操作栏，点击“更多 → 导出”选项。

3、在弹出窗口中选择导出格式组合：支持为每个文档分别导出为 PDF、Word（.docx）、Markdown（.md）或 Excel（.xlsx，仅限表格文档）；勾选“打包下载”后，所有文档将合并为一个 ZIP 文件。

4、点击“确认导出”，系统生成并自动下载 ZIP 包，解压后可见各文档按原名及所选格式独立存放。

三、使用石墨文档 API 批量导入导出（高级方式）

对于拥有技术能力的用户或企业管理员，可通过调用石墨开放 API 实现自动化批量操作，适用于定期同步、跨系统集成或大规模文档治理场景。该方式需提前获取有效 access_token 并配置权限范围。

1、访问石墨开放平台控制台，创建应用并获取 Client ID 与 Client Secret，在应用设置中开通“文档管理”和“文件上传”权限。

2、使用 OAuth2 流程获取用户授权后的 access_token，有效期为 2 小时，需配合 refresh_token 更新。

3、调用 POST /v1/docs/batch-import 接口上传 ZIP 文件流，并指定目标文件夹 ID；响应返回 task_id，后续轮询 GET /v1/tasks/{task_id} 获取导入状态与新生成文档 ID 列表。

4、调用 POST /v1/docs/batch-export 接口传入文档 ID 数组与 format 参数（pdf/docx/md/xlsx），接口返回预签名 ZIP 下载 URL，有效期为 10 分钟。