用途:为 gps 与 gps-mcp 配置 Google Play 服务账号凭证,解决认证问题,包括修复 401/403 错误、选择凭证环境变量、启用所需权限。
设置清单:创建 Google Cloud 服务账号;启用 Google Play Android Developer API;在 Play Console 的「用户和权限」中邀请该服务账号邮箱并分配所需的应用角色;下载 JSON 密钥,切勿提交到代码仓库。
凭证优先级(由高到低):--credentials <path|json>;GPS_CREDENTIALS / GOOGLE_PLAY_CREDENTIALS;GOOGLE_APPLICATION_CREDENTIALS;~/.config/gps/config.json 中的 {"credentialsPath": "..."}。
示例:export GOOGLE_APPLICATION_CREDENTIALS=/secure/path/sa.json 后执行 gps whoami。
安全标志:--confirm 用于任何写入操作(deploy、reply、refund、gps call 写操作);--read-only 用于仅检查的 CLI 或 MCP 会话。例如:gps --read-only --package com.example.app tracks list;gps-mcp --read-only --credentials /secure/path/sa.json。
常见失败排查:提示 No credentials found 通常是环境变量或路径未设置;401/Login Required 多为密钥错误、库认证方式不对或服务账号不可用;403 多为服务账号未在 Play Console 被邀请或缺少权限;Empty reviews 是因为 API 窗口只返回近期可回复的评论。执行写入操作前务必先用 gps whoami 验证。
限制:资料未提供更多平台支持、收费或价格信息,也未给出完整的凭证字段说明。