Perfil do Google ligado ao Claude

1. O que saber antes

A ligação é feita pela API oficial do Google, a Business Profile API. Ela é gratuita, mas fechada: todo projeto novo começa com cota zero, e o Google libera na mão, depois de analisar um pedido.

O Google só aceita o pedido se

• A conta Google que pede é proprietária ou administradora de um Perfil da Empresa verificado e ativo há mais de 60 dias. Pode ser o perfil da própria Conexão ou o de um cliente que você já gerencia.
• Esse perfil tem um site que representa o negócio.
• O perfil está completo e atualizado. O Google recomenda isso para a análise andar mais rápido.

2. Hoje: criar o projeto e pedir acesso

Feito uma vez, pela Conexão. É o mesmo raciocínio do app na Meta: a estrutura é da Conexão, não da Avantys.

1. Criar o projeto no Google Cloud

   Entre em console.cloud.google.com com a conta da operação. Clique em Criar projeto, dê o nome Conexao Perfil Google e crie.

2. Anotar o número do projeto

   No painel do projeto, o cartão Informações do projeto mostra o Número do projeto (só algarismos). Ele vai no formulário.

3. Mandar o pedido de acesso

   Abra o formulário de acesso à API, logado com a mesma conta. No menu, escolha Application for Basic API Access e preencha. Para o campo que pede o uso, um texto pronto, em inglês porque a análise é feita em inglês:

   copiar

   Conexão Marketing is a marketing agency in Brazil that manages the Google Business Profiles of its small and medium business clients. Each client grants our agency account manager access to their own profile. We will use the API internally, only for profiles we manage, to: read and reply to reviews after human approval, read performance metrics (calls, direction requests, website clicks, searches) for monthly client reports, publish local posts, and keep business information (hours, phone, website) consistent with the client's website. No data is sold or shared with third parties.

4. Guardar o número do caso e não reenviar

   O Google devolve um número de caso. Anote. Mandar o pedido de novo não acelera nada e pode bagunçar a fila.

5. Saber se foi aprovado

   O e-mail de resposta pode demorar. Para conferir sozinho: no projeto, APIs e serviços › Cotas, procure as APIs do Business Profile. 0 por minuto = ainda em análise. 300 por minuto = aprovado.

   Não peça aumento de cota enquanto estiver em zero. Zero quer dizer que o pedido de acesso ainda não foi aprovado, e não que falta cota.

3. Enquanto espera: cada cliente dá acesso à Conexão

A API só enxerga os perfis em que a conta da operação é administradora. Esse passo não depende do Google e pode começar hoje.

1. O cliente adiciona a Conexão como administradora

   O cliente continua proprietário. A Conexão entra como administradora, que gerencia tudo menos remover o dono. Mensagem pronta para mandar:

   copiar

   Oi, [nome]! Para a gente acompanhar o perfil da [empresa] no Google (avaliações, ligações, rotas e publicações), preciso que você dê acesso de administrador pra Conexão. Leva 1 minuto:
   
   1. Entre no Google com o e-mail que é dono do perfil da empresa
   2. Pesquise "[nome da empresa]" no Google ou abra business.google.com
   3. No painel do perfil, toque nos três pontinhos › Configurações do perfil › Pessoas e acesso
   4. Toque em Adicionar, cole [e-mail da Conexão] e escolha Administrador
   5. Toque em Convidar
   
   Você continua sendo o dono, a gente só passa a cuidar do dia a dia. Qualquer dúvida me chama.

2. Aceitar o convite

   O convite chega no e-mail da operação e só vale depois de aceito. Convite sem aceite é o motivo mais comum de cliente "sumir" da lista.

3. Organizar os perfis num grupo

   Em business.google.com/locations, crie um grupo de perfis chamado Clientes Conexão e mova os perfis aceitos para ele. Assim os clientes ficam separados de qualquer perfil pessoal da conta.

4. Controle no Claude

   copiar

   Crie o arquivo processos/perfil-google-clientes.md com uma tabela de todos os clientes da pasta clientes/: nome, link do perfil no Google, se o convite de administrador foi enviado, se foi aceito e a data. Deixe em branco o que eu ainda não sei e me pergunte cliente por cliente.

4. Depois da aprovação: ligar no VS Code

Só faz sentido quando a cota mudar para 300. Antes disso, todo teste dá erro.

1. Ativar as APIs

   Em APIs e serviços › Biblioteca, ative uma por uma:

   API	Pra que serve
   My Business Account Management API	Listar as contas e os perfis que a Conexão administra
   My Business Business Information API	Ler e corrigir horário, telefone, site, categorias
   Google My Business API	Avaliações (ler e responder) e publicações
   Business Profile Performance API	Números: ligações, rotas, cliques no site, buscas
   My Business Notifications API	Aviso de avaliação nova
   My Business Verifications API	Situação da verificação de cada perfil
   My Business Place Actions API	Links de agendar e pedir

2. Tela de consentimento

   Em APIs e serviços › Tela de consentimento OAuth:

   Conta do Google Workspace

   • Tipo Interno
   • Sem verificação e sem prazo de validade

   Conta Gmail comum

   • Tipo Externo, com o seu e-mail como usuário de teste
   • Depois do primeiro teste, clique em Publicar app. Em modo teste, o acesso cai a cada 7 dias
   • No login vai aparecer o aviso "app não verificado". É o seu próprio app: siga em Avançado

3. Criar a credencial

   Em APIs e serviços › Credenciais › Criar credenciais › ID do cliente OAuth, escolha App para computador, dê o nome Claude VS Code e baixe o arquivo JSON.

   Esse arquivo é chave. A mesma regra da aula 1: ele nunca vai pro GitHub. Guarde fora da pasta versionada, por exemplo em ~/.config/conexao-google/.

4. Instalar a skill e fazer a primeira conexão

   A Avantys está preparando uma skill de Perfil do Google para a Conexão, que faz o login, guarda o acesso com segurança e já traz as consultas prontas. Ela chega antes da sua aprovação. Para testar a ligação sem a skill:

   copiar

   Quero testar a conexão com a Business Profile API do Google. A credencial OAuth (App para computador) está em ~/.config/conexao-google/client_secret.json.
   
   1) Escreva um script Python pequeno que faça o login com o escopo https://www.googleapis.com/auth/business.manage, abrindo o navegador, e guarde o token em ~/.config/conexao-google/token.json;
   2) liste as contas em mybusinessaccountmanagement.googleapis.com/v1/accounts e, pra cada conta, os perfis (nome e endereço) pela Business Information API;
   3) confira que nenhum desses arquivos está dentro de uma pasta do Git.
   
   Me mostre o script antes de rodar e me explique cada erro em português se algo falhar.

   Se aparecer a lista com os perfis dos clientes, está ligado.

5. A rotina com o Claude

O que pedir depois de ligado. A regra vale para tudo: o Claude rascunha, você aprova. Resposta de avaliação é pública e fica pra sempre.

Puxe as avaliações dos últimos 7 dias de todos os perfis que a Conexão administra. Me devolva uma tabela por cliente: nota, data, trecho da avaliação e se já tem resposta. Para cada uma sem resposta, escreva um rascunho de até 60 palavras no tom da ficha de marca do cliente (clientes/[cliente]/marca). Nas negativas: reconheça o problema específico e leve a conversa pro privado, sem discutir. Não publique nada: espere eu aprovar uma por uma.

6. Enquanto o Google não libera

7. Erros comuns

8. Trilha

Marque quando cumprir o "pronto quando". Fica salvo neste navegador e vai junto quando você enviar.

• Projeto criado no Google CloudPronto quando: você tem o número do projeto anotado.
• Pedido de acesso enviadoPronto quando: o Google devolveu um número de caso.
• Clientes deram acessoPronto quando: o arquivo de controle mostra o convite aceito em todos os clientes que têm perfil.
• AprovadoPronto quando: a cota mudou de 0 para 300.
• Primeira conexãoPronto quando: o Claude listou os perfis dos clientes no VS Code.

9. Glossário

Perfil da Empresa no Google

O novo nome do Google Meu Negócio. É o cartão do negócio que aparece na busca e no Maps.

API

A porta oficial pela qual um programa, aqui o Claude, conversa com o Google sem ninguém clicar no painel.

Cota

Quantos pedidos por minuto o projeto pode fazer. Zero = sem acesso ainda.

OAuth

O login do Google que autoriza o Claude a agir em nome da conta da operação, sem você entregar senha.

Proprietário x administrador

O proprietário é o dono e pode tirar qualquer um. O administrador gerencia o perfil, mas não remove o dono.

Grupo de perfis

Pasta dentro do gerenciador do Google que junta vários perfis, útil para separar os clientes.