开始迁移

在此页面中，我们将提供有关规划 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. 测试不同的方法，帮助您快速上手。我们建议使用 Google API Explorer 执行基本测试。

    Merchant API 的请求网址格式为

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

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

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

    我们还在指南中嵌入了代码示例片段。如需查看示例，请参阅添加商品。

  3. 测试简单的用户历程。

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

    • 迁移的资源和调用具有正确的响应结果。
    • 错误率仍然较低。

制定发布计划

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

  • 一次实现一个子 API 或方法。
  • 每次只针对一小部分业务实施。
  • 始终监控是否存在问题。

实施迁移

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

    在对发布计划进行初步测试和开发后，将 Merchant API 集成到您的工作流中。

  2. 监控。

    准备好解决潜在问题。