Configurar o OAuth para o Gmail

Nesta página, descrevemos como configurar o OAuth para conectar o Gmail ao Gemini Enterprise como um repositório de dados.

Configurar a autenticação e as permissões do Gmail

Para ativar as ações do Gmail, um Google Cloud administrador precisa seguir estas etapas para ativar a API Gmail e configurar a autenticação.

Ativar a API Gmail

No Google Cloud console, ative as seguintes APIs:

Criar um app OAuth e adicionar escopos

Se você não tiver um app OAuth, siga estas etapas. Se você já tiver um app OAuth, pule para Criar credenciais de cliente OAuth.

  1. Acesse Google Auth Platform / Overview.

  2. Clique em Primeiros passos.

  3. Insira um nome para o app OAuth.

  4. Em E-mail para suporte ao usuário, selecione um endereço de e-mail de suporte para que os usuários do aplicativo entrem em contato com dúvidas sobre o consentimento.

  5. Em Público, selecione o tipo de usuário do app:

    • Externo: selecione Externo se você estiver criando um app para uso fora da sua organização do Google Workspace. Isso torna o app disponível publicamente para qualquer usuário com um Google aconta. Se você selecionou Externo para o tipo de usuário, adicione usuários de teste:
      1. Clique em Público-alvo.
      2. Em Usuários de teste, clique em Adicionar usuários.
      3. Insira seu endereço de e-mail e os outros usuários de teste autorizados e clique em Salvar.
    • Interno: selecione Interno se o app for restrito a membros de uma organização específica, limitando o acesso apenas aos membros da organização do Google Workspace. Google Cloud

  6. Clique em Próxima.

  7. Em Informações de contato, insira um endereço de e-mail para receber notificações sobre mudanças no projeto.

  8. Clique em Próxima.

  9. Em Concluir, revise a Política de dados do usuário dos serviços de API do Google. Se você concordar, selecione Eu concordo com a Política de dados do usuário dos serviços de API do Google.

  10. Clique em Continuar.

  11. Clique em Criar.

Depois de criar o app, você pode atualizar as configurações da tela de permissão OAuth em Branding e público-alvo.

Adicionar escopos mínimos

Para adicionar os escopos mínimos necessários, siga estas etapas:

  1. No Google Cloud console, acesse o menu .
  2. Selecione Acesso a dados no menu de navegação.
  3. Clique em Adicionar ou remover escopos.
  4. Em Adicionar escopos manualmente, cole os seguintes escopos para o Gmail com base no modo de conexão:
Modo de conexão Escopo Finalidade
Pesquisa federada https://www.googleapis.com/auth/gmail.readonly Necessário para pesquisar mensagens de e-mail.
Pesquisa federada e Ações
  • https://www.googleapis.com/auth/gmail.send
  • https://www.googleapis.com/auth/gmail.readonly
 Necessário para ler, pesquisar e enviar mensagens de e-mail.
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.compose
 Necessário para gerenciar a organização de e-mails, como criar e adicionar marcadores.
https://www.googleapis.com/auth/gmail.readonly Necessário para baixar anexos.

  1. Clique em Adicionar à tabela e em Atualizar.

  2. Clique em Salvar.

Criar credenciais de cliente OAuth

Este procedimento descreve como criar um novo ID do cliente OAuth para Google Cloud ações. Se você já tiver um ID do cliente OAuth para Google Cloud ações, poderá usar esse ID e a chave secreta para ações do Google Agenda em vez de criar um novo.

  1. Acesse Google Auth Platform / Clients.

  2. Clique em Criar cliente.

  3. Em Tipo de aplicativo, selecione Aplicativo da Web.

  4. No campo Nome, digite um nome para a credencial.

  5. Pule Origens JavaScript autorizadas.

  6. Na seção URIs de redirecionamento autorizados , clique em Adicionar URI e insira o seguinte URI: https://vertexaisearch.cloud.google.com/oauth-redirect

  7. Clique em Criar. A credencial recém-criada aparece em IDs do cliente OAuth 2.0. Abra o cliente criado e copie as seguintes informações:

    • ID do cliente
    • Chave secreta do cliente