核心用法
Google Merchant Center Skill 通过 Maton 代理层封装了 Google Merchant API v1 的全套能力，采用托管式 OAuth 解决开发者注册、Token 刷新等繁琐流程。用户仅需配置 MATON_API_KEY 环境变量，即可调用涵盖 8 大子 API 的接口：Products（商品管理）、Accounts（账户与用户）、DataSources（数据源配置）、Reports（业绩分析）、Promotions（促销活动）、Inventories（本地/区域库存）、Notifications（Webhook 订阅）、Conversions（转化追踪）。
典型工作流包括：1) 通过 accounts 端点获取账户 ID；2) 完成一次性开发者注册（registerGcp）；3) 创建 API 类型数据源；4) 批量插入商品（productInputs:insert）；5) 查询业绩报告优化投放。所有请求通过 Authorization: Bearer $MATON_API_KEY 鉴权，支持多连接场景下的 Maton-Connection 头部分流。
显著优点
- 零 OAuth 维护成本：Maton 自动处理 Google OAuth 2.0 流程、Token 刷新及权限校验，开发者无需搭建授权服务器。
- 模块化子 API 设计：清晰拆分商品、库存、报告等域，便于按需调用和权限最小化。
- SQL 式报告查询：Reports 子 API 支持类 SQL 语法（
SELECT offer_id, clicks FROM product_performance_view），灵活提取购物广告数据。 - 实时通知能力：支持
PRODUCT_STATUS_CHANGE等事件的 Webhook 订阅，实现商品状态变更的即时响应。
潜在缺点与局限性
- 强制开发者注册门槛：每个 Merchant Center 账户首次使用 v1 API 前必须调用
registerGcp完成注册，且需等待 Google 侧同步，增加冷启动复杂度。 - 数据源类型限制：仅
input: "API"类型的数据源支持写入操作，文件型数据源需通过 Merchant Center UI 或文件上传变更。 - 地域与渠道限制：本地库存（Local Inventories）仅对
LOCAL渠道商品有效；促销 API 需账户额外 enrolled Promotions Program。 - 微单位（Micros）认知负担：金额字段统一使用微单位（×1,000,000），易因单位换算错误导致定价异常。
适合人群
- DTC 品牌与独立站运营团队：需批量同步 Shopify/WooCommerce 商品至 Google Shopping。
- 广告代理与电商代运营：管理多客户（MCA）账户，自动化报告拉取与异常监控。
- Martech 开发者：构建内部 ERP 与 Google Merchant Center 的双向同步管道。
常规风险
- 误操作风险：Skill 明确声明「所有写操作需用户显式确认」，但自动化脚本若未加二次确认机制，可能导致商品误删或促销误设。
- 数据隐私合规：通过 Maton 代理转发请求，商品数据流经第三方基础设施，需评估 GDPR/CCPA 下的数据处理协议（DPA）覆盖情况。
- 速率限制与配额：Google Merchant API 存在调用配额，高频同步场景需实现指数退避及分页拉取（
pageToken）机制，避免 429 错误导致同步中断。 - 开发者注册单点故障：若
registerGcp因 Google 侧延迟或邮箱验证问题失败，将阻塞全量 API 使用，建议预留手动兜底方案（Merchant Center UI 操作）。