> 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/it/team-user-api/team.md).
# Team
## Panoramica
L'API Teams consente a retailer, inserzionisti e fornitori di gestire i team e gli utenti in modo programmatico tramite endpoint API.
### Pubblico di destinazione
* Retailer: gestisci i team dei fornitori e collabora con i partner pubblicitari.
* Inserzionisti: crea e gestisci i team per la collaborazione alle campagne.
* Sviluppatori: integra la gestione dei team nelle applicazioni.
* Piattaforma di gestione pubblicitaria: facilita i flussi di lavoro di creazione e gestione dei team.
### Gestione dei team
Nel Epsilon Retail Media sistema, i team rappresentano fornitori (inserzionisti) o retailer. I team dei fornitori creano le campagne, mentre i team dei retailer le esaminano e le gestiscono. Gli utenti possono appartenere a più team, ciascuno con il proprio set di utenti, campagne e wallet.
#### Che cos'è un Team ID?
Un Team ID è un identificatore univoco per ciascun team nel Epsilon Retail Media sistema. È richiesto nelle richieste API per associare le azioni al team retailer o fornitore corretto, come la generazione di annunci, la gestione degli utenti o il recupero dei report delle campagne a livello di team.
#### Trovare il tuo Team ID
Per utilizzare l'API Teams, avrai bisogno del tuo Team ID. Questo identifica il team retailer o fornitore nelle richieste API. Puoi trovarlo così:
1. Accedi al tuo Citrus Client.
2. Fai clic sul menu a discesa del profilo e seleziona **Impostazioni team**.
3. Il Team ID è visualizzato nella parte superiore della pagina.
### Elementi del team
Ciascun team include i seguenti elementi chiave:
| Nome campo | Descrizione |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Team ID | Un identificatore univoco per il team. |
| Nome del team | Il nome del team. |
| Ragione sociale | Il nome dell'azienda associata al team. |
| Sito web dell'azienda | L'URL del sito web ufficiale dell'azienda. |
| Numero di telefono | Il numero di telefono di contatto dell'azienda. |
| Indirizzo dell'azienda | L'indirizzo fisico dell'azienda. |
| Codice postale | Il codice postale dell'indirizzo dell'azienda. |
| ID aziendale | Un identificatore utilizzato per scopi aziendali o legali. |
| finanziatore dell'annuncio | Entità che finanzia l'annuncio pubblicitario, richiesta per la conformità alle leggi regionali come il Digital Services Act (DSA) dell'UE. |
### Definizioni dei campi dell'API Team
| Nome campo | Descrizione |
| ---------------------- | --------------------------------------------------------------------------------------------------------------- |
| id | L'ID univoco del team. |
| name | Il nome del team. |
| namespaceId | L'identificatore univoco del namespace. |
| companyName | Il nome dell'azienda a cui appartiene il team. |
| companyWebsite | L'URL del sito web dell'azienda. |
| companyPhone | Campo legacy. Il numero di telefono dell'azienda. |
| companyAddress | L'oggetto indirizzo per la sede dell'azienda. |
| userIds | Identificatori univoci degli utenti appartenenti al team. |
| reviewerEmail | Email da notificare quando una campagna richiede una revisione. Applicabile solo al team del Retailer primario. |
| sellerId | ID univoco del fornitore/venditore fornito da un Retailer. Deve corrispondere all'ID fornito dal retailer. |
| notificationRecipients | Destinatari delle notifiche della campagna. |
### Endpoint disponibili
| Endpoint | Descrizione |
| ----------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Crea team](/retail-media-interface/partner/it/team-user-api/team.md) |
Crea un nuovo team. Un team rappresenta un fornitore come un inserzionista, una piattaforma di gestione pubblicitaria o un venditore del marketplace.
Autorizzazioni\*\*: Retailer: possono creare team per conto di fornitori o inserzionisti (richiede la configurazione). Per progettazione, i retailer non possono creare team di retailer. Fornitori: possono creare team (se consentito dai retailer).
|
| [Aggiorna un team](/retail-media-interface/partner/it/team-user-api/team.md) |
Aggiorna i dettagli del team inclusi nome, informazioni aziendali, numero di telefono, URL del sito web e indirizzo. Nota: questo endpoint è soggetto a configurazione. Assicurati che il feature flag o l'impostazione pertinente sia abilitata nel tuo ambiente per utilizzare questa API.
|
| [Elenca tutti i team](/retail-media-interface/partner/it/team-user-api/team.md) | Recupera i team utilizzando i parametri: `name`, `namespace_id`, `seller_id`. Usa `page_token` per la navigazione e`page_size` per controllare i risultati per pagina. |
| [Ottieni il team per l'ID specificato](/retail-media-interface/partner/it/team-user-api/team.md) | Recupera informazioni dettagliate su un team specifico, inclusi i suoi membri. |
| [Unisciti a un team con il token di invito](/retail-media-interface/partner/it/team-user-api/team.md) | Consente agli utenti di unirsi a un team utilizzando un token di invito valido. |
Per le domande frequenti e i suggerimenti per la risoluzione dei problemi, consulta [Domande frequenti](/retail-media-interface/partner/it/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/it/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.