此页面由 Cloud Translation API 翻译。

概览

若要有效使用 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 OAuth Playground 和 APIs Explorer 等工具使用共享的 Google Cloud 项目（归 Google 所有）。您无法通过共享项目注册，原因如下：

您的应用需要有自己的专用 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 联系人。

详情请参阅以下内容：