Nutzer- und Zugriffsverwaltung migrieren

In der Content API for Shopping haben Sie Nutzer und ihre Zugriffsrechte mit einem Feld in der Account-Ressource verwaltet. In der Merchant API wird dies durch die dedizierte Ressource namens User und die entsprechenden Methoden (create, delete, get, list, path) ersetzt. Weitere Informationen finden Sie unter Zugriff auf Ihr Konto steuern.

Wichtige Unterschiede

Im Vergleich zur Content API for Shopping bietet die Merchant API die folgenden Vorteile für die Nutzerverwaltung:

  • Dedizierte Ressource: So können Sie detaillierter und direkter steuern, wer auf Ihr Merchant Center-Konto zugreifen kann und was diese Nutzer tun dürfen.
  • RESTful-Ressourcennamen: In der Merchant API werden User Ressourcen durch einen vollständigen Ressourcennamen identifiziert, z. B. accounts/12345/users/example@example.com.
  • me alias: Sie können das Alias me anstelle einer E-Mail-Adresse in dem Ressourcennamen verwenden, um auf den authentifizierten Nutzer zu verweisen, z. B. accounts/12345/users/me.
  • Zusammengefasste Zugriffsrechte: In der Merchant API werden boolesche Zugriffs felder aus der Content API (z. B. admin, reportingManager) in einem einzelnen wiederholbarenaccess_rights Feld zusammengefasst.
  • Nutzereinladung und ‑bestätigung: In der Merchant API wird ein expliziter Nutzerstatus eingeführt (PENDING oder VERIFIED). Wenn Sie einen neuen Nutzer erstellen, hat er den Status PENDING, bis er die Einladung annimmt. So ist der Status des Nutzers über die API sichtbar, was in der Content API for Shopping nicht möglich war. ## Anfragen hinzufügen

In der Merchant API werden die folgenden Anfrage-URLs verwendet, um Nutzer zu verwalten:

  • 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}

In der folgenden Tabelle werden die Anfrage-URLs der Content API for Shopping und der Merchant API verglichen.

Beschreibung der Anfrage Content API for Shopping Merchant API
Nutzer für ein Konto abrufen GET {api_version}/{merchantId}/accounts/{accountId} GET {api_version}/accounts/{account}/users
Nutzer erstellen PATCH {api_version}/{merchantId}/accounts/{accountId} POST {api_version}/accounts/{account}/users
Nutzer aktualisieren PATCH {api_version}/{merchantId}/accounts/{accountId} PATCH {api_version}/accounts/{account}/users/{email}
Nutzer löschen PATCH {api_version}/{merchantId}/accounts/{accountId} DELETE {api_version}/accounts/{account}/users/{email}

IDs

In der folgenden Tabelle werden die in Anfragen verwendeten IDs der Content API for Shopping und der Merchant API verglichen.

Beschreibung der ID Content API for Shopping Merchant API
Konto-ID accountId account in accounts/{account}
Nutzer-ID email_address im AccountUser-Objekt email in accounts/{account}/users/{email}

Methoden

In der folgenden Tabelle werden die Methoden der Content API for Shopping und der Merchant API verglichen.

Content API for Shopping Merchant API Verfügbarkeit und Hinweise
accounts.update users.create Erstellt einen neuen Nutzer für ein Konto.
accounts.get users.get Ruft einen einzelnen Nutzer ab.
accounts.get users.list Listet alle Nutzer für ein Konto auf.
accounts.update users.update Aktualisiert die Zugriffsrechte eines Nutzers.
accounts.update users.delete Löscht einen Nutzer aus einem Konto.

Detaillierte Feldänderungen

Aktualisieren Sie die Verwendung von Feldern wie folgt:

Content API for Shopping Merchant API Beschreibung
users (wiederholtes AccountUser) users (wiederholtes User) Die Ressource User ist jetzt eine Ressource der obersten Ebene mit einem eigenen Dienst.
AccountUser.email_address CreateUserRequest.user_id und Teil von User.name Die E-Mail-Adresse des Nutzers ist jetzt Teil des Ressourcennamens. Geben Sie sie bei der Erstellung im Feld user_id an.
AccountUser.admin access_rights: "ADMIN" In der Merchant API wird das boolesche Feld admin durch den Wert ADMIN in der Enum access_rights ersetzt.
AccountUser.order_manager, AccountUser.payments_manager, AccountUser.payments_analyst access_rights: "STANDARD" In der Merchant API werden diese Rollen durch das Zugriffsrecht STANDARD ersetzt.
AccountUser.reporting_manager access_rights: "PERFORMANCE_REPORTING" Die Rolle reporting_manager ist jetzt das Zugriffsrecht PERFORMANCE_REPORTING.
AccountUser.read_only access_rights: "READ_ONLY" Die Rolle read_only ist jetzt das Zugriffsrecht READ_ONLY.
Nicht verfügbar User.name Enthält den vollständigen Ressourcennamen des Nutzers, z. B. accounts/{account}/users/{email}.
Nicht verfügbar User.state Gibt den Status der Einladung des Nutzers an, entweder PENDING oder VERIFIED.
Zurück
Migrate accountstatuses to Aggregate Product Statuses
Weiter
Migrate homepage management