Acompanhar e reexecutar

🇺🇸 Read in English

Depois do POST /campaigns (ou de POST /audiences/engagement), a criação roda no servidor. Fechar a conexão ou derrubar a sua automação não interrompe nada: basta voltar a consultar pelo job_id.

Consulte o progresso

curl -s $BASE/executions/<job_id>/progress -H "Authorization: Bearer $KEY"

{
  "status": "running",
  "progress": {
    "phase": null,
    "throttle": null,
    "steps": [
      { "id": "campaign", "label": "Criando campanha...", "status": "success", "resultId": "120210…" },
      { "id": "adset_0", "label": "Criando conjunto de anúncios \"…\"", "status": "running" }
    ]
  }
}

• status: queued → running → success | partial | error.
• progress.phase descreve a preparação (leitura do Drive, vídeos, validação de públicos).
• progress.throttle.paused = true indica que a Meta limitou a conta: os itens esperam e são reenviados sozinhos (até 30 min).
• Consulte a cada 3–5 s. GET /executions/{job_id} traz o resumo completo com todos os IDs criados. O passo a passo continua disponível depois do fim.

Logs

GET /executions/{job_id}/logs lista as chamadas feitas à Meta e ao Drive, com mensagens de erro em português e códigos da Meta. Aceita também o job_id devolvido pelas consultas. Retenção: chamadas com sucesso ficam 24h e erros 14 dias — depois disso a lista volta vazia, mas o resumo da execução continua disponível.

Reexecute o que falhou

curl -s -X POST $BASE/executions/<job_id>/retry -H "Authorization: Bearer $KEY"

A reexecução usa o mesmo job_id e reaproveita campanha, conjuntos, mídias, criativos e anúncios já criados — só refaz o que falhou. Para repetir uma única chamada: POST /logs/{log_id}/retry (idempotente).

Regras aplicadas pelo servidor (resumo)

• Campanha falhou → nada mais é criado. Conjunto falhou → os anúncios dele são pulados; os demais seguem (partial).
• Upload falhou → uma nova tentativa automática; persistindo, o anúncio é pulado.
• Criativos são criados uma vez e reaproveitados entre conjuntos.
• Públicos personalizados de outra conta são barrados antes de qualquer escrita (pré-voo).
• Limites: até 50 conjuntos e 500 anúncios por execução; carrossel de 2 a 10 cartões.