核心功能
Google Merchant Center API的托管式OAuth集成，通过Maton网关代理访问Google官方Merchant API。支持产品目录管理、库存同步、促销配置、数据源管理、账户设置及转化追踪等全链路电商运营操作。
显著优势
- 官方API直连：底层调用
merchantapi.googleapis.com，非爬虫方案，数据实时性与可靠性有保障 - OAuth托管：Maton集中管理授权令牌，用户无需处理Token刷新与存储
- 完整写能力：支持产品创建/更新/删除、库存调整、促销设置等全CRUD操作
- 模块化设计：按业务域划分为products/accounts/datasources/reports/promotions/inventories等子API，结构清晰
- 多连接管理：支持多Merchant账户切换，通过
Maton-Connection头部显式指定目标账户
潜在局限
- 前置门槛：需完成一次性开发者注册（
registerGcp）才能使用v1端点，新用户有额外配置成本 - API数据源限制：产品写入仅限
input: "API"类型数据源，需预先创建对应数据源 - 程序准入：促销功能需账户单独 enrolled，部分高级报告需Market Insights订阅
- 渠道隔离：本地库存（Local Inventories）与在线库存（Online）完全分离，无法跨通道操作
- 微单位货币：价格字段使用micros（百万分之一），需单位换算，易出错
适用人群
- 电商运营团队：管理Google Shopping产品Feed、同步库存、调整价格策略
- 数字营销人员：配置促销活动、追踪转化来源、分析竞争定价
- SaaS集成商：构建多租户电商工具，对接客户Merchant Center数据
- 技术开发者：需程序化操作Google Merchant Center的中高级开发者
风险提示
- 密钥安全：
MATON_API_KEY为全局认证凭证，泄露可导致全部连接被滥用；文档明确要求最小权限原则、及时轮换、禁止日志记录 - 写操作确认机制：所有POST/PATCH/DELETE需显式用户批准并展示资源标识符，但实际执行仍依赖调用方（Claude/用户）遵守，无强制拦截
- 业务影响风险：产品删除、促销误配置、库存清零等操作直接影响 live Shopping 列表与销售收入，高影响操作需额外确认
- 连接漂移风险：多账户场景下省略
Maton-Connection头部将落入默认连接，可能导致数据写入错误账户 - 注册状态监控：开发者注册为一次性但账户状态可能变更，401错误需人工排查注册状态