Se procura uma API de avaliações do Google, provavelmente não precisa de mais uma explicação genérica sobre APIs. Precisa dos dados numa tabela para filtrar, cruzar, visualizar e partilhar com as pessoas que tomam decisões.
Este pedido surge com frequência em agências, franchisings e equipas com várias localizações. Alguém precisa de um painel no Tableau, um script em Python, uma exportação semanal para CSV ou uma forma fiável de obter avaliações de várias localizações sem abrir cada perfil manualmente.
A resposta curta é sim: pode obter avaliações através das APIs oficiais do Google Business Profile quando o projeto e o utilizador têm o acesso necessário. O fluxo adequado depende de querer desenvolver diretamente sobre a Google, usar a Localith como camada operacional ligada ou exportar um CSV limpo para uma ferramenta de business intelligence.
Este guia explica as três opções e mostra como preparar os dados para Tableau, Power BI, Looker Studio, folhas de cálculo ou Python.
Transforme a atividade das avaliações do Google em relatórios que a sua equipa consegue usar. Use o Localith para comparar localizações, exportar relatórios, acompanhar a atividade de resposta e identificar os padrões por trás das mudanças de classificação.
Experimente grátisExiste uma API de avaliações do Google?
Sim, embora o nome possa causar confusão. A Google não apresenta o acesso a avaliações como um produto independente chamado API de avaliações do Google. Para os perfis que a sua organização possui ou gere, o caminho oficial é a API do Google Business Profile.
A documentação da Google sobre avaliações explica como listar avaliações, obter uma avaliação, consultar várias localizações e gerir respostas da empresa. Se ainda precisa de configurar a aprovação do projeto e o OAuth, consulte este guia de acesso à API do Google Business Profile.
Para consultar dados públicos de locais, alguns programadores consideram a Places API ou serviços externos. São casos de utilização diferentes e não substituem a exportação completa do histórico de avaliações dos perfis geridos.
API do Google Business Profile, Places API ou Localith
Comece pela questão da propriedade e dos relatórios: trabalha com localizações geridas pela sua organização, procura dados públicos ou precisa de relatórios recorrentes de perfis ligados?
| Opção | Ideal para | Acesso a avaliações | Limitação principal |
|---|---|---|---|
| Relatórios e fluxos da Localith | Relatórios e operações multilocalização | Dados ligados, análise, relatórios PDF/CSV e integrações | Os perfis têm de estar ligados e sincronizados |
| Google Places API | Consulta pública de locais | Dados públicos segundo as regras do endpoint | Não é uma exportação completa de perfis geridos |
| API do Google Business Profile | Localizações próprias ou geridas | Avaliações e respostas de perfis acessíveis | Exige aprovação, OAuth, permissões e engenharia |
Que dados de avaliações pode obter?
Para relatórios, a estrutura dos dados é mais importante do que o nome da API. Uma exportação útil deve incluir:
- ID da avaliação
- Nome visível do autor
- Classificação
- Texto da avaliação
- Data de criação ou atualização
- Localização e ID estável
- Texto e data da resposta da empresa
- Classificação média e número total de avaliações
O método da Google devolve uma coleção paginada, a classificação média e o total de avaliações da localização. Os recursos individuais podem incluir ID, comentário, autor, classificação, data de criação e resposta.
Quando os dados estão centralizados, a equipa também pode pesquisar avaliações do Google por palavra-chave para detetar temas recorrentes sobre produtos, atendimento, equipa ou acessibilidade.
Opção 1: exportar dados de avaliações com a Localith
A Localith é a opção prática quando a pergunta é “Conseguimos obter dados limpos de todas as localizações todas as semanas?” e não “Conseguimos manter mais uma integração API?” As suas ferramentas de API do Google Business Profile mantêm ligados os fluxos de avaliações, perfis, relatórios e automação.
O fluxo é simples:
- Crie uma conta Localith ou inicie sessão.
- Ligue as contas e localizações do Google Business Profile.
- Abra a área de relatórios.
- Selecione o período, as localizações e o tipo de relatório.
- Descarregue o relatório em PDF ou CSV.
- Carregue o CSV na folha de cálculo, data warehouse ou ferramenta de BI.
Os relatórios podem incluir dados brutos e métricas como distribuição por estrelas, grupos de sentimento, total de avaliações, respostas, classificação média e data da avaliação mais recente. Assim, agências e equipas multilocalização mantêm um fluxo recorrente de relatórios de avaliações online sem programar OAuth e paginação.
Use o acesso API da Localith e o n8n em fluxos recorrentes
Para automatizações recorrentes, a equipa pode gerar uma chave API da Localith e ligar a Localith ao n8n. O nó da Localith permite obter avaliações, trabalhar com perfis e consultar métricas de desempenho que podem ser enviadas para Google Sheets, Airtable, Slack, email ou outras ferramentas.
Esta opção é adequada para ingestões programadas, alertas e fluxos de aprovação sem obrigar todas as ferramentas a autenticarem-se diretamente com a Google.
Evite a fila de aprovação da API do Google. O Localith oferece às agências uma camada gerida de GBP para fichas, avaliações, métricas e publicação para todos os seus clientes, sem projetos Cloud, OAuth ou gestão de quotas.
Experimente grátisOpção 2: exportar avaliações em CSV para Tableau
Se o requisito for um painel no Tableau, confirme primeiro se um CSV resolve o problema. Para muitos relatórios semanais ou mensais, é suficiente.
- Exporte os dados por avaliação da Localith.
- No Tableau, selecione Ficheiro de texto.
- Escolha o CSV.
- Configure a classificação como número e a data como data.
- Crie uma distribuição por estrelas.
- Adicione a localização como filtro.
- Crie tendências mensais de volume e classificação.
- Adicione o estado ou tempo de resposta quando estiver disponível.
- Publique o workbook e atualize a fonte segundo o calendário.
O CSV funciona especialmente bem quando a frequência é diária, semanal ou mensal e oferece um ficheiro visível que os analistas podem verificar antes de atualizar o painel.
Opção 3: obter avaliações com a API do Google Business Profile
Escolha o caminho direto quando tiver recursos de engenharia, os perfis estiverem numa estrutura de contas adequada e a aplicação precisar de controlar a ingestão e o armazenamento.
O endpoint atual é:
GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviewsA localização tem de estar verificada. O método devolve até 50 avaliações por página, permite ordenação e fornece nextPageToken quando existem mais resultados. Exige um scope OAuth como https://www.googleapis.com/auth/business.manage.
A Google também fornece um método em lote:
POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations:batchGetReviewsAs equipas que precisam de gerir avaliações do Google em várias localizações devem resolver primeiro a propriedade, as permissões e os identificadores estáveis.
Exemplo de fluxo com Python
Um fluxo de produção costuma:
- Usar um projeto aprovado para a API.
- Configurar OAuth com
business.manage. - Listar contas e localizações acessíveis.
- Pedir as avaliações de cada localização.
- Seguir
nextPageTokenaté concluir todas as páginas. - Converter cada avaliação numa linha.
- Guardar os dados em CSV, BigQuery, num armazém ou numa tabela de BI.
import requests
def fetch_reviews(access_token, location_name):
url = f"https://mybusiness.googleapis.com/v4/{location_name}/reviews"
params = {"pageSize": 50, "orderBy": "updateTime desc"}
headers = {"Authorization": f"Bearer {access_token}"}
reviews = []
while True:
response = requests.get(url, headers=headers, params=params, timeout=30)
response.raise_for_status()
payload = response.json()
reviews.extend(payload.get("reviews", []))
page_token = payload.get("nextPageToken")
if not page_token:
return reviews
params["pageToken"] = page_tokenEste é um padrão de integração, não um cliente pronto para produção. O sistema final também precisa de renovar tokens, repetir pedidos, guardar credenciais em segurança, registar eventos e tratar erros de permissões.
Modelo de dados recomendado para BI
Mantenha o modelo simples: uma linha estável por avaliação e um ID estável por localização.
| Campo | Tipo | Utilidade |
|---|---|---|
review_id |
Texto | Evita duplicados |
location_id |
Texto | Liga avaliações a perfis, regiões e clientes |
location_name |
Texto | Filtro legível |
rating |
Número | Médias e distribuição |
review_text |
Texto | Temas e sentimento |
review_date |
Data/hora | Tendências e períodos |
reply_text |
Texto | Indica se existiu resposta |
reply_date |
Data/hora | Permite medir tempos de resposta |
source |
Texto | Identifica a plataforma de origem |
Não misture linhas de resumo por localização com avaliações individuais. Use tabelas separadas e ligue-as através de location_id.
O que pode criar com os dados de avaliações do Google exportados?
É aqui que a exportação compensa. Quando cada avaliação fica numa única tabela normalizada, uma equipa pequena consegue criar relatórios que antes exigiam um programador. Estes são os que as agências e os operadores com várias localizações configuram com mais frequência, do mais simples ao mais complexo:
- Um painel de avaliações multilocalização. Uma única vista da classificação média, do volume de avaliações e da taxa de resposta por localização, para ver que filiais estão a cair antes da reunião mensal.
- Relatórios para clientes de agência. Um relatório limpo e repetível por cliente com a tendência de classificação, as avaliações novas e a taxa de resposta. Agende-o e pare de refazer apresentações à mão.
- Alertas de avaliações negativas. Uma regra que sinaliza cada nova avaliação de 1 ou 2 estrelas por localização, para que o responsável certo saiba no mesmo dia.
- Acompanhamento de SLA de resposta. Taxa de resposta e tempo médio de resposta por localização, para que “respondemos a cada avaliação” passe a ser um número exigível.
- Análise de sentimento e temas. Agrupe o texto das avaliações em temas como equipa, tempos de espera, preços e limpeza para ver o que os clientes realmente continuam a mencionar.
- Comparações de desempenho por localização. Classifique localizações ou regiões entre si para detetar os casos atípicos que merecem uma análise mais próxima.
- Cópias de segurança e arquivos de avaliações. Um registo datado de cada avaliação e resposta, útil quando uma avaliação muda ou desaparece.
Não precisa de todos no primeiro dia. A maioria das equipas começa pelo painel e pelo alerta de avaliações negativas, e acrescenta o resto quando o hábito de reporting se consolida.
Os dados de avaliações são mais úteis quando continuam ligados à operação. Um painel pode revelar avaliações sem resposta, enquanto um processo documentado explica como responder a avaliações do Google e um fluxo de respostas automáticas trata os casos adequados em escala. Também pode complementar o acompanhamento de posições locais quando quer comparar as tendências de avaliações com as mudanças de visibilidade em vez de tratar a reputação e a pesquisa local como programas separados.
Crie um painel de avaliações do Google no Claude (sem código)
Se não tem um analista nem uma licença de BI, há um caminho mais rápido: ligue a Localith ao Claude e peça o painel em linguagem natural. A Localith publica um conector MCP do Claude só de leitura que permite ao Claude obter diretamente os seus dados de avaliações do Google ligados, por isso salta a configuração da API, as exportações em CSV e as fórmulas de folha de cálculo.
Esta é a opção mais prática para agências e operadores que querem respostas, não infraestrutura. Este é o fluxo completo:
- Na Localith, ligue as localizações do Google Business Profile que gere.
- No Claude, abra Definições, Conectores e adicione a Localith. Pode procurá-la no diretório de conectores ou adicioná-la como conector personalizado.
- Peça ao Claude em linguagem natural, por exemplo: “Traz as avaliações dos últimos 90 dias de todas as minhas localizações e cria um painel com a classificação média, o volume de avaliações e a taxa de resposta por localização.”
- O Claude usa o conector para obter as suas avaliações e métricas, e cria um gráfico ou uma tabela que pode ler no próprio chat.
- Continue na mesma conversa: “Que três localizações têm a taxa de resposta mais baixa?” ou “Lista cada avaliação de 1 estrela do mês passado com a localização e a data.”
Como o conector é só de leitura, o Claude pode ler e analisar os seus dados de avaliações, mas não pode alterar avaliações nem publicar respostas. Isso torna-o seguro para entregar a alguém júnior da equipa. Quando quiser agir sobre o que encontrar, leve as respostas para o Agente de Resposta a Avaliações com IA ou para o seu fluxo de avaliações habitual.
Para um relatório recorrente, guarde o prompt e volte a executá-lo todos os meses, ou envie os mesmos dados para um fluxo programado com Localith e n8n. Em ambos os casos o resultado é o mesmo: uma agência consegue criar um painel de avaliações funcional numa tarde, sem escrever uma única linha de código.
Quando usar diretamente a Google ou a Localith?
| Cenário | Melhor opção |
|---|---|
| Aplicação personalizada com acesso aprovado | API do Google Business Profile |
| Relatórios multilocalização | Relatórios ou API da Localith |
| Painel Tableau ou Power BI | CSV ou ingestão programada |
| Automatização com Slack, Sheets ou Airtable | Localith com n8n |
| Relatórios para clientes | PDF/CSV da Localith |
| Operações de resposta | Fluxos de avaliações da Localith |
Use a Google diretamente quando a infraestrutura personalizada for um requisito e a equipa puder mantê-la. Use a Localith quando precisar de relatórios, exportações, alertas e operações sem manter toda a integração.
Para ampliar o controlo operacional, consulte como gerir vários perfis do Google Business, incluindo permissões, atualizações em massa e estrutura das contas.
Erros comuns da API de avaliações do Google
- Confundir a Places API com a API do Google Business Profile
- Pedir avaliações de um perfil inacessível ao utilizador OAuth
- Consultar uma localização não verificada
- Exportar apenas as primeiras 50 avaliações
- Não guardar IDs estáveis
- Misturar dados individuais com métricas agregadas
- Ignorar renovação de tokens, novas tentativas e quotas
- Assumir que todos os painéis precisam de dados em tempo real
O último risco é organizacional: criar um painel sem responsáveis. A exportação deve alimentar um processo claro de gestão da reputação no Google com responsáveis, tempos de resposta e regras de escalamento.
Transforme as avaliações num sistema de relatórios fiável
Uma API de avaliações do Google só acrescenta valor quando permite agir de forma consistente. O resultado deve mostrar alterações na classificação, volume, temas recorrentes, avaliações sem resposta e localizações fora do padrão.
Se tiver recursos de engenharia e acesso aprovado, pode desenvolver o fluxo diretamente. Se quiser avançar mais depressa, use a Localith para ligar perfis, exportar dados e manter a análise junto do trabalho diário de gestão.
Antes de começar, confirme que a equipa consegue ver as avaliações associadas aos seus perfis, aceder a todas as localizações necessárias e definir as decisões que o painel deve apoiar.
