使用 API 集成和 Code Assist 工具包加快迁移到 Merchant API 的速度，并借助 AI 赋能的开发工具构建新的集成。
概览
从 Content API for Shopping 迁移到 Merchant API 或构建新的集成时，您需要了解新的服务结构、资源名称和方法。AI 赋能的开发工具特别适合协助完成以下操作：
- 代码翻译和迁移：帮助您了解旧版 Content API for Shopping 代码并将其转换为新的 Merchant API 格式。这包括将商品属性映射到新结构，以及更新依赖项管理文件。
- API 文档专业知识：根据 Google 官方 API 文档中的权威内容，清晰地说明 Merchant API 资源、方法、字段、配额和最佳实践。
- 代码生成：以 Python、Java、PHP 等语言生成各种 Merchant API 任务的代码段。
- 问题排查：协助诊断和修正常见的 API 错误。
请选择最适合您的开发环境和特定使用情形的选项。使用 API 集成和 Code Assist 工具包，根据您的首选工作流程量身定制设置：
- Merchant API 开发者文档 MCP 服务器，用于直接检索上下文
- Merchant API Agent Skills，用于提供工作流程驱动的指导
下图展示了在最常用的集成式开发环境 (IDE)（例如 Antigravity、Visual Studio Code、Cursor 或 Copilot）中进行 AI 辅助代码迁移的设置选项。您可以设置 Gemini、Claude、ChatGPT、Grok 等编码助理，并使用 Merchant API 开发者文档 MCP 服务器或 Merchant API Agent 技能来增强它们的功能，以便在提高集成速度的同时，使它们能够更贴近实际情况。
Merchant API 开发者文档 MCP 服务器
从您选择的编码助理处获取有关 Merchant API 的情境智能信息。在 IDE 中，您现在可以使用 Model Context Protocol (MCP) 服务访问开发者文档。此服务可从 Google 官方 API 文档中提取关键信息，供您的编码助理使用。如需详细了解该协议本身，请参阅 Model Context Protocol 标准。
运作方式
当您向启用 MCP 的 IDE 编码助理询问有关 Merchant API 的问题时，该服务会从官方资源中检索最相关的文本和代码片段，并使用专门的检索增强生成 (RAG) 后端将这些片段作为上下文返回给编码助理。RAG 系统通过将 LLM 连接到外部的最新知识来源，来提高 LLM 的回答质量。这样一来，您的助理就能提供准确且最新的答案，而您无需离开开发环境。
工作流程示例：
- 您在与 MCP 兼容的编码助理或 Agent 中提出问题（例如，自然语言问题、代码示例请求或代码翻译）。
- 您的编码助理向 MCP 端点发送上下文请求。
- MCP 服务会搜索其已编入索引的官方 Merchant API 文档、指南和代码示例集合。
- 该服务会返回权威的代码段，作为编码助理的上下文。
- 编码助理会利用此上下文生成有依据的回答或代码翻译任务。
使用入门
如需集成和使用 MCP，请按以下步骤操作：
1. 使用兼容的工具
打开支持 Model Context Protocol 且具有可流式传输的 HTTP 传输的 IDE 或编码助理。
2. 配置端点
如需将 IDE 或编码助理连接到 MCP，请使用提供的远程端点详细信息，这些信息可能需要您输入直接服务网址或 MCP 定义，具体取决于您的工具配置：
配置设置：
Antigravity
请按照 Antigravity 文档中的说明操作。
"mcpServers": {
"mapi-devdocs": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://merchantapi.googleapis.com/devdocs/mcp"
]
}
}
Visual Studio Code
请按照 Visual Studio Code 文档中的说明操作。
"servers": {
"mapi-devdocs": {
"type": "http",
"url": "https://merchantapi.googleapis.com/devdocs/mcp/"
}
}
3. 添加代理说明（可选）
如需让智能体使用 MCP 直接翻译代码，请向其提供系统指令：Merchant Integrator Agent Protocol。这些指令会指导代理如何正确使用 MCP 进行代码翻译。根据您使用的工具，您可以在系统指令配置中或以代理的其他上下文的描述文件形式提供这些指令。
使用场景示例
在以下常见使用情形中，MCP 可以加快您的工作流程：
情景 1：迁移 products.insert 代码
您可以让代理直接将 Content API for Shopping products.insert 集成代码迁移到 Merchant API。
用户提示：
“将
products.insert代码迁移到 Merchant API”
通过为代理提供系统指令和 MCP 访问权限，代理可以直接在 IDE 中将 Content API for Shopping 代码转换为 Merchant API 代码。在这种情况下，它会将 productInputs.insert 识别为等效的调用，并将产品属性从旧格式映射到 Merchant API 所需的新格式。它还可以更新必需的导入和依赖项管理文件（例如 requirements.txt、pom.xml 或 package.json）。您可以指示代理就地进行更改或创建新文件夹。
场景 2：查找等效功能
您有一个使用 Content API for Shopping 的现有应用，需要更新该应用。您可以询问有关特定旧版方法的问题，以详细了解新实现和相关代码示例。
用户提示：
“Merchant API 中与 Content API for Shopping 中的 accountstatuses.get 方法等效的方法是什么？”
MCP 服务可提供来自官方迁移指南和参考文档的上下文，让您的助理能够提供详细的回答，包括新的 API 名称 accounts.issues。
方案 3：查找代码示例
您正在实现一项新功能，需要一个可供参考的实用示例。
用户提示：
“向我展示一个使用 Merchant API 添加新配送服务的 Python 代码示例。”
MCP 服务从 Google 官方 GitHub 代码库和开发者指南中检索相关代码示例。然后，Google 助理可以呈现一个完整的、可随时调整的代码块。
方案 4：了解 API 概念
您遇到新概念，或者想了解资源结构或整个 Merchant API 模式。
用户提示：
“如何使用 Merchant API 更新商品的商品目录？”
MCP 服务会返回产品资源文档和相关指南中的上下文。然后，助理可以说明如何使用 accounts.productInputs.insert 方法，并提供仅包含 productId 和您需要更新的与商品目录相关的字段的部分商品资源。
“如何使用 Merchant API 授权我的应用调用？”
MCP 服务会从涵盖不同授权方法的官方身份验证指南中检索上下文。然后，您的助理可以说明可用的主要选项，例如使用服务账号进行服务器到服务器的互动，或者在代表用户执行操作时使用 OAuth 2.0 客户端 ID。
情形 5：适应 API 变更
Merchant API 引入了与 Content API for Shopping 不同的新模式，例如批处理请求。Content API for Shopping 使用特定的 custombatch 方法，而 Merchant API 使用内置的通用 HTTP 批处理功能。
用户提示：
“在 Merchant API 中，执行 products.custombatch 的新方式是什么？”
MCP 服务从重构代码以处理并发请求中检索上下文，说明 Merchant API 中不存在专用 custombatch 方法。相反，它提供了有关使用 HTTP 批处理的文档，其中 Content-Type 为 multipart。然后，您的助理可以说明如何构建包含多个 API 调用的单个 HTTP 请求（发送到 https://merchantapi.googleapis.com/batch/{sub-api}/v1 端点），并提供有关如何构建多部分请求的示例。这样一来，原本可能令人困惑的迁移任务就变成了一个引导式流程。
场景 6：翻译报告查询
您可以让代理将 Content API for Shopping 的报告查询转换为 Merchant API。
用户提示：
“将此报告查询从 Content API 迁移到 Merchant API：SELECT metrics.impressions, metrics.clicks, metrics.ctr FROM MerchantPerformanceView WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'”
MCP 服务会检索最新的报告参考文档、开发者指南和迁移指南。根据这些信息，它会将查询转换为新结构，并将字段更新为新名称和值。
Merchant API Agent Skills
Agent Skills 规范是一种在各种 AI 开发工具中采用的开放标准。使用代理技能来提升您的开发者体验并优化从 Content API for Shopping 迁移和构建新集成这两项工作。Merchant API Agent Skills 软件包包含特定于网域的知识和工具，可增强 AI 智能体 的功能，并为文档查询、代码生成和问题排查提供按需的专家级帮助。
Merchant API 代理技能与各种 AI 赋能的命令行工具和 IDE（例如 Gemini 和 Claude Code）兼容。
运作方式
Merchant API 代理技能基于开放的代理技能标准构建，可提供专业的知识包。我们的代理技能 mapi-developer-assistant 充当 AI 开发工具与底层 Merchant API Dev Doc MCP 服务器之间的智能层。它嵌入了领域专业知识和程序指导，具有以下属性：
- 零配置：自动管理 MCP 服务器连接，无需手动设置端点。
- 专家工作流：将用户提示优化为查询，以便高效获取最相关的信息。
- 上下文管理和 token 效率：使用“逐步披露”按需加载信息，并保留 AI 的上下文窗口。
- 增强型输出格式设置：提供有关如何设置输出格式和结构以生成可操作、可读且一致的回答的说明。
工作流程示例：
- 您在 AI 开发工具中询问有关 Merchant API 的问题。
- Merchant API Agent Skill 会分析您的意图，制定精确的查询，并将程序性知识应用于请求。
- 代理技能向位于
merchantapi.googleapis.com/devdocs/mcp/的 Merchant API Dev Doc MCP 服务器发送上下文请求。 - MCP 服务会搜索其已编入索引的官方 Merchant API 文档、指南和代码示例集合。
- AI 代理会利用这些信息提供合成的切实可行的回答。
使用入门
商家 API 代理技能 README 提供了有关以下方面的分步指南：
- 使用 Gemini 命令行工具等工具的前提条件。
- 在所选工具中启用智能体技能支持。
- 按照 README 的说明，从 GitHub 代码库安装
mapi-developer-assistant技能。 - 验证安装。
- 基本技能管理命令。
如需详细了解各种 AI 工具（包括 Gemini 命令行工具、Claude Code 等）的安装和设置说明，请按照 README 文件中的指南操作。
示例提示
在 AI 开发工具中安装并启用 mapi-developer-assistant 技能后，当您提出与 Merchant API 相关的问题时，该技能通常会自动激活。
“如何在 Python 中使用 Merchant API 插入商品？”
“Merchant API 中与 Content API
accountstatuses.get方法等效的方法是什么？”
“请展示一个使用 Merchant API 处理身份验证的 Java 示例。”
“在调用
productInputs.insert时，我收到了‘400 无效请求’错误，并显示验证错误。如何解决此问题？"
“Merchant API 中的
ProductInput和Product有何区别？”
知识库来源
MCP 服务仅从公开和官方来源构建知识库，以确保其提供的上下文准确可靠。该服务会为官方开发者网站和代码示例代码库的全部内容编制索引，包括：
- Merchant API 开发者网站： 所有指南、参考资料和文档。
- Merchant API Apps 脚本服务： Apps 脚本中的 Merchant API 用法示例。
- 官方代码示例：GitHub 代码库中所有由 Google 提供的 Merchant API 官方代码示例。
- 客户端库：Merchant API 支持的所有官方客户端库。