迁移用户和访问权限管理

在 Content API for Shopping 中，您可以使用 Account 资源中的字段来管理用户及其访问权限。Merchant API 将此字段替换为名为 的专用 User资源和 相应的方法（create、delete、get、list、path）。如需了解详情， 请参阅控制对您 账号的访问权限。

主要区别

与 Content API for Shopping 相比，Merchant API 在用户管理方面具有以下优势：

• 专用资源：此资源提供了一种更精细、更直接的方式来 控制谁可以访问您的 Merchant Center 账号以及他们可以执行哪些操作。
• RESTful 资源名称：在 Merchant API 中，您可以使用 完整资源名称来标识 User 资源，例如 accounts/12345/users/example@example.com。
• me 别名：您可以在资源名称中使用别名 me 而不是电子邮件地址来引用经过身份验证的用户，例如 accounts/12345/users/me。
• 整合的访问权限：Merchant API 将 Content API 中的布尔值访问 字段（例如 admin、reportingManager）整合到单个可重复的access_rights字段中。
• 用户邀请和验证：Merchant API 引入了 明确的用户状态（PENDING 或 VERIFIED）。当您创建新用户时， 他们会处于 PENDING 状态，直到接受邀请。这样，API 就可以了解用户的状态，而 Content API for Shopping 中没有此功能。添加 ## 请求数

Merchant API 使用以下请求网址来管理用户：

• GET /accounts/v1/accounts/{account}/users/{email}
• GET /accounts/v1/accounts/{account}/users
• POST /accounts/v1/accounts/{account}/users
• PATCH /accounts/v1/accounts/{account}/users/{email}
• DELETE /accounts/v1/accounts/{account}/users/{email}

下表比较了 Content API for Shopping 和 Merchant API 之间的请求网址。

请求说明	Content API for Shopping	Merchant API
获取账号的用户	GET {api_version}/{merchantId}/accounts/{accountId}	GET {api_version}/accounts/{account}/users
创建用户	PATCH {api_version}/{merchantId}/accounts/{accountId}	POST {api_version}/accounts/{account}/users
更新用户	PATCH {api_version}/{merchantId}/accounts/{accountId}	PATCH {api_version}/accounts/{account}/users/{email}
删除用户	PATCH {api_version}/{merchantId}/accounts/{accountId}	DELETE {api_version}/accounts/{account}/users/{email}

标识符

下表比较了 Content API for Shopping 和 Merchant API 中请求所使用的标识符。

标识符说明	Content API for Shopping	Merchant API
账号标识符	accountId	accounts/{account} 中的 account
用户标识符	AccountUser 对象中的 email_address	accounts/{account}/users/{email} 中的 email

方法

下表比较了 Content API for Shopping 和 Merchant API 之间的方法。

Content API for Shopping	Merchant API	适用范围和说明
accounts.update	users.create	为账号创建新用户。
accounts.get	users.get	检索单个用户。
accounts.get	users.list	列出账号的所有用户。
accounts.update	users.patch	更新用户的访问权限。
accounts.update	users.delete	从账号中删除用户。

字段详细更改

请按如下所示更新字段的使用方式：

Content API for Shopping	Merchant API	说明
users（重复的 AccountUser）	users（重复的 User）	User 资源现在是具有自己服务的顶级资源。
AccountUser.email_address	CreateUserRequest.user_id 和 User.name 的一部分	用户的电子邮件地址现在是资源名称的一部分。在创建期间，请在 user_id 字段中指定该地址。
AccountUser.admin	access_rights: "ADMIN"	Merchant API 将布尔值 admin 字段替换为 access_rights 枚举中的 ADMIN 值。
AccountUser.order_manager、AccountUser.payments_manager、AccountUser.payments_analyst	access_rights: "STANDARD"	Merchant API 将这些角色替换为 STANDARD 访问权限。
AccountUser.reporting_manager	access_rights: "PERFORMANCE_REPORTING"	reporting_manager 角色现在是 PERFORMANCE_REPORTING 访问权限。
AccountUser.read_only	access_rights: "READ_ONLY"	read_only 角色现在是 READ_ONLY 访问权限。
不可用	User.name	包含用户的完整资源名称，例如 accounts/{account}/users/{email}。
不可用	User.state	表示用户邀请的状态，可以是 PENDING 或 VERIFIED。