Si vous utilisez Google Apps, il y a de fortes chances que vous ne les utilisiez pas pleinement. Avec Google Apps Script, vous pouvez ajouter des menus et des boîtes de dialogue personnalisés, écrire des fonctions et des macros personnalisées, et créer des modules complémentaires pour étendre Google Docs, Sheets et Slides.
Qu’est-ce que Google Apps Script?
Google Apps Script est une plate-forme de développement basée sur le cloud permettant de créer des applications Web personnalisées et légères. Vous pouvez créer des applications évolutives directement dans votre navigateur qui s’intègrent sans effort aux produits Google.
Apps Script utilise le langage JavaScript et rassemble la familiarité du développement Web et des produits Google en un seul endroit, ce qui en fait un outil parfait pour personnaliser des applications pour votre entreprise, votre organisation ou simplement pour automatiser des tâches banales.
Vous pouvez créer deux types de scripts avec Google Apps Script:
- Autonome: Ces scripts ne sont liés à aucun service, comme Google Docs, Sheets ou Slides. Ils peuvent exécuter des fonctions à l’échelle du système, un peu comme des macros. Ils ne sont pas idéaux pour être partagés avec un public plus large, car vous devez copier et coller le code pour les utiliser. Vous pouvez par exemple rechercher dans Drive des fichiers portant des noms spécifiques ou voir qui a accès à vos fichiers et dossiers partagés dans Drive.
- Lié: Ceux-ci sont liés à un fichier Google Docs, Sheets, Forms ou Slides. Les scripts liés étendent les fonctionnalités d’un fichier et n’effectuent des actions que dans ce fichier spécifique. Les exemples incluent l’ajout de menus personnalisés, de boîtes de dialogue et de barres latérales à un service ou à un script qui vous envoie des notifications par e-mail à chaque fois qu’une cellule particulière d’une feuille change.
Si vous ne connaissez pas beaucoup JavaScript, ou si vous n’en avez peut-être jamais entendu parler auparavant, ne vous laissez pas effrayer par le développement de votre propre script. Il est très facile de commencer à utiliser Apps Script, car il fournit un richesse de documentation et d’exemples à tester par vous-même. Vous trouverez ci-dessous quelques exemples simples pour vous aider à comprendre leur fonctionnement.
Comment créer un script autonome
Maintenant que vous savez ce qu’ils sont, allons-y et créons votre premier script autonome. Nous utiliserons un exemple de code de Google pour nous aider à démarrer, et nous fournirons des explications sur les lignes de code si vous n’êtes pas familier avec GoogleScript ou JavaScript.
Dirigez-vous vers Script Google Apps. Dans le coin supérieur gauche, cliquez sur l’icône du hamburger, puis sur « Nouveau script ».
Un nouveau projet sans titre s’ouvre avec une fonction vide à l’intérieur, mais comme nous utilisons un exemple de code de Google, vous pouvez continuer et supprimer tout le texte du fichier.
Remarque: Vous devez être connecté à votre compte Google pour que ce script fonctionne.
Après avoir supprimé le code préchargé dans le fichier, collez le code suivant:
//Initialize your function
function createADocument() {
// Create a new Google Doc named 'Hello, world!'
var doc = DocumentApp.create('Hello, world!');
// Access the body of the document, then add a paragraph.
doc.getBody().appendParagraph('This document was created by Google Apps Script.');
}
Avant de pouvoir exécuter le code, vous devez enregistrer le script. Cliquez sur « Fichier », puis sur « Enregistrer ».
Renommez le projet en quelque chose qui vous aide à vous souvenir de ce que fait le script, puis cliquez sur « OK ».
Pour exécuter votre code, cliquez sur l’icône de lecture située dans la barre d’outils.
Vous devrez accorder au script certaines autorisations pour accéder à votre compte Google via une fenêtre contextuelle après avoir cliqué sur «Exécuter» la première fois. Cliquez sur «Examiner les autorisations» pour voir à quoi il a besoin pour accéder.
Comme il ne s’agit pas d’une application validée par Google, vous recevrez un autre avertissement. Cela dit essentiellement que, sauf si vous connaissez le développeur (nous), ne procédez que si vous lui faites confiance. Cliquez sur « Avancé », puis sur « Aller à CreateNewDoc » (ou quel que soit le nom que vous avez nommé ce script).
Vérifiez les autorisations requises par le script, puis cliquez sur « Autoriser ».
Génial! Maintenant, dirigez-vous vers votre Drive et si tout a fonctionné, le message « Hello, World! » le fichier devrait être là. Double-cliquez dessus pour l’ouvrir.
Lorsque vous ouvrez le fichier, vous verrez la ligne de texte du code ajouté à votre document.
Désormais, si vous souhaitez recevoir une notification par e-mail lors de la création du document, vous pouvez ajouter quelques lignes de code supplémentaires pour en envoyer une automatiquement à votre compte Google. Ajoutez les lignes de code suivantes après doc.getBody().appendParagraph('This document was created by Google Apps Script.'); mais avant la dernière accolade } :
// Get the URL of the document. var url = doc.getUrl(); // Get the email address of the active user - that's you. var email = Session.getActiveUser().getEmail(); // Get the name of the document to use as an email subject line. var subject = doc.getName(); // Append a new string to the "url" variable to use as an email body. var body = 'Link to your doc: ' + url; // Send yourself an email with a link to the document. GmailApp.sendEmail(email, subject, body);
Cliquez sur l’icône «Exécuter».
Comme vous avez ajouté quelques lignes supplémentaires qui nécessitent des autorisations supplémentaires, vous devez suivre le même processus qu’auparavant. Cliquez sur « Vérifier les autorisations ».
Cliquez sur « Avancé », puis sur « Accéder à CreateNewDoc ».
Remarque: Comme Google vous avertit du lancement d’applications non vérifiées, vous recevrez également un e-mail d’alerte de sécurité. Google le fait juste au cas où vous n’étiez pas celui qui accorderait l’accès à une application non vérifiée.
Vérifiez le nouvel ensemble d’autorisations requis par le script, puis cliquez sur « Autoriser ».
Une fois le document créé, vous recevez un e-mail contenant un lien vers le fichier dans votre Google Drive.
Cliquez sur le lien pour accéder directement au fichier, qui se trouve dans votre Google Drive.
Comment créer un script lié
Pour cet exemple suivant, créons un script lié pour Google Sheets qui analyse une feuille existante pour les entrées en double dans une ligne, puis les supprime.
Si vous vous souvenez des scripts précédents, les scripts liés fonctionnent comme un module complémentaire à des fichiers spécifiques.Par conséquent, pour en créer un, ouvrons une feuille de calcul Google Sheet existante contenant au moins un point de données en double.
Cliquez sur «Outils», puis sur «Éditeur de script».
Le script Google Apps s’ouvre dans un nouvel onglet avec un script vide. Cette fois, cependant, le script est lié à la feuille à partir de laquelle il s’ouvre.
Tout comme avant, supprimez la fonction vide et collez le code suivant:
//Removes duplicate rows from the current sheet.
function removeDuplicates() {
//Get current active Spreadsheet
var sheet = SpreadsheetApp.getActiveSheet();
//Get all values from the spreadsheet's rows
var data = sheet.getDataRange().getValues();
//Create an array for non-duplicates
var newData = [];
//Iterate through a row's cells
for (var i in data) {
var row = data[i];
var duplicate = false;
for (var j in newData) {
if (row.join() == newData[j].join()) {
duplicate = true;
}
}
//If not a duplicate, put in newData array
if (!duplicate) {
newData.push(row);
}
}
//Delete the old Sheet and insert the newData array
sheet.clearContents();
sheet.getRange(1, 1, newData.length, newData[0].length).setValues(newData);
}
Remarque: Pour que le script supprime un doublon, toutes les cellules de la ligne doivent correspondre.
Enregistrez et renommez votre script, puis cliquez sur l’icône «Exécuter».
Encore une fois, comme vous l’avez rencontré dans le dernier script que vous avez créé, vous devrez revoir les autorisations requises par votre script et lui accorder l’accès à votre feuille de calcul. Cliquez sur «Examiner les autorisations» pour voir l’accès souhaité par ce script.
Acceptez les invites et cliquez sur «Autoriser» pour autoriser le script.
Une fois son exécution terminée, revenez à votre feuille et, comme par magie, toutes les entrées en double disparaissent de votre fichier!
Malheureusement, si vos données se trouvent à l’intérieur d’une table, comme dans l’exemple ci-dessus, ce script ne redimensionnera pas la table en fonction du nombre d’entrées qu’elle contient.
Bien qu’il s’agisse de deux exemples assez simples d’utilisation d’Apps Script, les options sont presque illimitées et tout dépend de ce que vous pouvez imaginer avec ces ressources. Mais, en attendant, dirigez-vous vers le Page Github de GSuite Devs ou Inspiration numérique et découvrez la pile d’exemples de scripts que vous pouvez déployer dans vos propres services pour avoir une meilleure idée de ce que Apps Script est vraiment capable de faire.
