开始迁移

本页面提供了有关规划 API 迁移的指导，并概述了所需步骤。

规划迁移

1. 将 Content API for Shopping 方法映射到 Merchant API 方法。

   了解 Merchant API 所需的新方法和资源。

2. 了解适用于您的迁移的最重大变化。

   请参阅以下资源，以便顺利完成迁移：

   • 从 Content API 迁移概览：详细介绍了 Merchant API 中需要注意的主要变化
   • 特定子 API 迁移指南：查看您需要的特定子 API 迁移指南，因为这些指南提供了新字段映射等关键信息。如需查看示例，请参阅迁移商品管理。
   • Merchant API 参考文档提供了 Merchant API 资源和方法的详细信息。
   • 快速入门指南介绍了如何快速开始使用 Merchant API 创建账号并上传示例商品。
   • 功能专用指南：如需了解新功能实现或更多说明，您可以查看导航栏中提供的功能指南。

3. 确定您计划迁移并希望实现的子 API。

   确定以下两点：

   • 您需要迁移的 Merchant API 功能
   • 您要实现的新功能

   完成此操作后，您可以确定工作量和要处理的子 API 的优先级列表。

   如果您最初无法迁移整个 Content API 实现，请根据重要性和复杂性优先迁移以下子 API。

   • 账号
   • 产品
   • 数据源
   • 报告

迁移步骤

1. 注册为开发者 如需使用 Merchant API，您必须在 Google Cloud 项目与主 Merchant Center 账号之间建立关联。 对于您与 Merchant API 搭配使用的每个 Google Cloud 项目，都需要进行一次性注册。您可以在概览页面中跟踪整个流程。

2. 测试不同的方法，帮助您提升效果。我们建议您使用 Google APIs Explorer 执行基本测试。

   Merchant API 的请求网址格式为

   https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}…
   

3. 利用我们的代码示例和客户端库。

   为了帮助缩短实现时间并从 gRPC 中受益，请使用客户端库和代码示例。

   这些指南包含代码示例片段。例如，请参阅添加商品。

4. 测试简单的用户体验历程。

   对您计划迁移的所有子 API 和功能进行用户体验历程测试，目标如下：

   • 迁移后的资源和调用具有正确的响应结果。
   • 错误率保持在较低水平。

制定发布计划

我们建议您采用以下方法：

• 一次实现一个子 API 或方法。
• 一次仅对一小部分业务实施。
• 随时监控问题。

实施迁移

1. 使用新资源和端点进行编码。

   在完成初始测试并制定发布计划后，将 Merchant API 集成到您的工作流中。

2. 监控。

   准备好应对潜在问题。