> 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/es/team-user-api/user-1.md).
# Usuario
## Descripción general
Los usuarios son personas que pertenecen a equipos y pueden realizar varias acciones dentro del Epsilon Retail Media sistema en función de sus permisos y roles.
### ¿Qué es un User ID?
Un User ID es un identificador único para cada usuario en el Epsilon Retail Media sistema. Se requiere en las solicitudes de API para identificar y gestionar usuarios específicos, como actualizar los detalles del usuario, modificar los permisos o recuperar información del usuario.
### Cómo encontrar tu User ID
Para utilizar la API de usuarios, necesitarás tu User ID. Este identifica al usuario específico en las solicitudes de API. Puedes encontrarlo de la siguiente manera:
1. Inicia sesión en tu cliente de Citrus.
2. Haz clic en el menú desplegable del perfil y selecciona **Perfil de usuario**.
3. El User ID se muestra en la sección del perfil de usuario.
### Elementos del usuario
Cada usuario incluye los siguientes elementos clave:
| Elemento | Descripción |
| ----------------------- | --------------------------------------------------------------------------------------------- |
| User ID | Un identificador único para el usuario. |
| Correo electrónico | La dirección de correo electrónico del usuario para el inicio de sesión y las notificaciones. |
| Nombre | El nombre del usuario. |
| Apellidos | Los apellidos del usuario. |
| Logo ID | Identificador único de la imagen de perfil del usuario. |
| Membresías de equipo | Lista de equipos a los que pertenece el usuario. |
| Permisos | Nivel de acceso y permisos del usuario dentro de los equipos. |
| Estado de la invitación | Estado de las invitaciones de equipo pendientes. |
### Definiciones de campos de la API de usuarios
A continuación se presentan los campos de usuario clave utilizados habitualmente en las solicitudes y respuestas de la API:
| Nombre del campo | Descripción |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id | Identificador único del usuario. |
| email | ID de correo electrónico del usuario. |
| namespace | Namespace al que pertenece el usuario. |
| firstName | Nombre del usuario. |
| lastName | Apellidos del usuario. |
| logoUrl | URL de la imagen de perfil o logotipo del usuario. Puedes recuperar el logoUrl utilizando [Obtener la URL del archivo](/retail-media-interface/partner/es/team-user-api/user-1/getfileurl.md). |
| teamIds | Lista de los IDs de equipo del usuario. |
| receivedInvitation | Detalles de las invitaciones pendientes. |
| inviteTeam | Objeto raíz para la carga útil de la invitación. |
| managerTeamId | ID único del equipo de retailer que gestiona el acceso y envía las invitaciones. Ejemplo: manager-team-123. |
| roleIds | Array de cadenas de texto de permisos del usuario. |
| teamId | ID del equipo para la invitación del usuario. |
| retailerTeamId | ID único del grupo gestionado por el retailer. |
| offset | Número de registros que se deben omitir antes de recuperar los resultados. |
### Endpoints disponibles
| Endpoint | Descripción |
| ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Invitar a un usuario al equipo](/retail-media-interface/partner/es/team-user-api/user-1.md) | Envía una invitación por correo electrónico para unirse a un equipo especificado. Requiere el ID de equipo y la dirección de correo electrónico del usuario. |
| [Obtener detalles del usuario actual](/retail-media-interface/partner/es/team-user-api/user-1.md) |
Recupera la información del perfil del usuario que ha iniciado sesión, incluyendo: - ID de usuario, correo electrónico, nombre, apellido y - Invitaciones de equipo pendientes con los detalles del remitente. Utiliza este endpoint para ver los detalles del usuario que ha iniciado sesión actualmente.
|
| [Obtener detalles del usuario](/retail-media-interface/partner/es/team-user-api/user-1.md) |
Recupera información sobre otros usuarios del equipo o un usuario específico por ID de usuario. Requiere el acceso adecuado (retailer o admin) dentro del espacio de nombres, y el usuario debe formar parte del equipo. Este endpoint se utiliza para la gestión de usuarios a nivel de equipo.
|
| [Actualizar detalles del usuario actual](/retail-media-interface/partner/es/team-user-api/user-1.md) | Modifica el nombre, el apellido y el ID del archivo de logotipo del usuario que ha iniciado sesión. Este endpoint no permite actualizar los detalles de otros usuarios. |
| [Eliminar un usuario](/retail-media-interface/partner/es/team-user-api/user-1.md) | Elimina a un usuario de un equipo (requiere los permisos adecuados). |
| [Modificar permisos de usuario](/retail-media-interface/partner/es/team-user-api/user-1.md) |
Actualiza los permisos de usuario por ID de usuario e ID de equipo. Tipos de permisos\*\*: - Retailer (Full o Report View) - Supplier (Full o Report View). Nota: Los roles de retailer y supplier no se pueden combinar.
|
| [Cargar un archivo](/retail-media-interface/partner/es/team-user-api/user-1.md) | Carga logotipos para perfiles de usuario y equipos. |
| [Obtener la URL del archivo](/retail-media-interface/partner/es/team-user-api/user-1.md) |
Genera una URL de descarga temporal para los archivos cargados utilizando el ID del archivo. Nota: Las URL solo son válidas durante 3600 segundos.
|
Para preguntas frecuentes y consejos de resolución de problemas, consulta [Preguntas frecuentes](/retail-media-interface/partner/es/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/es/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.