用途:通过命令行管理 Google Workspace 经销商业务,覆盖客户账号与订阅生命周期。
主要能力:customers 资源支持 get(查询客户账号)、insert(订购新客户账号)、patch/update(更新客户设置,注意无法通过 Reseller API 修改 customerType)。subscriptions 资源支持 activate(激活被经销商暂停的订阅)、changePlan(变更计划,如 30 天试用或灵活计划转为年度承诺计划)、changeRenewalSettings(仅适用于年度承诺计划的续订设置)、changeSeats(调整用户许可)、delete(取消、暂停或转为直接订阅)、get、insert(创建或转移订阅)、list(列出订阅,可按 customerNamePrefix 过滤)、startPaidService(将 30 天免费试用立即转为付费)、suspend(暂停活跃订阅,灵活计划暂停计费,年度计划暂停不改变续订日期且不续订)。resellernotify 资源支持 getwatchdetails、register、unregister,用于接收通知。
使用方式:前置要求是阅读 ../gws-shared/SKILL.md 获取认证、全局标志与安全规则,缺失时运行 gws generate-skills 生成。命令格式为 gws reseller <resource> <method> [flags]。调用前可用 gws reseller --help 浏览资源与方法,用 gws schema reseller.<resource>.<method> 查看必填参数、类型与默认值,再据此构建 --params 与 --json 标志。
适用场景:经销商批量管理客户账号、订阅计划与席位,处理试用转付费、暂停与恢复、订阅转移等运营任务。
限制:activate 仅能恢复由经销商暂停的订阅,因滥用或待接受条款等原因被暂停的无法通过该调用恢复;changeRenewalSettings 仅适用于年度承诺计划;无法通过 Reseller API 更新 customerType。其余认证细节与安全规则以 gws-shared 文档为准。