设置客户端库

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

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

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

    ~/shopping-samples/content/

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

    1. 前往 Google API 库
    2. 在页面顶部的菜单中选择一个项目。如果您还没有账号 不过,请点击 New project 创建一个项目。
    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 了。在下一部分中,您将创建并发送插入新商品的请求。