Configurare OAuth per Google Chat

Questa pagina descrive come configurare OAuth per connettere Google Chat a Gemini Enterprise come datastore.

Configurare l'autenticazione e le autorizzazioni per Google Chat

Per abilitare le azioni di Google Chat, un amministratore Google Cloud deve eseguire i seguenti passaggi per abilitare l'API Google Chat e configurare l'autenticazione.

Abilita l'API Google Chat

Nel progetto della console Google Cloud , abilita l'API Google Chat.

Configurare l'app

  1. Dopo aver abilitato l'API, vai alla scheda Configurazione e configura i dettagli dell'app nel seguente modo:

    • Nome app: inserisci un nome per l'app (ad esempio, Gemini Enterprise). Gli utenti vedranno questo nome quando la tua app invia un messaggio.
    • URL avatar: fornisci l'URL dell'icona di Gemini Enterprise. Questa icona verrà visualizzata accanto al nome dell'app nei thread di chat.
    • Descrizione: inserisci una descrizione (ad esempio, Google Chat app for Gemini Enterprise).

  2. Nella sezione Stato app, assicurati che lo stato sia impostato su LIVE.

  3. Fai clic su Salva.

Crea un'app OAuth e aggiungi ambiti

Se non hai un'app OAuth, segui questi passaggi. Se hai già un'app OAuth, vai a Crea le credenziali client OAuth.

  1. Vai a Google Auth Platform > Panoramica.

    Vai ad Auth Platform

  2. Fai clic su Inizia.

  3. Inserisci un nome per l'app OAuth.

  4. In Email dell'assistenza utente, seleziona un indirizzo email dell'assistenza che gli utenti della tua applicazione possono contattare per domande sul loro consenso.

  5. In Pubblico, seleziona il tipo di utente per la tua app:

    • Esterno: seleziona Esterno se stai creando un'app da utilizzare al di fuori della tua organizzazione Google Workspace. In questo modo, l'app è disponibile pubblicamente per qualsiasi utente con un Google account. Se hai selezionato Esterno, aggiungi utenti di test:
      1. Fai clic su Segmento di pubblico.
      2. Nella sezione Utenti di test, fai clic su Aggiungi utenti.
      3. Inserisci il tuo indirizzo email e gli altri utenti di test autorizzati, quindi fai clic su Salva.
    • Interna: seleziona Interna se l'app è limitata ai membri di un' Google Cloud organizzazione specifica, limitando l'accesso solo ai membri dell'organizzazione Google Workspace.

  6. Fai clic su Avanti.

  7. In Informazioni di contatto, inserisci un indirizzo email a cui ricevere notifiche in caso di modifiche al progetto.

  8. Fai clic su Avanti.

  9. In Fine, esamina le Norme relative ai dati utente dei servizi API di Google. Se accetti, seleziona Accetto le Norme relative ai dati utente: servizi API di Google.

  10. Fai clic su Continua.

  11. Fai clic su Crea.

Dopo aver creato l'app, puoi aggiornare le impostazioni della schermata per il consenso OAuth in Branding e Pubblico.

Aggiungere ambiti

Per aggiungere gli ambiti minimi richiesti:

  1. Nella Google Cloud console, vai a Menu .
  2. Seleziona Accesso ai dati dal menu di navigazione.
  3. Fai clic su Aggiungi o rimuovi ambiti.
  4. In Aggiungi ambiti manualmente, incolla i seguenti ambiti per Google Chat in base ai tuoi requisiti:
Modalità di connessione Ambito Finalità
Ricerca federata
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages.readonly
 Autorizzazione minima richiesta per cercare e recuperare contenuti. Consente al datastore di elencare gli spazi e leggere i messaggi.
Ricerca federata e Azioni
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages.readonly
https://www.googleapis.com/auth/chat.space.create Creazione dello spazio:ambito minimo richiesto per creare uno spazio di chat.
https://www.googleapis.com/auth/chat.messages.create Messaggistica:ambito minimo richiesto per rispondere a un thread di chat.

5. Fai clic su Aggiungi alla tabella e poi su Aggiorna.

6. Fai clic su Salva.

Crea le credenziali client OAuth

Questa procedura descrive come creare un nuovo ID client OAuth per le azioni di Google Cloud. Se hai già un ID client OAuth per le Google Cloud azioni, puoi utilizzare questo ID client e questo secret per le azioni di Google Chat anziché crearne uno nuovo.

  1. Vai a Google Auth Platform/Client.

  2. Fai clic su Crea cliente.

  3. Per Tipo di applicazione, seleziona Applicazione web.

  4. Nel campo Nome, inserisci un nome per la credenziale.

  5. Salta Origini JavaScript autorizzate.

  6. Nella sezione URI di reindirizzamento autorizzati, fai clic su Aggiungi URI e inserisci il seguente URI: https://vertexaisearch.cloud.google.com/oauth-redirect

  7. Fai clic su Crea. La credenziale appena creata viene visualizzata in ID client OAuth 2.0. Apri il client appena creato e copia le seguenti informazioni:

    • ID client
    • Client secret