使用入门

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 帐号的电子邮件，因为稍后您将需要使用该电子邮件。在屏幕截图中，您会看到其显示为 [e-mail]。

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

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

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

   

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

   

   注意：Google API 使用 OAuth 2.0 协议进行身份验证和授权。首先，您需要从 Google API 控制台获取 OAuth 凭据。然后，您的客户端应用会从 Google 授权服务器请求访问令牌，从响应中提取令牌，然后将此令牌发送到您要访问的 Google API。

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 密钥。

   

   注意：如果您之前不同意使用 Google API 所需的服务条款，那么现在系统将会引导您完成此过程。

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

警告：默认情况下，新用户只有标准访问权限，这意味着它将无法使用需要其他访问权限级别的方法。例如，Accounts 服务中的大多数方法都要求用户具有管理员访问权限。您可以在用户设置面板中调整新用户的权限。

如果您已经有一个现成的 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 进行开发的环境。现在，您可以继续了解有关发出请求和最佳做法的详情。