Contas de anúncio e frescor do dado

GET

/v1/t/{tenantID}/accounts

curl --request GET \
  --url https://dash.owiew.com/v1/t/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/accounts \
  --header 'Authorization: Bearer <token>'

• Produção

As contas do cliente com a data do último dado recebido.

Consulte isto antes de concluir que algo caiu. Uma conta que parou de coletar produz exatamente o mesmo desenho de uma campanha que morreu, e as duas hipóteses pedem ações opostas.

Exige a permissão account.read.

Authorizations

• tokenDeAcesso

Parameters

Path Parameters

tenantID

required

string format: uuid

O cliente. Vem SEMPRE do caminho — nunca de cabeçalho, nunca de cookie. Ele é conferido contra o token: um identificador que não bata com o do token devolve 403, e não uma resposta vazia.

Responses

200

OK

Media typeapplication/json

object

since

Primeiro dia efetivamente usado.

string format: date

until

Último dia efetivamente usado, inclusivo.

string format: date

accounts

Array<object>

Uma conta de anúncio do cliente. O par last_date / last_observed_at é o que distingue ‘a campanha caiu’ de ‘a coleta parou’ — a segunda hipótese é a mais comum e a que ninguém checa.

object

account_id

string

provider

Rede de anúncio de origem.

string

Allowed values: meta google tiktok

name

Nome da conta na plataforma. Cai no identificador quando a estrutura ainda não foi lida — nunca vem vazio.

string

timezone

Fuso em que os dias desta conta são contados.

string

last_date

Último DIA com dado. Nulo quando a conta nunca entregou nada.

string format: date

nullable

last_observed_at

Quando a coleta falou com esta conta pela última vez. Diferente de last_date: uma conta coletada há dez minutos pode ter dados só até anteontem, e isso é normal.

string format: date-time

nullable

conferida_via

Por onde last_observed_at foi conferido: direta (trilha da API da própria rede) ou ga4 (coleta do Google Analytics 4, enquanto a API do Google Ads não está liberada). Nulo quando a conta nunca foi conferida.

string

nullable

Allowed values: direta ga4

Example

{
  "accounts": [
    {
      "provider": "meta",
      "conferida_via": "direta"
    }
  ]
}

401

Token ausente, malformado ou vencido.

Media typeapplication/json

object

error

object

code

Código estável, seguro para comparar.

string

message

Texto para pessoa. Pode mudar entre versões — não decida nada a partir dele.

string

trace_id

Identificador da ocorrência. Cite-o ao pedir suporte.

string

Example ^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "trace_id": "example"
  }
}

403

O token é válido, e o escopo não. Ou ele foi emitido para outro cliente, ou o papel não inclui a permissão da rota. NÃO é 404 de propósito: esconder um erro de escopo atrás de ‘não encontrado’ faz quem integra procurar o problema no lugar errado.

Media typeapplication/json

object

error

object

code

Código estável, seguro para comparar.

string

message

Texto para pessoa. Pode mudar entre versões — não decida nada a partir dele.

string

trace_id

Identificador da ocorrência. Cite-o ao pedir suporte.

string

Example ^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "trace_id": "example"
  }
}