---
title: "API do Perfil da Empresa: como automatizar o pedido e a gestão de avaliações"
url: "https://patrickperdigao.com.br/blog/api-perfil-da-empresa-avaliacoes"
description: Como pedir acesso à API do Perfil da Empresa no Google, pegar o link de avaliação de cada local, monitorar novas avaliações e responder pela API.
author: Patrick Perdigão
author_url: "https://patrickperdigao.com.br/"
published: 2026-10-14
updated: 2026-10-14
category: Growth
tags: Google Business Profile API, API do Perfil da Empresa, avaliações, automação, Pub/Sub, Google Meu Negócio, SEO local
reading_time: 10 min
---

# API do Perfil da Empresa: como automatizar o pedido e a gestão de avaliações

> Como pedir acesso à API do Perfil da Empresa no Google, pegar o link de avaliação de cada local, monitorar novas avaliações e responder pela API.

Por Patrick Perdigão · Publicado em 14 out 2026 · 10 min de leitura · Tema: [Growth](https://patrickperdigao.com.br/blog/tema/growth.md)

## TL;DR

A API do Perfil da Empresa (Google Business Profile API) deixa você ler os dados dos seus locais, listar e responder avaliações e receber um aviso a cada avaliação nova. Ela não envia pedidos de avaliação: o que ela entrega é o link oficial de avaliação de cada local (newReviewUri), que você usa no seu fluxo de WhatsApp ou e-mail. O acesso depende de aprovação do Google e exige um perfil verificado e ativo há mais de 60 dias, com site próprio.

1. Sem aprovação, a cota da API é 0 por minuto; aprovada, sobe para 300 consultas por minuto.
2. O campo metadata.newReviewUri traz o link de avaliação de cada local, o que resolve o problema de quem gerencia muitos perfis.
3. Com o Pub/Sub, o Google avisa na hora quando chega uma avaliação nova, sem precisar consultar a API toda hora.

## O que é a API do Perfil da Empresa?

**É o conjunto de APIs do Google que permite ler e gerenciar Perfis da Empresa por código: dados dos locais, avaliações, respostas e notificações.** Em inglês, Google Business Profile API, o antigo Google My Business API.

Para um único perfil, o painel do Google resolve quase tudo. A API passa a valer a pena quando:

- **Você gerencia muitos locais**, como uma rede de lojas, franquias ou os clientes de uma agência.
- **Você quer integrar o Perfil da Empresa ao seu sistema**, como o ERP, o CRM ou a plataforma de atendimento.
- **Você quer automatizar a rotina de avaliações:** mandar o link certo para cada cliente, saber na hora quando chega uma avaliação e acompanhar a nota ao longo do tempo.

Ela não é uma API única. São várias, cada uma com uma parte do trabalho:

| API | O que faz | Exemplo de uso |
| --- | --- | --- |
| My Business Account Management | Lista as contas e os acessos | Descobrir o ID da conta |
| My Business Business Information | Lê e edita os dados dos locais | Pegar o link de avaliação (`newReviewUri`) |
| Google My Business API (v4) | Avaliações, respostas e outros recursos antigos | Listar e responder avaliações |
| My Business Notifications | Liga a conta a um tópico do Pub/Sub | Receber aviso de avaliação nova |

> [!NOTE] O pedido de avaliação não é feito pela API
> Não existe um método "pedir avaliação". O que a API entrega é o link oficial de avaliação de cada local. O envio para o cliente, por WhatsApp, e-mail ou SMS, é feito pelo seu sistema ou por uma ferramenta de automação.

## Como conseguir acesso à API?

**Crie um projeto no Google Cloud e envie o pedido de acesso básico pelo formulário da API, com um perfil verificado e ativo há mais de 60 dias.** Sem aprovação, a API não responde: a cota fica em 0 consultas por minuto.

Os requisitos, segundo a documentação do Google:

| Requisito | Detalhe |
| --- | --- |
| Perfil verificado e ativo | Há mais de 60 dias, seu ou de um cliente que você gerencia |
| Site próprio | O negócio do perfil precisa ter um site |
| Projeto no Google Cloud | O número do projeto (Project Number) vai no formulário |
| E-mail com acesso ao perfil | Proprietário ou administrador do Perfil da Empresa |

O passo a passo:

1. **Crie um projeto** no Google Cloud Console e anote o número do projeto, que aparece no painel.
2. **Envie o formulário de contato da API** do Perfil da Empresa, escolhendo "Application for Basic API Access".
3. **Aguarde o e-mail** com a resposta. Se for recusado, ajuste o que faltou e envie de novo.
4. **Confira a cota** em APIs e serviços > Cotas, no Google Cloud: 0 QPM significa que ainda não foi aprovado; 300 QPM, que está liberado.

Se o perfil ainda não está verificado, comece pelo guia de [verificação do Perfil da Empresa](https://patrickperdigao.com.br/blog/verificacao-perfil-da-empresa-google). Os 60 dias contam a partir daí.

## Como configurar o projeto?

**Habilite as APIs, crie uma credencial OAuth e autorize com o escopo `business.manage`.** A API age em nome de uma pessoa com acesso ao perfil, então a autenticação é por OAuth, e não só por chave de API.

1. **Habilite as quatro APIs** da tabela acima em APIs e serviços > Biblioteca.
2. **Configure a tela de consentimento OAuth** do projeto.
3. **Crie um ID do cliente OAuth** (aplicativo da Web ou de computador).
4. **Autorize uma vez** com a conta que administra os perfis, pedindo o escopo `https://www.googleapis.com/auth/business.manage`.
5. **Guarde o refresh token** em um cofre de segredos. É com ele que o sistema gera novos tokens de acesso sem pedir login de novo.

> [!WARNING] O refresh token dá acesso a todos os perfis da conta
> Quem tem o token pode editar dados e responder avaliações de todos os locais. Nunca coloque o token no código, no repositório ou em planilhas compartilhadas.

## Como pegar o link de avaliação de cada local?

**Liste os locais da conta pedindo o campo `metadata`: o `newReviewUri` de cada um é o link oficial para o cliente escrever uma avaliação.** A documentação descreve o campo como o link para a página da Pesquisa Google em que o cliente pode deixar uma avaliação do local.

Primeiro, o ID da conta:

```bash
curl -H "Authorization: Bearer $TOKEN" \
  "https://mybusinessaccountmanagement.googleapis.com/v1/accounts"
```

Depois, os locais com o link de avaliação. O parâmetro `readMask` diz quais campos a API deve devolver:

```bash
curl -H "Authorization: Bearer $TOKEN" \
  "https://mybusinessbusinessinformation.googleapis.com/v1/accounts/$CONTA/locations?readMask=name,title,metadata"
```

Na resposta, cada local traz algo assim:

```json
{
  "name": "locations/1234567890",
  "title": "Loja Centro",
  "metadata": {
    "placeId": "ChIJ...",
    "mapsUri": "https://maps.google.com/maps?cid=...",
    "newReviewUri": "https://search.google.com/local/writereview?placeid=ChIJ..."
  }
}
```

Os valores acima são ilustrativos. Salve o `newReviewUri` de cada local no seu CRM ou na base de clientes, ligado à loja em que o cliente comprou. Assim cada pedido leva o cliente para o perfil certo, o problema mais comum em redes com vários endereços.

## Como automatizar o pedido de avaliação?

**Ligue um gatilho de venda ou atendimento concluído a uma mensagem com o `newReviewUri` do local, enviada a todos os clientes.** A API entra no fluxo como a fonte dos links; o resto é automação comum.

| Etapa | O que acontece | Ferramenta típica |
| --- | --- | --- |
| Gatilho | Venda faturada, pedido entregue ou atendimento encerrado | ERP, CRM, e-commerce, planilha |
| Espera | Algumas horas ou um dia, para o cliente usar o produto | Fila, agendador ou automação |
| Link certo | Busca o `newReviewUri` do local da compra | Base sincronizada com a API |
| Envio | Mensagem padrão com o link | WhatsApp Business API, e-mail, SMS |
| Registro | Marca que o pedido foi enviado, para não repetir | CRM ou planilha |

Para quem não quer programar, ferramentas como Make, Zapier e n8n fazem esse fluxo com poucos blocos. É o que eu ensino no curso da Alura sobre [automação da coleta de avaliações para o Google Meu Negócio](https://www.alura.com.br/curso-online-Automatizar-coleta-avaliacoes-google-meu-negocio), com Make, Google Sheets e WhatsApp.

> [!IMPORTANT] Automatizar não muda as regras
> As políticas do Google proíbem pedir avaliações só a clientes satisfeitos, oferecer incentivos e pedir conteúdo específico. Um fluxo que pergunta a nota antes e só manda o link a quem deu 4 ou 5 estrelas viola essas regras. O fluxo deve mandar o mesmo pedido para todos. As regras completas, com modelos de mensagem, estão no post sobre o [link e o QR code de avaliação](https://patrickperdigao.com.br/blog/link-qr-code-avaliacao-google).

## Como receber um aviso a cada avaliação nova?

**Ligue a conta a um tópico do Google Cloud Pub/Sub pela My Business Notifications API: o Google publica uma mensagem a cada avaliação nova ou alterada.** É melhor do que consultar a API de tempos em tempos, porque o aviso chega na hora e não gasta cota.

1. **Crie um tópico** no Pub/Sub, no mesmo projeto.
2. **Dê permissão de publicação** no tópico para a conta de serviço `mybusiness-api-pubsub@system.gserviceaccount.com`.
3. **Crie uma assinatura** (push para um endpoint seu, ou pull).
4. **Ligue a conta ao tópico** com um PATCH no `notificationSetting`:

```bash
curl -X PATCH -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://mybusinessnotifications.googleapis.com/v1/accounts/$CONTA/notificationSetting?updateMask=pubsubTopic,notificationTypes" \
  -d '{
    "name": "accounts/'$CONTA'/notificationSetting",
    "pubsubTopic": "projects/'$PROJETO'/topics/avaliacoes",
    "notificationTypes": ["NEW_REVIEW", "UPDATED_REVIEW"]
  }'
```

Com o aviso chegando, o seu sistema pode mandar a avaliação para um canal do time, abrir um chamado quando a nota for baixa ou registrar tudo em uma planilha.

## Como listar e responder avaliações pela API?

**Liste com GET em `.../locations/{local}/reviews` e responda com PUT em `.../reviews/{avaliação}/reply`.** Esses métodos ficam na Google My Business API v4, que continua sendo a versão usada para avaliações.

Listar as avaliações de um local:

```bash
curl -H "Authorization: Bearer $TOKEN" \
  "https://mybusiness.googleapis.com/v4/accounts/$CONTA/locations/$LOCAL/reviews"
```

Cada avaliação traz, entre outros, a nota (`starRating`), o texto (`comment`), quem avaliou (`reviewer`), a data (`createTime`) e a resposta, se houver (`reviewReply`). Para vários locais de uma vez, existe o `locations:batchGetReviews`.

Responder:

```bash
curl -X PUT -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://mybusiness.googleapis.com/v4/accounts/$CONTA/locations/$LOCAL/reviews/$AVALIACAO/reply" \
  -d '{"comment": "Obrigado pela visita, Ana! Que bom que o atendimento foi rápido."}'
```

> [!TIP] Rascunho automático, aprovação humana
> Um bom meio-termo é o sistema sugerir a resposta, inclusive com IA, e uma pessoa aprovar antes de publicar. Respostas iguais para todo mundo parecem robô, e uma resposta errada a uma reclamação é pública.

## O que dá para medir com a API?

**Volume de avaliações, nota média e tempo de resposta, por local e por período.** Com as avaliações listadas, as métricas saem de contas simples:

| Métrica | Como calcular | Por que importa |
| --- | --- | --- |
| Avaliações novas por semana | Contar por `createTime` | Mostra se o fluxo de pedidos está funcionando |
| Nota média por local | Média de `starRating` | Compara lojas e encontra problemas de operação |
| Taxa de resposta | Avaliações com `reviewReply` ÷ total | Quanto do que os clientes dizem recebe resposta |
| Tempo até a resposta | Data da resposta − `createTime` | Velocidade de atendimento, principalmente nas negativas |
| Taxa de conversão do pedido | Avaliações novas ÷ pedidos enviados | Eficiência da mensagem e do momento do envio |

As avaliações também pesam fora do ranking: o Gemini no Google Maps usa o texto delas para responder perguntas sobre os lugares, como mostra o post sobre o [Gemini no Google Maps](https://patrickperdigao.com.br/blog/gemini-google-maps-seo-local).

## Quais erros evitar?

| Erro | O que fazer no lugar |
| --- | --- |
| Pedir acesso com um perfil novo ou sem site | Esperar os 60 dias de perfil verificado e ativo, com site próprio |
| Refresh token no código ou em planilha | Guardar em um cofre de segredos |
| Um link de avaliação para todas as lojas | Usar o `newReviewUri` de cada local |
| Filtrar quem recebe o pedido pela nota | Mandar o mesmo pedido para todos os clientes |
| Consultar a API a cada minuto atrás de novidades | Usar as notificações do Pub/Sub |
| Responder tudo automaticamente | Rascunho automático e aprovação humana |

## Checklist

- [ ] Perfil verificado e ativo há mais de 60 dias, com site próprio
- [ ] Projeto no Google Cloud criado e número do projeto anotado
- [ ] Pedido de acesso aprovado (cota de 300 QPM no Cloud Console)
- [ ] APIs habilitadas: Account Management, Business Information, Google My Business (v4) e Notifications
- [ ] OAuth com o escopo business.manage e refresh token guardado em segredo
- [ ] newReviewUri de cada local salvo na base de clientes ou no CRM
- [ ] Fluxo de envio que pede avaliação a todos os clientes, sem filtro
- [ ] Aviso de avaliação nova ligado ao time (Pub/Sub, e-mail ou Slack)

## Perguntas frequentes

### A API do Perfil da Empresa é gratuita?

Sim, o uso da API não é cobrado. O que limita é a cota: depois da aprovação, o projeto recebe 300 consultas por minuto, o que atende a maioria das empresas e agências. Os serviços do Google Cloud usados em volta dela, como o Pub/Sub, seguem a tabela do Google Cloud, que tem faixa gratuita.

### Como pedir acesso à API do Perfil da Empresa?

Crie um projeto no Google Cloud, anote o número do projeto e envie o formulário de contato da API escolhendo "Application for Basic API Access", com um e-mail que seja proprietário ou administrador do perfil. O perfil precisa estar verificado e ativo há mais de 60 dias e ter um site próprio. A resposta chega por e-mail.

### A API envia pedidos de avaliação para os clientes?

Não. A API não tem um método para pedir avaliações. Ela fornece o link oficial de avaliação de cada local, no campo metadata.newReviewUri, e o envio é feito pelo seu sistema, por WhatsApp, e-mail ou SMS.

### Dá para responder avaliações pela API?

Sim. O método PUT em accounts/{conta}/locations/{local}/reviews/{avaliação}/reply cria ou atualiza a resposta, e o DELETE no mesmo endereço remove. Vale manter uma pessoa aprovando as respostas, porque respostas genéricas e automáticas passam a impressão de descaso.

### Preciso da API para ter o link de avaliação?

Não. Para um ou poucos perfis, o link e o QR code saem do próprio Perfil da Empresa, em Ler avaliações > Receber mais avaliações. A API vale a pena para quem gerencia muitos locais ou quer integrar o pedido ao sistema de vendas ou ao CRM.

## Fontes e referências

- [Google for Developers: pré-requisitos das APIs do Perfil da Empresa](https://developers.google.com/my-business/content/prereqs)
- [Google for Developers: referência de accounts.locations (Business Information API)](https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations)
- [Google for Developers: trabalhar com dados de avaliações](https://developers.google.com/my-business/content/review-data)
- [Google for Developers: configurar notificações em tempo real](https://developers.google.com/my-business/content/notification-setup)
- [Política de conteúdo do Google Maps: engajamento falso](https://support.google.com/contributionpolicy/answer/7400114?hl=pt-BR)

## Sobre o autor

Patrick Perdigão é especialista em seo e growth. Especialista de SEO na Omie, instrutor na Alura e professor na EducaSEO. Perfil completo: https://patrickperdigao.com.br/index.md

## Continue lendo

- [Link e QR code de avaliação do Google: como pedir avaliações que ajudam no ranking](https://patrickperdigao.com.br/blog/link-qr-code-avaliacao-google.md): Como gerar o link e o QR code de avaliação do Perfil da Empresa, onde usar cada um e como pedir avaliações no Google sem violar as regras. (Growth, 14 out 2026)
- [Verificação do Perfil da Empresa no Google: carta, vídeo e outras opções](https://patrickperdigao.com.br/blog/verificacao-perfil-da-empresa-google.md): Carta do Google Meu Negócio não chegou? Veja todos os métodos de verificação do Perfil da Empresa (carta, vídeo, telefone, e-mail) e como evitar reprovação. (Growth, 14 out 2026)
- [Gemini no Google Maps: como a IA escolhe negócios locais e como aparecer](https://patrickperdigao.com.br/blog/gemini-google-maps-seo-local.md): O Ask Maps, a IA do Gemini no Google Maps, já chegou ao Brasil. Veja como ele recomenda lugares e o que ajustar no Perfil da Empresa para ser indicado. (Growth, 14 out 2026)