设置客户端库

欢迎推出 Merchant API 的 Beta 版。这是 Content API for Shopping 及未来。

有关 Merchant API 如何改进您的集成以及如何帮助塑造 请参阅发布 Merchant API Beta 版。

我们建议使用 Google API 客户端库， 如何启用 Content API for Shopping。本指南使用的是 Python Content API 客户端 库是一个示例，但它们可用于许多热门编程， 并简化常见的 API 任务，例如身份验证、发送请求、 和解析响应。如需有关为 Cloud Storage 设置客户端库的帮助， 请参阅 README.md，了解 googleads/googleads-shopping-samples 代码库。

注意 ：您需要安装几个必需的库，以便在 Python。因此，我们建议创建一个 Python 虚拟环境， 然后再继续操作。如需了解详情，请参阅 使用 pip 和虚拟环境安装软件包。

如需设置适用于 Python 的 Google API 客户端库，请完成以下步骤：

1. 为客户端库的配置和身份验证创建目录 文件。在您的主目录中，创建以下目录：

   ~/shopping-samples/content/

   注意 ：此路径以及 merchant-info.json 文件的文件名 python/shopping/content/common.py 文件（位于第 7 步中下载的 Content API 示例目录中）。

2. 如需下载服务账号凭据，请完成以下步骤：

   1. 在 Merchant Center 的设置菜单中： 选择 Content API。
   2. 点击身份验证。
   3. 点击 [+] 创建 API 密钥。
   4. 如果出现提示，请阅读并接受服务协议条款。

   系统会自动下载新密钥。

3. 将下载的凭据文件重命名为 service-account.json。

   注意 ：此文件名在 _Constants.py 文件中定义，位于 在 Content API 示例目录下的 python/shopping/content/ 中 在第 7 步中下载。

4. 将 service-account.json 文件移动到 home directory/shopping-samples/content/.

5. 在您的 home directory/shopping-samples/content/ 中，创建 merchant-info.json 文件为空。

6. 在 merchant-info.json 中，添加以下文本：

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

7. 克隆（或下载并解压缩） googleads/googleads-shopping-samples 将 GitHub 代码库复制到计算机上的任意位置；它不必位于 或位于 ~/shopping-samples/content/ 下。

8. 如果您下载并解压缩了代码库，请不要克隆，而是重命名 解压缩到 googleads-shopping-samples。

9. 要安装所需的示例依赖项，请在终端窗口中执行以下操作： 转至 googleads-shopping-samples/python/，然后运行以下命令：

   pip install -r requirements.txt
   

现在，您已经配置了适用于 Python 的 Google API 客户端库，可以用于 Content API 了。在下一部分中，您将创建并发送插入新商品的请求。