> 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/bulk-operation-api/bulk-operation-overview.md). # Información general sobre operaciones en lote ## Campañas masivas Las API de acciones masivas están diseñadas para ayudar a usuarios como AdOps, Servicios gestionados y Proveedores a realizar operaciones de creación y actualización a gran escala en **campañas**, **monederos** y **equipos** en una sola llamada a la API. Este enfoque de API asíncrona optimiza los flujos de trabajo, reduce el esfuerzo manual y mejora la eficiencia operativa. Estas API son especialmente valiosas para escenarios de alto volumen, como la incorporación, lanzamientos de temporada o ajustes de campañas principales, donde realizar llamadas a la API individuales llevaría mucho tiempo y estaría sujeto a errores. ### Beneficios clave * Eficiencia: reduce el número de llamadas a la API y elimina pasos manuales innecesarios al permitir múltiples operaciones en una sola solicitud. * Rendimiento: las API masivas minimizan la sobrecarga de ida y vuelta de HTTP. En lugar de enviar muchas solicitudes individuales (por ejemplo, 100 llamadas separadas), una sola solicitud masiva reduce la carga de la red y disminuye las probabilidades de alcanzar los límites de tasa. * Idempotencia: garantiza que cada operación en la solicitud masiva sea idempotente, lo que evita efectos secundarios no deseados durante los reintentos (como los activados por acciones de la interfaz de usuario). * Modelo de autorización y seguridad granular: aplica los controles de acceso correctos para cada operación y tipo de entidad dentro de la carga útil masiva, garantizando un manejo seguro de todas las acciones. * Auditoría y registro: mantiene registros correctos y pistas de auditoría para todas las operaciones dentro de una solicitud masiva, lo que garantiza la trazabilidad. * Capacidad de vista previa: algunas implementaciones admiten la vista previa de las modificaciones antes de aplicarlas, lo que ayuda a detectar errores a tiempo. * Integridad transaccional: una API masiva permite a los clientes agrupar un conjunto de acciones en una sola llamada a la API, lo que puede garantizar que: * Cada entidad en la solicitud masiva se valide de forma independiente. * Se devuelvan mensajes de error granulares para identificar qué entidades fallaron y por qué. * La operación completa no se bloquee si falla una entidad. ### Cómo usar las API de campañas masivas #### 1. Enviar una solicitud masiva Envía una solicitud para crear, editar o aprobar varias campañas a la vez. * Para crear: `/v3/campaigns/bulk/create` * Para editar: `/v3/campaigns/bulk/update` * Para aprobaciones: `/v3/campaigns/bulk/approve` Una vez enviada la solicitud, el sistema te proporciona un ID masivo y un estado como `submitted`. El procesamiento real ocurre en segundo plano. **Ejemplo (Actualizar campañas en masa):** ```http PATCH /v3/campaigns/bulk/update { "campaigns": [ { "campaign": { "id": "campaign_123", "name": "Updated Summer Sale Campaign", "startTime": "2025-08-01T00:00:00Z", "endTime": "2025-08-31T23:59:59Z", "campaignState": "CAMPAIGN_STATE_ACTIVE", "strategy": { "auction": { "maxBid": "6.5" } } }, "mask": "name,startTime,endTime,campaignState,strategy.auction.maxBid", "campaignType": "CAMPAIGN_TYPE_BANNER" }, { "campaign": { "id": "campaign_456", "name": "Holiday Promotion", "campaignState": "CAMPAIGN_STATE_PAUSED", "strategy": { "auction": { "maxBid": "5.0" } } }, "mask": "name,campaignState,strategy.auction.maxBid", "campaignType": "CAMPAIGN_TYPE_BANNER" } ] } ``` Respuesta: ```json { "bulkId": "c40f4f98-9b6b-11ee-b9d1-0242ac120002", "status": "BULK_OPERATION_SUBMITTED", "message": "Bulk campaign update request received and is being processed." } ``` #### 2. Consultar el estado Usa el ID masivo para consultar el progreso en: `/v3/campaigns/bulk/status/{bulkId}` Verás: * Qué campañas se realizaron correctamente o fallaron, con detalles de cada una. * Mensajes de error (si los hay). **Ejemplo:** ```http GET /v3/campaigns/bulk/status/c40f4f98-9b6b-11ee-b9d1-0242ac120002 ``` {% hint style="info" %} Notas: * Las API son asíncronas: envías un trabajo y realizas sondeos para ver los resultados. * Cada entidad de la solicitud masiva se valida de forma independiente; los errores se notifican por elemento. * Las API masivas están disponibles para campañas, monederos y equipos, con patrones similares para cada recurso. {% endhint %} ### Matriz de acceso a operaciones masivas | Operación | Método | Quién puede crear | Quién puede ver el estado | | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------ | ----------------------------------------------------------- | | Campañas | | | | | [Crear campañas de forma masiva](/retail-media-interface/partner/es/bulk-operation-api/bulkcampaignoperations/bulkcreatecampaign.md) | POST | Admin, Minorista principal, Proveedor, Usuario general | Admin, Minorista principal, Creador (incluidos proveedores) | | [Actualizar campañas de forma masiva](/retail-media-interface/partner/es/bulk-operation-api/bulkcampaignoperations/bulkupdatecampaign-1.md) | PATCH | Admin, Minorista principal, Proveedor, Usuario general | Admin, Minorista principal, Creador (incluidos proveedores) | | [Actualizar el estado de aprobación de la campaña](/retail-media-interface/partner/es/bulk-operation-api/bulkcampaignoperations/bulkcampaignapproval.md) | POST | Admin, Minorista principal | Admin, Minorista principal | | [Recuperar el estado de la operación masiva](/retail-media-interface/partner/es/bulk-operation-api/bulkcampaignoperations/bulkcampaignstatus-1.md) | GET | — | Admin, Minorista principal, Creador (incluidos proveedores) | | Monedero | | | | | [Crear monederos de forma masiva](/retail-media-interface/partner/es/bulk-operation-api/bulkwalletoperations/bulkcreatewallet.md) | POST | Admin, Minorista principal, Proveedor, Usuario general | Admin, Minorista principal, Creador (incluidos proveedores) | | [Actualizar monederos de forma masiva](/retail-media-interface/partner/es/bulk-operation-api/bulkwalletoperations/bulkupdatewallet.md) | PATCH | Admin, Minorista principal, Proveedor, Usuario general | Admin, Minorista principal, Creador (incluidos proveedores) | | [Recuperar el estado de la operación masiva de monederos](/retail-media-interface/partner/es/bulk-operation-api/bulkwalletoperations/bulkwalletstatus.md) | GET | — | Admin, Minorista principal, Creador (incluidos proveedores) | | Equipo | | | | | [Crear equipos de forma masiva](/retail-media-interface/partner/es/bulk-operation-api/bulkwalletoperations-1/bulkcreateteam.md) | POST | Admin, Minorista principal, Proveedor, Usuario general | Admin, Minorista principal, Creador (incluidos proveedores) | | [Actualizar equipos de forma masiva](/retail-media-interface/partner/es/bulk-operation-api/bulkwalletoperations-1/bulkupdateteam.md) | PATCH | Admin, Minorista principal, Proveedor, Usuario general | Admin, Minorista principal, Creador (incluidos proveedores) | | [Recuperar el estado de la operación masiva de equipos](/retail-media-interface/partner/es/bulk-operation-api/bulkwalletoperations-1/bulkteamstatus.md) | GET | — | Admin, Minorista principal, Creador (incluidos proveedores) | {% hint style="info" %} Creación y actualización de equipos en masa: cuando un proveedor intenta actualizar registros en masa, la API permite un máximo de 50 registros por solicitud. Si la solicitud contiene más de 50 registros, la API devuelve un mensaje de error que indica que se ha superado el límite. {% endhint %} --- # 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/bulk-operation-api/bulk-operation-overview.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.