Trong Content API for Shopping, bạn quản lý người dùng và quyền truy cập của họ bằng một trường trong tài nguyên Account. Merchant API thay thế trường này bằng tài nguyên chuyên dụng có tên là
User và
các phương thức tương ứng (create, delete, get, list, path). Để biết thêm thông tin,
xem Kiểm soát quyền truy cập vào tài khoản của bạn.
Những điểm khác biệt chính
So với Content API for Shopping, Merchant API mang lại những lợi ích sau đây cho việc quản lý người dùng:
- Tài nguyên chuyên dụng: Tài nguyên này cung cấp một cách chi tiết và trực tiếp hơn để kiểm soát những người có thể truy cập vào tài khoản Merchant Center của bạn và những việc họ có thể làm.
- Tên tài nguyên RESTful: Trong Merchant API, hãy xác định tài nguyên
Userbằng tên tài nguyên đầy đủ , ví dụ:accounts/12345/users/example@example.com. mebí danh: Bạn có thể sử dụng bí danhmethay cho địa chỉ email trong tên tài nguyên để tham chiếu đến người dùng đã xác thực, ví dụ:accounts/12345/users/me.- Quyền truy cập hợp nhất: Merchant API hợp nhất các trường truy cập boolean
từ Content API (ví dụ:
admin,reportingManager) thành một trường duy nhất, có thể lặp lạiaccess_rights. - Lời mời và quy trình xác minh người dùng: Merchant API giới thiệu
trạng thái người dùng rõ ràng (
PENDINGhoặcVERIFIED). Khi bạn tạo một người dùng mới, họ sẽ ở trạng tháiPENDINGcho đến khi chấp nhận lời mời. Điều này giúp API hiển thị trạng thái của người dùng, một tính năng không có trong Content API for Shopping. Thêm ## Yêu cầu
Merchant API sử dụng các URL yêu cầu sau đây để quản lý người dùng:
GET /accounts/v1/accounts/{account}/users/{email}GET /accounts/v1/accounts/{account}/usersPOST /accounts/v1/accounts/{account}/usersPATCH /accounts/v1/accounts/{account}/users/{email}DELETE /accounts/v1/accounts/{account}/users/{email}
Bảng sau đây so sánh các URL yêu cầu giữa Content API for Shopping và Merchant API.
| Nội dung mô tả yêu cầu | Content API for Shopping | Merchant API |
|---|---|---|
| Lấy người dùng cho một tài khoản | GET {api_version}/{merchantId}/accounts/{accountId} |
GET {api_version}/accounts/{account}/users |
| Tạo người dùng | PATCH {api_version}/{merchantId}/accounts/{accountId} |
POST {api_version}/accounts/{account}/users |
| Cập nhật người dùng | PATCH {api_version}/{merchantId}/accounts/{accountId} |
PATCH {api_version}/accounts/{account}/users/{email} |
| Xoá người dùng | PATCH {api_version}/{merchantId}/accounts/{accountId} |
DELETE {api_version}/accounts/{account}/users/{email} |
Giá trị nhận dạng
Bảng sau đây so sánh các giá trị nhận dạng được sử dụng trong yêu cầu giữa Content API for Shopping và Merchant API.
| Nội dung mô tả về giá trị nhận dạng | Content API for Shopping | Merchant API |
|---|---|---|
| Giá trị nhận dạng tài khoản | accountId |
account trong accounts/{account} |
| Giá trị nhận dạng người dùng | email_address trong đối tượng AccountUser |
email trong accounts/{account}/users/{email} |
Phương thức
Bảng sau đây so sánh các phương thức giữa Content API for Shopping và Merchant API.
| Content API for Shopping | Merchant API | Phạm vi cung cấp và lưu ý |
|---|---|---|
accounts.update |
users.create |
Tạo người dùng mới cho một tài khoản. |
accounts.get |
users.get |
Truy xuất một người dùng. |
accounts.get |
users.list |
Liệt kê tất cả người dùng cho một tài khoản. |
accounts.update |
users.patch |
Cập nhật quyền truy cập của người dùng. |
accounts.update |
users.delete |
Xoá người dùng khỏi một tài khoản. |
Thay đổi chi tiết về trường
Cập nhật cách sử dụng các trường như sau:
| Content API for Shopping | Merchant API | Mô tả |
|---|---|---|
users (lặp lại AccountUser) |
users (lặp lại User) |
Tài nguyên User hiện là tài nguyên cấp cao nhất có dịch vụ riêng. |
AccountUser.email_address |
CreateUserRequest.user_id và một phần của User.name |
Địa chỉ email của người dùng hiện là một phần của tên tài nguyên. Hãy chỉ định địa chỉ email đó trong trường user_id trong quá trình tạo. |
AccountUser.admin |
access_rights: "ADMIN" |
Merchant API thay thế trường boolean admin bằng giá trị ADMIN trong enum access_rights. |
AccountUser.order_manager, AccountUser.payments_manager, AccountUser.payments_analyst |
access_rights: "STANDARD" |
Merchant API thay thế các vai trò này bằng quyền truy cập STANDARD. |
AccountUser.reporting_manager |
access_rights: "PERFORMANCE_REPORTING" |
Vai trò reporting_manager hiện là quyền truy cập PERFORMANCE_REPORTING. |
AccountUser.read_only |
access_rights: "READ_ONLY" |
Vai trò read_only hiện là quyền truy cập READ_ONLY. |
| Không có | User.name |
Chứa tên tài nguyên đầy đủ của người dùng, ví dụ: accounts/{account}/users/{email}. |
| Không có | User.state |
Cho biết trạng thái của lời mời gửi cho người dùng, có thể là PENDING hoặc VERIFIED. |