> 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/cs/team-user-api/team.md).
# Tým
## Přehled
API Teams umožňuje maloobchodníkům, inzerentům a dodavatelům spravovat týmy a uživatele programově pomocí koncových bodů API.
### Cílová skupina
* Maloobchodníci: Spravujte týmy dodavatelů a spolupracujte s reklamními partnery.
* Inzerenti: Vytvářejte a spravujte týmy pro spolupráci na kampaních.
* Vývojáři: Integrujte správu týmů do aplikací.
* Platforma pro správu reklam: Usnadněte pracovní postupy vytváření a správy týmů.
### Správa týmů
V systému Epsilon Retail Media týmy představují buď dodavatele (inzerenty), nebo maloobchodníky. Týmy dodavatelů vytvářejí kampaně, zatímco týmy maloobchodníků je kontrolovaly a spravují. Uživatelé mohou patřit do více týmů, přičemž každý má vlastní sadu uživatelů, kampaní a peněženek.
#### Co je ID týmu?
ID týmu je jedinečný identifikátor pro každý tým v systému Epsilon Retail Media . Je vyžadováno v požadavcích API k propojení akcí se správným týmem maloobchodníka nebo dodavatele, jako je generování reklam, správa uživatelů nebo získávání přehledů kampaní na úrovni týmu.
#### Vyhledání ID vašeho týmu
Chcete-li používat API Teams, budete potřebovat svoje ID týmu. To identifikuje tým maloobchodníka nebo dodavatele v požadavcích API. Najdete ho takto:
1. Přihlaste se do svého Klienta Citrus.
2. Klikněte na rozbalovací nabídku profilu a vyberte **Nastavení týmu**.
3. ID týmu se zobrazí v horní části stránky.
### Prvky týmu
Každý tým obsahuje následující klíčové prvky:
| Název pole | Popis |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| ID týmu | Jedinečný identifikátor týmu. |
| Název týmu | Název týmu. |
| Název společnosti | Název společnosti spojené s týmem. |
| Webové stránky společnosti | Oficiální URL adresa webových stránek společnosti. |
| Telefonní číslo | Kontaktní telefonní číslo společnosti. |
| Adresa společnosti | Fyzická adresa společnosti. |
| Poštovní směrovací číslo | Poštovní směrovací číslo pro adresu společnosti. |
| IČO | Identifikátor používaný pro obchodní nebo právní účely. |
| financoval reklamu | Subjekt financující reklamu, vyžadovaný pro soulad s regionálními zákony, jako je akt o digitálních službách (DSA) EU. |
### Definice polí API pro týmy
| Název pole | Popis |
| ---------------------- | ------------------------------------------------------------------------------------------------------------ |
| id | Jedinečné ID týmu. |
| name | Název týmu. |
| namespaceId | Jedinečný identifikátor jmenného prostoru. |
| companyName | Název společnosti, ke které tým patří. |
| companyWebsite | URL adresa webových stránek společnosti. |
| companyPhone | Starší pole. Telefonní číslo společnosti. |
| companyAddress | Objekt adresy pro umístění společnosti. |
| userIds | Jedinečné identifikátory uživatelů patřících do týmu. |
| reviewerEmail | E-mail pro oznámení, když kampaň vyžaduje kontrolu. Platí pouze pro tým primárního maloobchodníka. |
| sellerId | Jedinečné ID dodavatele/prodejce poskytnuté maloobchodníkem. Musí odpovídat ID poskytnutému maloobchodníkem. |
| notificationRecipients | Příjemci oznámení o kampani. |
### Dostupné koncové body
| Koncový bod | Popis |
| --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Create team](/retail-media-interface/partner/cs/team-user-api/team.md) |
Vytvoří nový tým. Tým představuje dodavatele, jako je inzerent, platforma pro správu reklamy nebo prodejce na tržišti.
Oprávnění\*\*: Maloobchodníci: Mohou vytvářet týmy jménem dodavatelů nebo inzerentů (vyžaduje konfiguraci). Z principu nastavení maloobchodníci nemohou vytvářet maloobchodní týmy. Dodavatelé: Mohou vytvářet týmy (pokud to maloobchodníci povolují).
|
| [Update a team](/retail-media-interface/partner/cs/team-user-api/team.md) |
Aktualizuje podrobnosti o týmu včetně názvu, informací o společnosti, telefonního čísla, URL webu a adresy. Poznámka: Tento koncový bod podléhá konfiguraci. Ujistěte se, že je ve vašem prostředí povolen příslušný příznak funkce nebo nastavení, abyste mohli toto API používat.
|
| [Lists all teams](/retail-media-interface/partner/cs/team-user-api/team.md) | Získává týmy pomocí parametrů: `name`, `namespace_id`, `seller_id`. Použijte `page_token` pro navigaci a`page_size` pro řízení počtu výsledků na stránku. |
| [Get team for specified ID](/retail-media-interface/partner/cs/team-user-api/team.md) | Získává podrobné informace o konkrétním týmu, včetně jeho členů. |
| [Join a team with invitation token](/retail-media-interface/partner/cs/team-user-api/team.md) | Umožňuje uživatelům připojit se k týmu pomocí platného pozvánkového tokenu. |
Časté dotazy a tipy pro řešení problémů naleznete v části [Často kladené dotazy](/retail-media-interface/partner/cs/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/cs/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.