> 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/user-1.md).
# Utente
## Panoramica
Gli utenti sono individui che appartengono a team e possono eseguire varie azioni all'interno del Epsilon Retail Media sistema in base ai loro permessi e ruoli.
### Cos'è un ID utente?
Un ID utente è un identificatore univoco per ciascun utente nel Epsilon Retail Media sistema. È richiesto nelle richieste API per identificare e gestire utenti specifici, come l'aggiornamento dei dettagli dell'utente, la modifica dei permessi o il recupero delle informazioni sull'utente.
### Trovare il tuo ID utente
Per utilizzare l'API User, avrai bisogno del tuo ID utente. Questo identifica l'utente specifico nelle richieste API. Puoi trovarlo così:
1. Accedi al tuo Citrus Client.
2. Fai clic sul menu a discesa del profilo e seleziona **Profilo utente**.
3. L'ID utente viene visualizzato nella sezione del profilo utente.
### Elementi dell'utente
Ciascun utente include i seguenti elementi chiave:
| Elemento | Descrizione |
| -------------------- | --------------------------------------------------------------- |
| ID utente | Un identificatore univoco per l'utente. |
| Email | L'indirizzo email dell'utente per l'accesso e le notifiche. |
| Nome | Il nome dell'utente. |
| Cognome | Il cognome dell'utente. |
| ID logo | Identificatore univoco dell'immagine del profilo dell'utente. |
| Appartenenze ai team | Elenco dei team a cui appartiene l'utente. |
| Permessi | Livello di accesso e permessi dell'utente all'interno dei team. |
| Stato dell'invito | Stato degli inviti al team in sospeso. |
### Definizioni dei campi dell'API User
Di seguito sono riportati i campi utente chiave comunemente utilizzati nelle richieste e risposte API:
| Nome del campo | Descrizione |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id | Identificatore univoco dell'utente. |
| email | ID email dell'utente. |
| namespace | Spazio dei nomi a cui appartiene l'utente. |
| firstName | Nome dell'utente. |
| lastName | Cognome dell'utente. |
| logoUrl | URL dell'immagine del profilo o del logo dell'utente. Puoi recuperare logoUrl utilizzando [Recupera l'URL del file](/retail-media-interface/partner/it/team-user-api/user-1/getfileurl.md). |
| teamIds | Elenco degli ID dei team dell'utente. |
| receivedInvitation | Dettagli degli inviti in sospeso. |
| inviteTeam | Oggetto radice per il payload dell'invito. |
| managerTeamId | ID univoco del team del rivenditore che gestisce l'accesso e invia gli inviti. Esempio: manager-team-123. |
| roleIds | Array delle stringhe di permesso dell'utente. |
| teamId | ID del team per l'invito dell'utente. |
| retailerTeamId | ID univoco del gruppo gestito dal rivenditore. |
| offset | Numero di record da saltare prima di recuperare i risultati. |
### Endpoint disponibili
| Endpoint | Descrizione |
| ------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Invita un utente nel team](/retail-media-interface/partner/it/team-user-api/user-1.md) | Invia un invito via email per unirsi a un team specificato. Richiede l'ID del team e l'indirizzo email dell'utente. |
| [Recupera i dettagli dell'utente corrente](/retail-media-interface/partner/it/team-user-api/user-1.md) |
Recupera le informazioni del profilo dell'utente autenticato, tra cui: -ID utente, email, nome, cognome e -Inviti al team in sospeso con i dettagli del mittente. Utilizza questo endpoint per visualizzare i dettagli dell'utente attualmente autenticato.
|
| [Recupera i dettagli dell'utente](/retail-media-interface/partner/it/team-user-api/user-1.md) |
Recupera le informazioni su altri utenti del team o su un utente specifico tramite ID utente. Richiede l'accesso appropriato (retailer o admin) all'interno del namespace e l'utente deve far parte del team. Questo endpoint viene utilizzato per la gestione degli utenti a livello di team.
|
| [Aggiorna i dettagli dell'utente corrente](/retail-media-interface/partner/it/team-user-api/user-1.md) | Modifica il nome, il cognome e l'ID del file logo dell'utente autenticato. Questo endpoint non supporta l'aggiornamento dei dettagli di altri utenti. |
| [Rimuovi un utente](/retail-media-interface/partner/it/team-user-api/user-1.md) | Rimuove un utente da un team (richiede autorizzazioni adeguate). |
| [Modifica l'autorizzazione dell'utente](/retail-media-interface/partner/it/team-user-api/user-1.md) |
Aggiorna le autorizzazioni utente tramite ID utente e ID team. Tipi di autorizzazione\*\*: -Retailer (Full o Report View) -Supplier (Full o Report View). Nota: I ruoli retailer e supplier non possono essere combinati.
|
| [Carica un file](/retail-media-interface/partner/it/team-user-api/user-1.md) | Carica i loghi per i profili utente e i team. |
| [Recupera l'URL del file](/retail-media-interface/partner/it/team-user-api/user-1.md) |
Genera l'URL di download temporaneo per i file caricati utilizzando l'ID del file. Nota: Gli URL sono validi solo per 3600 secondi.
|
Per domande frequenti e suggerimenti sulla 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/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.