我们建议使用 Google API 客户端库, 如何启用 Content API for Shopping。本指南使用的是 Python Content API 客户端 库为例,但它们可用于许多热门编程, 并简化常见的 API 任务,例如身份验证、发送请求、 和解析响应。如需有关为 Cloud Storage 设置客户端库的帮助, 请参阅 README.md,了解 googleads/googleads-shopping-samples 代码库。
如需设置适用于 Python 的 Google API 客户端库,请完成以下步骤:
为客户端库的配置和身份验证创建目录 文件。在您的主目录中,创建以下目录:
~/shopping-samples/content/
如需下载服务账号凭据,请完成以下步骤:
- 前往 Google API 库。
- 在页面顶部的菜单中选择一个项目。如果您还没有账号 不过,请点击 New project 创建一个项目。
- 如果您尚未对此启用 Content API for Shopping 项目,然后在 Google API 列表中搜索并启用它。
- 在左侧边栏中,选择凭据。您可能需要点击 点击左上角的左指箭头即可查看这项内容。
- 如需设置服务账号,请选择创建凭据,然后 服务账号。
- 为新服务账号命名。该用户名也用作 服务账号 ID。记录服务账号 ID,包括相应部分 “@”之后字符,供以后使用。点击创建,然后完成 授予项目和用户访问权限的可选步骤,然后点击 完成。
- 系统会将您定向到“服务账号”页面,您可在其中添加新的服务 所有资源。
要获取 JSON 私钥,请点击服务账号,然后点击密钥 标签页。点击添加键 >创建新密钥,然后选择 JSON 作为 密钥类型。点击创建将私钥下载到您的计算机。 系统会自动下载新密钥。
将下载的凭据文件重命名为 service-account.json。
将 service-account.json 文件移动到 home directory/shopping-samples/content/.
在您的 home directory/shopping-samples/content/ 中,创建 merchant-info.json 文件为空。
在 merchant-info.json 中,添加以下文本:
{ "merchantId": your Merchant Center merchant ID, "accountSampleUser": "the email address associated with your Merchant Center account" }
将新服务账号添加为 Merchant Center 账号的用户。如果您 如果您是第三方开发者,则需要让客户完成此步骤 。
- 登录您的 Merchant Center 账号。
- 在 Merchant Center 账号的设置中,选择用户和 访问权限。
点击 + 添加用户,然后将服务账号 ID 用作电子邮件地址 为新用户创建的值
使用
Accounts
服务需要管理员权限,因此请选择 管理。点击添加用户,保存偏好设置,然后返回到 用户。服务账号 ID 会与所选用户角色一起列出。
对您要添加的所有其他服务账号重复此过程。
克隆(或下载并解压缩) googleads/googleads-shopping-samples 将 GitHub 代码库复制到计算机上的任意位置;它不必位于 或位于 ~/shopping-samples/content/ 下。
如果您下载并解压缩了代码库,请不要克隆,而是重命名 解压缩到 googleads-shopping-samples。
要安装所需的示例依赖项,请在终端窗口中执行以下操作: 转至 googleads-shopping-samples/python/,然后运行以下命令:
pip install -r requirements.txt
现在,您已经配置了适用于 Python 的 Google API 客户端库,可以用于 Content API 了。在下一部分中,您将创建并发送插入新商品的请求。