> ## Documentation Index > Fetch the complete documentation index at: https://docs.base44.com/llms.txt > Use this file to discover all available pages before exploring further. # Conectores do Google Workspace > Conecte Gmail, Google Calendar, Contacts, Drive, Docs e Sheets com um conector individual ou trabalhe com todos eles pelo conector 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. > [!NOTE] > > Você precisa de um [**Builder plan**](https://base44.com/pricing) 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: ```text wrap theme={null} Me conheça: dê uma olhada nos meus emails, reuniões e arquivos do Drive e me diga no que estou trabalhando. ``` ```text wrap theme={null} Seja meu assistente pessoal: acompanhe minha caixa de entrada e agenda e me diga o que precisa de mim hoje. ``` ```text wrap theme={null} Prepare minha próxima reunião com base nas conversas de email, arquivos e detalhes dos participantes relacionados. ``` ```text wrap theme={null} Escreva rascunhos de follow-up para os participantes depois de cada reunião. ``` ```text wrap theme={null} 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](#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** 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:** 1. Clique em **Connectors** na barra lateral do seu workspace. 2. Clique em **Add connector**. 3. Pesquise o serviço que você quer, como **Google Calendar** ou **Google Workspace**, e clique nele. 4. Selecione **Shared connector** e clique em **Next**. 5. Insira um **Connection name**. 6. Escolha onde a conexão pode ser usada em **Who can access**. O padrão é **Apps and Super agent**. 7. 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**. 8. Clique em **Add connector** e entre com a conta do Google que você quer compartilhar. 9. Abra seu app no editor do app. 10. Peça ao chat de IA para usar a conexão compartilhada do Google no recurso que você quer criar. **Conector de usuário do app** 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**. > [!TIP] > > **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](https://base44.com/pricing) ou superior. Se você usar seu próprio cliente OAuth, revise [Escopos e permissões](#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:** 1. Crie ou selecione um projeto no Google Cloud console. 2. Ative a API de cada serviço do Google que seu app usa. 3. Configure a tela de consentimento OAuth com os escopos que você planeja solicitar. 4. 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. 5. Crie um cliente OAuth para um aplicativo web. 6. Adicione `https://connectors.base44.com/api/oauth/callback` como URI de redirecionamento autorizado. 7. Copie o client ID e o client secret. **Para adicionar um conector de usuário do app do Google:** 1. Clique em **Connectors** na barra lateral do seu workspace. 2. Clique em **Add connector**. 3. Pesquise o serviço que você quer, como **Google Calendar** ou **Google Drive**, e clique nele. 4. Selecione **App user connector** e clique em **Next**. 5. Se **Choose how to manage authentication** aparecer, selecione **Let Base44 manage OAuth** ou **Use your own OAuth client**. 6. Insira um **Connector name**. 7. Se você usar seu próprio cliente OAuth, insira o **Client ID** e o **Client Secret** dele. 8. 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](#serviços-do-google). 9. Clique em **Add Connector**. 10. Abra seu app no editor do app. 11. 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](https://docs.base44.com/pt-BR/Integrations/connectors-catalog.md). ### Gmail Envie, leia e gerencie emails no [Gmail](https://base44.com/integrations/connectors/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: ```text wrap theme={null} Envie emails de confirmação automáticos quando um novo pedido for feito. ``` ```text wrap theme={null} Leia e analise os emails recebidos para criar tickets de suporte. ``` ```text wrap theme={null} Dispare um fluxo automaticamente quando um novo email chegar. ``` ```text wrap theme={null} Envie emails de follow-up personalizados para novos leads. ``` ```text wrap theme={null} 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](https://base44.com/integrations/connectors/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: ```text wrap theme={null} Sincronize todas as minhas reservas diretamente com meu Google Calendar. ``` ```text wrap theme={null} Mostre aos clientes minha disponibilidade em tempo real a partir do Google Calendar. ``` ```text wrap theme={null} Execute uma automação quando um evento da agenda for criado ou atualizado. ``` ```text wrap theme={null} Bloqueie automaticamente horários de reunião na minha agenda pessoal. ``` ```text wrap theme={null} 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: ```text wrap theme={null} Crie um CRM que sincronize clientes nos dois sentidos com meu Google Contacts. ``` ```text wrap theme={null} Importe leads de pessoas para quem enviei emails, mas nunca salvei como contatos. ``` ```text wrap theme={null} Analise minha rede de contatos e categorize os contatos automaticamente com IA. ``` ```text wrap theme={null} Crie um diretório pesquisável da empresa a partir da minha organização do Google Workspace. ``` ```text wrap theme={null} 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](https://base44.com/integrations/connectors/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: ```text wrap theme={null} Liste todos os arquivos do meu Google Drive e exiba-os no meu app. ``` ```text wrap theme={null} Pesquise no Google Drive documentos que correspondam a uma palavra-chave e mostre os resultados. ``` ```text wrap theme={null} Salve no Google Drive os relatórios em PDF gerados pelo meu app. ``` ```text wrap theme={null} Leia uma planilha do Google Drive e importe os dados dela para o meu app. ``` ```text wrap theme={null} 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](https://base44.com/integrations/connectors/google-docs). **Prompts de exemplo** Descreva no chat de IA o documento, o que o dispara e os campos dinâmicos. Por exemplo: ```text wrap theme={null} Gere documentos com anotações de reunião automaticamente. ``` ```text wrap theme={null} Crie contratos a partir de modelos com os dados do cliente. ``` ```text wrap theme={null} Atualize documentos compartilhados quando o status do projeto mudar. ``` ```text wrap theme={null} Exporte relatórios no formato do Google Docs. ``` ```text wrap theme={null} 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](https://base44.com/integrations/connectors/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: ```text wrap theme={null} Exporte os dados do app para uma planilha do Google Sheets. ``` ```text wrap theme={null} Importe leads de uma planilha do Google para o CRM. ``` ```text wrap theme={null} Atualize automaticamente as contagens de estoque no Google Sheets. ``` ```text wrap theme={null} Crie relatórios semanais e salve-os no Google Sheets. ``` ```text wrap theme={null} 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](https://docs.base44.com/pt-BR/Integrations/Connectors.md#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. > [!TIP] > > 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](https://docs.base44.com/pt-BR/Community-and-support/Contacting-support.md) com antecedência. Requisitos, prazos e exceções são definidos pelo Google. Confira a [documentação para desenvolvedores do Google](https://developers.google.com/identity/protocols/oauth2/production-readiness/restricted-scope-verification) antes de planejar com base neles. > [!NOTE] > > 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** ```javascript theme={null} // One account the whole app uses const { accessToken } = await base44.asServiceRole.connectors.getConnection("googlecalendar"); // Use the access token to call the Google Calendar API. ``` **Conector de usuário do app** ```javascript theme={null} // 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](https://docs.base44.com/pt-BR/developers/backend/resources/connectors/shared-connectors.md)** > > Configure, implante e chame uma conexão compartilhada a partir de uma função de backend. > **[Conectores de usuário do app](https://docs.base44.com/pt-BR/developers/backend/resources/connectors/app-user-connectors.md)** > > 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](https://docs.base44.com/pt-BR/Integrations/Connectors.md#vendo-suas-callback-urls). > [!NOTE] > > Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a [versão em inglês](https://docs.base44.com/index.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.