Plugin de Integração com as Avaliações do Google

Introdução

O plugin Integração com as Avaliações do Google permite exibir avaliações do Google Maps diretamente na página de detalhes das suas listagens. Isso ajuda a gerar mais confiança, aumentar a credibilidade e oferecer prova social real vinda do Google para os visitantes do seu site.

O plugin utiliza dados oficiais da Google Places API (New) e exibe um conjunto limitado de avaliações junto com informações importantes do negócio, totalmente integrado ao seu site eDirectory.

O que este plugin faz

Quando ativado, o plugin exibe até 5 avaliações do Google na página de detalhes da listagem, incluindo:

⭐ Nota média

👥 Quantidade total de avaliações

🔗 Link para a página do estabelecimento no Google Maps

🌍 Suporte a idioma e região, com base no local do site

🔄 Opção de ordenação para os visitantes:

• Mais relevantes
• Mais recentes

Requisitos

Antes de utilizar este plugin, você precisa ter:

• Uma conta no Google Cloud Platform (GCP)
• Faturamento ativado no projeto do GCP (obrigatório pelo Google)
• Uma chave da Google Places API (New)
• Acesso ao painel administrativo do eDirectory (sitemgr)

Como configurar o plugin

Etapa 1: Criar uma chave da Google Places API

1. Acesse o Google Cloud Platform's API Console.
2. Crie um novo projeto ou selecione um projeto existente

3. Ative o Faturamento do projeto

• Para habilitar o faturamento, consulte este artigo: Como habilitar o faturamento

4. Acesse Library (Biblioteca)

5. Procure por Places API (New) e clique nela

6. Clique em Enable (Ativar)

7. Em seguida, vá para APIs & Services. Click neste link para acessar: Google Cloud Platform's API Console.
8. Clique em Credentials (Credenciais)

9. Clique em Create Credentials e depois em Create an API Key

Etapa 2: Restringir a chave da API (Obrigatório)

Para evitar uso indevido e custos inesperados, é obrigatório restringir sua chave de API.

Restrição por endereço IP

1. Dê um nome à chave, por exemplo: Avaliações do Google
2. Selecione IP addresses (web servers, cron jobs, etc.)
3. Adicione o(s) endereço(s) IP do servidor onde o eDirectory está hospedado

⚠️ Sem essa restrição, terceiros podem utilizar sua chave de API, gerando requisições indevidas e custos inesperados.

Restrição adicional recomendada

• Em API restrictions, permita somente a Places API (New)
• Clique em Create

• Após clicar em Create, a chave da API será exibida. Copie a chave.

Etapa 3: Adicionar a chave da API no eDirectory

1. Faça login na área administrativa (sitemgr)
2. Acesse Configurações >Congifurações gerais > Plugins

3. Localize as configurações do plugin de Avaliações do Google

4. Cole a chave da API no campo de Avaliações do Google
5. Salve as alterações
6. Vá até Conteúdo > Anúncios > Modelos de Anúncio
7. Escolha um modelo para editar

8. Clique para adicionar um widget e selecione o widget Avaliações com o Google

9. Salve as alterações

10. Após a configuração, as avaliações passarão a ser exibidas nas listagens.

Custos da Google API: o que você precisa saber

O Google cobra por requisição de API, de acordo com o uso e os dados solicitados. Com este plugin, normalmente ocorrem as seguintes chamadas:

A) Text Search (para encontrar o Place ID)

• Endpoint: places:searchText   
• Tier (SKU) típico: Text Search Pro
• Usado para localizar o negócio com base no nome e endereço

B) Place Details (para buscar avaliações e dados)

• Endpoint: /v1/places/{placeId}   

  Quando avaliações são solicitadas:

  • Tier (SKU): Place Details Enterprise + Atmosphere
• Esta é a parte mais cara da integração

C) Fallback (sem avaliações)

Se as avaliações não puderem ser recuperadas:

• Tier (SKU): Place Details Enterprise
• Apenas a nota e a quantidade de avaliações são retornadas

📌 Resumo prático

Uma página de listagem com avaliações habilitadas geralmente gera:

• 1 requisição Text Search Pro
• 1 requisição Place Details Enterprise + Atmosphere

A maior parte do custo vem do Place Details com avaliações.

Onde verificar os preços

Os valores variam conforme a região e o volume de uso. Para consultar os preços atualizados, acesse a página oficial de preços do Google Maps Platform e procure pelos SKUs:

• Places API – Text Search Pro
• Places API – Place Details Enterprise
• Places API – Place Details Enterprise + Atmosphere

Boas práticas para reduzir custos

• 🔐 Sempre restrinja sua chave de API por IP
• 🏠 Garanta que as listagens tenham endereço completo e correto
• 📊 Monitore o uso em GCP → Billing → Reports
• 🚨 Configure alertas e limites de orçamento no Google Cloud

Perguntas frequentes

O plugin exibe todas as avaliações do Google?

Não. A Google Places API retorna no máximo 5 avaliações. Para exibir todas, geralmente é necessário acesso ao Google Business Profile.

Funciona em aplicativos mobile?

Não. Este plugin se aplica apenas ao site, não a aplicativos mobile.

Por que algumas listagens não exibem avaliações?

Possíveis motivos:

• O negócio não foi encontrado (título ou endereço incompletos)
• O negócio não possui avaliações públicas no Google
• Restrições ou permissões incorretas na chave da API
• Billing não habilitado no Google Cloud
• Limites ou cotas da API atingidos

Conclusão

O plugin de Integração com as Avaliações do Google é uma excelente forma de enriquecer suas listagens com avaliações reais e confiáveis do Google. Com a configuração correta e as restrições adequadas da chave de API, ele oferece grande valor ao site mantendo os custos sob controle.

Se precisar de ajuda para configurar sua chave de API, restrições de IP do servidor ou posicionamento do widget, nossa equipe de suporte está à disposição para ajudar.