Pular para o conteúdo
Anúncios

Uma campanha do Meta Ads

v1.0.0
GEThttps://api.growthaisystem.com/api/v1/ads/campaigns/{id}
  • ExigeAuthorization: Bearer gos_…— Chave de API (gos_…)· escoposads.read

Orçamento, totais do período e a série diária de UMA campanha. id é o id da campanha no Meta (o id que o resumo devolve) ou parte do nome: nome que bate em mais de uma campanha volta ambiguous com as opcoes.

Sempre 200: status diz o resultado de negócio (ok, not_connected, reconnect_needed, sync_pending, sync_failed, no_campaigns, not_found, ambiguous, not_configured, provider_error). Cada chamada lê o Meta na hora.

Parâmetros de caminho

Entram no próprio endereço, no lugar das chaves.

  • idstringobrigatório
    • tamanho 1–120

Parâmetros de consulta

Vão na querystring, depois do ?.

  • periodstringopcional

    Janela de análise: 7d, 14d, 30d ou 90d (padrão 7d).

    • padrão "7d"
    • um de"7d""14d""30d""90d"

Respostas

6 respostas documentadas — o código, o que ele significa nesta rota e a forma do corpo.

200Deu certoapplication/json

A campanha com a série diária (ou not_found/ambiguous/status de negócio).

V1AdsCampaign

    • status"ok"
      • sempre "ok"
      • idstring
      • nomestring
        • tamanho máx. 41
      • statusstring
        • um de"ativa""pausada""em_analise""rejeitada""concluida""com_problema"
        • valornumber
        • tipostring
          • um de"diario""total"
      • nivelOrcamentostring | null
        • um de"campanha""conjunto"
      • destring
      • atestring
    • moedastring
      • gastonumber
      • impressoesnumber
      • cliquesnumber
      • conversoesnumber
      • custoPorConversaonumber | null
      • roasnumber | null
      • itens máx. 14

      Cada item da lista

      • datastring
      • gastonumber
      • conversoesnumber
    • status"not_found"
      • sempre "not_found"
    • buscastring
      • tamanho máx. 120
    • status"ambiguous"
      • sempre "ambiguous"
    • buscastring
      • tamanho máx. 120
    • opcoesstring[]
      • itens máx. 5
    • status"not_connected"
      • sempre "not_connected"
    • status"reconnect_needed"
      • sempre "reconnect_needed"
    • motivostring
      • um de"token_revoked""scope_insufficient""caiu"
    • status"sync_pending"
      • sempre "sync_pending"
    • status"sync_failed"
      • sempre "sync_failed"
    • motivostring
      • um de"no_ad_accounts""discovery_failed""sem_resposta""unknown"
    • status"not_configured"
      • sempre "not_configured"
    • status"provider_error"
      • sempre "provider_error"
    • detalhestring
      • tamanho máx. 200