Configure o OAuth para o Gmail

Esta página descreve como configurar o OAuth para associar o Gmail ao Gemini Enterprise como um repositório de dados.

Configure a autenticação e as autorizações para o Gmail

Para ativar as ações do Gmail, um Google Cloud administrador tem de seguir os passos abaixo para ativar a API Gmail e configurar a autenticação.

Ative a API Gmail

Na Google Cloud consola, ative as seguintes APIs:

Crie uma app OAuth e adicione âmbitos

Se não tiver uma app OAuth, siga estes passos. Se já tiver uma app OAuth, avance para Criar credenciais de cliente OAuth.

  1. Aceda a Google Auth Platform / Vista geral.

  2. Clique em Começar.

  3. Introduza um nome para a sua app OAuth.

  4. Em Email de apoio técnico ao utilizador, selecione um endereço de email de apoio técnico para os utilizadores da sua aplicação entrarem em contacto com perguntas sobre o respetivo consentimento.

  5. Em Público, selecione o tipo de utilizador da sua app:

    • Externo: selecione Externo se estiver a criar uma app para utilização fora da sua organização do Google Workspace. Isto torna a app disponível publicamente para qualquer utilizador com uma conta Google . Se selecionou Externo para o tipo de utilizador, adicione utilizadores de teste:
      1. Clique em Público-alvo.
      2. Em Utilizadores de teste, clique em Adicionar utilizadores.
      3. Introduza o seu endereço de email e o de quaisquer outros utilizadores de teste autorizados e, de seguida, clique em Guardar.
    • Interno: selecione Interno se a app estiver restrita a membros de uma Google Cloud organização específica, limitando o acesso apenas a membros organizacionais do Google Workspace.

  6. Clicar em Seguinte.

  7. Em Informações de contacto, introduza um endereço de email onde possa receber notificações sobre quaisquer alterações ao seu projeto.

  8. Clicar em Seguinte.

  9. Em Concluir, reveja a Política de Dados do Utilizador dos Serviços de APIs Google. Se concordar, selecione Aceito a Política de Dados do Utilizador dos Serviços de API da Google.

  10. Clique em Continuar.

  11. Clique em Criar.

Depois de criar a app, pode atualizar as definições do ecrã de consentimento OAuth em Branding e Público-alvo.

Adicione âmbitos mínimos

Para adicionar os âmbitos mínimos necessários, siga estes passos:

  1. Na Google Cloud consola, aceda a Menu .
  2. Selecione Acesso aos dados no menu de navegação.
  3. Clique em Adicionar ou remover âmbitos.
  4. Em Adicionar manualmente âmbitos, cole os seguintes âmbitos para o Gmail de acordo com o modo de ligação:
Modo de ligação Âmbito Finalidade
Pesquisa federada https://www.googleapis.com/auth/gmail.readonly Necessário para pesquisar mensagens de email.
Pesquisa federada e ações https://www.googleapis.com/auth/gmail.send
https://www.googleapis.com/auth/gmail.readonly		 Necessário para enviar e ler mensagens de email.

  1. Clique em Adicionar à tabela e, de seguida, em Atualizar.

  2. Clique em Guardar.

Crie credenciais do cliente OAuth

Este procedimento descreve como criar um novo ID de cliente OAuth para Google Cloud ações. Se já tiver um ID de cliente OAuth para Google Cloud ações, pode usar esse ID de cliente e segredo para ações do Calendário Google em vez de criar um novo.

  1. Aceda a Google Auth Platform / Clientes.

  2. Clique em Criar cliente.

  3. Para Tipo de aplicação, selecione Aplicação Web.

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

  5. Ignore as origens JavaScript autorizadas.

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

  7. Clique em Criar. A credencial recém-criada é apresentada em IDs de clientes OAuth 2.0. Abra o cliente que criou e copie as seguintes informações:

    • ID do cliente
    • Segredo do cliente