如需有效使用 Merchant API,务必了解注册、身份验证 和授权 的概念。它们在确保安全且正确地访问 Merchant Center 数据方面发挥着不同的作用。
术语
注册、身份验证和授权是相关的,但每个都有不同的含义和用途。
- 身份验证:在此过程中,服务会验证发出 API 请求的 用户或应用的身份。Merchant API 使用标准 Google 机制,例如 OAuth 2.0。如需了解详情,请参阅对请求进行身份验证和以您自己的账号进行身份验证。
- 授权:此过程确定经过身份验证的 用户或应用可以使用 Merchant Center 账号执行哪些操作。 它会根据在 Merchant Center 账号中授予经过身份验证的用户的角色和权限回答以下问题:“您可以做什么?” 例如,用户可能被授权读取商品数据,但不能修改账号设置。
- 注册:对于 Merchant API,这是一个一次性设置 过程,可让 Google 向您发送有关您管理的 商家账号的重要服务通告。注册会将您的开发者电子邮件地址添加到您的主要 Merchant Center 账号,并将其与您用于身份验证的 Google Cloud 项目 ID 相关联。通过这种关联,您的应用可以接收有关您管理的所有商家账号的服务通告。如需了解详情,请参阅创建 Google Cloud 项目。
注册
注册过程对于让您的应用能够使用 Merchant API 至关重要。以下是您有必要知道的信息:
前提条件
如需注册使用 Merchant API,您需要满足以下条件:
- Merchant Center 账号:您需要有一个现有的 Merchant Center 账号。
- 管理员访问权限 :您用于发起注册调用的 Google 用户账号必须对您要注册的 Merchant Center 账号拥有管理员权限。
- Google Cloud 项目:您的应用必须与 Google Cloud 项目相关联。此项目会为您的应用提供必要的凭据(例如 OAuth 2.0 客户端 ID)以进行身份验证。
为什么无法注册共享的 Google Cloud 项目
Google OAuth Playground 和 APIs Explorer 等工具使用 Google 拥有的共享 Google Cloud 项目。您无法使用共享项目进行注册,因为:
- 它们旨在用于测试和探索,而不是用于生产应用身份。
- 注册它们意味着共享工具与您的特定 Merchant Center 数据之间存在关联,这可能会导致不必要的通信。
您的应用需要有自己的专用 Google Cloud 项目,这样 Google 向您发送的 Merchant API 通信才能与您的实际使用情况相关。
不过,您可以使用 OAuth Playground 和 API Explorer 网络应用来使用 Merchant API 进行实验和非生产用例。
查找 Google Cloud 项目 ID
您可以在 Google Cloud 控制台中找到项目 ID 和项目编号 。如需了解详情,请参阅查找项目名称、编号和 ID。
执行注册调用
使用 Accounts 子 API 中的
registerGcp
方法进行注册。此调用会将您的 Google Cloud 项目编号与 Merchant Center 账号相关联。
在此过程中,您应提供与您用于调用 API 的个人用户相关联的电子邮件地址。此电子邮件地址的所有者必须是对 Merchant Center 账号拥有管理员访问权限的用户。
关于电子邮件字段
有效的沟通至关重要。Google 会发送有关 Merchant API 的重要更新、强制性服务通告 (MSA)、开发者调查问卷和其他机会。妥善管理联系人可确保这些信息送达合适的人员。
- 用途:Google 会将此电子邮件地址用作与 API 相关通信的主要联系人。
- 电子邮件地址的所有者:这应该是负责 API 集成的个人开发者 或主要技术联系人的电子邮件地址。
- 最佳实践:
- 请:使用个人的公司电子邮件地址。
- 请勿:使用一般群组别名或服务账号电子邮件地址。我们希望将通信发送给真人收件人。
用于联系人管理的 users 资源
虽然注册调用中的电子邮件地址会设置初始联系人,但
管理联系人和权限的更可靠方法是使用 Merchant API
accounts.users
资源或 Merchant Center 界面中的用户管理设置。如需详细了解如何使用 Merchant Center,请参阅
管理账号中的人员。
您可以按如下方式利用这些功能:
- 添加所有开发者:将负责 API 集成的开发者添加为 Merchant Center 账号的用户。
- 分配
API_DEVELOPER角色:除了标准角色(管理员、 标准),您还可以为用户分配API_DEVELOPER角色。具体而言,请将此角色分配给应接收与 API 相关通信的用户。您可以将此角色与其他角色结合使用。 - 福利:
- 明确分离:将 API 联系人管理与一次性 注册分离。
- 灵活性:随着团队成员的变化更新联系人。
- 有针对性的通信:确保将特定于 API 的新闻发送给 相关人员。
即使您在注册期间提供了电子邮件地址,我们也强烈建议您通过添加具有 API_DEVELOPER 角色的用户来管理 API 联系人。
参考
如需了解详情,请参阅以下内容: