开始使用

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

本指南将帮助您使用 Manufacturer Center API 创建您的第一个应用。在开始编码之前，您需要做一些准备工作。

REST 支持

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

• 面向品牌所有者和数据合作伙伴的产品。
• 以及 ProductCertification 以供认证机构使用。

本文档的其余部分将主要针对 Product 产品，但针对 ProductCertification 的流程应与此类似。

设置您的 Manufacturer Center 账号

1. 创建 Manufacturer Center 账号。

   注意 ：认证正文用户无法以这种方式创建帐号，但需要直接与我们的支持团队联系。

2. 请务必记住您用于创建此 Manufacturer Center 帐号的电子邮件地址，因为稍后您会用到该信息。在屏幕截图中，您会看到其表示为 [e-mail]。

发出您的第一个 API 请求（无需任何代码！）

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

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

   

3. 在 APIs Explorer 中，确保在 Authentication 下拉菜单中选择 Google OAuth 2.0：

   

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

   

   注意 ：如果您之前未授予 OAuth2 权限，现在系统会要求您授权调用。

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

6. 如果您的 Manufacturer Center 中还没有任何商品，此列表中就不会显示任何商品。此时，您可以跳转到其他请求并查看它们的用途。由于这是一个 RESTful API，因此所有请求都以类似的方式运行。有了产品后，接下来不妨试用 Accounts.Products.get。

创建 Google API 控制台项目

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

注意 ：如果您有兴趣代表客户使用自己的 Manufacturer Center 帐号进行调用，请参阅授权请求指南。

您的第一个已获授权的 API 请求（使用 Java）

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

1. 安装 Apache Maven（如果尚未安装）。

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

3. 在 java 子目录中，构建 Java 示例：

   $ mvn compile
   

4. 现在，运行 ProductsListSample（ProductCertification 示例为 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 创建的其他示例。