Google Drive 下载器：简易高效的文件获取工具

---

安装指南

要开始使用Google Drive 下载器，您只需通过Python的包管理器pip进行安装。在您的命令行界面执行以下命令即可轻松完成安装：

pip install googledrivedownloader

此命令将自动下载并安装所需的所有库，使您可以立即开始从Google Drive下载文件。

---

项目的使用说明

一旦安装完毕，您便可以利用该工具轻松下载共享自Google Drive的文件。首先，确保您手头有一个分享链接，其格式应支持直接文件访问。

以下示例展示了如何下载一个名为mnist.zip的文件，并将其解压到名为data的本地目录中：

from google_drive_downloader import GoogleDriveDownloader as gdd

# 文件ID可以在Google Drive的分享链接中找到，例如：
# https://drive.google.com/open?id=1iytA1n2z4go3uVCwE__vIKouTKyIDjEq
file_id = '1iytA1n2z4go3uVCwE__vIKouTKyIDjEq'
dest_path = './data/mnist.zip'  # 指定下载路径
unzip = True  # 是否解压文件

gdd.download_file_from_google_drive(file_id=file_id, dest_path=dest_path, unzip=unzip)

执行这段代码后，指定的.zip文件将被下载至data目录，并自动解压缩。

---

项目API使用文档

该库提供了直观简洁的API接口，主要功能是通过文件ID下载文件。关键参数解释如下：

• file_id: 必须参数，需要下载的文件在Google Drive上的唯一标识符。
• dest_path: 指定文件下载后的保存路径，默认为当前工作目录下的同名文件。
• unzip: 布尔值，指定是否在下载完成后自动解压缩文件，默认为False。
• showsize: 可选参数，设为True时，在下载过程中显示文件大小及进度，默认为False。
• overwrite: 可选参数，若目标文件已存在，且设置为True，则覆盖原有文件，否则抛出异常，默认为False。

---

进阶使用：定制化需求

对于更复杂的使用场景，如控制下载流的行为或处理特定错误，您可以通过调整上述参数来满足个性化需求。例如，增加下载过程中的反馈信息或者严格控制文件重写逻辑，都是非常直接的定制方式。

通过以上简明的技术文档，您应该已经掌握了如何高效地使用Google Drive 下载器来处理和集成Google Drive中的文件了。无论是自动化脚本还是手动操作，这个工具都能极大地简化从云端获取数据的过程。