Niveau de codage: intermédiaire
Durée: 20 minutes
Type de projet: automatisation avec un menu personnalisé
Objectifs
- Comprendre ce que fait la solution.
- Découvrez le rôle des services Apps Script dans la solution.
- configurer votre environnement ;
- Configurez le script.
- Exécutez le script.
À propos de cette solution
Vous pouvez analyser des données textuelles, comme les commentaires ouverts, à grande échelle. Pour effectuer une analyse des entités et des sentiments à partir de Google Sheets, cette solution utilise le service URLFetch pour se connecter à l'API Google Cloud Natural Language.
Comment ça marche ?
Le script collecte le texte de la feuille de calcul et se connecte à l'API Google Cloud Natural Language pour analyser les entités et les sentiments présents dans la chaîne. Un tableau croisé dynamique récapitule le score de sentiment moyen pour chaque entité mentionnée sur toutes les lignes de données textuelles.
Services Apps Script
Cette solution utilise les services suivants:
- Service Spreadsheet : envoie les données textuelles à l'API Google Cloud Natural Language et marque chaque ligne comme "Complete" (Terminée) une fois son sentiment analysé.
- Service URLFetch : se connecte à l'API Google Cloud Natural Language pour effectuer une analyse des entités et des sentiments sur le texte.
Prérequis
Pour utiliser cet exemple, vous devez remplir les conditions préalables suivantes:
- Un compte Google (les comptes Google Workspace peuvent nécessiter l'approbation d'un administrateur)
Un navigateur Web avec accès à Internet.
Un projet Google Cloud avec un compte de facturation associé Consultez la section Activer la facturation pour un projet.
Configurer votre environnement
Ouvrir votre projet Cloud dans la console Google Cloud
S'il n'est pas déjà ouvert, ouvrez le projet Cloud que vous souhaitez utiliser pour cet exemple:
- Dans la console Google Cloud, accédez à la page Sélectionner un projet.
- Sélectionnez le projet Google Cloud que vous souhaitez utiliser. Vous pouvez également cliquer sur Créer un projet et suivre les instructions à l'écran. Si vous créez un projet Google Cloud, vous devrez peut-être activer la facturation pour ce projet.
Activer l'API Google Cloud Natural Language
Cette solution se connecte à l'API Google Cloud Natural Language. Avant d'utiliser les API Google, vous devez les activer dans un projet Google Cloud. Vous pouvez activer une ou plusieurs API dans un même projet Google Cloud.
Dans votre projet Cloud, activez l'API Google Cloud Natural Language.
Configurer l'écran de consentement OAuth
Cette solution nécessite un projet Cloud avec un écran d'autorisation configuré. La configuration de l'écran de consentement OAuth permet de définir ce que Google présente aux utilisateurs et d'enregistrer votre application pour que vous puissiez la publier ultérieurement.
- Dans la console Google Cloud, accédez à Menu > API et services > Écran de consentement OAuth.
- Pour Type d'utilisateur, sélectionnez Interne, puis cliquez sur Créer.
- Remplissez le formulaire d'enregistrement de l'application, puis cliquez sur Save and Continue (Enregistrer et continuer).
Pour l'instant, vous pouvez ignorer l'ajout de champs d'application et cliquer sur Enregistrer et continuer. Par la suite, lorsque vous créerez une application destinée à être utilisée en dehors de votre organisation Google Workspace, vous devrez définir le type d'utilisateur sur Externe, puis ajouter les niveaux d'autorisation requis par votre application.
- Consultez le résumé d'enregistrement de votre application. Pour apporter des modifications, cliquez sur Modifier. Si l'enregistrement de l'application semble correct, cliquez sur Back to Dashboard (Revenir au tableau de bord).
Obtenir une clé API pour l'API Google Cloud Natural Language
- Accédez à Google Cloud Console. Assurez-vous que votre projet pour lequel la facturation est activée est ouvert.
Dans la console Google Cloud, accédez à Menu > API et services > Identifiants.
Cliquez sur Créer des identifiants > Clé API.
Notez votre clé API, car vous en aurez besoin lors d'une prochaine étape.
Configurer le script
Créer le projet Apps Script
- Cliquez sur le bouton ci-dessous pour créer une copie de l'exemple de feuille de calcul Analyse des sentiments pour les commentaires. Le projet Apps Script correspondant à cette solution est joint à la feuille de calcul.
Créer une copie - Cliquez sur Extensions > Apps Script.
- Mettez à jour la variable suivante dans le fichier de script avec votre clé API :
const myApiKey = 'YOUR_API_KEY'; // Replace with your API key.
- Cliquez sur Enregistrer .
Ajouter des données textuelles
- Revenez à la feuille de calcul.
- Ajoutez des données textuelles aux colonnes id et comments. Vous pouvez utiliser des exemples d'avis sur des établissements de vacances provenant de Kaggle ou utiliser vos propres données. Vous pouvez ajouter d'autres colonnes si nécessaire, mais pour que le script s'exécute correctement, les colonnes id et comments doivent contenir des données.
Exécuter le script
- En haut de la feuille de calcul, cliquez sur Outils de sentiment > Marquer des entités et un sentiment. Vous devrez peut-être actualiser la page pour que ce menu personnalisé s'affiche.
Lorsque vous y êtes invité, autorisez le script. Si l'écran de consentement OAuth affiche l'avertissement Cette application n'est pas validée, continuez en sélectionnant Paramètres avancés > Accéder à {Project Name} (non sécurisé).
Cliquez sur Outils de sentiment > Marquer des entités et des sentiments à nouveau.
Une fois le script terminé, passez à la feuille Tableau croisé dynamique pour voir les résultats.
Examiner le code
Pour examiner le code Apps Script de cette solution, cliquez sur Afficher le code source ci-dessous:
Afficher le code source
Code.gs
Contributeurs
Cet échantillon est géré par Google avec l'aide d'Experts Google Developers.
Étapes suivantes
- Blog: Analyser du texte dans Google Sheets à l'aide de l'API Google Cloud Natural Language et d'Apps Script
- Documentation sur l'API Google Cloud Natural Language