W Content API for Shopping użytkownikami i ich uprawnieniami dostępu zarządzało się za pomocą pola w zasobie Account. Merchant API zastępuje go dedykowanym zasobem o nazwie User i odpowiednimi metodami (create, delete, get, list, path). Więcej informacji znajdziesz w artykule Kontrola dostępu do konta.
Najważniejsze różnice
W porównaniu z Content API for Shopping interfejs Merchant API oferuje następujące korzyści w zakresie zarządzania użytkownikami:
- Dedykowany zasób: zapewnia bardziej szczegółowy i bezpośredni sposób kontrolowania, kto może uzyskać dostęp do konta Merchant Center i jakie działania może podejmować.
- Nazwy zasobów RESTful: w interfejsie Merchant API zasoby
Usersą identyfikowane za pomocą pełnej nazwy zasobu, np.accounts/12345/users/example@example.com. - Alias
me: zamiast adresu e-mail w nazwie zasobu możesz użyć aliasume, aby odwołać się do uwierzytelnionego użytkownika, np.accounts/12345/users/me. - Skonsolidowane uprawnienia dostępu: interfejs Merchant API konsoliduje pola dostępu logicznego z interfejsu Content API (np.
admin,reportingManager) w jedno powtarzalne poleaccess_rights. - Zaproszenie i weryfikacja użytkownika: interfejs Merchant API wprowadza jednoznaczny stan użytkownika (
PENDINGlubVERIFIED). Gdy tworzysz nowego użytkownika, jest on w staniePENDING, dopóki nie zaakceptuje zaproszenia. Dzięki temu interfejs API ma wgląd w stan użytkownika, co nie było możliwe w przypadku Content API for Shopping. Dodaj ## prośby
Interfejs Merchant API używa tych adresów URL żądań do zarządzania użytkownikami:
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}
W tabeli poniżej porównano adresy URL żądań między interfejsem Content API for Shopping a interfejsem Merchant API.
| Opis prośby | Content API for Shopping | Merchant API |
|---|---|---|
| Pobieranie użytkowników konta | GET {api_version}/{merchantId}/accounts/{accountId} |
GET {api_version}/accounts/{account}/users |
| Tworzenie konta użytkownika | PATCH {api_version}/{merchantId}/accounts/{accountId} |
POST {api_version}/accounts/{account}/users |
| Aktualizowanie użytkownika | PATCH {api_version}/{merchantId}/accounts/{accountId} |
PATCH {api_version}/accounts/{account}/users/{email} |
| Usuwanie użytkownika | PATCH {api_version}/{merchantId}/accounts/{accountId} |
DELETE {api_version}/accounts/{account}/users/{email} |
Identyfikatory
W tabeli poniżej porównano identyfikatory używane w żądaniach między Content API for Shopping i Merchant API.
| Opis identyfikatora | Content API for Shopping | Merchant API |
|---|---|---|
| Identyfikator konta | accountId |
account w: accounts/{account} |
| Identyfikator użytkownika | email_address w obiekcie AccountUser |
email w: accounts/{account}/users/{email} |
Metody
W tabeli poniżej porównano metody interfejsu Content API for Shopping i interfejsu Merchant API.
| Content API for Shopping | Merchant API | Dostępność i uwagi |
|---|---|---|
accounts.update |
users.create |
Tworzy nowego użytkownika konta. |
accounts.get |
users.get |
Pobiera informacje o jednym użytkowniku. |
accounts.get |
users.list |
Wyświetla listę wszystkich użytkowników konta. |
accounts.update |
users.patch |
Aktualizuje uprawnienia dostępu użytkownika. |
accounts.update |
users.delete |
Usuwa użytkownika z konta. |
Szczegółowe zmiany w polach
Zaktualizuj użycie pól w ten sposób:
| Content API for Shopping | Merchant API | Opis |
|---|---|---|
users (powtórzono AccountUser) |
users (powtórzono User) |
Zasób User jest teraz zasobem najwyższego poziomu z własną usługą. |
AccountUser.email_address |
CreateUserRequest.user_id i część User.name |
Adres e-mail użytkownika jest teraz częścią nazwy zasobu. Podaj go w polu user_id podczas tworzenia. |
AccountUser.admin |
access_rights: "ADMIN" |
Interfejs Merchant API zastępuje wartość logiczną pola admin wartością ADMIN w typie wyliczeniowym access_rights. |
AccountUser.order_manager, AccountUser.payments_manager, AccountUser.payments_analyst |
access_rights: "STANDARD" |
Interfejs Merchant API zastępuje te role uprawnieniami dostępu STANDARD. |
AccountUser.reporting_manager |
access_rights: "PERFORMANCE_REPORTING" |
Rola reporting_manager to teraz uprawnienie dostępu PERFORMANCE_REPORTING. |
AccountUser.read_only |
access_rights: "READ_ONLY" |
Rola read_only to teraz prawo dostępu READ_ONLY. |
| Niedostępne | User.name |
Zawiera pełną nazwę zasobu użytkownika, na przykład accounts/{account}/users/{email}. |
| Niedostępne | User.state |
Wskazuje stan zaproszenia użytkownika: PENDING lub VERIFIED. |