用途：在 TypeScript/JavaScript 后端服务、仪表盘或自动化脚本中，以编程方式访问 Google Play Developer API，而非通过命令行工具操作。
前置条件：Node.js 20+ 与 TypeScript 5+，并需服务账号密钥（JSON 文件或原始 JSON 字符串）。安装：npm install @gpc-cli/api @gpc-cli/auth。
主要能力：createApiClient 提供对 Android Publisher v3、Play Developer Reporting v1beta1、Play Custom App Publishing v1 及 Games Configuration v1configuration 共 234 个接口的类型化访问；createEnterpriseClient 用于私有应用发布。多数操作需先经编辑会话（edits.insert / validate / commit），同一时间仅允许一个未关闭编辑。常见模式包括上传 AAB、设置发布轨道、创建自定义封闭测试轨道、上传混淆文件与扩展文件、列出一次性商品、回复评论、管理订阅、校验与确认购买、下载 Play GCS 批量报表。
用法要点：认证通过 resolveAuth()，支持文件路径、JSON 字符串或环境变量（GPC_SERVICE_ACCOUNT、GOOGLE_APPLICATION_CREDENTIALS）。分页使用 paginate / paginateAll；部分列表命令统一返回含 nextPageToken 的 JSON 信封，读取裸数组的旧脚本需调整。自 v0.9.47 起内置按 Google 六桶模型的自动限流（每桶 3000 次/分钟），可用 createRateLimiter 自定义。错误通过 PlayApiError 与 AuthError 捕获。
限制：私有应用一经创建无法公开；批量报表需服务账号具备查看应用信息与下载批量报表的只读权限；部分接口的行为与字段随版本变更，需参考对应版本说明。文档涉及具体版本号与迁移细节，使用前建议核对官方资料。