API do Google Business Profile: o que ela faz e como obter acesso
Por Toy Wen Da, Cofundador · Atualizado em · 6 min de leitura
Traduzido do original em inglês. Ler em inglês
A API do Google Business Profile permite gerenciar dados da ficha, avaliações, publicações e estatísticas por meio de código, em vez do painel comum. Ela serve para empresas e agências que cuidam de muitas unidades e para desenvolvedores que criam ferramentas sobre o Google Business Profile. O acesso não é automático: você se candidata por um formulário do Google, e o Google analisa cada pedido antes de conceder uma cota.
O que a API do Google Business Profile faz
O painel é o caminho manual e a API é o caminho programático, e os dois trabalham com os mesmos dados: nome da empresa, endereço, horário de funcionamento, categorias, fotos, publicações, avaliações e métricas de desempenho. Com a API, um software lê e grava esses dados diretamente, em vez de alguém digitá-los à mão. Essa diferença importa quando você gerencia mais do que um punhado de unidades, porque atualizar 40 fichas uma a uma é um trabalho bem diferente de enviar uma única atualização para as 40.
Para quem ela serve
- Marcas com várias unidades que querem manter horários, categorias e fotos consistentes em todas as lojas.
- Agências que gerenciam o Google Business Profile de vários clientes a partir de um único sistema.
- Plataformas SaaS que criam ferramentas de gestão de avaliações, SEO local ou reputação sobre esses dados.
- Desenvolvedores que criam painéis internos para operações de franquias ou redes.
Uma empresa com uma única unidade raramente precisa de acesso direto à API, já que o painel já cobre publicações, envio de fotos e respostas a avaliações. Uma conta de desenvolvedor só aumentaria o tempo de configuração, sem um retorno proporcional.
Como obter acesso à API do Google Business Profile: os passos
O acesso passa pelo Google Cloud, e não pelo login comum do Business Profile.
1. Crie um projeto no Google Cloud
Crie um projeto no Google Cloud Console e ative o faturamento. Mais adiante, é também aí que você ativa a "Business Profile API" na Biblioteca de APIs (API Library).
2. Envie a solicitação de acesso à API
O Google restringe essa API por meio de um formulário de candidatura, então não dá para simplesmente ativá-la. Você descreve seu caso de uso, sua empresa e como pretende usar os dados. O prazo de aprovação varia: alguns desenvolvedores em discussões de comunidades relatam ter esperado cerca de duas semanas, enquanto outros descrevem várias recusas, mesmo quando o pedido era para gerenciar o próprio perfil de empresa.
3. Configure a tela de consentimento OAuth
Credenciais criadas no modo "testing" (teste) muitas vezes falham sem avisar. Vários desenvolvedores que investigaram problemas de acesso descobriram que a solução era mudar o status de publicação da tela de consentimento OAuth para "In Production" (em produção), um passo fácil de esquecer e que raramente é apontado como causa de uma chamada que falhou.
4. Gere as credenciais e teste
Depois de aprovado, crie credenciais OAuth ou de conta de serviço e teste com um perfil real. Se você gerencia a ficha de um cliente, ser adicionado como administrador no Business Profile dele não dá acesso à API. A solicitação do seu próprio projeto no Cloud ainda precisa ser aprovada separadamente.
Acesso à API por conta própria x plataforma gerenciada
Pedir o acesso direto à API e usar uma plataforma criada sobre ela resolvem o mesmo problema de maneiras diferentes.
| Abordagem | Esforço de configuração | Custo típico | Ideal para |
|---|---|---|---|
| Acesso direto à API (seu próprio projeto no Cloud) | Alto: candidatura, espera pela aprovação, configuração do OAuth, manutenção contínua | A API do Google em si é gratuita; o custo real é o tempo da sua equipe de engenharia | Desenvolvedores que criam uma ferramenta própria ou gerenciam dezenas de unidades internas |
| Plataforma de terceiros para gerenciar o GBP | Baixo: cadastre-se e conecte seu perfil | Planos criados sobre a API oficial já foram listados a partir de cerca de $9.00 por mês para duas ou três unidades | Agências e empresas que querem edição em massa e sincronização de avaliações sem manter código |
| Somente o painel manual | Nenhum | Grátis | Empresas com uma única unidade que cuidam de publicações, horários e avaliações de vez em quando |
As plataformas que anunciam acesso à API do Google Business Profile normalmente usam os endpoints oficiais e autorizados, e não scraping do painel. Confirme isso antes de dar acesso ao seu perfil, porque ferramentas baseadas em scraping aumentam o risco de sua ficha ser sinalizada.
Problemas comuns
Os atrasos na aprovação não são o único obstáculo. Desenvolvedores que trabalham com a API relatam erros 404 "method not found" quando as credenciais não correspondem ao escopo correto, e exigência de vídeo de demonstração pela equipe de análise do Google antes de aprovar certos apps OAuth. Também é comum que as candidaturas sejam recusadas quando o e-mail da conta não corresponde ao domínio da própria empresa. Nenhum desses problemas é um bloqueio definitivo, mas cada um acrescenta tempo real até a API devolver dados utilizáveis.
Você precisa de acesso à API ou de um painel mais bem configurado?
Você só precisa de acesso à API se gerencia muitas unidades ou está criando um produto sobre os dados do Google Business Profile; caso contrário, o que você procura é configurar melhor o painel. Se o objetivo é ter mais visibilidade, como acertar as categorias, completar as perguntas e respostas ou evitar que as publicações fiquem enterradas, isso é um problema de painel e de conteúdo, não de API. Acertar as categorias do Google Business Profile ou arrumar a forma como a seção de perguntas e respostas do Google Business Profile aparece costuma ter mais efeito do que qualquer quantidade de acesso programático. A API é a escolha certa quando você sincroniza dezenas de unidades ou cria um produto em torno dos dados, e ela não ajuda se você só quer ter uma posição melhor nas buscas locais.
O próprio guia Search Essentials do Google diz que informações de negócio precisas e mantidas de forma consistente sustentam o desempenho de uma ficha nas buscas locais. A API pode ajudar a escalar esse trabalho, mas não o cria. Para ver em que pé está a sua configuração atual, com API ou sem ela, rode um exemplo de relatório de SEO no seu site e na sua ficha.
Perguntas frequentes
A API do Google Business Profile é gratuita?
A API em si não tem taxa de licenciamento do Google, mas o acesso depende de um processo de aprovação, e a maioria das empresas acaba pagando por uma plataforma de terceiros ou por horas de desenvolvedor para criar e manter a integração.
Quanto tempo leva a aprovação da API do Google Business Profile?
Varia. Relatos da comunidade mencionam aprovações em cerca de duas semanas, mas algumas candidaturas são recusadas e precisam ser reenviadas com mais detalhes sobre o caso de uso.
Posso usar a API se sou apenas administrador do perfil de outra pessoa?
Ser adicionado como administrador não dá acesso à API por si só. Você ainda precisa do seu próprio projeto no Google Cloud com uma solicitação de API aprovada.
Por que estou recebendo um erro 404 ao chamar a API?
Isso geralmente indica uma incompatibilidade de credenciais ou de escopo. Muitas vezes são credenciais de conta de serviço usadas onde se esperavam credenciais OAuth, ou uma API que não foi ativada no projeto do Cloud.
Pequenas empresas precisam da API do Google Business Profile?
Raramente. Uma empresa com uma única unidade pode cuidar de publicações, fotos, horários e respostas a avaliações pelo painel padrão. A API compensa quando você gerencia várias unidades ou cria um software em torno dos dados.
Próximo passo: descubra o que realmente está atrapalhando a sua ficha
Antes de passar semanas com uma candidatura à API do Google Business Profile, descubra se o que você precisa corrigir é mesmo um problema de código. Fale com a equipe e receba um exemplo de relatório de SEO que mostra o que está prejudicando a sua visibilidade agora e se um acesso no nível da API mudaria alguma coisa.
Recursos / Referências
Leia também: Google Reviews API: The Free Options vs the 5-Review Limit.
Fontes
Sobre o autor
O SearchBlueprint pesquisou, escreveu e avaliou este artigo com o mesmo pipeline de conteúdo que nossos clientes usam nos próprios sites. A nota que aparece na assinatura é a que nosso mecanismo de conteúdo deu a esta página antes de ela ser publicada. Nada aqui passa por revisão manual, e esse é justamente o ponto: é o resultado do produto, publicado onde qualquer pessoa pode conferir.