开始使用

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

Manufacturer Center API 可让应用直接与 Manufacturer Center 平台互动。为帮助您顺利开始使用,我们提供了 Java 和 .NET 形式的代码示例

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

设置 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),在表单的“'父级”字段中点击执行

    注意:如果您之前未授予 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 帐号代表客户发起调用,请参阅授权请求指南。

您的首个使用 Java 授权的 API 请求

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

  1. 安装 Apache Maven(如果尚未安装)。
  2. 从我们的 GitHub 页面下载我们的购物广告示例

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

    $ mvn compile
            

  4. 现在,运行 ProductsListSample 代码:

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
            

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

  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 创建的其他示例。