核心用法
本 Skill 为纯文档型 API 集成指南，通过 Maton 代理网关提供对 Google Merchant Center API 的完整访问能力。用户需先完成开发者注册（一次性）并建立 OAuth 连接，即可通过标准 REST API 调用管理商品目录、库存数据、促销活动、数据源配置、账户设置及转化跟踪等八大模块。
使用流程分为三步：首先获取 Maton API Key 并配置环境变量；其次完成 Google Merchant Center 开发者注册（调用 registerGcp 端点关联 GCP 项目）；最后创建 OAuth 连接并获取 connection_id 用于后续请求。所有 API 调用均通过 https://api.maton.ai/google-merchant/{sub-api}/v1/ 统一入口，由 Maton 自动注入 OAuth Token 完成身份验证。
支持的关键操作包括：商品 CRUD（需指定 API 类型数据源）、本地/区域库存管理、促销创建（需账户 enrolled）、SQL 风格报告查询（如产品表现分析）、Webhook 通知订阅，以及多账户管理（MCA）。写操作强制要求用户显式确认目标资源标识及操作后果。
显著优点
1. 托管 OAuth 简化集成：无需自行处理 Google OAuth 2.0 复杂流程，Maton 提供完整的连接生命周期管理（创建、查询、删除、指定默认连接）。
2. 模块化 API 设计：八大子 API（products/accounts/datasources 等）结构清晰，版本统一为 v1，学习成本低。
3. 企业级功能覆盖：支持 Google Shopping 全链路运营——从商品上架、库存同步、促销配置到转化归因，满足中大型商家需求。
4. 安全设计严谨：明确区分读写权限，所有修改操作强制二次确认；支持最小权限原则配置；提供详细错误码对照表与故障排查指南。
5. 零依赖零维护：纯文档型 Skill，无第三方库依赖，无需担心供应链攻击或版本冲突。
潜在缺点与局限性
1. 前置门槛较高：需完成 Google 开发者注册、Maton 账户开通、OAuth 授权三步准备，新手可能遇到 401/403 等配置错误。
2. 实时性限制：商品插入后需数分钟才能在 processed product 中生效，不适合需要秒级同步的场景。
3. 功能依赖前提：促销 API 需账户 enrolled Promotions 项目；本地库存仅支持 LOCAL 渠道商品；子账户列表仅 MCA 可用。
4. 数据格式特殊：金额使用 micros（需除以 1,000,000）、productId 采用 语言~地区~SKU 复合格式，增加集成复杂度。
5. 网络依赖单一：所有流量经由 Maton 代理，若 Maton 服务不可用则完全中断，无直连 Google 的 fallback 方案。
适合的目标群体
- 跨境电商运营团队：管理多地区 Google Shopping Feed，需批量同步商品与库存。
- 电商 SaaS 开发者：构建 ERP/PIM 与 Google Merchant Center 的双向数据同步。
- 数字营销代理机构：为客户配置促销、监控产品表现、生成投放优化报告。
- 独立站技术负责人：希望自动化管理 Google Shopping 商品流，减少人工 Merchant Center 操作。
常规使用风险
- 密钥泄露风险：
MATON_API_KEY泄露可导致账户数据被非法访问，需严格环境变量管理并定期轮换。 - 误操作风险：批量删除商品、修改数据源配置或运费设置可能直接影响线上销售，务必先在只读模式验证资源标识。
- Google 政策合规：商品数据需符合 Google 产品数据规范，违规可能导致账户 suspension。
- Rate Limit 限制：高频调用可能触发 429 错误，生产环境需实现指数退避重试机制。
- Maton 服务依赖：连接管理、OAuth Token 刷新均依赖 Maton 基础设施，需关注其服务状态公告。