核心用法
Google Merchant Center Skill 是 Maton 平台提供的 Google Merchant API 托管网关，封装了 OAuth 认证流程，允许用户通过统一的 REST API 接口管理 Google Shopping 业务。核心功能覆盖九大子 API：
- Products：产品目录的增删改查，支持批量插入产品输入（ProductInput）
- Inventories：本地库存（Local Inventory）和区域库存（Regional Inventory）管理
- DataSources：数据源配置，支持 API 类型数据源的创建与即时刷新
- Reports：购物广告性能分析，包括点击率、展示量、价格竞争力、热销商品等视图
- Promotions：促销活动创建与管理
- Accounts：账户设置、用户权限、配送规则、退货政策查询
- Notifications：产品状态变更等事件的 Webhook 订阅
- Conversions：转化追踪源管理
- LFP：本地履约合作（Beta）
认证采用双令牌机制：Maton API Key（MATON_API_KEY）作为平台级凭证，Google OAuth 由 Maton 托管于 ctrl.maton.ai，用户仅需完成一次授权即可长期调用。
显著优点
1. 零 OAuth 开发成本：无需自行处理 Google OAuth 2.0 流程、令牌刷新和密钥存储，大幅降低接入门槛
2. 模块化 API 设计：按业务域拆分为子 API，版本独立（v1/v1beta），便于按需集成
3. 实时业务洞察：Reports API 提供价格竞争力分析、竞品可见度对比等高级数据，支持 SQL 风格查询
4. 库存精细化管理：区分本地门店库存与区域库存，支持 O2O 场景
5. 多连接管理：支持同一 Maton 账户关联多个 Google Merchant 账户，通过 Maton-Connection 头部灵活切换
潜在缺点与局限性
- 平台依赖性：完全依赖 Maton 网关，若 Maton 服务中断或停止运营，现有集成将失效
- 数据延迟：产品插入/更新后需数分钟才能在处理后的产品中生效，非实时同步
- 货币精度限制：价格使用微单位（micros），需额外换算，易因精度问题产生误差
- GCP 项目注册要求：稳定版 v1 API 要求 GCP 项目注册，否则需回退至 v1beta
- 速率限制：共享 Maton 网关配额，高频操作可能触发 429 限流
适合人群
- 电商技术团队：需将 Google Shopping 运营流程自动化的中大型商家
- SaaS 服务商：为客户提供多平台商品同步服务的第三方开发者
- 数据分析师：需定期提取购物广告性能报告进行内部 BI 分析的团队
- 品牌零售商：拥有线下门店，需管理本地库存参与 Google 本地广告（Local Inventory Ads）
常规风险
- 账户权限风险：若 OAuth 授权给了错误的 Google 账户，或账户失去 Merchant Center 管理员权限，API 将返回 403/404
- 数据操作不可逆：产品删除操作立即生效，无回收站机制，误删需重新录入
- 促销时间窗口风险：促销活动需严格校验
promotionEffectiveDates，时区或格式错误可能导致活动未生效或提前结束 - Webhook 可靠性：通知订阅依赖回调 URL 可用性，需自行实现幂等处理和重试逻辑