> 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/sk/team-user-api/team.md).

# Tím

## Prehľad

Teams API umožňuje predajcom, inzerentom a dodávateľom spravovať tímy a používateľov programovo cez API koncové body.

### Cieľová skupina

* Predajcovia: Spravujte tímy dodávateľov a spolupracujte s reklamnými partnermi.
* Inzerenti: Vytvárajte a spravujte tímy pre spoluprácu na kampaniach.
* Vývojári: Integrujte správu tímov do aplikácií.
* Platforma na správu reklám: Uľahčujte pracovné postupy vytvárania a správy tímov.

### Správa tímov

V Epsilon Retail Media systéme tímy predstavujú buď dodávateľov (inzerentov) alebo predajcov. Tímy dodávateľov vytvárajú kampane, zatiaľ čo tímy predajcov ich kontrolovať a spravovať. Používatelia môžu patriť do viacerých tímov, z ktorých každý má vlastnú množinu používateľov, kampaní a peňaženiek.

#### Čo je ID tímu?

ID tímu je jedinečný identifikátor pre každý tím v Epsilon Retail Media systéme. Vyžaduje sa v požiadavkách API na prepojenie akcií sa správnym tímom predajcu alebo dodávateľa, ako je generovanie reklám, správa používateľov alebo získavanie výkazov kampaní na úrovni tímu.

#### Vyhľadanie vášho ID tímu

Ak chcete používať Teams API, budete potrebovať svoje ID tímu. To identifikuje tím predajcu alebo dodávateľa v požiadavkách API. Nájdete ho takto:

1. Prihláste sa do svojho Citrus Klienta.
2. Kliknite na rozbaľovaciu ponuku profilu a vyberte **Team Settings**.
3. ID tímu sa zobrazuje v hornej časti stránky.

<figure><img src="/files/MXgaLnh8IQIccft1Kwup" alt="" width="100%"><figcaption></figcaption></figure>

### Prvky tímu

Každý tím obsahuje nasledujúce kľúčové prvky:

| Názov poľa                 | Popis                                                                                                                   |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| ID tímu                    | Jedinečný identifikátor pre tím.                                                                                        |
| Názov tímu                 | Názov tímu.                                                                                                             |
| Názov spoločnosti          | Názov spoločnosti spojenej s tímom.                                                                                     |
| Webová stránka spoločnosti | URL adresa oficiálnej webovej stránky spoločnosti.                                                                      |
| Telefónne číslo            | Kontaktné telefónne číslo spoločnosti.                                                                                  |
| Adresa spoločnosti         | Fyzická adresa spoločnosti.                                                                                             |
| Poštové smerovacie číslo   | Poštové smerovacie číslo pre adresu spoločnosti.                                                                        |
| IČO / Obchodné ID          | Identifikátor používaný na obchodné alebo právne účely.                                                                 |
| financovateľ reklamy       | Subjekt financujúci reklamu, vyžadovaný pre súlad s regionálnymi zákonmi, ako je Zákon o digitálnych službách EÚ (DSA). |

### Definície polí Team API

| Názov poľa             | Popis                                                                                                    |
| ---------------------- | -------------------------------------------------------------------------------------------------------- |
| id                     | Jedinečné ID tímu.                                                                                       |
| name                   | Názov tímu.                                                                                              |
| namespaceId            | Jedinečný identifikátor menného priestoru.                                                               |
| companyName            | Názov spoločnosti, do ktorej tím patrí.                                                                  |
| companyWebsite         | URL adresa webovej stránky spoločnosti.                                                                  |
| companyPhone           | Pôvodné pole. Telefónne číslo spoločnosti.                                                               |
| companyAddress         | Objekt adresy pre sídlo spoločnosti.                                                                     |
| userIds                | Jedinečné identifikátory používateľov patriacich do tímu.                                                |
| reviewerEmail          | E-mail na odoslanie oznámenia, keď kampaň vyžaduje kontrolu. Použiteľné len pre tím primárneho predajcu. |
| sellerId               | Jedinečné ID dodávateľa/predajcu poskytnuté predajcom. Musí sa zhodovať s ID poskytnutým predajcom.      |
| notificationRecipients | Príjemcovia oznámení o kampani.                                                                          |

### Dostupné koncové body

| Koncový bod                                                                                   | Popis                                                                                                                                                                                                                                                                                                                                                                                              |
| --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Create team](/retail-media-interface/partner/sk/team-user-api/team.md)                       | <p>Vytvorí nový tím. Tím zastupuje dodávateľa, ako je inzerent, platforma na spravovanie reklamy alebo predajca na trhovisku.<br><br>Povolenia\*\*:<br>Maloobchodníci: Môžu vytvárať tímy v mene dodávateľov alebo inzerentov (vyžaduje konfiguráciu). Na základe návrhu maloobchodníci nemôžu vytvárať maloobchodné tímy.<br>Dodávatelia: Môžu vytvárať tímy (ak to maloobchodníci povoľujú).</p> |
| [Update a team](/retail-media-interface/partner/sk/team-user-api/team.md)                     | <p>Aktualizuje podrobnosti o tíme vrátane názvu, informácií o spoločnosti, telefónneho čísla, URL adresy webovej lokality a adresy.<br><strong>Poznámka</strong>: Tento koncový bod podlieha konfigurácii. Uistite sa, že príslušný príznak funkcie alebo nastavenie je vo vašom prostredí povolené, aby ste mohli používať toto API.</p>                                                          |
| [Lists all teams](/retail-media-interface/partner/sk/team-user-api/team.md)                   | Získa tímy pomocou parametrov: `name`, `namespace_id`, `seller_id`. Použite `page_token` na navigáciu a`page_size` na riadenie počtu výsledkov na stránku.                                                                                                                                                                                                                                         |
| [Get team for specified ID](/retail-media-interface/partner/sk/team-user-api/team.md)         | Získa podrobné informácie o konkrétnom tíme vrátane jeho členov.                                                                                                                                                                                                                                                                                                                                   |
| [Join a team with invitation token](/retail-media-interface/partner/sk/team-user-api/team.md) | Umožňuje používateľom pripojiť sa k tímu pomocou platného pozývacieho tokenu.                                                                                                                                                                                                                                                                                                                      |

Často kladené otázky a tipy na riešenie problémov nájdete v časti [Často kladené otázky](/retail-media-interface/partner/sk/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/sk/team-user-api/team.md?ask=<question>&goal=<endgoal>
```

`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.
