---
title: "API de avaliações do Google: painéis e relatórios"
date: "2026-06-05"
canonical_id: google-reviews-api
author: "Marija Azhderska"
category:
  - google-business-profile
  - gbp-api
  - review-management
tags:
  - google-reviews-api
  - review-export
  - tableau
  - python
  - multi-location
summary: "Saiba como funciona a API de avaliações do Google, como exportar avaliações para Python, Tableau, CSV e ferramentas de BI e quando usar a Localith."
draft: false
template: blog
image: "blog/google-reviews-api/google-reviews-api-guide.jpg"
faq:
  - question: "Existe uma API de avaliações do Google?"
    answer: "Sim. Para avaliações de perfis próprios ou geridos, o caminho oficial é a API do Google Business Profile. A Google não a apresenta como um produto independente chamado API de avaliações do Google."
  - question: "Como posso exportar avaliações do Google?"
    answer: "Pode usar a API do Google Business Profile, uma plataforma ligada como a Localith ou um relatório CSV. Para um painel de BI, um CSV limpo costuma ser o ponto de partida mais rápido."
  - question: "Posso importar avaliações do Google para o Tableau?"
    answer: "Sim. Exporte os dados por avaliação em CSV, ligue o Tableau ao ficheiro, configure os tipos de data e classificação e crie gráficos por localização, classificação, data e estado da resposta."
  - question: "Posso obter avaliações do Google com Python?"
    answer: "Sim, se o projeto Google Cloud tiver acesso à API e o utilizador OAuth puder aceder ao perfil. O fluxo deve tratar autenticação, localizações, paginação, novas tentativas e renovação de tokens."
  - question: "Qual é a diferença entre a API de avaliações do Google e a Places API?"
    answer: "A API do Google Business Profile permite trabalhar com avaliações de perfis próprios ou geridos. A Places API fornece dados públicos de locais e não substitui uma exportação completa das avaliações dos perfis geridos."
  - question: "A API do Google Business Profile devolve o texto das avaliações?"
    answer: "Sim. Os recursos podem incluir ID, comentário, autor, classificação, data de criação e resposta da empresa para localizações acessíveis."
  - question: "Posso exportar avaliações de várias localizações?"
    answer: "Sim. A Google fornece um método em lote para localizações acessíveis e a Localith permite selecionar perfis ligados para relatórios e exportações."
  - question: "A Localith permite exportar avaliações do Google?"
    answer: "Sim. A Localith disponibiliza análise de avaliações e relatórios descarregáveis em PDF e CSV para as localizações e períodos selecionados."
  - question: "Tenho de gerir o Perfil de Empresa para obter as avaliações?"
    answer: "No caminho oficial, a conta autenticada precisa de acesso ao perfil. A localização também tem de estar verificada para usar o método que lista avaliações."
  - question: "Posso publicar avaliações de clientes através de uma API?"
    answer: "Não. Os clientes devem deixar avaliações através do fluxo da Google. A API permite gerir ações da empresa, como ler avaliações e administrar respostas."
seo:
  title: "Crie painéis e relatórios de avaliações do Google"
  description: "Aprenda como funciona a API de avaliações do Google e exporte avaliações para Python, Tableau, CSV e BI com a Google ou a Localith."
  og_image: "blog/google-reviews-api/google-reviews-api-guide.jpg"
  structured_data: article
---

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.

{{product-cta:review-reporting}}

## Existe 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](https://developers.google.com/my-business/content/review-data) 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](/pt/blog/guia-acesso-api-gbp-para-agencias/).

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 |

![Caminhos para exportar avaliações do Google](/images/blog/google-reviews-api/google-reviews-api-process-01.svg)

## 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](/pt/blog/como-pesquisar-avaliacoes-google/) 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](/pt/api/) mantêm ligados os fluxos de avaliações, perfis, relatórios e automação.

O fluxo é simples:

1. Crie uma conta Localith ou inicie sessão.
2. Ligue as contas e localizações do Google Business Profile.
3. Abra a área de relatórios.
4. Selecione o período, as localizações e o tipo de relatório.
5. Descarregue o relatório em PDF ou CSV.
6. 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](/pt/blog/relatorios-avaliacoes-online/) sem programar OAuth e paginação.

![Configuração de relatórios da Localith para exportar métricas ou dados de avaliações](/images/blog/google-reviews-api/google-review-reports-section.jpg)

### 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.

![Janela da chave da API do Google Business Profile na Localith com opções para copiar e abrir a documentação](/images/blog/google-reviews-api/google-business-profile-api-key.jpg)

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.

{{product-cta:api-agency}}

## Opção 2: exportar avaliações em CSV para Tableau

Se o requisito for um painel no [Tableau](https://www.tableau.com/), confirme primeiro se um CSV resolve o problema. Para muitos relatórios semanais ou mensais, é suficiente.

1. Exporte os dados por avaliação da Localith.
2. No Tableau, selecione **Ficheiro de texto**.
3. Escolha o CSV.
4. Configure a classificação como número e a data como data.
5. Crie uma distribuição por estrelas.
6. Adicione a localização como filtro.
7. Crie tendências mensais de volume e classificação.
8. Adicione o estado ou tempo de resposta quando estiver disponível.
9. 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.

![Exemplo de painel do Tableau criado a partir de uma exportação CSV de avaliações do Google](/images/blog/google-reviews-api/google-reviews-api-tableau-dashboard-01.svg)

## 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 é:

```text
GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviews
```

A 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:

```text
POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations:batchGetReviews
```

As equipas que precisam de [gerir avaliações do Google em várias localizações](/pt/blog/como-gerir-avaliacoes-google-multiplas-localizacoes/) devem resolver primeiro a propriedade, as permissões e os identificadores estáveis.

### Exemplo de fluxo com Python

Um fluxo de produção costuma:

1. Usar um projeto aprovado para a API.
2. Configurar OAuth com `business.manage`.
3. Listar contas e localizações acessíveis.
4. Pedir as avaliações de cada localização.
5. Seguir `nextPageToken` até concluir todas as páginas.
6. Converter cada avaliação numa linha.
7. Guardar os dados em CSV, BigQuery, num armazém ou numa tabela de BI.

```python
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_token
```

Este é 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](/pt/blog/como-responder-avaliacoes-google/) e um [fluxo de respostas automáticas](/pt/blog/guia-configuracao-resposta-automatica-avaliacoes-google/) trata os casos adequados em escala. Também pode complementar o [acompanhamento de posições locais](/pt/blog/rastreador-de-posicoes-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](https://claude.ai/) e peça o painel em linguagem natural. A Localith publica um [conector MCP do Claude](/pt/docs/integracoes/configuracao-claude-mcp/) 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:

1. Na Localith, ligue as localizações do Google Business Profile que gere.
2. No Claude, abra **Definições, Conectores** e adicione a Localith. Pode procurá-la no diretório de conectores ou adicioná-la como conector personalizado.
3. 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."
4. 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.
5. 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](/pt/agente-ia-resposta-avaliacoes/) 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](/pt/docs/integracoes/configuracao-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](/pt/blog/gerir-varios-perfis-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

![Erros frequentes ao exportar dados com a API de avaliações do Google](/images/blog/google-reviews-api/google-reviews-api-pitfalls-01.svg)

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](/pt/blog/gestao-reputacao-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](/pt/blog/como-ver-minhas-avaliacoes-google/), aceder a todas as localizações necessárias e definir as decisões que o painel deve apoiar.