> 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/team.md).
# Team
## Übersicht
Die Teams-API ermöglicht es Händlern, Werbetreibenden und Lieferanten, Teams und Benutzer programmatisch über API-Endpunkte zu verwalten.
### Zielgruppe
* Händler: Verwalten Sie Lieferantenteams und arbeiten Sie mit Werbepartnern zusammen.
* Werbetreibende: Erstellen und verwalten Sie Teams für die Zusammenarbeit bei Kampagnen.
* Entwickler: Integrieren Sie das Teammanagement in Anwendungen.
* Anzeigenverwaltungsplattform: Erleichtern Sie Workflows zur Teamerstellung und -verwaltung.
### Teammanagement
Im Epsilon Retail Media System repräsentieren Teams entweder Lieferanten (Werbetreibende) oder Händler. Lieferantenteams erstellen Kampagnen, während Händlerteams diese überprüfen und verwalten. Benutzer können mehreren Teams angehören, von denen jedes über ein eigenes Set an Benutzern, Kampagnen und Wallets verfügt.
#### Was ist eine Team-ID?
Eine Team-ID ist eine eindeutige Kennung für jedes Team im Epsilon Retail Media System. Sie ist in API-Anfragen erforderlich, um Aktionen dem richtigen Händler- oder Lieferantenteam zuzuordnen, z. B. das Generieren von Anzeigen, das Verwalten von Benutzern oder das Abrufen von Berichten auf Teamebene.
#### So finden Sie Ihre Team-ID
Um die Teams-API zu nutzen, benötigen Sie Ihre Team-ID. Diese identifiziert das Händler- oder Lieferantenteam 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 **Teameinstellungen**.
3. Die Team-ID wird oben auf der Seite angezeigt.
### Team-Elemente
Jedes Team enthält die folgenden Schlüsselelemente:
| Feldname | Beschreibung |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Team-ID | Eine eindeutige Kennung für das Team. |
| Teamname | Der Name des Teams. |
| Unternehmensname | Der Name des mit dem Team verbundenen Unternehmens. |
| Unternehmenswebsite | Die offizielle Website-URL des Unternehmens. |
| Telefonnummer | Die Kontakttelefonnummer des Unternehmens. |
| Unternehmensadresse | Die physische Adresse des Unternehmens. |
| Postleitzahl | Die Postleitzahl für die Adresse des Unternehmens. |
| Geschäfts-ID | Eine Kennung, die für geschäftliche oder rechtliche Zwecke verwendet wird. |
| Anzeigenfinanzierer | Entität, die die Anzeige finanziert; erforderlich zur Einhaltung regionaler Gesetze wie dem Gesetz über digitale Dienste (DSA) der EU. |
### Definitionen der Team-API-Felder
| Feldname | Beschreibung |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| id | Die eindeutige ID des Teams. |
| name | Der Name des Teams. |
| namespaceId | Die eindeutige Kennung des Namespace. |
| companyName | Der Name des Unternehmens, zu dem das Team gehört. |
| companyWebsite | Die URL der Unternehmenswebsite. |
| companyPhone | Legacy-Feld. Die Telefonnummer des Unternehmens. |
| companyAddress | Das Adressobjekt für den Standort des Unternehmens. |
| userIds | Eindeutige Kennungen der Benutzer, die zum Team gehören. |
| reviewerEmail | E-Mail-Adresse für Benachrichtigungen, wenn eine Kampagne überprüft werden muss. Gilt nur für das primäre Händlerteam. |
| sellerId | Eindeutige Lieferanten-/Händler-ID, die von einem Händler bereitgestellt wird. Muss mit der vom Händler bereitgestellten ID übereinstimmen. |
| notificationRecipients | Empfänger für Kampagnenbenachrichtigungen. |
### Verfügbare Endpunkte
| Endpunkt | Beschreibung |
| ---------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Team erstellen](/retail-media-interface/partner/de/team-user-api/team.md) |
Erstellt ein neues Team. Ein Team repräsentiert einen Lieferanten, wie z. B. einen Werbetreibenden, eine Anzeigenverwaltungsplattform oder einen Marktplatz-Verkäufer.
Berechtigungen\*\*: Händler: Können Teams im Namen von Lieferanten oder Werbetreibenden erstellen (erfordert Konfiguration). Aus Designgründen können Händler keine Händler-Teams erstellen. Lieferanten: Können Teams erstellen (sofern vom Händler erlaubt).
|
| [Ein Team aktualisieren](/retail-media-interface/partner/de/team-user-api/team.md) |
Aktualisiert Teamdetails einschließlich Name, Unternehmensinformationen, Telefonnummer, Website-URL und Adresse. Hinweis: Dieser Endpunkt unterliegt einer Konfiguration. Stellen Sie sicher, dass das entsprechende Feature-Flag oder die Einstellung in Ihrer Umgebung aktiviert ist, um diese API zu verwenden.
|
| [Listet alle Teams auf](/retail-media-interface/partner/de/team-user-api/team.md) | Ruft Teams unter Verwendung von Parametern ab: `name`, `namespace_id`, `seller_id`. Verwenden Sie `page_token` zur Navigation und`page_size` um die Ergebnisse pro Seite zu steuern. |
| [Team für die angegebene ID abrufen](/retail-media-interface/partner/de/team-user-api/team.md) | Ruft detaillierte Informationen über ein bestimmtes Team ab, einschließlich seiner Mitglieder. |
| [Einem Team mit Einladungstoken beitreten](/retail-media-interface/partner/de/team-user-api/team.md) | Ermöglicht Benutzern den Beitritt zu einem Team unter Verwendung eines gültigen Einladungstokens. |
Häufig gestellte Fragen und Tipps zur Fehlerbehebung finden Sie unter [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/team.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.