设置客户端库

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

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

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

   ~/shopping-samples/content/

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。

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 用作新用户的电子邮件地址。

   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 搭配使用了。在下一部分中，您将创建并发送请求以插入新商品。