设置客户端库

欢迎使用 Merchant API（Beta 版），它是 Content API for Shopping 的官方后继者。

获取 Merchant API（Beta 版）的最新动态，包括新功能、 bug 修复和版本更新。

了解如何在 Google 上管理您的商家和产品，以及如何通过程序化方式大规模访问数据、数据分析和独特功能。立即开始使用

我们建议您使用 Google API 客户端库设置 Content API for Shopping。本指南使用 Python Content API 客户端库作为示例，但这些库适用于许多常用编程语言，可简化身份验证、发送请求和解析响应等常见 API 任务。如需有关为其他语言设置客户端库的帮助，请参阅 GitHub 上 googleads/googleads-shopping-samples 代码库中相应语言的 README.md。

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

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

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

   ~/shopping-samples/content/

   注意： 此路径以及在第 5 步中创建的 merchant-info.json 文件的文件名在第 7 步中下载的 Content API 示例目录下的 python/shopping/content/common.py 文件中定义。

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

   1. 前往 Google API 库。
   2. 在页面顶部的菜单中选择一个项目。如果您尚未创建任何项目，请点击 New project（新建项目），创建一个项目。
   3. 如果您还没有为此项目启用 Content API for Shopping，请在 Google API 列表中搜索并启用它。
   4. 在左侧边栏中，选择 Credentials。您可能需要点击左上角的向左箭头才能看到此信息。
   5. 如需设置服务账号，请依次选择 Create credentials（创建凭据）和 Service account（服务账号）。
   6. 为新服务账号命名。这也用作服务账号 ID 的默认用户名。记录服务账号 ID（包括“@”字符后面的部分），以备日后使用。点击创建，然后完成向项目和用户授予访问权限的可选步骤，最后点击完成。
   7. 您将转到“服务账号”页面，您可以在该页面中访问您的新服务账号。

3. 如需获取 JSON 私钥，请点击相应服务账号，然后点击密钥标签页。依次点击添加密钥 > 创建新密钥，然后选择 JSON 作为密钥类型。点击创建将私钥下载到您的计算机。系统会自动下载新密钥。

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

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

5. 将 service-account.json 文件移至 home directory/shopping-samples/content/。

6. 在 home directory/shopping-samples/content/ 中，创建一个空的 merchant-info.json 文件。

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

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

8. 将新服务账号作为用户添加到您的 Merchant Center 账号中。如果您是第三方开发者，则需要将您的客户端设置为自动执行此步骤。

   1. 前往您的 Merchant Center 账号。
   2. 在 Merchant Center 账号的“设置”中，选择用户和访问权限。

   3. 点击 + 添加人员，然后将服务账号 ID 用作新用户的电子邮件地址。

      注意 ：如果您之前未记下服务账号 ID，请前往“服务账号”管理页面，然后选择您创建的项目。

   4. 使用 Accounts 服务需要管理员访问权限，因此请选择管理员。

   5. 点击添加用户以保存偏好设置，然后返回用户列表。服务账号 ID 会与所选用户角色一起列出。

   6. 对您要添加的其他所有服务账号重复执行上述流程。

9. 将 googleads/googleads-shopping-samples GitHub 代码库克隆（或下载并解压缩）到计算机上的任意位置；该代码库不必位于您的主目录或 ~/shopping-samples/content/ 中。

10. 如果您下载并解压缩了代码库（而不是克隆），请将解压缩的目录重命名为 googleads-shopping-samples。

11. 如需安装所需的示例依赖项，请在终端窗口中前往 googleads-shopping-samples/python/ 并运行以下命令：

    pip install -r requirements.txt
    

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