gpd-cli-usage

GPD CLI 用法

需要运行或设计 Google Play Developer Console 的 gpd 命令时，请使用此技能。

发现命令

• 始终使用 --help 确认命令和标志。
  • gpd --help
  • gpd publish --help
  • gpd monetization --help

标志约定

• 使用明确的长标志（例如：--package、--track、--status）。
• 不使用交互式提示；破坏性操作必须使用 --confirm。
• 用户需要所有页面时，使用 --all。

输出格式

• 默认输出为压缩 JSON。
• 调试时使用 --pretty 输出易读的 JSON。

身份验证和默认设置

• 必须通过 GPD_SERVICE_ACCOUNT_KEY 使用服务账号进行身份验证。
• 优先使用权限设为 0600 的密钥文件（chmod 600 key.json），或使用密钥管理器，而不是将原始 JSON 粘贴到环境中。在命令中内联使用 export GPD_SERVICE_ACCOUNT_KEY='{...}' 会导致密钥泄露到 Shell 历史记录和进程环境中（可通过 ps、/proc 和子进程查看）。
• 使用专用且遵循最小权限原则的服务账号，仅授予任务所需的 Play Console 权限；切勿将密钥提交到源代码管理中。
• 验证对某个软件包的访问权限：
  • gpd auth check --package com.example.app

安全性

• 在执行破坏性操作之前，尽可能使用 --dry-run。
• 对于多步骤发布，优先使用编辑生命周期（gpd publish edit create）。