--- title: "Guia de acesso à API do Google Business Profile para agências" date: "2026-04-21" canonical_id: google-business-profile-api-guide locale_slug: "guia-acesso-api-gbp-para-agencias" author: "Marija Azhderska" category: - google-business-profile - gbp-api tags: - "google-business-profile-api" - "gbp-api" - "acesso-api" - "fluxos-agencia" summary: "Saiba como funciona o acesso à API do Google Business Profile para agências, o que a aprovação exige, quais endpoints importam e quando usar o Localith." draft: false template: "blog" image: "blog/google-business-profile-api-guide/gbp-api-agencies.jpg" faq: - question: "O Google Business Profile tem API?" answer: "Sim. O Google fornece APIs de Business Profile para gerir dados de contas e localizações de forma programática." - question: "A API do Google Business Profile é gratuita?" answer: "O Google documenta limites de uso, quotas e pedidos de aumento de quota, não uma página de preços tipo SaaS. As agências também devem considerar custos de desenvolvimento e manutenção." - question: "A API do Google My Business é o mesmo que a API do Google Business Profile?" answer: "Normalmente, sim. O Google mudou Google My Business para Google Business Profile, mas o nome antigo ainda aparece em documentação, pesquisas e nomes de APIs." - question: "As agências podem obter acesso à API do Google Business Profile?" answer: "Sim. As agências podem solicitar acesso, mas a aprovação não é automática. O Google avalia contexto de negócio, projeto Cloud, conta de organização e motivo de uso." - question: "Como obtenho acesso à API GBP?" answer: "Crie ou selecione um projeto Google Cloud, prepare o perfil verificado e o contexto do site, envie o pedido de acesso, aguarde a análise e verifique o estado da quota." - question: "O que uma agência deve incluir no pedido?" answer: "Número do projeto, site, relação de proprietário ou gestor, motivo claro, fluxos pretendidos e plano de autenticação." - question: "Quanto demora a aprovação?" answer: "O tempo pode variar. Não prometa uma data fixa. Monitorize o pedido e a quota no Google Cloud." - question: "Porque o meu pedido foi rejeitado?" answer: "Pode dever-se a motivo pouco claro, contexto fraco de site ou perfil, dados incompletos do projeto ou um caso de uso que não encaixa nos requisitos." - question: "Porque não vejo a API do Google Business Profile no Google Cloud?" answer: "A API pode não aparecer até o projeto ser aprovado, ou as APIs certas ainda podem precisar de ativação. OAuth, projeto e permissões também podem bloquear o acesso." - question: "Posso usar a API para obter avaliações do Google?" answer: "Sim. Avaliações são um caso de uso comum. Use a referência REST do Google para os recursos exatos, ou o Localith para um fluxo de avaliações gerido." - question: "Posso responder a avaliações com a API?" answer: "O Google suporta fluxos de avaliações e respostas através de recursos relevantes de Business Profile. As agências devem manter controlos de aprovação antes de publicar." - question: "Posso publicar Google Posts através da API?" answer: "Os recursos LocalPosts do Google suportam fluxos de publicação quando disponíveis. As agências também podem usar os fluxos de publicação de Google Posts do Localith." - question: "Existem limites de API?" answer: "Sim. O Google documenta limites, incluindo quotas padrão de 300 QPM para várias APIs e 10 edições por minuto por perfil para Business Information." - question: "Quando devo usar o Localith em vez de construir diretamente?" answer: "Construa diretamente se precisa de controlo total e tem equipa técnica. Use o Localith se a sua agência quer fluxos geridos para avaliações, fichas, métricas, publicação, n8n e análise com IA." seo: title: "Guia de acesso à API do Google Business Profile" description: "Saiba como funciona o acesso à API do Google Business Profile para agências, o que a aprovação exige, quais endpoints importam e quando usar o Localith." og_image: "blog/google-business-profile-api-guide/gbp-api-agencies.jpg" structured_data: "article" --- Gerir avaliações, fichas, relatórios e publicações de Google Business Profile uma localização de cada vez deixa de funcionar quando a sua agência serve vários clientes. A [API do Google Business Profile](https://support.google.com/business/answer/6333473?hl=en), ainda muitas vezes pesquisada como Google My Business API, é a forma oficial do Google para gerir dados de contas e localizações de forma programática. Mas o acesso não é apenas uma opção dentro do Google Cloud. Depende da aprovação do Google. Se o objetivo é ligar dados GBP a fluxos de clientes sem manter infraestrutura direta sobre APIs do Google, o Localith oferece uma [ferramenta de API do Google Business Profile](/api/) gerida para fichas, avaliações, métricas, publicação e automação. As agências que querem esse caminho podem começar aí. Equipas que vão construir diretamente devem compreender primeiro acesso, configuração, quota e endpoints. Este guia explica acesso, requisitos, configuração pós-aprovação e quando uma camada de fluxo gerida encaixa melhor do que uma integração própria. {{product-cta:api-agency}} ## O que é a API do Google Business Profile? A API do Google Business Profile é um conjunto de interfaces para gerir dados de contas e localizações associados ao Google Search e Maps. A [visão geral do Google](https://developers.google.com/my-business/content/overview) explica que as APIs permitem gerir dados do perfil, acesso partilhado e conteúdo criado por utilizadores, como fotos, publicações e avaliações. Para uma agência, a versão prática é simples: a API permite que os seus sistemas trabalhem com contas, localizações, informação do negócio, avaliações, publicações, multimédia, Q&A, métricas, notificações e fluxos administrativos sem entrar perfil por perfil. Google Business Profile substituiu Google My Business, mas "Google My Business API" ainda aparece em pesquisas, nomes de APIs e referências para developers. "GBP API", "Business Profile API" e "Google My Business API" costumam apontar para o mesmo ecossistema. ## Porque as agências procuram acesso à API do Google Business Profile As agências não querem uma API pela API. Querem fluxos repetíveis para clientes. Se a sua equipa gere 20, 50 ou 200 localizações, o trabalho manual vira uma fila de tarefas: levar avaliações para relatórios, rever respostas pendentes, atualizar horários de feriados, publicar posts, exportar métricas e responder a perguntas de clientes. O acesso à API torna-se útil quando esse trabalho precisa de dashboards, aprovações, folhas de cálculo, CRMs, Slack ou ferramentas internas. Para agências focadas em alterações operacionais, não em infraestrutura, os fluxos de [gestão de fichas](/listings-management/) do Localith cobrem alterações de dados em várias localizações. ## As agências podem obter acesso à API do Google Business Profile? Sim. As agências podem solicitar acesso à API do Google Business Profile, mas a aprovação não é automática. Os [pré-requisitos do Google](https://developers.google.com/my-business/content/prereqs) incluem uma conta Google, familiaridade com Business Profile, um projeto Google Cloud, uma conta de organização e um pedido de acesso. O Google também indica que os candidatos devem gerir um perfil verificado e ativo há mais de 60 dias e ter um site de negócio coerente. Para uma agência, o pedido deve parecer um caso real de negócio, não um projeto vazio. Use um email com relação credível de proprietário ou gestor, alinhe site e domínio com o contexto do negócio e explique os fluxos de clientes que precisa de suportar. O Google pode rejeitar pedidos fracos ou pouco claros. ## Requisitos de acesso à API do Google Business Profile para agências Antes de pedir acesso, transforme os requisitos do Google numa checklist operacional. | Requisito | Porque importa para agências | |---|---| | Conta Google | O pedido precisa de uma identidade real. | | Familiaridade com Business Profile | O Google espera contexto operacional de GBP. | | Projeto Google Cloud | A aprovação fica ligada a um projeto. | | Conta de organização | O Google inclui isto no processo. | | GBP verificado e ativo 60+ dias | O Google aponta para histórico ativo e verificado. | | Site do negócio | Deve representar o negócio listado. | | Email de proprietário ou gestor | Reforça a relação com o perfil. | | Número do projeto Cloud | Necessário para o pedido. | | Motivo de negócio claro | O Google precisa de entender o uso. | | Plano de OAuth e dados | Dados privados exigem permissões corretas. | Seja específico. "Precisamos de acesso à API" é fraco. "Gerimos relatórios GBP, monitorização de avaliações, atualizações de fichas e Google Posts para clientes multi-localização" é muito mais claro. ![Checklist de requisitos de acesso à API do Google Business Profile para agências, incluindo projeto Cloud, perfil verificado, site, número do projeto, caso de uso e plano OAuth](/images/blog/google-business-profile-api-guide/google-business-profile-api-guide-checklist-01.png) ## Como solicitar acesso à API do Google Business Profile passo a passo Comece pela página de [pré-requisitos do Google](https://developers.google.com/my-business/content/prereqs), porque o caminho exato de contacto pode mudar. 1. Crie ou selecione o projeto Google Cloud. 2. Confirme que o perfil da agência ou negócio está verificado, ativo, completo e ligado a um site credível. 3. Encontre o número do projeto Google Cloud. 4. Abra o caminho de pedido ou contacto da GBP API a partir da página de requisitos. 5. Selecione Basic API Access. 6. Envie dados do negócio, número do projeto, email de contacto e caso de uso. 7. Aguarde a análise do Google. Não prometa uma data fixa aos clientes. 8. Verifique o estado da quota no Google Cloud. 9. Interprete a quota com cuidado: 0 QPM indica que o projeto não está aprovado, enquanto 300 QPM indica aprovação para as APIs relevantes, segundo a orientação de [limites de uso](https://developers.google.com/my-business/content/limits) do Google. ### O que as agências devem escrever no pedido Explique para quem gere perfis, porque o dashboard padrão não chega, quais fluxos exigem API e como vai tratar autenticação, permissões e acesso a dados. ![Diagrama de fluxo que mostra como as agências solicitam acesso à API do Google Business Profile desde o projeto Cloud até ao estado da quota e OAuth](/images/blog/google-business-profile-api-guide/google-business-profile-api-guide-access-flow-01.png) ## O que acontece depois da aprovação? A aprovação não termina a configuração. A página de [configuração básica](https://developers.google.com/my-business/content/basic-setup) do Google explica que as equipas podem ter de ativar as APIs necessárias no Google API Console depois da aprovação: - Google My Business API - My Business Account Management API - My Business Lodging API - My Business Place Actions API - My Business Notifications API - My Business Verifications API - My Business Business Information API - My Business Q&A API Dados protegidos exigem OAuth 2.0, credenciais, redirect URIs, acesso da app e autorização de utilizador. Muitas equipas ficam presas aqui: uma API pode precisar de ativação, o utilizador pode não ter o papel correto ou um pedido pode falhar com 403. O Google também indica que não há ambiente sandbox. Quando suportado, use `validateOnly` antes de alterar dados reais. ![Checklist pós-aprovação da API do Google Business Profile com ativação de APIs, OAuth, autorização de utilizadores, permissões, limites e testes cuidadosos](/images/blog/google-business-profile-api-guide/google-business-profile-api-guide-approval-setup-01.png) ## O que as agências podem fazer com a API do Google Business Profile? A API faz sentido quando se liga ao trabalho real da agência. A [referência REST do Google](https://developers.google.com/my-business/reference/rest) é a fonte para recursos exatos, mas esta tabela traduz capacidades para fluxos. | Fluxo de agência | Capacidade API | Uso para clientes | |---|---|---| | Inventário de localizações | Contas e localizações | Manter uma base central de localizações. | | Alterações de ficha | Business Information API | Atualizar horários, descrições, categorias e atributos. | | Monitorização de avaliações | Recursos de avaliações | Enviar avaliações novas para dashboards ou alertas. | | Respostas a avaliações | Avaliações e estado de resposta | Gerir aprovações e respostas. | | Google Posts | Recursos LocalPosts | Publicar campanhas em localizações compatíveis. | | Multimédia | Recursos de media | Gerir fotos e outros recursos. | | Relatórios | Performance API | Reportar chamadas, cliques, impressões e direções. | | Visibilidade | Impressões por palavras-chave | Mostrar termos que geram descoberta. | | Q&A | Q&A API | Acompanhar perguntas de clientes. | | Notificações | Notifications API | Alertar equipas sobre alterações relevantes. | O Localith foca-se em fluxos práticos para agências: fichas, avaliações, métricas, publicação, automação com n8n e conectores de IA. Pode combinar dados de avaliações com [fluxos de resposta a avaliações com IA](/ai-reviews-reply-agent/), métricas com [analítica GBP](/analytics/) e [publicação de Google Posts](/publishing/) multi-localização. ## Quando uma agência não precisa de acesso direto à API GBP O acesso direto é poderoso, mas nem sempre é a ferramenta certa. Se gere poucos perfis, o dashboard GBP pode chegar. Se não tem developers, a API direta pode transformar um problema operacional em trabalho de software. Se o urgente são relatórios, avaliações, publicações ou alterações de fichas, uma camada gerida pode ser mais rápida. O acesso direto encaixa quando precisa de infraestrutura própria e consegue manter autenticação, limites, monitorização, reintentos, alterações de endpoints e suporte. Uma camada gerida encaixa quando o resultado importa mais do que controlar cada endpoint. ## Preços, custo e limites da API do Google Business Profile O Google não apresenta preços da API do Google Business Profile como uma página SaaS normal. Documenta [limites de uso](https://developers.google.com/my-business/content/limits), quotas e pedidos de aumento. Para várias APIs de Business Profile, o Google lista uma quota padrão de 300 consultas por minuto. Para Business Information API também lista 10 edições por minuto por perfil. Aumentos de quota não são automáticos. O maior custo costuma estar à volta da API: OAuth, tempo de aprovação, erros 403, lógica de quotas, monitorização, alterações de acesso de clientes e manutenção. ## Principais APIs e endpoints que as agências devem conhecer Use isto como mapa antes de ler a [documentação da API do Google Business Profile](https://developers.google.com/my-business/reference/rest). | API ou recurso | Para que as agências usam | Exemplo | |---|---|---| | Account Management API | Gestão de contas e acessos | Listar contas de clientes. | | Business Information API | Campos principais do perfil | Atualizar horários, categorias e atributos. | | Performance API | Métricas GBP | Levar cliques, chamadas e impressões para relatórios. | | Verifications API | Verificação | Apoiar processos de verificação disponíveis. | | Q&A API | Perguntas e respostas | Monitorizar perguntas de clientes. | | Lodging API | Dados de hotelaria | Gerir detalhes de alojamento. | | Place Actions API | Links de ação | Gerir reservas, pedidos ou marcações. | | Notifications API | Eventos de perfil | Acionar alertas perante alterações. | | LocalPosts | Google Posts | Criar ou gerir publicações. | | Reviews | Avaliações e respostas | Listar avaliações e gerir respostas. | Para agências, as áreas de maior valor costumam ser Business Information, Reviews, Performance, LocalPosts e Notifications. ## Problemas comuns que as agências encontram com a API GBP A documentação oficial está correta, mas espalhada por visão geral, requisitos, configuração, limites e referência REST. As agências podem esperar sem prazo claro, receber aprovação mas ainda ter de ativar APIs, não ver uma API porque o projeto não está aprovado ou receber erros 403 por permissões insuficientes. Testar também exige cuidado porque o Google diz que não há sandbox. Os fóruns refletem essa confusão. Numa [conversa do Local Search Forum](https://localsearchforum.com/threads/need-help-getting-access-to-google-business-profile-apis.62211/), utilizadores mencionam dúvidas sobre aprovação e visibilidade de endpoints. Use isto como sinal, não como política. Para configuração, use as páginas de [configuração básica](https://developers.google.com/my-business/content/basic-setup) e [limites](https://developers.google.com/my-business/content/limits) do Google. ## Um caminho mais rápido para agências: usar o Localith como camada de API GBP Se a sua agência precisa de controlo total e tem developers, construir sobre as APIs do Google pode fazer sentido. Se o objetivo é executar fluxos GBP mais depressa, o Localith pode funcionar como [ferramenta de API do Google Business Profile](/api/) e camada gerida. O Localith foi criado para agências e equipas multi-localização que precisam de fichas, avaliações, métricas, publicação, automação e análise com IA num só sistema. Suporta fluxos REST e liga dados GBP a n8n, Claude, fluxos tipo ChatGPT, folhas de cálculo, Slack e relatórios. | Necessidade | Construir com APIs do Google | Usar Localith | |---|---|---| | Controlo técnico | Melhor se precisa de infraestrutura própria. | Melhor se o fluxo importa mais que cada endpoint. | | Rapidez | Exige aprovação, Cloud, OAuth e endpoints. | Começa a partir de fluxos geridos. | | OAuth e permissões | A equipa mantém o modelo completo. | Localith gere o fluxo de produto. | | Avaliações | Constrói sincronização e alertas. | Usa fluxos geridos de avaliações. | | Respostas | Constrói aprovação e publicação. | Usa [fluxos de resposta a avaliações com IA](/ai-reviews-reply-agent/). | | Fichas | Constrói validação e reintentos. | Usa fluxos de fichas em localizações selecionadas. | | Métricas | Constrói exportes e relatórios. | Usa relatórios e analítica do Localith. | | Google Posts | Constrói criação e agendamento. | Usa publicação gerida. | | n8n | Mantém o seu próprio conector. | Usa o node comunitário do Localith. | | Claude ou ChatGPT | Constrói uma ponte de dados. | Usa conectores do Localith. | | Manutenção | A equipa mantém alterações e suporte. | Localith mantém a camada de fluxo. | Explore a [ferramenta de API do Google Business Profile](/api/) do Localith para ver o caminho gerido. ![Diagrama de arquitetura que mostra o Localith como camada gerida entre a API do Google Business Profile e ferramentas de agência como n8n, Claude, ChatGPT, Sheets, Slack e relatórios](/images/blog/google-business-profile-api-guide/google-business-profile-api-guide-workflow-map-01.png) Importante: o Localith não evita as regras de acesso do Google nem promete que o seu projeto Google Cloud será aprovado. É uma camada gerida de API e fluxos GBP. ## Exemplos de fluxos de agência com o Localith O Localith é útil quando a sua agência precisa de fluxos operacionais, não apenas endpoints. As chaves API do Localith estão disponíveis em [Localith API access](/docs/integrations/api-access/) em Account > API key. ![Janela de chave API do Localith para copiar ou regenerar uma chave](/images/docs/integrations/api-access--api-key.jpg) Equipas de automação podem instalar o [node comunitário do Localith para n8n](/docs/integrations/n8n-setup/) para fluxos de avaliações, fichas e métricas. O node suporta 7 operações. ![Painel de credenciais do n8n configurado para o node comunitário do Localith](/images/docs/integrations/n8n-setup--credentials.jpg) Equipas que querem análise em linguagem natural podem ligar o [Claude MCP connector](/docs/integrations/claude-mcp-setup/). Ele oferece 6 ferramentas apenas de leitura para localizações, detalhes, métricas, métricas de avaliações, avaliações e documentação API. O Claude pode analisar dados GBP, mas não modificar fichas nem responder a avaliações através desse conector. Para um passo a passo completo com prompts e exemplos, veja [como usar Claude MCP para gerenciar múltiplos perfis do Google Business](/pt/blog/como-usar-claude-mcp-perfis-google-business/). Exemplos de fluxos: alertas de avaliações no Slack, sincronização com folhas de cálculo, relatórios semanais de [GBP analytics](/analytics/), rascunhos com [fluxos de resposta a avaliações com IA](/ai-reviews-reply-agent/), atualizações por [gestão de fichas](/listings-management/) e [publicação de Google Posts](/publishing/) multi-localização. Se esses fluxos são o objetivo, comece com a [ferramenta de API do Google Business Profile](/api/) do Localith em vez de construir primeiro a integração direta. ## Escolha o caminho que encaixa com o fluxo da agência O acesso direto à API encaixa com agências que precisam de infraestrutura própria e conseguem manter aprovação, OAuth, permissões, quotas, monitorização e suporte. O Localith encaixa com trabalho operacional: relatórios, avaliações, fichas, publicação, automação e análise com IA. Veja como o Localith funciona como [ferramenta de API do Google Business Profile](/api/) gerida para agências que precisam de fichas, avaliações, métricas, publicação, automação e conectores de IA.