Visão geral

O conector do Gmail para o Gemini Enterprise permite pesquisar e realizar ações nos dados do Gmail usando comandos em linguagem natural.

**Observação**: o Gemini Enterprise lançou novos conectores de dados do Google Workspace para Gmail, Google Drive, Google Chat e Google Agenda. Os novos conectores usam um Google-managed OAuth app, então você não precisa mais criar seu próprio cliente OAuth nem fornecer um ID e uma chave secreta do cliente ao criar o repositório de dados. Para instruções de configuração do Gmail, consulte Configurar um repositório de dados do Gmail.

Ações permitidas

Quando o repositório de dados do Gmail está ativado, os usuários finais podem usar comandos em linguagem natural no Gemini Enterprise para realizar as seguintes ações.

Ação	Descrição
Enviar mensagem	Envia uma nova mensagem do Gmail.
Responder	Responde a uma mensagem do Gmail.
Encaminhar	Encaminha uma mensagem do Gmail.
Criar um rascunho	Cria um rascunho no Gmail.
Atualizar rascunho	Atualiza um rascunho no Gmail.
Listar rascunhos	Lista os rascunhos do Gmail na caixa de e-mails do usuário.
Pesquisar conversas	Pesquisa conversas do Gmail que correspondam a uma consulta.
Acessar conversa	Busca o conteúdo completo de uma conversa do Gmail.
Acessar anexo de mensagem	Busca metadados de um anexo em uma mensagem do Gmail.
Criar marcador	Cria um marcador no Gmail.
Atualizar marcador	Atualiza um marcador no Gmail.
Excluir marcador	Exclui um marcador no Gmail.
Listar marcadores	Lista os marcadores definidos na caixa de e-mails do Gmail do usuário.
Marcar mensagem	Adiciona um ou mais marcadores a uma mensagem específica do Gmail.
Remover marcador da mensagem	Remove um ou mais marcadores de uma mensagem específica do Gmail.
Marcar mensagens em lote	Adiciona um ou mais marcadores a várias mensagens do Gmail em uma única solicitação.
Remover marcadores de mensagens em lote	Remove um ou mais marcadores de várias mensagens do Gmail em uma única solicitação.
Marcar conversa	Adiciona um ou mais marcadores a uma conversa específica do Gmail.
Remover marcador da conversa	Remove um ou mais marcadores de uma conversa específica do Gmail.
Marcar conversas em lote	Adiciona um ou mais marcadores a várias conversas do Gmail em uma única solicitação.
Remover marcadores de conversas em lote	Remove um ou mais marcadores de várias conversas do Gmail em uma única solicitação.
Criar filtro	Cria um filtro do Gmail.
Listar filtros	Lista os filtros do Gmail na caixa de e-mails do usuário.
Excluir filtro	Exclui um filtro do Gmail existente.

Observações:

• O tamanho máximo de arquivo para uploads e downloads no Gemini Enterprise é de 50 MB.

Escopos obrigatórios

O app OAuth gerenciado pelo GoogleGoogle solicita os seguintes escopos do OAuth. Os usuários concedem esses escopos ao autorizar o conector:

Escopo	Finalidade
https://www.googleapis.com/auth/gmail.readonly	Pesquisar e ler mensagens, conversas, rascunhos, marcadores e anexos do Gmail.
https://www.googleapis.com/auth/gmail.send	Enviar e encaminhar mensagens e respostas do Gmail.
https://www.googleapis.com/auth/gmail.compose	Criar e atualizar rascunhos do Gmail.
https://www.googleapis.com/auth/gmail.modify	Adicionar e remover marcadores em mensagens e conversas do Gmail.
https://www.googleapis.com/auth/gmail.labels	Criar, atualizar e excluir marcadores do Gmail.
https://www.googleapis.com/auth/gmail.settings.basic	Criar, listar e excluir filtros do Gmail.
https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile, openid	Identificar o usuário que está autorizando.

Limitações

• O repositório de dados do Gmail é compatível apenas com os global, us, e eu locais.

• Ao criar um novo app ou adicionar um repositório de dados a um app já existente, recomendamos associar apenas um repositório de dados a ações pertencentes a um único tipo de conector.

• Se você usa controles de segurança, esteja ciente das limitações deles relacionadas aos dados no Gmail, conforme discutido na tabela a seguir:

  Controle de segurança	Observe o seguinte:
  Residência dos dados (DRZ)	O Gemini Enterprise garante a residência de dados apenas em Google Cloud. Para informações sobre residência de dados e o Gmail, consulte as orientações e a documentação de conformidade do Google Workspace, incluindo Regiões de dados do Google Workspace. Confira também exemplos como Escolher a região onde os dados são armazenados e Soberania digital.
  Chaves de criptografia gerenciadas pelo cliente (CMEK, na sigla em inglês)	Suas chaves criptografam apenas dados no Google Cloud. Os controles do Cloud Key Management Service não se aplicam aos dados armazenados no Gmail.
  Transparência no acesso	Os registros de Transparência no acesso mostram as ações realizadas pela equipe do Google no projeto Google Cloud . Você também precisa analisar os registros da Transparência no acesso criados pelo Google Workspace. Para mais informações, consulte Eventos de registro da Transparência no acesso na documentação da Ajuda do administrador do Google Workspace.

A seguir

• Para criar e configurar um repositório de dados com o Gmail, consulte Configurar um repositório de dados do Gmail.