Google Merchant Center

核心功能

Google Merchant Center API的托管式OAuth集成，通过Maton网关代理访问Google官方Merchant API。支持产品目录管理、库存同步、促销配置、数据源管理、账户设置及转化追踪等全链路电商运营操作。

显著优势

• 官方API直连：底层调用merchantapi.googleapis.com，非爬虫方案，数据实时性与可靠性有保障
• OAuth托管：Maton集中管理授权令牌，用户无需处理Token刷新与存储
• 完整写能力：支持产品创建/更新/删除、库存调整、促销设置等全CRUD操作
• 模块化设计：按业务域划分为products/accounts/datasources/reports/promotions/inventories等子API，结构清晰
• 多连接管理：支持多Merchant账户切换，通过Maton-Connection头部显式指定目标账户

潜在局限

• 前置门槛：需完成一次性开发者注册（registerGcp）才能使用v1端点，新用户有额外配置成本
• API数据源限制：产品写入仅限input: "API"类型数据源，需预先创建对应数据源
• 程序准入：促销功能需账户单独 enrolled，部分高级报告需Market Insights订阅
• 渠道隔离：本地库存（Local Inventories）与在线库存（Online）完全分离，无法跨通道操作
• 微单位货币：价格字段使用micros（百万分之一），需单位换算，易出错

适用人群

• 电商运营团队：管理Google Shopping产品Feed、同步库存、调整价格策略
• 数字营销人员：配置促销活动、追踪转化来源、分析竞争定价
• SaaS集成商：构建多租户电商工具，对接客户Merchant Center数据
• 技术开发者：需程序化操作Google Merchant Center的中高级开发者

风险提示

• 密钥安全：MATON_API_KEY为全局认证凭证，泄露可导致全部连接被滥用；文档明确要求最小权限原则、及时轮换、禁止日志记录
• 写操作确认机制：所有POST/PATCH/DELETE需显式用户批准并展示资源标识符，但实际执行仍依赖调用方（Claude/用户）遵守，无强制拦截
• 业务影响风险：产品删除、促销误配置、库存清零等操作直接影响 live Shopping 列表与销售收入，高影响操作需额外确认
• 连接漂移风险：多账户场景下省略Maton-Connection头部将落入默认连接，可能导致数据写入错误账户
• 注册状态监控：开发者注册为一次性但账户状态可能变更，401错误需人工排查注册状态

Google Merchant Center 集成能力评估

核心用法

本 Skill 通过 Maton 平台提供 Google Merchant Center API 的托管式 OAuth 集成，支持对 Google Shopping 业务的完整管理能力。核心功能覆盖八大子 API：

• products — 商品目录的增删改查，支持通过 productInputs:insert 批量上架
• inventories — 本地库存（LOCAL 渠道）和区域库存管理
• datasources — 数据源配置，支持 API 类型数据源的创建与维护
• reports — 业绩分析报表，包括 product_performance_view（点击/曝光）和 product_view（库存状态）
• promotions — 促销活动管理（需账户 enrolled）
• accounts — 账户设置、配送规则、用户信息管理
• notifications — Webhook 订阅，监听商品状态变更
• conversions — 转化追踪配置

技术接入需完成一次性开发者注册（registerGcp），之后所有 v1 端点可用。认证采用双层机制：Maton API Key（MATON_API_KEY）+ Google OAuth，写操作需显式用户确认。

显著优点

1. 官方渠道可信：通过 Maton 代理直连 merchantapi.googleapis.com，TLS 1.2+ 加密，符合 Google 官方规范
2. 功能完整度高：覆盖从商品上架、库存同步到转化追踪的全链路，替代手动 Merchant Center 操作
3. 安全设计规范：明确区分读写权限，所有 POST/PATCH/DELETE 强制要求资源标识确认，降低误操作风险
4. 多账户支持：通过 Maton-Connection Header 管理多个 Merchant Center 连接，适合代运营场景
5. 实时事件通知：支持 PRODUCT_STATUS_CHANGE 等事件的 Webhook 订阅，便于构建自动化工作流

潜在局限与风险

| 局限 | 说明 |

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

开发者注册门槛 | 每个 Merchant Center 账户需手动完成 registerGcp，增加首次配置成本 |

| **Promotions 权限限制** | 促销 API 需账户提前 enrolled，否则返回 403 |

| **数据延迟** | 商品插入后需数分钟才能在 processed product 中体现 |

| **单位复杂度** | 货币值使用 micros（需除以 1,000,000），产品 ID 格式为 `lang~label~offerId`，易出错 |

| **渠道隔离** | Local inventories 仅支持 LOCAL 渠道产品，与 ONLINE 产品数据不互通 |

适合人群

• 电商运营团队：需批量管理数千 SKU 的 Google Shopping 上架与价格更新
• 跨境卖家：多市场（US/EU）账户的统一库存与配送规则管理
• Google Ads 代理商：代管多个客户 Merchant Center 账户的自动化报表与优化
• 技术集成商：需将 Merchant Center 数据同步至内部 ERP/Business Intelligence 系统

常规风险

• API Key 泄露风险：MATON_API_KEY 一旦泄露，攻击者可访问所有关联的 Merchant Center 数据。必须环境变量存储、定期轮换
• 误操作影响业务：删除数据源或更新配送设置可能导致广告停投，写操作前务必二次确认
• OAuth 授权范围：过度授权可能导致非预期数据访问，建议定期审计 Maton 连接权限
• 依赖 Maton 服务可用性：代理层故障将中断所有 API 调用，需设计降级方案

安全认证结论

安全评级 S 级（100 分），T2 来源可信度。本 Skill 为纯文档型集成指南，无可执行代码，无敏感信息硬编码，通过六维安全检测（静态分析、动态行为、依赖审计、网络流量、隐私合规、威胁情报）零风险项。