Configurer OAuth pour Google Chat

Cette page explique comment configurer OAuth pour associer Google Chat à Gemini Enterprise en tant que data store.

Configurer l'authentification et les autorisations pour Google Chat

Pour activer les actions Google Chat, un administrateur Google Cloud doit effectuer les étapes suivantes pour activer l'API Google Chat et configurer l'authentification.

Activer l'API Google Chat

Dans votre projet de console Google Cloud , activez l'API Google Chat.

Configurer l'application

1. Après avoir activé l'API, accédez à l'onglet Configuration et configurez les informations sur l'application comme suit :

   • Nom de l'application : saisissez le nom de l'application (par exemple, Gemini Enterprise). Les utilisateurs verront ce nom lorsque votre application enverra un message.
   • URL de l'avatar : indiquez l'URL de l'icône Gemini Enterprise. Cette icône s'affichera à côté du nom de l'application dans les fils de discussion.
   • Description : saisissez une description (par exemple, Google Chat app for Gemini Enterprise).

2. Sous État de l'application, assurez-vous que l'état est défini sur EN COURS.

   Remarque : Si l'état de l'application est DÉSACTIVÉ, les requêtes envoyées à l'API REST Google Chat à l'aide de ce numéro de projet sont refusées.

3. Cliquez sur Enregistrer.

Créer une application OAuth et ajouter des habilitations

Si vous n'avez pas d'application OAuth, suivez ces étapes. Si vous disposez déjà d'une application OAuth, passez à Créer des identifiants client OAuth.

1. Accédez à Google Auth Platform > Présentation.

   Accéder à Auth Platform

2. Cliquez sur Commencer.

3. Saisissez un nom pour votre application OAuth.

4. Dans Adresse e-mail d'assistance utilisateur, sélectionnez une adresse e-mail d'assistance pour que les utilisateurs de votre application puissent vous contacter en cas de question sur leur consentement.

5. Sous Audience, sélectionnez le type d'utilisateur pour votre application :

   • Externe : sélectionnez Externe si vous créez une application à utiliser en dehors de votre organisation Google Workspace. L'application est alors disponible publiquement pour tous les utilisateurs disposant d'un compte Google . Si vous avez sélectionné Externe, ajoutez des utilisateurs de test :
     1. Cliquez sur Audience.
     2. Sous Utilisateurs de test, cliquez sur Ajouter des utilisateurs.
     3. Saisissez votre adresse e-mail et celles des autres utilisateurs de test autorisés, puis cliquez sur Enregistrer.
   • Interne : sélectionnez Interne si l'application est réservée aux membres d'une organisation Google Cloud spécifique, ce qui limite l'accès aux membres de l'organisation Google Workspace.

6. Cliquez sur Suivant.

7. Sous Coordonnées, saisissez une adresse e-mail à laquelle vous recevrez des notifications en cas de modification de votre projet.

8. Cliquez sur Suivant.

9. Sous Terminer, consultez le Règlement sur les données utilisateur dans les services d'API Google. Si vous les acceptez, sélectionnez J'accepte le Règlement sur les données utilisateur dans les services d'API Google.

10. Cliquez sur Continuer.

11. Cliquez sur Créer.

Une fois l'application créée, vous pouvez mettre à jour les paramètres de l'écran de consentement OAuth dans Branding et Audience.

Ajouter des niveaux d'accès

Pour ajouter les niveaux d'accès minimum requis, procédez comme suit :

1. Dans la console Google Cloud , accédez à Menu .
2. Dans le menu de navigation, sélectionnez Accès aux données.
3. Cliquez sur Ajouter ou supprimer des niveaux d'accès.
4. Sous Ajouter manuellement des champs d'application, collez les champs d'application suivants pour Google Chat en fonction de vos besoins :

Mode de connexion	Champ d'application	Objectif
Recherche unifiée	https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.messages.readonly	Autorisation minimale requise pour rechercher et récupérer du contenu. Permet au data store de lister les espaces et de lire les messages.
Recherche unifiée et Actions	https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.messages.readonly
	https://www.googleapis.com/auth/chat.spaces.create	Création d'espaces : champ d'application minimal requis pour créer un espace de discussion.
	https://www.googleapis.com/auth/chat.messages.create	Messagerie : portée minimale requise pour répondre à un fil de discussion.

5. Cliquez sur Ajouter au tableau, puis sur Mettre à jour.

6. Cliquez sur Enregistrer.

Remarque : Si vous n'avez besoin que de rechercher dans le data store et que vous n'effectuerez pas d'autres actions, limitez les niveaux d'accès à https://www.googleapis.com/auth/chat.spaces.readonly et https://www.googleapis.com/auth/chat.messages.readonly. Pour effectuer des actions, vous avez besoin des champs d'application supplémentaires spécifiés dans Actions compatibles.

Créer des identifiants client OAuth

Cette procédure explique comment créer un ID client OAuth pour les actions Google Cloud. Si vous disposez déjà d'un ID client OAuth pour les actions Google Cloud , vous pouvez utiliser cet ID client et ce code secret pour les actions Google Chat au lieu d'en créer un.

1. Accédez à Google Auth Platform/Clients.

2. Cliquez sur Créer un client.

3. Dans le champ Type d'application, sélectionnez Application Web.

4. Dans le champ Nom, saisissez un nom pour l'identifiant.

5. Ignorez Origines JavaScript autorisées.

6. Dans la section URI de redirection autorisés, cliquez sur Ajouter un URI et saisissez l'URI suivant : https://vertexaisearch.cloud.google.com/oauth-redirect

7. Cliquez sur Créer. Les identifiants que vous venez de créer s'affichent sous ID client OAuth 2.0. Ouvrez le client que vous venez de créer et copiez les informations suivantes :

   • ID client
   • Code secret du client