> 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/team.md). # Equipo ## Descripción general La API de Teams permite a los minoristas, anunciantes y proveedores gestionar equipos y usuarios de forma programática a través de puntos de enlace de la API. ### Público objetivo * Minoristas: gestionen equipos de proveedores y colaboren con socios publicitarios. * Anunciantes: creen y gestionen equipos para la colaboración en campañas. * Desarrolladores: integren la gestión de equipos en las aplicaciones. * Plataforma de gestión de anuncios: facilite los flujos de trabajo de creación y gestión de equipos. ### Gestión de equipos En el Epsilon Retail Media sistema, los equipos representan a proveedores (anunciantes) o minoristas. Los equipos de proveedores crean campañas, mientras que los equipos de minoristas las revisan y gestionan. Los usuarios pueden pertenecer a varios equipos, cada uno con su propio conjunto de usuarios, campañas y monederos. #### ¿Qué es un Team ID? Un Team ID es un identificador único para cada equipo en el Epsilon Retail Media sistema. Es obligatorio en las solicitudes de la API para asociar acciones con el equipo de minorista o proveedor correcto, como generar anuncios, gestionar usuarios o recuperar informes de campaña a nivel de equipo. #### Cómo encontrar su Team ID Para utilizar la API de Teams, necesitará su Team ID. Este identifica al equipo de minorista o proveedor en las solicitudes de la API. Puede encontrarlo de la siguiente manera: 1. Inicie sesión en su Citrus Client. 2. Haga clic en el menú desplegable del perfil y seleccione **Team Settings**. 3. El Team ID se muestra en la parte superior de la página.
### Elementos del equipo Cada equipo incluye los siguientes elementos clave: | Nombre del campo | Descripción | | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | Team ID | Un identificador único para el equipo. | | Nombre del equipo | El nombre del equipo. | | Nombre de la empresa | El nombre de la empresa asociada con el equipo. | | Sitio web de la empresa | La URL del sitio web oficial de la empresa. | | Número de teléfono | El número de teléfono de contacto de la empresa. | | Dirección de la empresa | La dirección física de la empresa. | | Código postal | El código postal de la dirección de la empresa. | | ID comercial | Un identificador utilizado con fines comerciales o legales. | | financiador del anuncio | Entidad que financia el anuncio, requerida para cumplir con las leyes regionales como la Ley de Servicios Digitales (DSA) de la UE. | ### Definiciones de campos de la API de Teams | Nombre del campo | Descripción | | ---------------------- | -------------------------------------------------------------------------------------------------------------------------- | | id | El ID único del equipo. | | name | El nombre del equipo. | | namespaceId | El identificador único del espacio de nombres. | | companyName | El nombre de la empresa a la que pertenece el equipo. | | companyWebsite | La URL del sitio web de la empresa. | | companyPhone | Campo heredado. El número de teléfono de la empresa. | | companyAddress | El objeto de dirección de la ubicación de la empresa. | | userIds | Identificadores únicos de los usuarios que pertenecen al equipo. | | reviewerEmail | Correo electrónico para notificar cuando una campaña necesita revisión. Aplicable solo al equipo de minorista principal. | | sellerId | ID único de proveedor/comerciante proporcionado por un minorista. Debe coincidir con el ID proporcionado por el minorista. | | notificationRecipients | Destinatarios de las notificaciones de campaña. | ### Puntos de enlace disponibles | Punto de enlace | Descripción | | ------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Crear equipo](/retail-media-interface/partner/es/team-user-api/team.md) |

Crea un nuevo equipo. Un equipo representa a un proveedor, como un anunciante, una plataforma de gestión de anuncios o un vendedor del marketplace.

Permisos\*\*:
Minoristas: Pueden crear equipos en nombre de proveedores o anunciantes (requiere configuración). Por diseño, los minoristas no pueden crear equipos de minoristas.
Proveedores: Pueden crear equipos (si lo permiten los minoristas).

| | [Actualizar un equipo](/retail-media-interface/partner/es/team-user-api/team.md) |

Actualiza los detalles del equipo, incluyendo el nombre, la información de la empresa, el número de teléfono, la URL del sitio web y la dirección.
Nota: Este endpoint está sujeto a configuración. Asegúrese de que la marca de función (feature flag) o ajuste relevante esté habilitado en su entorno para usar esta API.

| | [Muestra una lista de todos los equipos](/retail-media-interface/partner/es/team-user-api/team.md) | Recupera equipos utilizando parámetros: `name`, `namespace_id`, `seller_id`. Utilice `page_token` para la navegación y`page_size` para controlar los resultados por página. | | [Obtener equipo para el ID especificado](/retail-media-interface/partner/es/team-user-api/team.md) | Recupera información detallada sobre un equipo específico, incluidos sus miembros. | | [Unirse a un equipo con token de invitación](/retail-media-interface/partner/es/team-user-api/team.md) | Permite a los usuarios unirse a un equipo mediante un token de invitación válido. | Para preguntas frecuentes y consejos de resolución de problemas, consulte [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/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.