开始使用

借助 Manufacturer Center (MfC) API,应用可以直接与 Manufacturer Center 平台互动。为了帮助您入门,我们提供了 Java 和 .NET 版本的代码示例

本指南将帮助您使用 Manufacturer Center API 创建您的首个应用。您需要先完成一些操作,然后才能开始编写代码。

REST 支持

我们的 REST API 支持针对两种不同类型的资源执行基本的 CRUD 操作:

本文档的其余部分将主要为 Product 编写,但对于 ProductCertification,过程应该是类似的。

设置您的 Manufacturer Center 帐号

  1. 创建 Manufacturer Center 帐号

  2. 请务必记住您创建 Manufacturer Center 帐号时所用的电子邮件地址,以备稍后使用。在屏幕截图中,您会看到其表示为 manufacturer_user@example.com

发出第一个 API 请求(无需任何代码!)

  1. 前往 Accounts.Products.list 开发者文档中的 API Explorer

  2. 确保登录的 Google 帐号已列在“设置”标签页的“用户”设置中。

  3. 在 API Explorer 中,确保已在 Authentication(身份验证)下拉菜单中选择 Google OAuth 2.0

  4. 在表单的“父”字段中输入 accounts/{account_id}(将 {account_id} 替换为您 Manufacturer Center 帐号的制造商 ID),然后点击执行

  5. 您应该会看到一条成功响应。恭喜!您已发出第一个 Manufacturer Center API 请求。

  6. 如果您的 Manufacturer Center 中没有任何商品,则列表中不会有任何商品。此时,您可以跳转至其他请求并查看它们的操作。由于这是一个 RESTful API,所有请求的工作方式都类似。有了商品后,下一步就是尝试 Accounts.Products.get

创建 Google API 控制台项目

对 Manufacturer Center API 的请求通过您的 API 控制台项目发出。在这里,假设您将访问自己的 Manufacturer Center 帐号,因此我们建议您使用服务帐号来简化身份验证流程。如需详细了解如何设置新的服务帐号以与您的 Manufacturer Center 帐号搭配使用,请参阅服务帐号指南。

您使用 Java 发出的第一个 API 请求

现在您已经设置了服务帐号并将服务帐号 ID 添加到您的 Manufacturer Center 帐号,接下来可以使用可用的示例代码访问您的帐号。本指南使用 Java 示例演示如何使用 API。

  1. 安装 Apache Maven(如果尚未安装)。

  2. 从 GitHub 页面下载我们的购物示例

  3. java 子目录中,构建 Java 示例:

    $ mvn compile
    
  4. 现在运行 ProductsListSampleProductCertification 示例是 ListProductCertificationsSample)代码:

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
    
  5. 如果您未按照源文件随附的 README 文件中的配置说明进行操作,则会收到错误消息,提示您找不到示例配置。按照 README 中的说明创建配置目录,并为其填充适当的信息。您在设置服务帐号时下载的 JSON 文件应放在该目录中,文件名为 service-account.json。请务必通过设置以下环境变量来告知文件的位置。

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>
    
  6. 现在您已设置了示例配置,请再次运行 ProductsListSample 代码。

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
    
  7. 此时,Java 程序应该执行完成,并输出它找到的商品列表,或者输出你的帐号中没有任何商品的消息。如果您收到“用户无法访问帐号 1234567890”等错误,则很可能是因为您尚未在 Manufacturer Center 中将服务帐号用户设置为授权用户。从 API 的角度来看,API 控制台项目代表不在授权 Manufacturer Center 管理员列表上的用户发送请求,因此当然会拒绝该请求。

  8. 您可以根据需要多次尝试运行 ProductsListSample,因为它是只读请求。您还可以探索我们为 Java 和 .NET 创建的其他示例。