借助 Manufacturer Center (MfC) API,应用可以直接与 Manufacturer Center 平台互动。为了帮助您入门,我们提供了 Java 和 .NET 版本的代码示例。
本指南将帮助您使用 Manufacturer Center API 创建您的首个应用。您需要先完成一些操作,然后才能开始编写代码。
REST 支持
我们的 REST API 支持针对两种不同类型的资源执行基本的 CRUD 操作:
- 面向品牌所有者和数据合作伙伴的产品。
- 以及认证机构的 ProductCertification。
本文档的其余部分将主要为 Product 编写,但对于 ProductCertification,过程应该是类似的。
设置您的 Manufacturer Center 帐号
请务必记住您创建 Manufacturer Center 帐号时所用的电子邮件地址,以备稍后使用。在屏幕截图中,您会看到其表示为 manufacturer_user@example.com。
发出第一个 API 请求(无需任何代码!)
前往
Accounts.Products.list
开发者文档中的 API Explorer。确保登录的 Google 帐号已列在“设置”标签页的“用户”设置中。
在 API Explorer 中,确保已在 Authentication(身份验证)下拉菜单中选择 Google OAuth 2.0:
在表单的“父”字段中输入
accounts/{account_id}
(将{account_id}
替换为您 Manufacturer Center 帐号的制造商 ID),然后点击执行。您应该会看到一条成功响应。恭喜!您已发出第一个 Manufacturer Center API 请求。
如果您的 Manufacturer Center 中没有任何商品,则列表中不会有任何商品。此时,您可以跳转至其他请求并查看它们的操作。由于这是一个 RESTful API,所有请求的工作方式都类似。有了商品后,下一步就是尝试
Accounts.Products.get
。
创建 Google API 控制台项目
对 Manufacturer Center API 的请求通过您的 API 控制台项目发出。在这里,假设您将访问自己的 Manufacturer Center 帐号,因此我们建议您使用服务帐号来简化身份验证流程。如需详细了解如何设置新的服务帐号以与您的 Manufacturer Center 帐号搭配使用,请参阅服务帐号指南。
您使用 Java 发出的第一个 API 请求
现在您已经设置了服务帐号并将服务帐号 ID 添加到您的 Manufacturer Center 帐号,接下来可以使用可用的示例代码访问您的帐号。本指南使用 Java 示例演示如何使用 API。
安装 Apache Maven(如果尚未安装)。
从 GitHub 页面下载我们的购物示例。
在
java
子目录中,构建 Java 示例:$ mvn compile
现在运行
ProductsListSample
(ProductCertification 示例是ListProductCertificationsSample
)代码:$ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
如果您未按照源文件随附的 README 文件中的配置说明进行操作,则会收到错误消息,提示您找不到示例配置。按照 README 中的说明创建配置目录,并为其填充适当的信息。您在设置服务帐号时下载的 JSON 文件应放在该目录中,文件名为
service-account.json
。请务必通过设置以下环境变量来告知文件的位置。export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>
现在您已设置了示例配置,请再次运行
ProductsListSample
代码。$ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
此时,Java 程序应该执行完成,并输出它找到的商品列表,或者输出你的帐号中没有任何商品的消息。如果您收到“用户无法访问帐号 1234567890”等错误,则很可能是因为您尚未在 Manufacturer Center 中将服务帐号用户设置为授权用户。从 API 的角度来看,API 控制台项目代表不在授权 Manufacturer Center 管理员列表上的用户发送请求,因此当然会拒绝该请求。
您可以根据需要多次尝试运行
ProductsListSample
,因为它是只读请求。您还可以探索我们为 Java 和 .NET 创建的其他示例。