Conectores do Google Workspace

Escolha um conector e conecte-o por uma conta compartilhada ou pela conta de cada pessoa. Escopos são as permissões que seu app solicita ao Google. Solicite apenas os que ele precisa.

Você precisa de um Builder plan ou superior para usar conectores no seu app.

O que você pode fazer

Conecte seu app ao seu email, agendas, contatos e arquivos.

Automatizar emails

Envie confirmações e follow-ups, e transforme emails recebidos em tarefas ou tickets.

Sincronizar agendas e contatos

Sincronize reservas, mostre sua disponibilidade e mantenha os contatos atualizados.

Trabalhar com arquivos e dados

Salve relatórios no Drive, gere documentos no Docs e importe ou exporte dados do Sheets.

Conector do Google Workspace

Use este conector quando seu app combinar vários serviços do Google. Um exemplo é um assistente que trabalha com sua caixa de entrada, agenda e arquivos do Drive. Se ele usar só um ou dois, conecte esses serviços. Prompts de exemplo Descreva no chat de IA os serviços do Google envolvidos, o que dispara a ação e os campos dinâmicos. Por exemplo:

Me conheça: dê uma olhada nos meus emails, reuniões e arquivos do Drive e me diga no que estou trabalhando.

Seja meu assistente pessoal: acompanhe minha caixa de entrada e agenda e me diga o que precisa de mim hoje.

Prepare minha próxima reunião com base nas conversas de email, arquivos e detalhes dos participantes relacionados.

Escreva rascunhos de follow-up para os participantes depois de cada reunião.

Transforme as reuniões e emails desta semana em um Doc e uma Sheet.

Escopos

Este conector solicita os escopos abaixo em 6 serviços. Por isso, ele precisa de mais acesso que um conector individual.

Gmail: gmail.readonly, gmail.modify, gmail.compose, gmail.send
Calendar: calendar.readonly, calendar.settings.readonly, calendar.events
Contacts: contacts.readonly
Drive: drive.readonly, drive
Docs: documents.readonly, documents
Sheets: spreadsheets.readonly, spreadsheets

Cada escopo é descrito no respectivo serviço em Serviços do Google.

Acesso: Seu app trabalha com os dados da conta do Google que autoriza a conexão.

Conectando um serviço do Google

Conecte um serviço do Google por uma conta compartilhada ou deixe cada pessoa conectar a própria conta.

Conector compartilhado
Conector de usuário do app

Você conecta uma conta uma única vez, e todos que usam seu app compartilham essa conexão e os dados dela.Para adicionar um conector compartilhado do Google:

Clique em Connectors na barra lateral do seu workspace.
Clique em Add connector.
Pesquise o serviço que você quer, como Google Calendar ou Google Workspace, e clique nele.
Selecione Shared connector e clique em Next.
Insira um Connection name.
Escolha onde a conexão pode ser usada em Who can access. O padrão é Apps and Super agent.
Se Permissions aparecer, escolha Read-only para ver dados. Escolha Read & write se seu app precisar enviar, criar ou alterar dados. O padrão é Read-only.
Clique em Add connector e entre com a conta do Google que você quer compartilhar.
Abra seu app no editor do app.
Peça ao chat de IA para usar a conexão compartilhada do Google no recurso que você quer criar.

Cada pessoa conecta a própria conta do Google, para que seu app trabalhe com os dados dela. O Google Calendar também oferece Let Base44 manage OAuth.

Antes de começar: Proprietários e admins do workspace configuram conectores de usuário do app. Para deixar a Base44 gerenciar o OAuth, você precisa de um plano Pro ou superior. Se você usar seu próprio cliente OAuth, revise Escopos e permissões antes de criar.

Se você usar Let Base44 manage OAuth no Google Calendar, pule para Para adicionar um conector de usuário do app do Google.Para preparar seu próprio cliente OAuth:

Crie ou selecione um projeto no Google Cloud console.
Ative a API de cada serviço do Google que seu app usa.
Configure a tela de consentimento OAuth com os escopos que você planeja solicitar.
Enquanto seu app OAuth estiver em modo de teste, adicione como usuários de teste as contas do Google que você vai usar para testar.
Crie um cliente OAuth para um aplicativo web.
Adicione https://connectors.base44.com/api/oauth/callback como URI de redirecionamento autorizado.
Copie o client ID e o client secret.

Para adicionar um conector de usuário do app do Google:

Clique em Connectors na barra lateral do seu workspace.
Clique em Add connector.
Pesquise o serviço que você quer, como Google Calendar ou Google Drive, e clique nele.
Selecione App user connector e clique em Next.
Se Choose how to manage authentication aparecer, selecione Let Base44 manage OAuth ou Use your own OAuth client.
Insira um Connector name.
Se você usar seu próprio cliente OAuth, insira o Client ID e o Client Secret dele.
Em Scopes, desmarque os escopos que seu app não precisa. Com seu próprio cliente OAuth, adicione outros em Additional scopes. Para ver o que cada escopo faz, veja Serviços do Google.
Clique em Add Connector.
Abra seu app no editor do app.
Peça ao chat de IA para adicionar uma forma de as pessoas conectarem a própria conta do Google.

Serviços do Google

Encontre o serviço que seu app usa para ver o que ele pode fazer e quais escopos solicita. Para outros conectores do Google, como Google Analytics, Google Meet e Google Search Console, veja o catálogo de conectores.

Gmail

Envie, leia e gerencie emails no Gmail. Prompts de exemplo Descreva no chat de IA o assunto, o corpo da mensagem, a formatação, os destinatários e os campos dinâmicos. Por exemplo:

Envie emails de confirmação automáticos quando um novo pedido for feito.

Leia e analise os emails recebidos para criar tickets de suporte.

Dispare um fluxo automaticamente quando um novo email chegar.

Envie emails de follow-up personalizados para novos leads.

Notifique os membros da equipe por email quando tarefas forem atribuídas.

Escopos

Ler o conteúdo dos emails é um escopo restrito do Google.

Os nomes dos escopos do Gmail começam com https://www.googleapis.com/auth/:

gmail.readonly: Ler mensagens e metadados
gmail.modify: Ler, rotular e alterar mensagens, mas sem excluí-las permanentemente
gmail.compose: Criar rascunhos e enviar emails
gmail.send: Enviar mensagens
gmail.labels: Gerenciar marcadores
gmail.settings.basic: Gerenciar filtros, assinaturas e a resposta automática de férias

Acesso: Seu app trabalha com os emails da conta do Gmail que autoriza a conexão.

Google Calendar

Acesse e gerencie eventos do Google Calendar. Prompts de exemplo Descreva no chat de IA a agenda, os eventos, o que dispara a ação e os campos dinâmicos. Por exemplo:

Sincronize todas as minhas reservas diretamente com meu Google Calendar.

Mostre aos clientes minha disponibilidade em tempo real a partir do Google Calendar.

Execute uma automação quando um evento da agenda for criado ou atualizado.

Bloqueie automaticamente horários de reunião na minha agenda pessoal.

Adicione novos eventos à agenda quando uma tarefa for marcada como concluída.

Escopos

O escopo amplo calendar gerencia todas as agendas. Escolha um escopo mais restrito quando seu app só lê eventos ou disponibilidade. Com Let Base44 manage OAuth, o seletor oferece apenas os escopos mais restritos.

Os nomes dos escopos do Google Calendar começam com https://www.googleapis.com/auth/:

calendar: Gerenciar todas as agendas e eventos
calendar.readonly: Ver todas as agendas, eventos e configurações
calendar.events: Gerenciar eventos nas agendas
calendar.events.readonly: Ver eventos nas agendas
calendar.events.freebusy: Ver informações de disponibilidade das agendas sem ver detalhes dos eventos
calendar.freebusy: Ver informações de disponibilidade das agendas
calendar.app.created: Gerenciar agendas criadas pelo seu app
calendar.calendarlist.readonly: Ver a lista de agendas
calendar.events.public.readonly: Ver eventos públicos nas agendas
calendar.settings.readonly: Ver as configurações do Google Calendar

Acesso: Seu app trabalha com as agendas da conta do Google que autoriza a conexão.

Google Contacts

Leia, crie e gerencie contatos no Google Contacts. Prompts de exemplo Descreva no chat de IA os contatos, o que dispara a ação e os campos dinâmicos. Por exemplo:

Crie um CRM que sincronize clientes nos dois sentidos com meu Google Contacts.

Importe leads de pessoas para quem enviei emails, mas nunca salvei como contatos.

Analise minha rede de contatos e categorize os contatos automaticamente com IA.

Crie um diretório pesquisável da empresa a partir da minha organização do Google Workspace.

Salve automaticamente novos clientes como contatos quando eles se cadastrarem.

Escopos

Escolha contacts.readonly quando seu app só precisar ler contatos salvos.

Os nomes dos escopos do Google Contacts começam com https://www.googleapis.com/auth/:

contacts.readonly: Ver contatos
contacts: Ver, criar, editar e excluir contatos
contacts.other.readonly: Ver outros contatos, como pessoas para quem você enviou emails mas não salvou
directory.readonly: Ver o diretório do Google Workspace da sua organização

Acesso: Seu app trabalha com os contatos da conta do Google que autoriza a conexão.

Google Drive

Pesquise, acesse e gerencie arquivos no Google Drive. Prompts de exemplo Descreva no chat de IA os arquivos ou pastas, o que dispara a ação e os campos dinâmicos. Por exemplo:

Liste todos os arquivos do meu Google Drive e exiba-os no meu app.

Pesquise no Google Drive documentos que correspondam a uma palavra-chave e mostre os resultados.

Salve no Google Drive os relatórios em PDF gerados pelo meu app.

Leia uma planilha do Google Drive e importe os dados dela para o meu app.

Dispare um fluxo quando um arquivo for adicionado ou atualizado no Drive.

Escopos

O escopo drive dá ao seu app acesso a todos os arquivos e pastas do Google Drive. Já o drive.file cobre apenas os arquivos que seu app cria ou abre.

Os nomes dos escopos do Google Drive começam com https://www.googleapis.com/auth/:

drive: Ver, criar, editar e excluir todos os arquivos e pastas do Google Drive
drive.readonly: Ver todos os arquivos e pastas do Google Drive
drive.file: Acessar apenas os arquivos que seu app cria ou abre com permissão

Acesso: Seu app trabalha com arquivos no Google Drive da conta do Google que autoriza a conexão.

Google Docs

Crie e edite documentos do Google Docs. Prompts de exemplo Descreva no chat de IA o documento, o que o dispara e os campos dinâmicos. Por exemplo:

Gere documentos com anotações de reunião automaticamente.

Crie contratos a partir de modelos com os dados do cliente.

Atualize documentos compartilhados quando o status do projeto mudar.

Exporte relatórios no formato do Google Docs.

Colabore em documentos com comentários da equipe.

Escopos

O escopo documents permite que seu app veja e edite todos os documentos do Google Docs da conta conectada, não só os que ele cria.

Os nomes dos escopos do Google Docs começam com https://www.googleapis.com/auth/:

documents: Ver, criar e editar todos os documentos do Google Docs
documents.readonly: Ver todos os documentos do Google Docs

Acesso: Seu app trabalha com os documentos da conta do Google que autoriza a conexão.

Google Sheets

Leia e grave dados em planilhas do Google Sheets. Prompts de exemplo Descreva no chat de IA a planilha, o que dispara a ação e os campos dinâmicos. Por exemplo:

Exporte os dados do app para uma planilha do Google Sheets.

Importe leads de uma planilha do Google para o CRM.

Atualize automaticamente as contagens de estoque no Google Sheets.

Crie relatórios semanais e salve-os no Google Sheets.

Sincronize os envios de formulários com um banco de dados no Google Sheets.

Escopos

O escopo spreadsheets permite que seu app altere todas as planilhas da conta, não só as que ele cria.

Os nomes dos escopos do Google Sheets começam com https://www.googleapis.com/auth/:

spreadsheets: Ver, editar, criar e excluir todas as planilhas do Google Sheets
spreadsheets.readonly: Ver todas as planilhas do Google Sheets

Acesso: Seu app trabalha com as planilhas da conta do Google que autoriza a conexão.

Escopos e permissões

Quando você usa seu próprio cliente OAuth, o app OAuth é seu e você envia a verificação dele ao Google. Conectores compartilhados do Google e Let Base44 manage OAuth usam o app OAuth da Base44. Nesses casos, você não precisa enviar nada ao Google. Veja Usando seu próprio cliente OAuth. O Google agrupa as permissões que seu app solicita em 3 categorias. Esses grupos definem a verificação que seu app precisa antes de entrar no ar. Por isso, escolha os escopos mais restritos que atendam ao que seu app faz. Isso importa principalmente para Gmail, Drive e Calendar.

Básico: Cobre nome, endereço de email e perfil. O Google não pede nada a mais.
Sensível: Cobre acesso mais amplo a um serviço do Google, como criar eventos na agenda. O Google pede a verificação do app, incluindo uma análise de como você usa os dados.
Restrito: Cobre a leitura do conteúdo de mensagens ou arquivos de alguém, como ler o Gmail. O Google pede a verificação do app e também pode exigir uma avaliação de segurança independente anual.

Para enviar emails sem a verificação de escopo restrito, solicite apenas gmail.send.

A verificação de escopo restrito pode levar várias semanas. Até ela ser concluída, o Google pode limitar quantas pessoas podem usar seu app e mostrar um aviso de app não verificado. Se o Google exigir uma avaliação de segurança, um avaliador independente aprovado pelo Google analisa seu app usando o framework CASA. A avaliação inclui perguntas sobre a plataforma em que seu app roda e sobre seu próprio código. Por isso, entre em contato com o suporte com antecedência. Requisitos, prazos e exceções são definidos pelo Google. Confira a documentação para desenvolvedores do Google antes de planejar com base neles.

A Base44 sempre adiciona o escopo email para identificar a conta do Google. Como ele está sempre incluído, aparece como um escopo bloqueado em Scopes.

Usando serviços do Google em uma função de backend

Se você escreve suas próprias funções de backend, elas podem chamar as APIs do Google diretamente. A Base44 cuida do fluxo OAuth e do armazenamento do token. Em uma conexão compartilhada, passe um ID de serviço da tabela abaixo para getConnection(). Em uma conexão de usuário do app, passe o ID do seu próprio conector, não um ID de serviço.

Conector compartilhado
Conector de usuário do app

// One account the whole app uses
const { accessToken } =
  await base44.asServiceRole.connectors.getConnection("googlecalendar");
// Use the access token to call the Google Calendar API.

// The signed-in person's own account
const { accessToken } =
  await base44.asServiceRole.connectors.getCurrentAppUserConnection(
    "YOUR_CONNECTOR_ID",
  );
// Use the access token to call the Google API for that person.

Serviço	ID do serviço (conexões compartilhadas)
Gmail	`gmail`
Google Calendar	`googlecalendar`
Google Contacts	`google_contacts`
Google Drive	`googledrive`
Google Docs	`googledocs`
Google Sheets	`googlesheets`
Google Workspace	`googleworkspace`

Conectores compartilhados

Configure, implante e chame uma conexão compartilhada a partir de uma função de backend.

Conectores de usuário do app

Obtenha um token por usuário e chame a API como a pessoa conectada.

Solução de problemas

Se você usa seu próprio cliente OAuth, verifique estes pontos quando as pessoas não conseguirem conectar a conta do Google.

Algumas pessoas não conseguem conectar a própria conta

Se você usa seu próprio cliente OAuth, ele começa em modo de teste. Nesse modo, só usuários de teste aprovados podem se conectar. Antes de abrir o acesso para mais pessoas, mova seu app OAuth para produção e conclua a verificação que o Google exigir.

A conexão falha com um erro de URI de redirecionamento

Registre a callback URL usada pela sua conexão como URI de redirecionamento autorizado no seu cliente OAuth do Google:

Para a callback URL única, insira exatamente https://connectors.base44.com/api/oauth/callback.
Para callback URLs por app, veja Vendo suas callback URLs.

Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.

Começando

Criando seu app

Protegendo seu app

Promovendo seu app

Conectores

Registro de alterações

O que você pode fazer

Automatizar emails

Sincronizar agendas e contatos

Trabalhar com arquivos e dados

Conector do Google Workspace

Conectando um serviço do Google

Serviços do Google

Gmail

Google Calendar

Google Contacts

Google Drive

Google Docs

Google Sheets

Escopos e permissões

Usando serviços do Google em uma função de backend

Conectores compartilhados

Conectores de usuário do app

Solução de problemas

​O que você pode fazer

Automatizar emails

Sincronizar agendas e contatos

Trabalhar com arquivos e dados

​Conector do Google Workspace

​Conectando um serviço do Google

​Serviços do Google

​Gmail

​Google Calendar

​Google Contacts

​Google Drive

​Google Docs

​Google Sheets

​Escopos e permissões

​Usando serviços do Google em uma função de backend

Conectores compartilhados

Conectores de usuário do app

​Solução de problemas

O que você pode fazer

Conector do Google Workspace

Conectando um serviço do Google

Serviços do Google

Gmail

Google Calendar

Google Contacts

Google Drive

Google Docs

Google Sheets

Escopos e permissões

Usando serviços do Google em uma função de backend

Solução de problemas