Google Merchant Center

核心功能

Google Merchant Center 技能提供完整的 Google Shopping 生态 API 访问能力，通过 Maton 托管 OAuth 简化认证流程，覆盖商品、库存、数据源、促销、报告等 8 大子 API。

核心能力矩阵

| 模块 | 关键操作 | 典型场景 |

|---------|---------|---------|

| **Products** | 增删改查商品目录 | 批量上架、价格更新、状态监控 |

| **Inventories** | 本地/区域库存管理 | 门店库存同步、区域定价 |

| **DataSources** | 数据源配置 | API 数据源创建、Feed 刷新 |

| **Reports** | 性能分析与洞察 | CTR 分析、价格竞争力、热销趋势 |

| **Promotions** | 促销活动管理 | 折扣码配置、生效周期控制 |

| **Notifications** | 实时状态变更推送 | 商品审核状态 webhook |

| **Conversions** | 转化追踪配置 | 归因模型设置、ROAS 分析 |

显著优势

1. 托管 OAuth：无需自建 GCP 项目，Maton 处理 token 生命周期
2. 模块化设计：8 个独立子 API，按需调用避免权限浪费
3. SQL 式报告：类 SQL 查询语言（product_performance_view 等），降低数据分析门槛
4. 多账户支持：通过 Maton-Connection 头管理多个 Merchant Center 账户

主要局限

• 强制注册步骤：v1 API 需一次性 registerGcp 开发者注册，新账户无法即开即用
• 数据源类型限制：商品仅可写入 input: "API" 类型数据源，需预先配置
• 促销准入门槛：Promotions API 要求账户预先 enrolled，否则返回 403
• 微单位货币：金额需用 amountMicros（×10⁶），增加计算复杂度
• 延迟可见性：商品插入后需数分钟才能在 processed product 中查询

适用人群

• 电商运营团队：需要自动化 Google Shopping Feed 管理
• DTC 品牌方：多区域定价、本地库存（Local Inventory Ads）场景
• 营销代理商：托管多个客户 Merchant Center 账户，需统一 API 接入
• 数据分析师：需通过 Reports API 获取结构化购物广告表现数据

常规风险提示

• 认证链依赖：需同时维护 Maton API Key + Google OAuth 双凭证，任一失效即中断
• 403 权限迷雾：Google 的账户/程序权限体系复杂，错误信息常指向不明（如 MCA 专属接口误用）
• Webhook 可靠性：Notifications 依赖自建回调端点，需处理重试与幂等
• 数据合规：商品数据上传受 Google Shopping 政策约束，违规可能导致账户封禁

核心用法

该 Skill 提供 Google Merchant Center API 的托管式接入能力，通过 Maton API 网关 (gateway.maton.ai) 代理所有请求，用户仅需配置 MATON_API_KEY 环境变量即可调用完整的 Merchant API 功能模块。

主要功能模块：

• Products：商品目录的增删改查（productInputs:insert / products:list）
• Inventories：本地库存与区域库存管理
• DataSources：API 数据源配置与文件源刷新
• Reports：商品表现查询（clicks、impressions）、价格竞争力分析
• Promotions：促销活动管理（需提前 enroll 该 program）
• Accounts/Notifications：账户设置、用户权限、Webhook 订阅

关键前置步骤：
1. 注册 Maton 账号获取 MATON_API_KEY
2. 在 Google Merchant Center 完成一次性开发者注册（developerRegistration:registerGcp）
3. 创建 OAuth Connection 并授权（ctrl.maton.ai/connections）

---

显著优点

| 优势 | 说明 |

|------|------|

| **零 OAuth 代码实现** | Maton 托管 OAuth 流程，用户无需处理 token 刷新、scope 协商 |

| **模块化 API 覆盖** | 完整对接 v1 API 的 8 个子系统（products/accounts/reports/promotions 等） |

| **多语言示例** | 提供 Python、JavaScript、cURL 可直接运行的代码片段 |

| **连接管理灵活** | 支持多账号场景，通过 `Maton-Connection` header 指定特定连接 |

| **报告查询能力** | 支持标准 SQL-like 查询（如 `product_performance_view`、`price_competitiveness_product_view`）|

---

潜在缺点与局限性

1. 第三方网关依赖：所有数据流经 Maton 服务器（gateway.maton.ai），存在供应商锁定和数据驻留信任问题
2. 开发者注册门槛：Google v1 API 强制要求一次性 registerGcp 调用，失败则返回 401
3. 数据源类型限制：productInputs:insert 仅支持 input: "API" 类型的数据源，需预先创建
4. 促销功能需 enroll：Promotions API 返回 403 若账户未加入该计划
5. Local Inventory 限制：仅适用于 LOCAL channel 商品，与 ONLINE 商品互斥
6. 延迟问题：产品插入后需数分钟才能在 processed product 中体现

---

适合人群

• DTC 品牌运营团队：需要自动化商品上架、库存同步、价格监控
• 跨境电商卖家：管理多国站点商品数据（利用 feedLabel 区分市场）
• 电商 SaaS 开发者：构建基于 Google Shopping 的第三方工具
• 数据分析师：定期拉取 product_performance_view 进行 ROI 分析

---

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| **供应链/供应商风险** | Maton 作为商业网关，若服务中断或政策变更将影响可用性 | 保留直接调用 Google API 的 fallback 方案 |

| **密钥泄露风险** | `MATON_API_KEY` 泄露可导致商户数据被窃取 | 使用密钥管理系统，避免提交到 Git |

| **数据隐私合规** | 商品数据、销售报告流经第三方 | 评估 Maton DPA（数据处理协议）是否符合 GDPR/CCPA 要求 |

| **Google 政策变更** | Merchant API 频繁迭代，v1beta 已弃用 | 关注 [Google Merchant API 更新日志](https://developers.google.com/merchant/api/release-notes) |

| **误操作风险** | `DELETE` 操作不可逆，且无回收站机制 | 生产环境操作前先在 sandbox 账户测试 |