用途:gws-reseller 是 Google Workspace Reseller 的命令行技能,用于管理 Workspace 经销商侧的客户账户与订阅,命令形式为 gws reseller <resource> <method> [flags]。
使用前提:需先阅读 ../gws-shared/SKILL.md 了解认证、全局标志与安全规则;若该文件缺失,运行 gws generate-skills 生成。
主要能力:customers 资源支持 get(查询客户账户)、insert(新建客户账户)、patch/update(更新客户账户设置,且不能通过 Reseller API 修改 customerType,但 team 客户可验证域名后变为 domain)。resellernotify 资源支持 getwatchdetails(返回经销商对应 watch 的全部详情)、register(注册接收通知)、unregister(取消注册接收通知)。subscriptions 资源支持 activate(重新激活被经销商暂停的订阅)、changePlan(更新订阅方案,适用于 30 天试用或灵活方案转为年付承诺方案)、changeRenewalSettings(更新用户许可续订设置,仅适用于年付承诺方案)、changeSeats(更新用户许可设置)、delete(取消、暂停或将订阅转为直接销售)、get(获取指定订阅)、insert(创建或转移订阅)、list(列出经销商管理的订阅,可按 customerNamePrefix 过滤)、startPaidService(将 30 天免费试用立即转为付费服务,需已设置付款方案)、suspend(暂停处于 ACTIVE 状态的付费订阅;灵活方案暂停计费,年付方案暂停不改变原续订日期且不续订)。
发现命令:调用前可先用 gws reseller --help 浏览资源与方法,用 gws schema reseller.<resource>.<method> 查看必填参数、类型与默认值,再据此构建 --params 与 --json 标志。
限制:activate 仅能激活由经销商暂停的订阅,因滥用或待接受服务条款等原因被暂停的订阅无法借此恢复;changePlan、changeRenewalSettings、startPaidService 等有各自的套餐与付款前提。其他平台支持、价格与效果信息暂未提供。