Recursos
Facturación y recuperación de pagos
El gasto se cobra a nivel de cuenta en todas las campañas. Un pago fallido bloquea la entrega condelivery_status: "payment_failed" y conserva el status activo/en pausa configurado de cada campaña. Corrige el método de pago de la cuenta y luego llama a Reintentar pagos de anuncios fallidos una vez para la cuenta. La respuesta pone en cola un intento en segundo plano; no confirma el pago. Tras la liquidación, las campañas activas pueden reanudarse y las campañas en pausa siguen en pausa, sujetas a otros requisitos de entrega.
Consulta Pagar los anuncios para ver el flujo en el panel, un ejemplo de solicitud, el comportamiento ante solicitudes duplicadas y el manejo de campañas heredadas.
Configuración única
- Scopes:
media:generate,media:read,ad_campaign:create,ad_campaign:update,ad_campaign:basic:read. - Método de pago de anuncios: se conecta en el panel (saldo o tarjeta). Solo se necesita para lanzar; los borradores funcionan sin él.
1
Genera una creatividad
amount_charged; si el saldo no alcanza → 402 con un deposit_url). Consulta periódicamente GET /media/{id} hasta que status sea ready y luego usa file.id:failed reembolsa el cargo: ajusta el prompt y vuelve a intentarlo. Video: "type": "video" más, opcionalmente, duration_seconds (5/10/15), resolution (480p–4k) y hasta 4 IDs de archivo en reference_media (el primero define el fotograma inicial).2
Crea y lanza el anuncio en una sola solicitud
POST /ads con un ad_group y un ad_campaign en línea crea todo el árbol en una sola transacción y lo lanza:"status": "draft" a ad_campaign y lánzalo más tarde con PATCH /ad_campaigns/{id} {"status": "active"}.Para reutilizar contenedores existentes, pasa
ad_group_id en lugar de ad_group, o ad_campaign_id en lugar de ad_campaign.3
Supervisa
Consulta periódicamente
GET /ads/{id}: delivery_status es el estado en vivo (un breve in_review para la moderación de contenido es normal), e issues[] incluye un message legible para cualquier cosa que la red publicitaria haya rechazado de forma asíncrona.Controla la entrega con pause / unpause en anuncios, grupos de anuncios o campañas. Edita los textos o las creatividades con PATCH /ads/{id}: enviar creatives reemplaza todo el conjunto, así que incluye la entrada base.Errores
Cada validación es un400 cuyo mensaje indica qué corregir:

