SuperAPI AI 工具集

gps-troubleshooting

部署与运维

查看项目

更新于 10-15 19:57

技能介绍

用途:排查 gps 与 gps-mcp 的常见失败,包括凭据缺失、401/403、评论列表为空、只读模式阻止写入、包名与权限范围问题。

主要能力与用法:

  1. 先做鉴权检查,运行 gps whoami。若提示 No credentials found,设置 GOOGLE_APPLICATION_CREDENTIALS 或使用 --credentials;401 需重新生成服务账号密钥并确认 API 已启用;403 需在 Play Console 中邀请服务账号并授予应用访问权限。
  2. 包名错误:使用精确的 application id(如 com.example.app)。同一包名的 listings/tracks 成功而另一个失败,通常说明权限是按应用范围授予的。
  3. 评论为空:reviews list 返回 { "reviews": [] } 往往属正常,Publisher API 只返回近期可回复评论的一个切片。可用 tracks list / listings list 验证鉴权是否正常。
  4. 只读模式:--read-only 或 MCP 的 --read-only 会阻止写入(deploy、reply、refund 等),但 tracks/listing 读取仍可用(临时 edit,不会提交)。出现 Cannot perform write operation … in read-only mode 时,去掉 --read-only,或在用户批准后使用可写会话。
  5. 未确认的写入:CLI 写命令缺少 --confirm 会失败,仅在用户明确要求该变更后再添加。
  6. 发现命令:gps ops <keyword>、gps search <keyword>;若缺少子命令,可用 gps call 或 MCP 配合注册表名称。

适用场景:使用 gps CLI 或 gps-mcp 操作 Google Play 发布、评论回复、退款等任务时定位失败原因。

限制:资料未提供更多平台、收费或效果信息;具体命令行为以实际工具为准。