Como ligar os grupos do Google do FarejaLeads para o teste de app (Directory API, opção avançada)
Atualizado em · feito pelo dono da plataforma (admin)
Opção avançada, desligada por padrão. Com isto ligado, cada projeto de teste ganha um Google Group no domínio do FarejaLeads (teste-<slug>@<domínio>) e cada inscrito entra nele sozinho; o cliente cola o e-mail do grupo uma vez na Play Console. O grupo nunca aparece no e-mail do inscrito. Sem estas variáveis, o fluxo é o padrão: CSV dos pendentes na lista de e-mails e liberação.
O que você ganha
- Grupo por projeto criado sozinho
- Inscrito adicionado ao grupo na hora
- Grupo posto na trilha de teste da Play pela API, com a conta de serviço do cliente
Antes de começar
- O domínio (ou um subdomínio, ex.: grupos.farejaleads.com) num Google Workspace ou no Cloud Identity Free, que é gratuito e basta para grupos: workspace.google.com/gcpidentity/signup.
- Um projeto no Google Cloud (console.cloud.google.com) para a conta de serviço.
Passo a passo
1. Domínio no Cloud Identity Free (ou Workspace)
Cadastre o domínio em workspace.google.com/gcpidentity/signup e confirme a posse com o registro TXT no DNS (Cloudflare → DNS → Add record). Para usar um subdomínio só para grupos, adicione-o em admin.google.com → Conta → Domínios → Gerenciar domínios → Adicionar domínio secundário.
O usuário administrador que você criar aqui é o GOOGLE_GROUPS_ADMIN_EMAIL.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
2. Deixe os grupos aceitarem Gmail de fora
admin.google.com → Apps → Google Workspace → Grupos do Google → Configurações de compartilhamento: permita que os proprietários do grupo adicionem membros externos à organização e salve.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
3. Conta de serviço com as APIs
console.cloud.google.com → APIs e serviços → Biblioteca: ative Admin SDK API e Groups Settings API.
IAM e administrador → Contas de serviço → Criar conta de serviço (nome farejaleads-grupos, sem papéis). Abra a conta → Chaves → Adicionar chave → JSON: o arquivo baixado é o GOOGLE_GROUPS_SA_JSON. Copie também o ID do cliente (Client ID, número longo).
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
4. Delegação em todo o domínio
admin.google.com → Segurança → Controle de dados e acesso → Controles de API → Delegação em todo o domínio → Adicionar novo: cole o Client ID e os escopos https://www.googleapis.com/auth/admin.directory.group,https://www.googleapis.com/auth/admin.directory.group.member,https://www.googleapis.com/auth/apps.groups.settings → Autorizar.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
5. Cole no FarejaLeads
Segredos GOOGLE_GROUPS_SA_JSON (o JSON inteiro, numa linha), GOOGLE_GROUPS_ADMIN_EMAIL (o administrador do passo 1) e, se os grupos ficam num subdomínio, GOOGLE_GROUPS_DOMINIO (ex.: grupos.farejaleads.com; sem ele, vale o domínio do administrador). Só variável de ambiente.
No Lovable, abra o projeto do FarejaLeads → Cloud → Secrets → Add secret, com o nome exato e o valor.
Clique em Publish: o site no ar só lê o segredo novo depois de publicado.
6. Teste
Em /app/teste-app, num projeto seu, clique em Criar grupo do Google e inscreva um e-mail de teste na página /testar/<slug>: ele aparece como membro em groups.google.com.
Regras que valem sempre
- A chave da conta de serviço nunca vai para o banco nem para conversa.
- Sem as variáveis, nada quebra: os projetos usam o CSV dos pendentes na lista de e-mails da Play Console e a liberação.