> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/de/team-user-api/user-1.md).
# Benutzer
## Übersicht
Benutzer sind Einzelpersonen, die Teams angehören und verschiedene Aktionen innerhalb des Epsilon Retail Media Systems basierend auf ihren Berechtigungen und Rollen ausführen können.
### Was ist eine Benutzer-ID?
Eine Benutzer-ID ist ein eindeutiger Identifikator für jeden Benutzer im Epsilon Retail Media System. Sie ist in API-Anfragen erforderlich, um bestimmte Benutzer zu identifizieren und zu verwalten, z. B. zum Aktualisieren von Benutzerdetails, Ändern von Berechtigungen oder Abrufen von Benutzerinformationen.
### So finden Sie Ihre Benutzer-ID
Um die Benutzer-API zu verwenden, benötigen Sie Ihre Benutzer-ID. Diese identifiziert den jeweiligen Benutzer in API-Anfragen. Sie finden sie wie folgt:
1. Melden Sie sich bei Ihrem Citrus Client an.
2. Klicken Sie auf das Profil-Dropdown-Menü und wählen Sie **Benutzerprofil**.
3. Die Benutzer-ID wird im Abschnitt Benutzerprofil angezeigt.
### Benutzer-Elemente
Jeder Benutzer enthält die folgenden Schlüsselelemente:
| Element | Beschreibung |
| --------------------- | -------------------------------------------------------------------------- |
| Benutzer-ID | Ein eindeutiger Identifikator für den Benutzer. |
| E-Mail | Die E-Mail-Adresse des Benutzers für die Anmeldung und Benachrichtigungen. |
| Vorname | Der Vorname des Benutzers. |
| Nachname | Der Nachname des Benutzers. |
| Logo-ID | Eindeutiger Identifikator des Profilbilds des Benutzers. |
| Team-Mitgliedschaften | Liste der Teams, denen der Benutzer angehört. |
| Berechtigungen | Zugriffsstufe und Berechtigungen des Benutzers innerhalb von Teams. |
| Einladungsstatus | Status ausstehender Team-Einladungen. |
### Felddefinitionen der Benutzer-API
Die folgenden Schlüsselfelder für Benutzer werden häufig in API-Anfragen und -Antworten verwendet:
| Feldname | Beschreibung |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id | Eindeutiger Identifikator des Benutzers. |
| email | E-Mail-ID des Benutzers. |
| namespace | Namespace, dem der Benutzer angehört. |
| firstName | Vorname des Benutzers. |
| lastName | Nachname des Benutzers. |
| logoUrl | URL zum Profilbild oder Logo des Benutzers. Sie können die logoUrl abrufen über [Datei-URL abrufen](/retail-media-interface/partner/de/team-user-api/user-1/getfileurl.md). |
| teamIds | Liste der Team-IDs des Benutzers. |
| receivedInvitation | Details zu ausstehenden Einladungen. |
| inviteTeam | Stammobjekt für die Einladungsnutzlast. |
| managerTeamId | Eindeutige ID des Händler-Teams, das den Zugriff verwaltet und Einladungen versendet. Beispiel: manager-team-123. |
| roleIds | Array der Berechtigungs-Strings des Benutzers. |
| teamId | ID des Teams für die Benutzereinladung. |
| retailerTeamId | Eindeutige ID der vom Händler verwalteten Gruppe. |
| offset | Anzahl der zu überspringenden Datensätze vor dem Abrufen von Ergebnissen. |
### Verfügbare Endpunkte
| Endpunkt | Beschreibung |
| ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [Laden Sie einen Benutzer in das Team ein](/retail-media-interface/partner/de/team-user-api/user-1.md) | Sendet eine E-Mail-Einladung zum Beitritt zu einem bestimmten Team. Erfordert Team-ID und E-Mail-Adresse des Benutzers. |
| [Details des aktuellen Benutzers abrufen](/retail-media-interface/partner/de/team-user-api/user-1.md) |
Ruf die Profilinformationen des angemeldeten Benutzers ab, einschließlich: -Benutzer-ID, E-Mail, Vorname, Nachname und -Ausstehende Team-Einladungen mit Absenderdetails. Verwenden Sie diesen Endpunkt, um Details des aktuell angemeldeten Benutzers anzuzeigen.
Ruft Informationen über andere Benutzer im Team oder einen spezifischen Benutzer nach Benutzer-ID ab. Erfordert entsprechenden Zugriff (Händler oder Admin) innerhalb des Namespace, und der Benutzer muss Teil des Teams sein. Dieser Endpunkt wird für das Benutzermanagement auf Teamebene verwendet.
|
| [Details des aktuellen Benutzers aktualisieren](/retail-media-interface/partner/de/team-user-api/user-1.md) | Ändert den Vornamen, Nachnamen und die Logo-Datei-ID des angemeldeten Benutzers. Dieser Endpunkt unterstützt nicht das Aktualisieren von Details anderer Benutzer. |
| [Einen Benutzer entfernen](/retail-media-interface/partner/de/team-user-api/user-1.md) | Entfernt einen Benutzer aus einem Team (erfordert entsprechende Berechtigungen). |
| [Benutzerberechtigung ändern](/retail-media-interface/partner/de/team-user-api/user-1.md) |
Aktualisiert Benutzerberechtigungen nach Benutzer-ID und Team-ID. Berechtigungstypen\*\*: -Händler (Vollständig oder Berichtsansicht) -Lieferant (Vollständig oder Berichtsansicht). Hinweis: Händler- und Lieferantenrollen können nicht kombiniert werden.
|
| [Eine Datei hochladen](/retail-media-interface/partner/de/team-user-api/user-1.md) | Lädt Logos für Benutzerprofile und Teams hoch. |
| [Datei-URL abrufen](/retail-media-interface/partner/de/team-user-api/user-1.md) |
Generiert eine temporäre Download-URL für hochgeladene Dateien unter Verwendung der Datei-ID. Hinweis: Die URLs sind nur 3600 Sekunden lang gültig.
|
Für häufig gestellte Fragen und Tipps zur Fehlerbehebung siehe [Häufig gestellte Fragen](/retail-media-interface/partner/de/partner-api-overview/frequently-asked-questions.md#team-and-user).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.citrusad.com/retail-media-interface/partner/de/team-user-api/user-1.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.