为确保数据安全、强制执行访问权限控制并维护系统完整性,您必须对所有 Merchant API 请求进行身份验证。API 使用经过身份验证的身份来确定调用方有权执行的操作。例如,某些调用方可能对商品数据具有只读权限,而其他调用方则可以修改 Merchant Center 中的账号设置。
本文档是关于 Merchant API 使用入门的系列文章中的一篇。如果您已设置 Merchant API 身份验证,则可以跳到下一部分: 注册为开发者
向 Merchant API 请求授权
发送到 Merchant API 的每个请求都必须包含授权令牌,以便向 Google 标识您的应用。如需设置身份验证和授权,请确定最能描述您计划如何使用 Merchant API 的用例:
您是否正在构建供其他企业使用的应用?
如果是,您可以使用 OAuth 2.0 授权。在以下情况下,请选择 OAuth 2.0 授权:
- 您是第三方提供商或代理机构:您正在构建一个应用(例如 SaaS 平台),供其他企业用来管理自己的 Merchant Center 数据。
- 您需要管理许多外部账号:您希望一个应用能够跨多个由不同账号所有者拥有的独立 Merchant Center 账号运行。您的客户通过登录自己的 Google 账号并在权限请求页面上点击“允许”来授予权限。
您是否在为自己的企业构建应用?
如果是,您可以使用服务账号授权来获取 Merchant API 访问权限。 在以下情况下,请选择服务账号授权:
- 您正在构建自己的内部应用:您正在专门为自己的业务开发一个工具来管理自己的 Merchant Center 数据,或者您希望凭证属于应用本身,而不是特定的个人用户。
- 您需要无需人工登录的自动化:您的应用会运行后台任务,例如自动库存更新或“cron”作业。
OAuth 2.0 授权
如果您是管理多个客户账号的第三方提供商或代理机构,则您的应用必须使用 OAuth 2.0 向请求授权。请按照以下步骤为 Merchant API 设置 OAuth 2.0:
- 在 Google Cloud 控制台的 API 和服务中创建 OAuth 2.0 凭证
- 将 OAuth2 客户端凭据下载到文件(例如
client-secrets.json) - 将电子邮件账号作为用户添加到 Merchant Center:确保您用于授权请求的 Google 账号在 Merchant Center 中作为用户存在。如需了解详情,请参阅如何向 Merchant Center 添加用户或从中移除用户
- 为其分配
Admin角色以执行注册。如需详细了解角色,请参阅在 Merchant Center 中管理用户和访问权限级别 - 使用代码示例设置身份验证:按照官方代码示例设置身份验证和示例配置文档部分中的指南进行操作
如需详细了解 OAuth 2.0 授权,请参阅授权第三方应用访问 Merchant Center 账号和使用 OAuth 2.0 访问 Google API。
服务账号授权
您可以使用服务账号授权 Merchant API 访问您自己的 Merchant Center 账号。请按照以下步骤为 Merchant API 设置服务账号授权:
- 在 Google Cloud 控制台的“API 和服务”中创建服务账号凭证
- 下载私钥:为服务账号创建并下载 JSON 格式的私钥。将文件重命名为
service-account.json - 将服务账号添加到 Merchant Center:复制唯一服务账号电子邮件地址(例如
sa@project.iam.gserviceaccount.com),并将其作为新用户添加到 Merchant Center。如需了解详情,请参阅如何向 Merchant Center 添加用户或从中移除用户 - 为其分配
Admin访问权限。如需详细了解访问权限级别,请参阅在 Merchant Center 中管理用户和访问权限级别 - 使用代码示例设置身份验证:按照官方代码示例设置身份验证和示例配置文档部分中的指南进行操作
如需详细了解服务账号授权,请参阅授权访问您的 Merchant Center 账号和服务账号概览。