为gphotos-sync项目创建OAuth客户端ID的完整指南

为gphotos-sync项目创建OAuth客户端ID的完整指南

前言

在开始使用gphotos-sync工具同步Google相册之前，我们需要创建一个OAuth客户端ID。这是Google API安全认证的必要步骤，允许你的应用访问Google相册数据。本文将详细介绍从零开始创建OAuth客户端ID的全过程。

准备工作

1. 确保你有一个有效的Google账户
2. 准备一个项目名称（如"gphotos"）
3. 了解基本的Google Cloud操作概念

创建Google Cloud项目

1. 访问Google Cloud控制台
2. 如果你是首次使用，需要选择国家/地区并同意服务条款
3. 在顶部横幅中点击当前项目名称（初次使用会显示"选择项目"）
4. 点击"新建项目"按钮
5. 输入项目名称（如"gphotos"），注意：
   • 名称在账户内必须唯一
   • 创建后无法修改
6. 保持"位置"为默认的"无组织"
7. 点击"创建"按钮

启用Photos API

1. 确保刚才创建的项目处于活动状态
2. 通过左侧导航菜单找到"API和服务" > "库"
3. 搜索"Photos Library API"
4. 点击"启用"按钮

配置OAuth同意屏幕

1. 导航至"API和服务" > "OAuth同意屏幕"
2. 选择"外部"作为用户类型
3. 点击"创建"

在应用注册部分：

1. 设置应用名称（如"gphotos"），注意：
   • 不需要与项目名称相同
   • 不要包含"Google"字样
2. 输入你的电子邮件作为"用户支持电子邮件"
3. 输入你的电子邮件作为"开发者联系信息"
4. 保留其他字段默认值
5. 点击"保存并继续"

在范围部分：

1. 无需任何操作，直接点击"保存并继续"

在测试用户部分：

1. 无需添加测试用户，直接点击"保存并继续"

最后查看摘要并返回仪表板。

创建OAuth凭据

1. 导航至"API和服务" > "凭据"
2. 点击"+创建凭据"，选择"OAuth客户端ID"
3. 选择"桌面应用"作为应用类型
4. 为凭据命名（如"gphotos"）
5. 点击"创建"按钮
6. 点击"下载JSON"将客户端ID保存为client_secret.json

发布应用（关键步骤）

重要提示：如果不发布应用，你的认证令牌将在7天后过期。

1. 返回"API和服务" > "OAuth同意屏幕"
2. 点击"发布应用"
3. 阅读通知并确认

后续步骤

完成上述步骤后，你需要将下载的client_secret.json文件移动到gphotos-sync工具要求的特定位置。不同操作系统的存放位置不同：

• Windows: %APPDATA%\gphotos-sync
• macOS: ~/Library/Application Support/gphotos-sync
• Linux: ~/.config/gphotos-sync

常见问题解答

Q: 为什么需要创建OAuth客户端ID？ A: 这是Google API的安全机制，确保只有经过授权的应用可以访问用户数据。

Q: 应用名称有什么限制？ A: 不能包含"Google"字样，且在Google Cloud项目中必须唯一。

Q: 为什么必须发布应用？ A: 未发布的应用生成的令牌有7天有效期限制，发布后可获得长期有效的令牌。

Q: 可以创建多个客户端ID吗？ A: 可以，但通常一个项目只需要一个客户端ID。

通过以上步骤，你已经成功为gphotos-sync工具配置了必要的OAuth认证信息，接下来就可以按照工具的README文档继续设置和使用它来同步你的Google相册了。