建议您使用 Google API 客户端库来设置 Content API for Shopping。本指南以 Python Content API 客户端库为例,但这些库适用于许多常用的编程语言,可简化常见的 API 任务,例如身份验证、发送请求和解析响应。如需有关为其他语言设置客户端库的帮助,请参阅 GitHub 上 googleads/googleads-shopping-samples 代码库中相应语言的 README.md。
如需设置 Python 版 Google API 客户端库,请完成以下步骤:
为客户端库的配置和身份验证文件创建目录。在您的主目录中,创建以下目录:
~/shopping-samples/content/
如需下载服务账号凭据,请完成以下步骤:
- 前往 Google API 库。
- 在页面顶部的菜单中选择一个项目。如果您还没有项目,请点击新项目创建一个项目。
- 如果您还没有为此项目启用 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 搭配使用。在下一部分中,您将创建并发送请求以插入新商品。