Google Photos 官方 API 封装工具,支持本地照片备份、相册创建与管理,适合需要自动化云端图库的用户。
说明:
## 核心用法
该 Skill 通过封装 Google Photos Library API,提供命令行式的照片管理能力。主要功能包括:
– **相册管理**:列出现有相册(获取 Album ID)、创建新相册并自定义标题
– **照片上传**:支持单张图片上传,可选指定目标相册
– **OAuth 认证**:采用标准 OAuth 2.0 流程,首次运行生成 `token.pickle` 持久化凭证
使用时需通过 `scripts/gphotos.py` 脚本执行,依赖本地 Python 虚拟环境。
## 显著优点
1. **官方 API 背书**:直接调用 `photoslibrary.googleapis.com`,非第三方逆向接口,稳定性与长期兼容性有保障
2. **权限粒度可控**:仅访问应用上传的照片及用户明确共享的内容,不触碰完整图库
3. **轻量无侵入**:纯命令行工具,不驻留后台服务,用完即走
## 潜在局限
– **无批量上传**:示例命令为单文件上传,大规模备份需自行编写循环脚本
– **依赖本地环境**:需维护 Python 虚拟环境及凭证文件路径,对非技术用户门槛较高
– **Token 过期风险**:`token.pickle` 需定期刷新,长期无人值守运行可能中断
## 适合人群
– 开发者或技术用户,希望将 Google Photos 集成到自动化工作流
– 需要定期将本地相机/服务器照片归档至云端备份的摄影师或工作室
– 注重数据主权、倾向官方 API 而非第三方同步工具的用户
## 常规风险
– **凭证泄露**:`credentials.json` 与 `token.pickle` 包含完整 OAuth 凭据,务必纳入 `.gitignore` 并限制文件权限
– **误操作覆盖**:当前未提及重复上传检测,同名文件可能产生重复条目
– **API 配额限制**:Google Photos API 存在每日调用上限,大规模同步需关注配额策略








