使用入门

Content API for Shopping 可让应用直接与 Merchant Center 平台互动，大幅提高大型或复杂 Merchant Center 帐号的管理效率。一些典型的用例包括：

  • 自动帐号管理
  • 基于每个商品的商品管理
  • Datafeed 规划
  • 管理复杂的税费和运费设置

您可以使用 Content API for Shopping 来构建软件以管理客户级至商品级的帐号。Merchant Center 网站能做到的 API 基本上都能做到，而且是以编程方式做到。为了帮助您入门，我们提供了用 Java、.NET、Python、PHP、Ruby 和 Go 编写的代码示例。

本指南将帮助您使用 Content API 来创建您的首个应用。在您开始编码之前，您需要执行以下几项操作。

设置您的 Merchant Center 帐号

  1. 创建一个 Merchant Center 帐号。

  2. 验证网站网址并声明所有权。

  3. 配置您的税费和运费设置。

  4. 请务必记住您用于创建此 Merchant Center 帐号的电子邮件，因为稍后您将需要使用该电子邮件。在屏幕截图中，您会看到其显示为 merchant_user@example.com。

发出首个 API 请求（无需任何代码！）

  1. 在我们的 Products.list 开发者文档中访问 API Explorer。

  2. 确保登录的 Google 帐号列在 Users 设置（可从溢出菜单访问）中。

  3. 在 API Explorer 中，确保 Authentication 设置显示为 Google OAuth 2.0：

  4. 点击 Accept，可授权 Google 创建的 API 控制台项目代表您临时访问您的 Merchant Center 帐号，从而发出一个 API 请求。请注意，此屏幕应来自 google.com，而且您应该使用 Merchant Center 电子邮件地址登录。

  5. 将 Merchant Center 帐号中的商家 ID 输入到表单的 merchantId 字段中，然后点击 Execute。

    >

  6. 您应该会看到一个成功响应。恭喜！您已经发出首个购物 API 请求。

  7. 如果您的 Merchant Center 中还没有商品，则列表中不会有任何商品。但您无需担心，我们很快就会添加一些商品。此时，您可以跳到其他请求并查看它们的功能。由于这是一个 RESTful API，因此所有请求的工作方式都相似。接下来的步骤最好包括 Products.insert、Inventory.set 和 Accountstatuses.get。

检索用于身份验证的服务帐号密钥

Merchant Center 可以自动为您创建一个 Google API 控制台项目和关联的服务帐号密钥。使用 Content API for Shopping 时，您的应用将使用此密钥进行身份验证。

  1. 从 Merchant Center 的三点状菜单中选择 Content API。

  2. 选择 Authentication 标签页。

  3. 点击 + 按钮，可以创建新的 API 密钥。

创建新的 API 控制台项目，并且在该项目中创建新的服务帐号之后，该服务帐号 ID 将作为新用户添加到您的 Merchant Center 帐号中。此外，您的浏览器将自动下载包含服务帐号密钥的 JSON 文件。如果您丢失此文件，则无法重新下载，但您可以重复上述过程创建一个新的密钥。

如果您已经有一个现成的 API 控制台项目并且想要改用该项目，那么以下是您为现成项目设置 Content API 访问权限的具体操作。

  • 如果您要访问自己的 Merchant Center 帐号，我们建议您使用服务帐号来简化身份验证流程。有关如何设置新服务帐号的详细信息，请查看服务帐号指南。创建帐号后，您已下载并存储的服务帐号密钥将用于身份验证，您可以接收调用 API 所需的 API 令牌。

  • 如果您有兴趣代表客户使用其自己的 Merchant Center 帐号进行调用，请参阅授权请求指南。但是，如果为了试用 Content API，我们建议您设置一个测试帐号，并使用它直到完成开发。

使用 Python 实现首个获授权的 API 请求

您拥有服务帐号密钥之后，就可以使用可用的示例代码访问您的帐号。本指南将借助 Python 示例演示如何使用 API。

  1. 从我们的 GitHub 页面下载 Python 示例。

  2. 在 python 目录中，使用 PIP 安装所需的软件包依赖项。随附的 README.md 文件中提供了更详细的说明。 

    pip install -r requirements.txt

  3. 运行 shopping/content/products/list.py 文件，类似于我们之前在 API 沙盒中所执行的操作。 

    python -m shopping.content.products.list

  4. 如果您没有按照源文件随附的 README 文件中的配置说明进行操作，则会收到错误消息，指出无法找到示例配置。按照 README 文件中的说明创建配置目录，并在其中填写适当的信息。您在设置服务帐号时下载的 JSON 文件应放在该目录中，文件名为 service-account.json。

  5. 设置了示例配置之后，请再次运行 shopping/content/products/list.py。 

    python -m shopping.content.products.list

  6. 此时，Python 脚本应该完成执行操作，然后打印出它找到的商品列表，或者打印出您的帐号中没有商品的消息。如果您收到“用户无法访问帐号 1234567890”等错误消息，则很可能是因为您尚未将该服务帐号用户设置为 Merchant Center 中的授权用户。从 API 的角度来看，API 控制台项目代表发送请求的用户不在获授权的 Merchant Center 管理员列表中，因此 Merchant Center 当然会拒绝该请求。

  7. 您可以根据需要多次尝试运行 shopping/content/products/list.py，因为它是一个只读请求。您还可以浏览我们为 Python 和其他语言创建的许多其他示例。

此时，您已经有了一个非常适合使用 Content API for Shopping 进行开发的环境。现在，您可以继续了解有关发出请求和最佳做法的详情。