开发文档

Telegram 数据导出、历史导入与账号删除

区分数据导出、导入、退出登录和删除账号,设计有范围确认、进度与结果核验的数据操作。

GetTGAPI 编辑团队更新于
文档解读核对日期

依据官方资料整理,由 GetTGAPI 独立维护。 文档目录与术语表 →

本页内容
  1. 导出按用户选择的范围执行
  2. 导入不是直接发送历史文本
  3. 删除账号与退出设备完全不同
  4. 实现建议

导出按用户选择的范围执行

Takeout 使用独立会话,查询需要相应包装,结束时报告完成或中止。导出范围、媒体大小和数据类别应与用户选择一致,不能默认扩大到全部资料。

导入不是直接发送历史文本

历史导入先校验文件与目标,再初始化、上传媒体和完成导入。导入消息有特定来源标记,应与普通实时消息区分。目标聊天权限和用户确认都是流程的一部分。

删除账号与退出设备完全不同

账号删除可能立即生效,也可能涉及两步验证及延迟条件。不能把删除账号作为清理客户端会话的后备动作。保留登录、退出当前设备和永久删除账号应使用不同入口与确认文字。

实现建议

先列出数据范围和目的地,显示可取消的执行进度,完成后核对结果数量与失败项。导出文件含私人数据,应限制下载权限并提供清理方式。发布客户端前还应阅读官方 API 使用条款;此处是操作边界说明,不能替代条款原文。