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 Google Cloud amministratore deve eseguire i seguenti passaggi per abilitare l'API Google Chat e configurare l'autenticazione.

Abilitare l'API Google Chat

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

Configurare l'app

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

   • Nome app: inserisci un nome per l'app (ad es. 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 es. Google Chat app for Gemini Enterprise).

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

   Nota: se lo Stato app è DISABILITATO, le richieste all'API REST di Google Chat che utilizzano questo numero di progetto vengono rifiutate.

3. Fai clic su Salva.

Creare un'app OAuth e aggiungere ambiti

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

1. Vai a Piattaforma di autenticazione Google > Panoramica.

   Vai alla piattaforma di autenticazione

2. Fai clic su Inizia.

3. Inserisci un nome per l'app OAuth.

4. In Email di assistenza utente, seleziona un indirizzo email di assistenza che gli utenti della tua applicazione possono contattare per porre 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 Pubblico.
     2. In 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.
   • Interno: seleziona Interno se l'app è limitata ai membri di una determinata Google Cloud organizzazione, limitando l'accesso solo ai membri dell'organizzazione Google Workspace.

6. Fai clic su Avanti.

7. In Dati di contatto, inserisci un indirizzo email a cui ricevere notifiche in merito a eventuali 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 dei 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 Brand e pubblico.

Aggiungere ambiti

Per aggiungere gli ambiti minimi richiesti, segui questi passaggi:

1. Nella Google Cloud console, vai al 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 i 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.spaces.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 , quindi su Aggiorna.

6. Fai clic su Salva.

Nota: se devi solo cercare nel datastore e non eseguire altre azioni, limita gli ambiti a https://www.googleapis.com/auth/chat.spaces.readonly e https://www.googleapis.com/auth/chat.messages.readonly. Per eseguire le azioni, devi disporre degli ambiti aggiuntivi specificati in Azioni supportate.

Creare le credenziali client OAuth

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

1. Vai a Piattaforma di autenticazione Google/Client.

2. Fai clic su Crea client.

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 che hai appena creato e copia le seguenti informazioni:

   • ID client
   • Client secret