Google Business Profile (buscas, mapa, ações e avaliações)

GET

/v1/t/{tenantID}/google-business

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

• Produção

O painel do Google Business Profile do cliente na janela pedida: uma série diária por métrica (impressões na busca e no mapa em desktop e celular, cliques no site, ligações, pedidos de rota, conversas, reservas), totais, as avaliações novas por dia e o retrato (nota média em milésimos, ponderada pelo total de cada local) e os locais com dado. Contagens somam entre os locais. Sem inicio/fim: os últimos 30 dias (America/Sao_Paulo); janela máxima de 400 dias. Erros 400: GBP_DATA_INVALIDA, GBP_JANELA_INVERTIDA, GBP_JANELA_LONGA, GBP_LOCAL_INVALIDO. Cliente que nunca conectou recebe 200 com conectado: false.

Exige a permissão insights.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.

Query Parameters

inicio

string format: date

Primeiro dia, AAAA-MM-DD. Padrão: 29 dias antes de fim.

fim

string format: date

Último dia, AAAA-MM-DD, inclusivo. Padrão: hoje em America/Sao_Paulo.

local

string

/^locations/[0-9]{1,20}$/

Restringe a um local (locations/N). Omitido, soma todos.

Responses

200

OK

Media typeapplication/json

object

Example ^generated

{}

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"
  }
}