> 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/partner-api-overview/epsilon-retail-media-partner-apis-overview-1.md).
# Descripción general de las API de socios de Epsilon Retail Media
Le damos la bienvenida a la Epsilon Retail Media Partner API. Esta guía le ayuda a integrarse con nuestra plataforma publicitaria para gestionar sus campañas, monederos, equipos y usuarios de forma programática. También puede realizar un seguimiento del rendimiento y hacer crecer su negocio de manera eficaz.
## ¿Qué es una API?
Una API son las siglas en inglés de Interfaz de Programación de Aplicaciones. Una API actúa como intermediario permitiendo que dos componentes de software se comuniquen mediante un conjunto de funciones y procedimientos. Las API se utilizan comúnmente para obtener o enviar datos, accediendo a funciones y servicios de otras aplicaciones.
## ¿Qué es la Partner API?
Nuestra Partner API le da acceso programático a casi todo lo que puede hacer en la Epsilon interfaz de usuario de las plataformas de En el sitio Campaign Management. Esto significa que en lugar de hacer clic manualmente en la aplicación, sus sistemas o desarrolladores pueden conectarse directamente a nuestra plataforma y automatizar, personalizar o integrar sus funciones en sus propias herramientas o flujos de trabajo.
La Partner API es utilizada por muchos minoristas y socios, incluidos agregadores como Pacvue, Skai y Commerce IQ.
## Descripción general de la API
La Epsilon Retail Media Partner API permite la gestión programática de retail media [Campañas](/retail-media-interface/partner/es/campaign-management-api/productcampaign-1/createproductcampaign.md), [Equipo](/retail-media-interface/partner/es/team-user-api/team.md) & [Usuario](/retail-media-interface/partner/es/team-user-api/user-1/createuserteaminvite.md), y [Billeteras](/retail-media-interface/partner/es/billing-api/wallet.md). Utilícela para crear y actualizar campañas en múltiples formatos publicitarios, incluidos anuncios de productos patrocinados (SPA), banners estáticos y creatividades responsivas. Banner X anuncios.
Nuestra Partner API es una API basada en REST que utiliza protocolos comunes GET, POST, PATCH y DELETE a través de cargas JSON.
## Beneficios clave
* Automatice las operaciones de campañas, equipos y usuarios, y monederos a través de puntos de enlace de la API REST.
* Gestione múltiples campañas y recursos de manera eficiente con soporte para operaciones masivas.
* Le permite orquestar llamadas a la API para que se adapten a su flujo de trabajo y arquitectura de sistema existentes.
* Cree y gestione campañas en anuncios de productos patrocinados, banners y Banner X formatos.
* Autenticación basada en clave de usuario con tokens por tiempo limitado para interacciones seguras con la API.
## Requisitos previos
Antes de utilizar la Partner API, asegúrese de cumplir con los siguientes requisitos:
### Acceso al espacio de nombres
Debe tener acceso a su espacio de nombres designado, que actúa como contenedor para sus datos y configuraciones. Póngase en contacto con el Epsilon equipo de Soporte para obtener los detalles de configuración del espacio de nombres específicos para sus minoristas.
### Pertenencia al equipo
Debe formar parte de un equipo de proveedor o de minorista principal con los permisos adecuados dentro de su espacio de nombres.
### Solicitud de incorporación a la API
Los agregadores de anuncios, agencias y marcas socias deben realizar una solicitud de incorporación a la API antes de utilizar las Partner APIs. Utilice el formulario de incorporación oficial al que se hace referencia en [KB0040933](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040933)para iniciar una nueva conexión API.
### Acceso a la API de informes
Debe tener acceso a la API de informes (almacén de datos BigQuery) para consultar tablas relevantes como dim\_product, dim\_catalog y dim\_placement. Esto ayuda a validar la preparación de la integración y a explorar los metadatos.
### Metadatos requeridos
Asegúrese de que su catálogo de productos, ubicación e información del equipo estén creados y disponibles en su espacio de nombres. Puede verificar esto consultando las tablas adecuadas de BigQuery.
Si no tiene acceso a BigQuery, solicítelo a través del formulario oficial de solicitud de acceso a la API. Según sus necesidades, consulte el artículo correspondiente de la base de conocimientos:
* **Cambiar/Eliminar punto de enlace de la API de BigQuery de informes**: Necesita modificar un punto de enlace de API existente - [KB0040934](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040934).
* NUEVA Partner API (API de informes)\*\* - [KB0040947](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040947).
{% hint style="info" %}
Nota de acceso: Algunos enlaces de este documento apuntan a recursos internos o restringidos. Asegúrese de haber iniciado sesión con las credenciales adecuadas para acceder al contenido.
{% endhint %}
## Primeros pasos con las Partner APIs
### Requisitos de autenticación
La Partner API utiliza un proceso de autorización que requiere una clave de usuario. Los tokens de acceso se recuperan llamando a la API de autenticación mediante clave de usuario:
* Su clave de usuario recuperada se pasa en el encabezado de esta solicitud.
* El token de acceso recuperado se utiliza posteriormente en cualquier llamada a métodos de la Partner API.
* Los tokens caducan un poco antes de cumplir las 24 horas desde su generación.
{% hint style="info" %}
Se debe solicitar un nuevo token cuando caduque el anterior. Un cliente no debe generar un nuevo token con cada solicitud a nuestra API.
{% endhint %}
### Obtenga sus credenciales de la API
Para empezar a utilizar las Epsilon Retail Media Partner APIs, necesita la siguiente información. Si no está seguro de alguno de los detalles, póngase en contacto con su Soporte o abra un ticket para obtener asistencia.
* Su clave de usuario para la autenticación.
* La URL base para realizar llamadas a la API.
### Recupere su clave de usuario
1. Inicie sesión en su Epsilon Retail Media cuenta de equipo.
2. Elija un equipo.
3. En el menú desplegable del perfil, seleccione **Configuración de usuario**.
4. Navegue a la pestaña **Clave de usuario**.
5. Haga clic en **Mostrar** para revelar su clave API.
Utilice esta clave para autenticar sus solicitudes de API. Epsilon Retail Media utiliza autenticación basada en clave de usuario. Intercambie su clave de usuario por un token de acceso por tiempo limitado para autorizar solicitudes de API. Para obtener más información, consulte [Solicitudes de autenticación](/retail-media-interface/partner/es/partner-api-authentication/authenticating-requests.md).
### Obtenga su URL base
Póngase en contacto con su Soporte para obtener la URL base correcta para su entorno. Punto de enlace de ejemplo:
```
https://campaign..citrusad.com/v3/campaigns
```
Una vez que tenga su clave de usuario, puede autenticarse y comenzar a realizar llamadas a la API para:
* Ver y gestionar sus campañas publicitarias.
* Gestionar sus presupuestos publicitarios y gastos.
* Gestionar los detalles de su equipo y usuarios.
## Configurar el entorno
Epsilon Retail Media proporciona dos entornos distintos para cada minorista: Producción y Sandbox. Ambos entornos se crean de forma predeterminada cuando se incorpora a un minorista.
### Entorno de Sandbox
{% hint style="info" %}
El acceso a Sandbox normalmente se proporciona solo a minoristas y agregadores. Si no está seguro de su elegibilidad, póngase en contacto con Soporte.
{% endhint %}
Utilice este entorno seguro para probar su integración antes de pasar a producción. Los minoristas deben utilizar este entorno para validar las llamadas a la API, probar la carga de catálogos, simular la creación de campañas y garantizar la funcionalidad de extremo a extremo antes de pasar a producción. Utilice el Sandbox para todas las actividades de desarrollo, prueba y control de calidad. Cada minorista tiene una URL de Sandbox única, normalmente con el formato:
```
https://-sandbox.citrusad.com
```
El entorno de Sandbox incluye:
### Entorno de producción
Cambie a producción únicamente después de una validación exitosa en Sandbox. El entorno de producción se utiliza para campañas en vivo y entrega de anuncios en tiempo real. Admite operaciones a gran escala, incluidas actualizaciones de catálogos, sincronización de pedidos y seguimiento del rendimiento publicitario. La URL de producción sigue este formato:
```
https://.citrusad.com
```
Asegúrese de que todos los datos (catálogos, productos, pedidos) sean precisos y estén completos antes de utilizar este entorno.
{% hint style="info" %}
Confirma siempre que el entorno sea el correcto antes de realizar llamadas a la API, especialmente al utilizar credenciales y URL base. Es posible que la URL base no siempre coincida con el namespace, según la configuración de integración del retailer.
{% endhint %}
## Endpoints de la API para socios
Epsilon Retail Media La API ofrece un conjunto de características principales agrupadas en categorías funcionales, cada una respaldada por endpoints dedicados. La tabla a continuación resume las principales API orientadas a socios, su propósito y los métodos HTTP utilizados.
### Gestión de campañas
**¿Qué es un anuncio de Sponsored Product?** Los anuncios de Sponsored Product (SPA) son anuncios ubicados en las cuadrículas de productos del sitio del retailer, que se encuentran habitualmente en las páginas de búsqueda y categoría, así como en la PDP y la página principal, superpuestos entre las publicaciones orgánicas.
**¿Qué es un Banner X Ad?** Banner X anuncios son unidades publicitarias totalmente adaptables que crecen y cambian según la pantalla del usuario. Están compuestas por numerosos elementos de Creatividad, desde imágenes principales y de fondo hasta textos de encabezado y botones de llamada a la acción.
**¿Qué es un anuncio de Banner?** Un Banner estándar es una imagen estática con una URL de clic detrás.
#### Campaña de producto
| Endpoint | Descripción | Método |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------ |
| [Crear una campaña de producto](/retail-media-interface/partner/es/campaign-management-api/productcampaign-1/createproductcampaign.md) | Crea una nueva campaña de producto utilizando los detalles proporcionados en el cuerpo de la solicitud. | POST |
| [Obtener la lista de todas las campañas de productos](/retail-media-interface/partner/es/campaign-management-api/productcampaign-1/listproductcampaigns.md) | Recupera una lista de todas las campañas de productos según los parámetros proporcionados. | GET |
| [Actualizar una campaña de producto](/retail-media-interface/partner/es/campaign-management-api/productcampaign-1/updateproductcampaign.md) | Actualiza una campaña de producto existente utilizando el ID de la campaña | PATCH |
| [Obtener campaña de producto por ID](/retail-media-interface/partner/es/campaign-management-api/productcampaign-1/getproductcampaign-1.md) | Recupera los detalles de la campaña de producto para el ID de campaña especificado. | GET |
| [Cambiar el estado de aprobación de una campaña de producto](/retail-media-interface/partner/es/campaign-management-api/productcampaign-1/approveproductcampaign-1.md) | Actualiza el estado de aprobación de una campaña de producto especificada. | POST |
| [Comprobar la viabilidad de reserva para campañas de Ubicación fija](/retail-media-interface/partner/es/campaign-management-api/productcampaign-1/checkfixedtenancyavailable-1.md) | Comprueba si la reserva es factible para campañas de Ubicación fija. | POST |
#### Banner X Campaña
| Endpoint | Descripción | Método |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Crear una campaña de Banner X](/retail-media-interface/partner/es/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md) | Crea una nueva campaña de banner X utilizando los detalles proporcionados en el cuerpo de la solicitud. | POST |
| [Obtener detalles de la campaña de Banner X](/retail-media-interface/partner/es/campaign-management-api/bannerxcampaign-1/getbannerxcampaign-1.md) | Recupera los detalles de la campaña de banner X para el ID de campaña especificado. | GET |
| [Actualizar campaña de Banner X](/retail-media-interface/partner/es/campaign-management-api/bannerxcampaign-1/updatebannerxcampaign.md) | Actualiza una Banner X campaña existente proporcionando el ID de la campaña y los datos de la campaña actualizados en el cuerpo de la solicitud. | PATCH |
| [Actualizar el estado de aprobación de la campaña de Banner X](/retail-media-interface/partner/es/campaign-management-api/bannerxcampaign-1/approvebannerxcampaign-1.md) | Actualiza el estado de aprobación de una campaña de banner X especificada. | POST |
| [Obtener la lista de todas las campañas de Banner X](/retail-media-interface/partner/es/campaign-management-api/bannerxcampaign-1/listbannerxcampaigns.md) | Recupera una lista de campañas de banner X según los filtros y parámetros especificados, incluidos el nombre de la campaña, el ID de ubicación, el ID de equipo, el estado de aprobación y más. | GET |
#### Campaña de Banner
| Endpoint | Descripción | Método |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ------ |
| [Crear una campaña de banner](/retail-media-interface/partner/es/campaign-management-api/bannercampaign/createbannercampaign-1.md) | Crea una nueva campaña de banner utilizando los detalles proporcionados en el cuerpo de la solicitud. | POST |
| [Obtener detalles de la campaña de banner](/retail-media-interface/partner/es/campaign-management-api/bannercampaign/getbannercampaign-1.md) | Recupera los detalles de la campaña de banner para el ID de campaña especificado. | GET |
| [Actualizar campaña de banner](/retail-media-interface/partner/es/campaign-management-api/bannercampaign/updatebannercampaign.md) | Actualiza una campaña de banner existente utilizando el ID de la campaña. | PATCH |
| [Actualizar el estado de aprobación de la campaña de banner](/retail-media-interface/partner/es/campaign-management-api/bannercampaign/approvebannercampaign.md) | Actualiza el estado de aprobación de una campaña de banner especificada | POST |
#### Archivos de campaña
| Endpoint | Descripción | Método |
| ------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | ------ |
| [Cargar un archivo de campaña](/retail-media-interface/partner/es/campaign-management-api/creativeassets/uploadfile.md) | Carga diferentes tipos de archivos de campaña | POST |
| [Obtener la URL del archivo de la campaña](/retail-media-interface/partner/es/campaign-management-api/creativeassets/getcampaignfileurl.md) | Recupera la URL de un archivo de campaña utilizando el ID de archivo y el tipo de archivo especificados. | POST |
#### Estándar de contenido
| Endpoint | Descripción | Método |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Obtener detalles del estándar de contenido de Banner X](/retail-media-interface/partner/es/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md) | Recupera Banner X los detalles del estándar de contenido para el ID de estándar de contenido especificado. | GET |
| [Obtener los estándares de contenido de la lista para campañas de Banner X](/retail-media-interface/partner/es/campaign-management-api/bannerxcontentstandard/listbannerxcontentstandard.md) | Recupera la lista de estándares de contenido para Banner X campañas en función de los parámetros especificados, como el namespace, el nombre y el ID del estándar de contenido. | GET |
| [Obtener detalles del estándar de contenido del banner](/retail-media-interface/partner/es/campaign-management-api/bannerxcontentstandard/getbannercontentstandard.md) | Recupera los detalles del estándar de contenido de Banner para el ID de estándar de contenido especificado. | GET |
| [Obtener los estándares de contenido de la lista para campañas de banner](/retail-media-interface/partner/es/campaign-management-api/bannerxcontentstandard/listbannercontentstandard.md) | Recupera la lista de estándares de contenido para campañas de banner en función de los parámetros especificados, como el namespace, el nombre y el ID del estándar de contenido. | GET |
#### Campaña
| Endpoint | Descripción | Método |
| ------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Obtener la lista de todas las campañas](/retail-media-interface/partner/es/campaign-management-api/campaign/listcampaigns-1.md) | Recupera una lista de campañas según los filtros y parámetros especificados, incluidos el nombre de la campaña, el tipo de campaña, el ID de ubicación, el ID de equipo, el estado de aprobación y más. | POST |
| [Obtener el historial de la campaña](/retail-media-interface/partner/es/campaign-management-api/campaign/getcampaignhistory.md) | Recupera el historial de una campaña utilizando su ID de campaña. | GET |
| [Obtener detalles de la puja mínima para palabras clave](/retail-media-interface/partner/es/campaign-management-api/campaign/retrievekeywordsminbid.md) | Recupera los detalles de la puja mínima individual y la puja mínima general de la campaña para un conjunto de palabras clave especificadas en campañas de tipo de ubicación de Búsqueda y Categoría y Búsqueda. | POST |
| [Obtener detalles de la puja mínima para la categoría](/retail-media-interface/partner/es/campaign-management-api/campaign/retrievecategoryminbid.md) | Recupera los detalles de la puja mínima individual y la puja mínima general de la campaña para campañas de tipo de ubicación de categoría. | POST |
## Gestión de activos creativos
### ¿Qué es un activo creativo?
Los activos creativos son imágenes utilizadas en campañas de Banner y Banner X . Estos activos deben cumplir con requisitos técnicos específicos para garantizar una visualización y un rendimiento adecuados.
### Directrices de carga:
* Tamaño de archivo < 4 MB
* Tipos de archivo: PNG, JPEG, JPG, GIF, SVG y PDF
* Un archivo a la vez
* El ID de equipo, el ID de espacio y el ID de estándar de contenido son obligatorios
* Proporciona una ruta absoluta completa al archivo
{% hint style="info" %}
Las cargas de activos creativos se gestionan a través de los endpoints de Archivo de campaña enumerados en la sección Gestión de campañas anterior.
{% endhint %}
## Gestión de estándares de contenido
### ¿Qué es un estándar de contenido?
Los estándares de contenido son directrices y parámetros técnicos que dictan cómo debe mostrarse un anuncio de Banner o Banner X dentro de un espacio designado en un sitio web o plataforma digital. Los estándares incluyen parámetros como las dimensiones y el tamaño, el formato y tamaño de archivo, la resolución y la calidad, el posicionamiento y la alineación, las restricciones de contenido y la interactividad.
### Gestión de usuarios y equipos
#### ¿Qué es un equipo?
Un equipo es una colección de usuarios y se clasifica como un equipo de proveedor (anunciante) o de retailer. Los equipos de proveedores suelen crear campañas, mientras que los retailers revisan las campañas y realizan tareas administrativas. Un usuario en el sistema puede pertenecer a varios equipos o solo a uno. Normalmente, un equipo tendrá usuarios, campañas y billeteras asociados a él.
#### Equipo
| Endpoint | Descripción | Método |
| ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- | ------ |
| [Crear equipo](/retail-media-interface/partner/es/team-user-api/team/createteam-1.md) | Crea un nuevo equipo. | POST |
| Actualizar un equipo | Actualiza los detalles de un equipo especificado por el team\_id. | PATCH |
| Listar todos los equipos | Recupera una lista de equipos proporcionando parámetros como name, namespace\_id y seller\_id. | GET |
| [Obtener equipo para el ID especificado](/retail-media-interface/partner/es/team-user-api/team/getteam-1.md) | Recupera información detallada sobre un equipo específico, incluidos sus miembros. | GET |
| Unirse a un equipo con token de invitación | Permite a los usuarios unirse a un equipo utilizando un token de invitación válido y no expirado. | POST |
#### Usuario
| Endpoint | Descripción | Método |
| ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ------ |
| [Invitar a un usuario al equipo](/retail-media-interface/partner/es/team-user-api/user-1/createuserteaminvite.md) | Envía una invitación a un usuario para unirse a un equipo especificado. | POST |
| Recuperar detalles de usuario mediante ID de usuario | Recupera los detalles del usuario que ha iniciado sesión actualmente en la Epsilon Retail Media plataforma. | GET |
| [Obtener detalles del usuario](/retail-media-interface/partner/es/team-user-api/user-1/getusersforteam.md) | Recupera los detalles del usuario según el ID de equipo proporcionado. | GET |
| [Actualizar detalles del usuario actual](/retail-media-interface/partner/es/team-user-api/user-1/updateuserprofile.md) | Modifica los detalles del usuario que ha iniciado sesión actualmente en la Epsilon Retail Media plataforma. | PATCH |
| [Modificar permisos de usuario](/retail-media-interface/partner/es/team-user-api/user-1/modifyuserpermission.md) | Actualiza los permisos de un usuario proporcionando tanto el ID de usuario como el ID de equipo. | PATCH |
| [Cargar un archivo](/retail-media-interface/partner/es/team-user-api/user-1/uploadfile-1.md) | Carga logotipos para perfiles de usuario y equipos. | POST |
| [Obtener la URL del archivo](/retail-media-interface/partner/es/team-user-api/user-1/getfileurl.md) | Recupera la URL del logotipo de un equipo o usuario utilizando el ID de archivo especificado. | POST |
| Eliminar un usuario | Elimina a un usuario del equipo. | DELETE |
### Facturación y gestión de billeteras
#### ¿Qué es una billetera?
Una billetera almacena los fondos de un anunciante con el fin de realizar pagos (p. ej., pagar por anuncios realizados).
#### Billetera
| Endpoint | Descripción | Método |
| ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Crear un monedero](/retail-media-interface/partner/es/billing-api/wallet/createwallet.md) | Crea una billetera dentro de un espacio de nombres especificado y la asocia a un equipo mediante el ID de equipo. | POST |
| [Actualizar una billetera](/retail-media-interface/partner/es/billing-api/wallet/updatewallet-1.md) | Actualiza una billetera dentro de un espacio de nombres y teamId especificados. | PATCH |
| [Recuperar monedero por ID](/retail-media-interface/partner/es/billing-api/wallet/getwallet-1.md) | Recupera los detalles de una billetera específica mediante su identificador único, {id}. | GET |
| [Enumerar todos los monederos](/retail-media-interface/partner/es/billing-api/wallet/listwallets.md) | Recupera una lista de billeteras según los filtros y parámetros especificados, incluidos el ID de equipo, el nombre de la billetera, el ID de billetera, el ID externo y más. | GET |
| [Obtener el saldo de un monedero específico](/retail-media-interface/partner/es/billing-api/wallet/getwalletbalance.md) | Recupera el saldo actual de una billetera especificada. | GET |
| [Gestionar fondos para un monedero específico](/retail-media-interface/partner/es/billing-api/wallet/managefunds.md) | Gestiona las operaciones de fondos para una billetera específica. | POST |
#### Gasto
| Endpoint | Descripción | Método |
| -------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------ |
| [Recuperar los detalles del gasto de la campaña](/retail-media-interface/partner/es/billing-api/spend/getcampaignspend.md) | Calcula el presupuesto restante para campañas específicas en función de su saldo disponible y límites de gasto. | POST |
### Operación masiva
#### Campaña
| Endpoint | Descripción | Método |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ------ |
| [Crear campañas de forma masiva](/retail-media-interface/partner/es/bulk-operation-api/bulkcampaignoperations/bulkcreatecampaign.md) | Crea varias campañas simultáneamente (hasta 1000) según el tipo de campaña. | POST |
| [Actualizar campañas de forma masiva](/retail-media-interface/partner/es/bulk-operation-api/bulkcampaignoperations/bulkupdatecampaign-1.md) | Actualiza campañas dentro de un espacio de nombres especificado. | PATCH |
| [Actualizar el estado de aprobación de la campaña](/retail-media-interface/partner/es/bulk-operation-api/bulkcampaignoperations/bulkcampaignapproval.md) | Aprueba o rechaza campañas dentro de un espacio de nombres especificado. | POST |
| Recuperar estado de la operación masiva | Recupera el estado y los detalles de una operación de campaña masiva utilizando el ID de operación masiva. | GET |
#### Billetera
| Endpoint | Descripción | Método |
| --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------ |
| [Crear monederos de forma masiva](/retail-media-interface/partner/es/bulk-operation-api/bulkwalletoperations/bulkcreatewallet.md) | Cree múltiples billeteras a la vez dentro de su organización (hasta 1000). | POST |
| [Recuperar el estado de la operación masiva de monederos](/retail-media-interface/partner/es/bulk-operation-api/bulkwalletoperations/bulkwalletstatus.md) | Recupera el estado de una operación de billetera masiva utilizando su ID masivo. | GET |
| [Actualizar monederos de forma masiva](/retail-media-interface/partner/es/bulk-operation-api/bulkwalletoperations/bulkupdatewallet.md) | Actualiza múltiples billeteras simultáneamente. | PATCH |
#### Equipo
| Endpoint | Descripción | Método |
| ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------ |
| [Crear equipos de forma masiva](/retail-media-interface/partner/es/bulk-operation-api/bulkwalletoperations-1/bulkcreateteam.md) | Crea equipos masivos para una organización. | POST |
| [Actualizar equipos de forma masiva](/retail-media-interface/partner/es/bulk-operation-api/bulkwalletoperations-1/bulkupdateteam.md) | Actualiza múltiples equipos simultáneamente. | PATCH |
| [Recuperar el estado de la operación masiva de equipos](/retail-media-interface/partner/es/bulk-operation-api/bulkwalletoperations-1/bulkteamstatus.md) | Recupera el estado de una operación de equipo masiva utilizando su ID masivo. | GET |
### Término de búsqueda sugerido
#### ¿Qué son los términos de búsqueda sugeridos?
Los términos de búsqueda sugeridos son una colección de términos proporcionados mediante un archivo del minorista que asocia productos con términos específicos que se presentan al usuario al crear una campaña en el paso de términos de búsqueda. Para obtener más información, consulte Términos de búsqueda sugeridos.
| Endpoint | Descripción | Método |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Enumera todos los términos de búsqueda sugeridos](/retail-media-interface/partner/es/suggested-search-term-api/suggestedsearchterm/listsuggestedsearchterms.md) | Recupera términos de búsqueda sugeridos para la segmentación de catálogo por términos de búsqueda sugeridos en función de parámetros especificados como ID de catálogo, código de producto y más. | GET |
## Mejores prácticas
Siga estas mejores prácticas para garantizar una integración fluida, eficiente y confiable con las Epsilon Retail Media API de socios:
* Pruebe siempre en el entorno de pruebas antes del despliegue en producción.
* Utilice puntos de enlace masivos para operaciones múltiples.
* Verifique si hay problemas de datos específicos en las respuestas de error.
* Utilice archivos comprimidos para una carga de datos más rápida.
* Actualice los tokens de acceso solo cuando hayan expirado.
* Valide los campos obligatorios antes de enviar solicitudes.
## Manejo de errores
Nuestras API de socios devuelven respuestas de error JSON estructuradas para admitir un manejo de excepciones sólido.
* **Código de estado HTTP**: Códigos de error estándar (400, 401, 403, 500, etc.)
* **Código de error**: Identificador de error específico.
* **Mensaje**: Descripción del error legible por humanos.
* **Violaciones de campos**: Errores de validación de campos específicos para problemas de entrada de datos.
Para obtener información detallada sobre el manejo de errores, consulte [Gestión de errores](/retail-media-interface/partner/es/partner-api-overview/error-handling.md).
## Soporte y recursos
| Recurso | Descripción |
| ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| [Preguntas frecuentes](/retail-media-interface/partner/es/partner-api-overview/frequently-asked-questions.md) | Preguntas y respuestas frecuentes relacionadas con el uso y la integración de la API. |
| Notas de la versión | Resumen de las actualizaciones o cambios recientes en la API. |
| [Glosario](https://developers.citrusad.com/partner/docs/createupdate-campaign-fields-1) | Definiciones de los términos clave utilizados en toda la documentación de la API. |
---
# 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/partner-api-overview/epsilon-retail-media-partner-apis-overview-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.