设置客户端库

建议您使用 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. 在页面顶部的菜单中选择一个项目。如果您还没有项目,请点击新项目创建一个项目。
    3. 如果您还没有为此项目启用 Content API for Shopping,请在 Google API 列表中搜索并启用它。
    4. 在左侧边栏中,选择凭据。您可能需要点击左上角的左箭头才能看到此信息。
    5. 如需设置服务账号,请选择创建凭据,然后选择服务账号
    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 搭配使用。在下一部分中,您将创建并发送请求以插入新商品。