Przenoszenie zarządzania użytkownikami i dostępem
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
W Content API for Shopping użytkownikami i ich prawami dostępu zarządzało się za pomocą pola w zasobie Account. Interfejs Merchant API zastępuje to dedykowanym zasobem o nazwie User i odpowiednimi metodami (create, delete, get, list, path). Więcej informacji znajdziesz w artykule Kontrolowanie dostępu do konta.
Najważniejsze różnice
W porównaniu z Content API for Shopping interfejs Merchant API oferuje te zalety w zakresie zarządzania użytkownikami:
- Dedykowane zasoby: ta opcja zapewnia bardziej szczegółowy i bezpośredni sposób kontrolowania, kto ma dostęp do Twojego konta Merchant Center i co może na nim robić.
- Nazwy zasobów RESTful: w Merchant API identyfikuj zasoby
User za pomocą pełnej nazwy zasobu, np. accounts/12345/users/example@example.com.
mealias: możesz użyć aliasu me zamiast adresu e-mail w nazwie zasobu, aby odwołać się do uwierzytelnionego użytkownika, np. accounts/12345/users/me.- Skonsolidowane prawa dostępu: Merchant API konsoliduje pola dostępu typu boolean z Content API (np.
admin, reportingManager) w jedno powtarzalne pole access_rights.
- Zapraszanie i weryfikacja użytkowników: interfejs Merchant API wprowadza wyraźny stan użytkownika (
PENDING lub VERIFIED). Gdy utworzysz nowego użytkownika, będzie on w stanie PENDING, 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
## Żądania
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 znajdziesz porównanie adresów URL żądań w Content API for Shopping i 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 znajdziesz porównanie identyfikatorów używanych w żądaniach między interfejsem Content API for Shopping a 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 znajdziesz porównanie metod interfejsu Content API for Shopping i 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 pojedynczego użytkownika. |
accounts.get |
users.list |
Wyświetla listę wszystkich użytkowników konta. |
accounts.update |
users.update |
Aktualizuje uprawnienia dostępu użytkownika. |
accounts.update |
users.delete |
Usuwa użytkownika z konta. |
Szczegółowe zmiany w polach
Zmień sposób używania 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. Określ go w polu user_id podczas tworzenia. |
AccountUser.admin |
access_rights: "ADMIN" |
Interfejs Merchant API zastępuje pole logiczne admin wartością ADMIN w wyliczeniu access_rights. |
AccountUser.order_manager, AccountUser.payments_manager, AccountUser.payments_analyst |
access_rights: "STANDARD" |
Interfejs Merchant API zastępuje te role STANDARD prawem dostępu. |
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 uprawnienie dostępu READ_ONLY. |
| Niedostępne |
User.name |
Zawiera pełną nazwę zasobu użytkownika, np. accounts/{account}/users/{email}. |
| Niedostępne |
User.state |
Wskazuje stan zaproszenia użytkownika: PENDING lub VERIFIED. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-08 UTC.
[null,null,["Ostatnia aktualizacja: 2025-08-08 UTC."],[],[],null,["# Migrate user and access management\n\nIn Content API for Shopping, you managed users and their access rights with a\nfield in the `Account` resource. Merchant API replaces this with the dedicated\nresource named\n[`User`](/merchant/api/reference/rest/accounts_v1/accounts.users) and\ncorresponding methods (create, delete, get, list, path). For more information,\nsee [Control access to your\naccount](/merchant/api/guides/accounts/control-access).\n\nKey differences\n---------------\n\nCompared to Content API for Shopping, Merchant API offers the following\nadvantages for user management:\n\n- **Dedicated resource**: This provides a more granular and direct way to control who can access your Merchant Center account and what they can do.\n- **RESTful resource names** : In Merchant API, identify `User` resources by a full resource name, for example, `accounts/12345/users/example@example.com`.\n- **`me` alias** : You can use the alias `me` in place of an email address in the resource name to refer to the authenticated user, for example, `accounts/12345/users/me`.\n- **Consolidated access rights** : Merchant API consolidates boolean access fields from Content API (for example, `admin`, `reportingManager`) into a single, repeatable`access_rights` field.\n- **User invitation and verification** : Merchant API introduces an explicit user state (`PENDING` or `VERIFIED`). When you create a new user, they are in a `PENDING` state until they accept the invitation. This provides API visibility into the user's status, which was not available in the Content API for Shopping. Add ## Requests\n\nMerchant API uses the following request URLs to manage users:\n\n- `GET /accounts/v1/accounts/{account}/users/{email}`\n- `GET /accounts/v1/accounts/{account}/users`\n- `POST /accounts/v1/accounts/{account}/users`\n- `PATCH /accounts/v1/accounts/{account}/users/{email}`\n- `DELETE /accounts/v1/accounts/{account}/users/{email}`\n\nThe following table compares the request URLs between the Content API for\nShopping and Merchant API.\n\n| Request description | Content API for Shopping | Merchant API |\n|--------------------------|---------------------------------------------------------|---------------------------------------------------------|\n| Get users for an account | `GET {api_version}/{merchantId}/accounts/{accountId}` | `GET {api_version}/accounts/{account}/users` |\n| Create a user | `PATCH {api_version}/{merchantId}/accounts/{accountId}` | `POST {api_version}/accounts/{account}/users` |\n| Update a user | `PATCH {api_version}/{merchantId}/accounts/{accountId}` | `PATCH {api_version}/accounts/{account}/users/{email}` |\n| Delete a user | `PATCH {api_version}/{merchantId}/accounts/{accountId}` | `DELETE {api_version}/accounts/{account}/users/{email}` |\n\nIdentifiers\n-----------\n\nThe following table compares the identifiers used in requests between the\nContent API for Shopping and Merchant API.\n\n| Identifier description | Content API for Shopping | Merchant API |\n|------------------------|-------------------------------------------------|-----------------------------------------------|\n| Account identifier | `accountId` | `account` in `accounts/{account}` |\n| User identifier | `email_address` within the `AccountUser` object | `email` in `accounts/{account}/users/{email}` |\n\nMethods\n-------\n\nThe following table compares the methods between the Content API for Shopping\nand Merchant API.\n\n| Content API for Shopping | Merchant API | Availability \\& notes |\n|--------------------------|----------------------------------------------------------------------------------|------------------------------------|\n| `accounts.update` | [`users.create`](/merchant/api/reference/rest/accounts_v1/accounts.users/create) | Creates a new user for an account. |\n| `accounts.get` | [`users.get`](/merchant/api/reference/rest/accounts_v1/accounts.users/get) | Retrieves a single user. |\n| `accounts.get` | [`users.list`](/merchant/api/reference/rest/accounts_v1/accounts.users/list) | Lists all users for an account. |\n| `accounts.update` | [`users.update`](/merchant/api/reference/rest/accounts_v1/accounts.users/update) | Updates a user's access rights. |\n| `accounts.update` | [`users.delete`](/merchant/api/reference/rest/accounts_v1/accounts.users/delete) | Deletes a user from an account. |\n\nDetailed field changes\n----------------------\n\nUpdate your use of fields as follows:\n\n| Content API for Shopping | Merchant API | Description |\n|---------------------------------------------------------------------------------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------------------------------|\n| `users` (repeated `AccountUser`) | `users` (repeated `User`) | The `User` resource is now a top-level resource with its own service. |\n| `AccountUser.email_address` | `CreateUserRequest.user_id` and part of `User.name` | The user's email address is now part of the resource name. Specify it in the `user_id` field during creation. |\n| `AccountUser.admin` | `access_rights: \"ADMIN\"` | Merchant API replaces the boolean `admin` field by the `ADMIN` value in the `access_rights` enum. |\n| `AccountUser.order_manager`, `AccountUser.payments_manager`, `AccountUser.payments_analyst` | `access_rights: \"STANDARD\"` | Merchant API replaces these roles to `STANDARD` access right. |\n| `AccountUser.reporting_manager` | `access_rights: \"PERFORMANCE_REPORTING\"` | The `reporting_manager` role is now the `PERFORMANCE_REPORTING` access right. |\n| `AccountUser.read_only` | `access_rights: \"READ_ONLY\"` | The `read_only` role is now the `READ_ONLY` access right. |\n| Not available | `User.name` | Contains the full resource name of the user, for example, `accounts/{account}/users/{email}`. |\n| Not available | `User.state` | Indicates the status of the user's invitation, either `PENDING` or `VERIFIED`. |"]]
