GSP1301

Présentation

Les modules complémentaires peuvent étendre les fonctionnalités de Google Workspace pour aider les utilisateurs à être plus productifs et à améliorer leur workflow. Dans cet atelier, vous allez créer un module complémentaire Google Workspace qui exploite la puissance de Gemini et de Vertex AI pour effectuer une analyse des sentiments dans Gmail. Vous configurerez les ressources cloud nécessaires (y compris les API Vertex AI) ainsi qu'un projet Apps Script, et déploierez le module complémentaire.

Ce module complémentaire vous permet d'identifier et d'étiqueter automatiquement les e-mails dont le ton est négatif. Vous pouvez l'utiliser pour prioriser les réponses du service client ou identifier rapidement les e-mails potentiellement sensibles.

À la fin de l'atelier, vous disposerez d'un outil fonctionnel qui illustre l'application pratique de l'IA pour améliorer la productivité et la communication dans un contexte professionnel.

Points abordés

Dans cet atelier, vous allez effectuer les tâches suivantes :

• Créer un module complémentaire Google Workspace qui étend les fonctionnalités de Gmail
• Intégrer Vertex AI à Google Workspace pour utiliser Gemini et les fonctionnalités de traitement du langage naturel de Vertex AI dans un module complémentaire Gmail
• Implémenter l'authentification OAuth2 pour autoriser de manière sécurisée le module complémentaire à accéder aux données utilisateur
• Appliquer l'analyse des sentiments pour analyser de façon programmatique le contenu des e-mails et déterminer leur ton émotionnel
• Utiliser Apps Script en écrivant du code pour interagir avec Gmail, gérer les interfaces utilisateur et se connecter à des API externes

Préparation

Avant de cliquer sur le bouton "Démarrer l'atelier"

Lisez ces instructions. Les ateliers sont minutés, et vous ne pouvez pas les mettre en pause. Le minuteur, qui démarre lorsque vous cliquez sur Démarrer l'atelier, indique combien de temps les ressources Google Cloud resteront accessibles.

Cet atelier pratique vous permet de suivre les activités dans un véritable environnement cloud, et non dans un environnement de simulation ou de démonstration. Des identifiants temporaires vous sont fournis pour vous permettre de vous connecter à Google Cloud le temps de l'atelier.

Pour réaliser cet atelier :

• Vous devez avoir accès à un navigateur Internet standard (nous vous recommandons d'utiliser Chrome).

Remarque : Ouvrez une fenêtre de navigateur en mode incognito (recommandé) ou de navigation privée pour effectuer cet atelier. Vous éviterez ainsi les conflits entre votre compte personnel et le compte temporaire de participant, qui pourraient entraîner des frais supplémentaires facturés sur votre compte personnel.

• Vous disposez d'un temps limité. N'oubliez pas qu'une fois l'atelier commencé, vous ne pouvez pas le mettre en pause.

Remarque : Utilisez uniquement le compte de participant pour cet atelier. Si vous utilisez un autre compte Google Cloud, des frais peuvent être facturés à ce compte.

Démarrer l'atelier et se connecter à la console Google Cloud

1. Cliquez sur le bouton Démarrer l'atelier. Si l'atelier est payant, une boîte de dialogue s'affiche pour vous permettre de sélectionner un mode de paiement. Sur la gauche, vous trouverez le panneau "Détails concernant l'atelier", qui contient les éléments suivants :

   • Le bouton "Ouvrir la console Google Cloud"
   • Le temps restant
   • Les identifiants temporaires que vous devez utiliser pour cet atelier
   • Des informations complémentaires vous permettant d'effectuer l'atelier

2. Cliquez sur Ouvrir la console Google Cloud (ou effectuez un clic droit et sélectionnez Ouvrir le lien dans la fenêtre de navigation privée si vous utilisez le navigateur Chrome).

   L'atelier lance les ressources, puis ouvre la page "Se connecter" dans un nouvel onglet.

   Conseil : Réorganisez les onglets dans des fenêtres distinctes, placées côte à côte.

   Remarque : Si la boîte de dialogue Sélectionner un compte s'affiche, cliquez sur Utiliser un autre compte.

3. Si nécessaire, copiez le nom d'utilisateur ci-dessous et collez-le dans la boîte de dialogue Se connecter.

   {{{user_0.username | "Username"}}}

   Vous trouverez également le nom d'utilisateur dans le panneau "Détails concernant l'atelier".

4. Cliquez sur Suivant.

5. Copiez le mot de passe ci-dessous et collez-le dans la boîte de dialogue Bienvenue.

   {{{user_0.password | "Password"}}}

   Vous trouverez également le mot de passe dans le panneau "Détails concernant l'atelier".

6. Cliquez sur Suivant.

   Important : Vous devez utiliser les identifiants fournis pour l'atelier. Ne saisissez pas ceux de votre compte Google Cloud. Remarque : Si vous utilisez votre propre compte Google Cloud pour cet atelier, des frais supplémentaires peuvent vous être facturés.

7. Accédez aux pages suivantes :

   • Acceptez les conditions d'utilisation.
   • N'ajoutez pas d'options de récupération ni d'authentification à deux facteurs (ce compte est temporaire).
   • Ne vous inscrivez pas à des essais sans frais.

Après quelques instants, la console Cloud s'ouvre dans cet onglet.

Remarque : Pour accéder aux produits et services Google Cloud, cliquez sur le menu de navigation ou saisissez le nom du service ou du produit dans le champ Recherche.

Tâche 1 : Accéder à votre environnement d'atelier

Vous vous êtes connecté à la console Google Cloud. Connectez-vous maintenant à Gmail.

1. Cliquez sur Ouvrir Gmail pour ouvrir la page de connexion à Gmail.

Conseil : Réorganisez les onglets dans des fenêtres distinctes pour les consulter plus facilement.

2. Connectez-vous à Gmail avec le nom d'utilisateur et le mot de passe .

Remarque : Ces identifiants figurent également dans le volet Détails concernant l'atelier et ont été utilisés pour vous connecter à la console Google Cloud.

3. Une fois dans Gmail, cliquez sur Commencer et fermez toutes les fenêtres d'information qui peuvent s'ouvrir. Vous devez maintenant voir votre boîte de réception.

Vous êtes prêt à commencer les activités de l'atelier.

Tâche 2 : Configurer votre environnement Google Cloud

Dans cette tâche, vous allez activer l'API Vertex AI, puis configurer l'écran de consentement OAuth pour définir ce que Google Workspace affiche aux utilisateurs.

Activer l'API Vertex AI

1. Dans le menu de navigation de la console Google Cloud, cliquez sur API et services > Bibliothèque.

2. Saisissez API Vertex AI dans la zone Rechercher des API et des services, puis cliquez sur API Vertex AI dans les résultats de recherche.

3. Cliquez sur Activer pour activer l'API.

La page "Détails de l'API/du service" s'ouvre.

Configurer l'écran d'autorisation OAuth

1. Dans le volet de gauche, cliquez sur Écran de consentement OAuth.

2. Cliquez sur Commencer.

3. Sous Informations sur l'application, configurez les éléments suivants, puis cliquez sur Suivant :

• Nom de l'application : Analyse des sentiments dans Gmail avec Gemini et Vertex AI
• Adresse e-mail d'assistance utilisateur :

4. Dans le champ Audience, sélectionnez Interne, puis cliquez sur Suivant.
5. Pour Coordonnées, définissez Adresses e-mail sur , puis cliquez sur Suivant.
6. Pour Terminer, acceptez le Règlement sur les données utilisateur dans les services d'API Google, puis cliquez sur Continuer.
7. Cliquez sur Créer.

Cliquez sur Vérifier ma progression pour valider l'objectif. Configurer l'écran d'autorisation OAuth

Tâche 3 : Configurer le projet Apps Script

Dans cette tâche, vous allez créer et configurer votre module complémentaire en tant que projet Apps Script.

Obtenir le numéro de projet Google Cloud

Pour obtenir le numéro de votre projet Google Cloud à utiliser lorsque vous créez un projet Apps Script :

1. Dans le menu de navigation (), cliquez sur Présentation Cloud > Tableau de bord.

2. Dans la section "Informations sur le projet", notez le numéro du projet, car vous en aurez besoin plus tard dans cet atelier.

Créer un projet Apps Script

1. Dans le volet "Ressources destinées aux élèves", cliquez sur ce lien : script.google.com/ pour ouvrir la page Apps Script.

2. Cliquez sur Nouveau projet pour créer un projet Apps Script.

3. Nommez votre projet :

   • Cliquez sur Projet sans titre en haut à gauche.
   • Nommez le projet Analyse des sentiments dans Gmail avec Gemini et Vertex AI, puis cliquez sur Renommer.

4. Rendez le fichier manifeste visible :

   • Dans le volet de gauche, cliquez sur Paramètres du projet ().
   • Sélectionnez Afficher le fichier manifeste 'appsscript.json' dans l'éditeur.

5. Modifiez votre projet Google Cloud Platform :

   • Faites défiler la page vers le bas jusqu'à la section Projet Google Cloud Platform (GCP), puis cliquez sur Changer de projet.
   • Définissez le numéro de projet GCP sur le numéro de projet que vous avez noté précédemment.
   • Cliquez sur Définir un projet.

Cliquez sur Vérifier ma progression pour valider l'objectif. Créer un projet Apps Script

Tâche 4 : Remplir les fichiers de code

• Dans le volet de gauche, cliquez sur Éditeur () pour ouvrir la fenêtre de l'éditeur.

Suivez les instructions ci-dessous pour mettre à jour votre projet avec l'exemple de code.

appsscript.json

1. Ouvrez appsscript.json et remplacez son contenu par ce qui suit :

{ "timeZone": "America/Toronto", "oauthScopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/gmail.addons.execute", "https://www.googleapis.com/auth/gmail.labels", "https://www.googleapis.com/auth/gmail.modify", "https://www.googleapis.com/auth/script.external_request", "https://www.googleapis.com/auth/userinfo.email" ], "addOns": { "common": { "name": "Sentiment Analysis", "logoUrl": "https://fonts.gstatic.com/s/i/googlematerialicons/sentiment_extremely_dissatisfied/v6/black-24dp/1x/gm_sentiment_extremely_dissatisfied_black_24dp.png" }, "gmail": { "homepageTrigger": { "runFunction": "onHomepageTrigger", "enabled": true } } }, "exceptionLogging": "STACKDRIVER", "runtimeVersion": "V8" }

2. Cliquez sur Enregistrer pour enregistrer votre projet.

Code.gs

1. Ouvrez Code.gs et remplacez son contenu par le code suivant :

/* Copyright 2024-2025 Google LLC Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at https://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ // Replace with your project ID const PROJECT_ID = '{{{project_0.project_id | Project ID}}}'; // Location for your Vertex AI model const VERTEX_AI_LOCATION = 'us-east4'; // Model ID to use for sentiment analysis const MODEL_ID = 'gemini-2.0-flash'; /** * Triggered when the add-on is opened from the Gmail homepage. * * @param {Object} e - The event object. * @returns {Card} - The homepage card. */ function onHomepageTrigger(e) { return buildHomepageCard(); } /** * Builds the main card displayed on the Gmail homepage. * * @returns {Card} - The homepage card. */ function buildHomepageCard() { // Create a new card builder const cardBuilder = CardService.newCardBuilder(); // Create a card header const cardHeader = CardService.newCardHeader(); cardHeader.setImageUrl('https://fonts.gstatic.com/s/i/googlematerialicons/mail/v6/black-24dp/1x/gm_mail_black_24dp.png'); cardHeader.setImageStyle(CardService.ImageStyle.CIRCLE); cardHeader.setTitle("Analyze your Gmail"); // Add the header to the card cardBuilder.setHeader(cardHeader); // Create a card section const cardSection = CardService.newCardSection(); // Create buttons for generating sample emails and analyzing sentiment const buttonSet = CardService.newButtonSet(); // Create "Generate sample emails" button const generateButton = createFilledButton('Generate sample emails', 'generateSampleEmails', '#34A853'); buttonSet.addButton(generateButton); // Create "Analyze emails" button const analyzeButton = createFilledButton('Analyze emails', 'analyzeSentiment', '#FF0000'); buttonSet.addButton(analyzeButton); // Add the button set to the section cardSection.addWidget(buttonSet); // Add the section to the card cardBuilder.addSection(cardSection); // Build and return the card return cardBuilder.build(); } /** * Creates a filled text button with the specified text, function, and color. * * @param {string} text - The text to display on the button. * @param {string} functionName - The name of the function to call when the button is clicked. * @param {string} color - The background color of the button. * @returns {TextButton} - The created text button. */ function createFilledButton(text, functionName, color) { // Create a new text button const textButton = CardService.newTextButton(); // Set the button text textButton.setText(text); // Set the action to perform when the button is clicked const action = CardService.newAction(); action.setFunctionName(functionName); textButton.setOnClickAction(action); // Set the button style to filled textButton.setTextButtonStyle(CardService.TextButtonStyle.FILLED); // Set the background color textButton.setBackgroundColor(color); return textButton; } /** * Creates a notification response with the specified text. * * @param {string} notificationText - The text to display in the notification. * @returns {ActionResponse} - The created action response. */ function buildNotificationResponse(notificationText) { // Create a new notification const notification = CardService.newNotification(); notification.setText(notificationText); // Create a new action response builder const actionResponseBuilder = CardService.newActionResponseBuilder(); // Set the notification for the action response actionResponseBuilder.setNotification(notification); // Build and return the action response return actionResponseBuilder.build(); } /** * Generates sample emails for testing the sentiment analysis. * * @returns {ActionResponse} - A notification confirming email generation. */ function generateSampleEmails() { // Get the current user's email address const userEmail = Session.getActiveUser().getEmail(); // Define sample emails const sampleEmails = [ { subject: 'Thank you for amazing service!', body: 'Hi, I really enjoyed working with you. Thank you again!', name: 'Customer A' }, { subject: 'Request for information', body: 'Hello, I need more information on your recent product launch. Thank you.', name: 'Customer B' }, { subject: 'Complaint!', body: '', htmlBody: `

Hello, You are late in delivery, again.

Please contact me ASAP before I cancel our subscription.

`, name: 'Customer C' } ]; // Send each sample email for (const email of sampleEmails) { GmailApp.sendEmail(userEmail, email.subject, email.body, { name: email.name, htmlBody: email.htmlBody }); } // Return a notification return buildNotificationResponse("Successfully generated sample emails"); } /** * Analyzes the sentiment of the first 10 threads in the inbox * and labels them accordingly. * * @returns {ActionResponse} - A notification confirming completion. */ function analyzeSentiment() { // Analyze and label emails analyzeAndLabelEmailSentiment(); // Return a notification return buildNotificationResponse("Successfully completed sentiment analysis"); } /** * Analyzes the sentiment of emails and applies appropriate labels. */ function analyzeAndLabelEmailSentiment() { // Define label names const labelNames = ["HAPPY TONE 😊", "NEUTRAL TONE 😐", "UPSET TONE 😡"]; // Get or create labels for each sentiment const positiveLabel = GmailApp.getUserLabelByName(labelNames[0]) || GmailApp.createLabel(labelNames[0]); const neutralLabel = GmailApp.getUserLabelByName(labelNames[1]) || GmailApp.createLabel(labelNames[1]); const negativeLabel = GmailApp.getUserLabelByName(labelNames[2]) || GmailApp.createLabel(labelNames[2]); // Get the first 10 threads in the inbox const threads = GmailApp.getInboxThreads(0, 10); // Iterate through each thread for (const thread of threads) { // Iterate through each message in the thread const messages = thread.getMessages(); for (const message of messages) { // Get the plain text body of the message const emailBody = message.getPlainBody(); // Analyze the sentiment of the email body const sentiment = processSentiment(emailBody); // Apply the appropriate label based on the sentiment if (sentiment === 'positive') { thread.addLabel(positiveLabel); } else if (sentiment === 'neutral') { thread.addLabel(neutralLabel); } else if (sentiment === 'negative') { thread.addLabel(negativeLabel); } } } } /** * Sends the email text to Vertex AI for sentiment analysis. * * @param {string} emailText - The text of the email to analyze. * @returns {string} - The sentiment of the email ('positive', 'negative', or 'neutral'). */ function processSentiment(emailText) { // Construct the API endpoint URL const apiUrl = `https://${VERTEX_AI_LOCATION}-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/${VERTEX_AI_LOCATION}/publishers/google/models/${MODEL_ID}:generateContent`; // Prepare the request payload const payload = { contents: [ { role: "user", parts: [ { text: `Analyze the sentiment of the following message: ${emailText}` } ] } ], generationConfig: { temperature: 0.9, maxOutputTokens: 1024, responseMimeType: "application/json", // Expected response format for simpler parsing. responseSchema: { type: "object", properties: { response: { type: "string", enum: ["positive", "negative", "neutral"] } } } } }; // Prepare the request options const options = { method: 'POST', headers: { 'Authorization': `Bearer ${ScriptApp.getOAuthToken()}` }, contentType: 'application/json', muteHttpExceptions: true, // Set to true to inspect the error response payload: JSON.stringify(payload) }; // Make the API request const response = UrlFetchApp.fetch(apiUrl, options); // Parse the response. There are two levels of JSON responses to parse. const parsedResponse = JSON.parse(response.getContentText()); const sentimentResponse = JSON.parse(parsedResponse.candidates[0].content.parts[0].text).response; // Return the sentiment return sentimentResponse; }

Cliquez sur Enregistrer pour enregistrer votre projet.

Tâche 5 : Déployer le module complémentaire

Dans cette tâche, vous allez déployer le module complémentaire, puis vérifier l'installation.

Déployer le module complémentaire

1. Dans la barre de titre, cliquez sur Déployer > Tester les déploiements.

2. Vérifiez que Gmail figure bien dans la liste des applications, puis cliquez sur Installer.

3. Cliquez sur OK.

Vérifier l'installation

• Actualisez l'onglet Gmail. Une icône doit s'afficher dans le volet de droite.

Résoudre les problèmes

Si vous ne voyez pas votre module complémentaire dans la liste, actualisez la fenêtre du navigateur.

Si vous ne le voyez toujours pas, revenez au projet Apps Script, désinstallez le module complémentaire depuis la fenêtre Tester les déploiements, puis réinstallez-le.

Tâche 6 : Exécuter le module complémentaire

Vous êtes prêt à exécuter le module complémentaire. Dans cette tâche, vous allez ouvrir le module complémentaire et l'autoriser, puis générer des e-mails pour vérifier que l'analyse fonctionne.

1. Toujours dans Gmail, dans le volet de droite, cliquez sur Analyse des sentiments ().

2. Lorsque le panneau latéral s'ouvre, cliquez sur Autoriser l'accès pour autoriser l'exécution du module complémentaire.

Un écran de consentement s'ouvre. Sélectionnez votre adresse e-mail () et parcourez les écrans pour autoriser l'accès.

Une fois que vous avez donné votre consentement, le volet "Analyse des sentiments" s'ouvre à droite.

3. Dans le volet "Analyse des sentiments", cliquez sur Générer des exemples d'e-mails.

Le module complémentaire génère désormais des exemples d'e-mails pour tester l'analyse. Un message s'affiche une fois la génération terminée, ce qui ne prend que quelques secondes.

4. Attendez que les exemples d'e-mails s'affichent dans votre boîte de réception. Vous devrez peut-être actualiser votre boîte de réception pour voir les nouveaux e-mails.

5. Une fois que les exemples d'e-mails se trouvent dans votre boîte de réception, dans le volet "Analyse des sentiments", cliquez sur Analyser les e-mails.

Un message indiquant que l'analyse est terminée s'affiche en bas de l'écran du module complémentaire.

Remarque : L'analyse des e-mails peut prendre un certain temps. Vous pouvez actualiser la page pour vérifier l'état des étiquettes appliquées.

Le module complémentaire analyse vos e-mails et applique l'étiquette appropriée ("TON JOVIAL 😊", "TON AGACÉ 😡" ou "TON NEUTRE 😐") aux messages de votre boîte de réception.

Vous devrez peut-être actualiser Gmail pour voir les étiquettes appliquées.

7. Poursuivez vos tests : Vous pouvez tester le module complémentaire en envoyant des e-mails de différents sentiments (positif, négatif, neutre) depuis votre compte Gmail de l'atelier vers un autre compte Gmail de l'atelier. Les e-mails externes ne sont pas autorisés. Observez comment le module complémentaire analyse et étiquette chaque e-mail.

REMARQUE : Le code ne récupère que les 10 derniers e-mails de votre boîte de réception, mais vous pouvez modifier cette valeur.

8. Fermez le module complémentaire : Une fois que vous avez terminé d'utiliser le module complémentaire, vous pouvez le fermer en cliquant sur le X en haut à droite du panneau latéral.

Cliquez sur Vérifier ma progression pour valider l'objectif. Appliquer l'analyse des sentiments

Félicitations !

Vous avez terminé l'atelier "Analyse des sentiments dans Gmail avec Gemini et Vertex AI".

Dans cet atelier, vous avez appris à effectuer les tâches suivantes :

• Créer un module complémentaire Google Workspace : développer un outil pratique qui étend les fonctionnalités de Gmail
• Intégrer Vertex AI à Google Workspace : utiliser Gemini et les fonctionnalités de traitement du langage naturel de Vertex AI dans un module complémentaire Gmail
• Implémenter l'authentification OAuth2 : autoriser de manière sécurisée le module complémentaire à accéder aux données utilisateur
• Appliquer l'analyse des sentiments : analyser de façon programmatique le contenu des e-mails pour déterminer leur ton émotionnel
• Utiliser Apps Script : écrire du code pour interagir avec Gmail, gérer les interfaces utilisateur et se connecter à des API externes

Vous disposez désormais d'un module complémentaire Gmail fonctionnel qui peut vous aider à prioriser vos e-mails et à améliorer votre workflow. N'hésitez pas à tester d'autres fonctionnalités du module complémentaire, par exemple en personnalisant l'analyse des sentiments ou en ajoutant de nouvelles fonctionnalités.

Formations et certifications Google Cloud

Les formations et certifications Google Cloud vous aident à tirer pleinement parti des technologies Google Cloud. Nos cours portent sur les compétences techniques et les bonnes pratiques à suivre pour être rapidement opérationnel et poursuivre votre apprentissage. Nous proposons des formations pour tous les niveaux, à la demande, en salle et à distance, pour nous adapter aux emplois du temps de chacun. Les certifications vous permettent de valider et de démontrer vos compétences et votre expérience en matière de technologies Google Cloud.

Dernière mise à jour du manuel : 25 mars 2025

Dernier test de l'atelier : 25 février 2025

Copyright 2025 Google LLC. Tous droits réservés. Google et le logo Google sont des marques de Google LLC. Tous les autres noms d'entreprises et de produits peuvent être des marques des entreprises auxquelles ils sont associés.