Configurar o OAuth para o Google Chat

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

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

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

Ativar a API Google Chat

No projeto do Google Cloud console, ative a API Google Chat.

Configurar o app

  1. Depois de ativar a API, acesse a guia Configuração e configure os detalhes do app da seguinte maneira:

    • Nome do app: insira um nome para o app (por exemplo, Gemini Enterprise). Os usuários vão ver esse nome quando o app enviar uma mensagem.
    • URL do avatar: forneça o URL do ícone do Gemini Enterprise. Esse ícone vai aparecer ao lado do nome do app nas conversas.
    • Descrição: insira uma descrição (por exemplo, Google Chat app for Gemini Enterprise).

  2. Em Status do app, verifique se o status está definido como ATIVO.

  3. Clique em Salvar.

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 > Visão geral.

    Acessar a plataforma de autenticação

  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, adicione usuários de teste:
      1. Clique em Público.
      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 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 Marca e Público-alvo.

Adicionar escopos

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 do Google Chat com base nos seus requisitos:
Modo de conexão Escopo Finalidade
Pesquisa federada
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages.readonly
 Permissão mínima necessária para pesquisar e recuperar conteúdo. Permite que o repositório de dados liste espaços e leia mensagens.
Pesquisa federada e ações
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages.readonly
https://www.googleapis.com/auth/chat.space.create Criação de espaço:escopo mínimo necessário para criar um espaço do Chat.
https://www.googleapis.com/auth/chat.messages.create Mensagens:escopo mínimo necessário para responder a uma conversa.

5. Clique em Adicionar à tabela e em Atualizar.

6. 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 Chat 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, insira 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 que você acabou de criar e copie as seguintes informações:

    • ID do cliente
    • Chave secreta do cliente