用途:创建并运行验证脚本,测试 Google Play Store API 的连接与权限,确认服务账号配置可用于后续发布流程。
前提条件:已完成服务账号创建(需先运行 android-service-account-guide)、已下载服务账号 JSON 文件、已安装 Python 3、已知应用包名。
输入:service_account_json_path(必填,JSON 密钥文件路径)、package_name(必填,应用包名)。
主要能力:校验服务账号 JSON 是否有效(检查 type、project_id、private_key、client_email 等必需字段,且 type 必须为 service_account);通过 androidpublisher v3 构建服务并尝试创建再删除 edit,以测试 Play Developer API 连接与包访问权限。
使用方式:脚本创建于 scripts/validate-playstore.py,执行 chmod +x scripts/validate-playstore.py 使其可执行;依赖文件 scripts/requirements-playstore.txt 含 google-auth==2.23.0、google-api-python-client==2.100.0。验证步骤:python3 -m venv .venv;source .venv/bin/activate(Windows 为 .venv\Scripts\activate);pip install google-auth google-api-python-client;python3 scripts/validate-playstore.py /path/to/service-account.json com.example.app;完成后 deactivate。
输出:校验脚本、依赖文件,以及 API 连接确认。
限制与排错:出现 404 表示应用不在 Play Console 或包名不匹配;403 或权限错误表示服务账号权限不足,需在 Play Console 的 Setup > API access 授予 Release 权限,权限传播可能需等待 5–10 分钟;缺少库时执行 pip install google-auth google-api-python-client。其他收费、价格或平台支持信息暂未提供。