开始迁移

在此页面中,我们将提供有关规划 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 API 探索器执行基本测试。

    Merchant API 的请求网址的格式为

    https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}
    
  3. 利用我们的代码示例和客户端库。

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

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

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

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

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

制定发布计划

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

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

实施迁移

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

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

  2. 监控。

    准备好解决潜在问题。