概览

如需有效使用 Merchant API，请务必了解注册、身份验证和授权的概念。它们在确保安全、正确地访问 Merchant Center 数据方面发挥着不同的作用。

术语

身份验证：在此过程中，服务会验证发出 API 请求的用户或应用的身份。Merchant API 使用 OAuth 2.0 等标准 Google 机制。不支持使用 API 密钥进行身份验证，否则会导致身份验证错误。如需了解详情，请参阅对请求进行身份验证和以您自己的账号身份进行身份验证。
授权：此过程确定经过身份验证的用户或应用可以使用 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 OAuth Playground 和 APIs Explorer 等工具使用 Google 拥有的共享 Google Cloud 云项目。您无法注册共享项目，原因如下：

您的应用需要有自己的专用 Google Cloud 项目，以便 Google 向您发送的 Merchant API 通信内容与您的实际使用情况保持相关。

不过，您可以使用 OAuth Playground 和 API Explorer Web 应用，将 Merchant API 用于实验和非生产用例。

您可以在 Google Cloud 控制台中找到项目 ID 和项目编号。如需了解详情，请参阅查找项目名称、编号和 ID。

使用 Accounts 子 API 中的 registerGcp 方法进行注册。此调用会将您的 Google Cloud 项目编号与 Merchant Center 账号相关联。

在此过程中，您应提供与您用于调用 API 的个人用户关联的邮箱。此邮箱必须属于对 Merchant Center 账号拥有管理员访问权限的用户。

有效沟通是关键。Google 会发送重要更新、重要服务通知 (MSA)、开发者调查问卷以及与 Merchant API 相关的其他机会。妥善管理联系人可确保这些通知发送给合适的人员。

虽然注册调用中的电子邮件地址会设置初始联系人，但管理联系人和权限的更可靠方法是使用 Merchant API accounts.users 资源或 Merchant Center 界面中的用户管理设置。如需详细了解如何使用 Merchant Center，请参阅管理账号中的用户。

请按以下方式充分利用这些功能：

添加所有开发者：将负责 API 集成的开发者添加为 Merchant Center 账号的用户。
分配 API_DEVELOPER 角色：除了标准角色（管理员、标准）之外，您还可以为用户分配 API_DEVELOPER 角色。具体而言，请将此角色分配给应接收 API 相关通知的用户。您可以将其与其他角色结合使用。
优势：
- 清晰分离：将 API 联系人管理与一次性注册分离开来。
- 灵活性：随着团队成员的变化更新联系人。
- 有针对性的沟通：确保将特定于 API 的消息发送给相关人员。

即使您在注册期间提供了电子邮件地址，我们也强烈建议您通过添加具有 API_DEVELOPER 角色的用户来管理 API 联系人。

详情请参阅以下内容：