核心功能
本技能提供 Google Merchant Center API 的完整托管集成，通过 Maton 网关实现 OAuth 认证代理，支持商家对 Google Shopping 生态的全方位数据操作。涵盖 9 大子 API：商品管理（products）、账户设置（accounts）、数据源配置（datasources）、分析报告（reports）、促销活动（promotions）、库存管理（inventories）、通知订阅（notifications）、转化追踪（conversions）以及本地履约（lfp）。
显著优势
1. 零 OAuth 开发成本：无需自建 Google Cloud 项目、配置 OAuth 2.0 流程或管理 token 刷新，Maton 自动处理凭证生命周期
2. 模块化子 API 架构：按需调用特定服务（如仅同步库存或仅拉取报告），避免臃肿集成
3. 类 SQL 报告查询：通过 reports:search 端点使用标准 SQL 查询商品表现、价格竞争力、热销榜单等，无需额外 BI 工具
4. 实时与批量操作兼顾：支持单品 CRUD、批量分页查询，以及数据源级联刷新
5. 多连接管理：同一 Maton 账户可绑定多个 Merchant Center 账户，通过 header 灵活切换
局限与注意事项
- 版本碎片化：各子 API 独立版本（v1/v1beta），部分功能（如 lfp）仍为 beta，生产环境需验证稳定性
- 延迟特性：商品写入后需数分钟才能在 Google 端生效，非实时同步
- 价格精度：采用微单位（micros）存储，需手动除以 1,000,000，易出错
- Product ID 格式复杂：
language~feedLabel~offerId三段式结构，增加了 URL 构造难度 - 网关依赖：所有请求经 Maton 代理，存在额外的网络跳转点和潜在单点故障
适用人群
- 电商运营团队：需要自动化商品上架、库存同步、促销投放
- 营销分析人员：依赖 Google Shopping 广告数据，需要程序化拉取表现报告
- SaaS 工具开发者：构建电商 ERP、PIM 或价格监控工具，需对接 Google Merchant Center
- 多店铺管理者：拥有多个 Merchant Center 账户，需要统一 API 入口
常规风险提示
| 风险类别 | 说明 |
|---------|------|
| 数据一致性 | 异步处理机制可能导致 Maton 端与 Google 端短暂状态不一致 |
| 权限管控 | OAuth scope 较宽，连接一旦建立即获得账户完整操作权限，需妥善保管 Maton API key |
| 费率限制 | 429 错误表明触及 Google API 配额，高频场景需实施指数退避重试 |
| 账户关联 | 误操作 accountId 可能导致请求他人账户数据（403/401 拦截，但仍需仔细核对）|