Google Photos Mobile Client 开源项目教程

1. 项目介绍

Google Photos Mobile Client 是一个基于逆向工程移动 API 的开源项目，它允许用户通过命令行界面（CLI）或 Python 库上传媒体文件到 Google Photos。该项目支持无限原始质量上传（可禁用）、创建专辑、实时进度跟踪等功能，非常适合需要批量上传图片和视频到 Google Photos 的用户。

2. 项目快速启动

在开始使用 Google Photos Mobile Client 之前，确保已经安装了 Python 环境。

首先，需要安装项目：

pip install https://github.com/xob0t/google_photos_mobile_client/archive/refs/heads/main.zip --force-reinstall

接下来，获取认证数据 auth_data。这需要使用设备上的 Google Photos ReVanced 或者通过官方 APK（需要 root 权限）来获取。以下是通过 ReVanced 获取认证数据的方法：

1. 在设备上安装 Google Photos ReVanced 和 GmsCore。
2. 连接设备到电脑，打开终端执行以下命令：

# 对于 Windows 用户
adb logcat | FINDSTR "auth%2Fphotos.native"

# 对于 Linux/Mac 用户
adb logcat | grep "auth%2Fphotos.native"

3. 登录 Google Photos ReVanced，复制日志中的 androidId= 到行尾的文本。

然后，使用 Python 客户端上传文件：

from gpmc import Client

path = "/path/to/media_file.jpg"  # 文件或目录路径
auth_data = "你的认证数据"
client = Client(auth_data=auth_data)
output = client.upload(target=path, show_progress=True)
print(output)

或者使用 CLI 工具：

gpmc "/path/to/media_file.jpg" --progress --auth_data "你的认证数据"

3. 应用案例和最佳实践

批量上传

如果你需要上传整个目录的文件，可以使用 --recursive 参数：

gpmc "/path/to/directory" --recursive --auth_data "你的认证数据"

创建专辑

可以通过 --album 参数创建专辑，如果设置为 'AUTO'，则根据文件所在的目录结构自动创建专辑：

gpmc "/path/to/media_file.jpg" --album "专辑名称" --auth_data "你的认证数据"

使用代理

如果你需要通过代理上传，可以设置 --proxy 参数：

gpmc "/path/to/media_file.jpg" --proxy "协议://用户名:密码@主机:端口" --auth_data "你的认证数据"

4. 典型生态项目

• Google Photos Web Client: 一个基于 Web API 的 Python 客户端。
• GP File Hide: 一个可以将任何文件伪装成媒体文件以便 Google Photos 接受和存储的项目。
• Google Photos Toolkit: 用于管理 Google Photos 库的批量操作工具。

以上便是 Google Photos Mobile Client 的基本教程，希望对您的使用有所帮助。