Apprendre à réaliser son premier Google Apps Script !

Si vous utilisez comme moi la plupart des applications G Suite (la suite bureautique et collaborative de Google) il peut-être intéressant de connaître le potentiel offert par la plateforme de développement offerte par Google sur ces différentes applications.

Qu’est-ce que Google Apps Script ?

Google Apps Script est une plate-forme de développement d’applications qui permet de créer rapidement et facilement des applications professionnelles qui s’intègrent aux différentes applications de la G Suite.

Pour cela, il faut écrire du code en JavaScript et nous avons accès aux bibliothèques intégrées pour les applications telles que Gmail, Agenda, Docs, Sheets, Forms, etc.

Une solution simple et accessible !

Avec cette solution nous n’avons rien à installer ! Google nous fournit directement un éditeur de code dans notre navigateur et les scripts s’exécutent directement sur les serveurs de Google. 🙂

C’est notamment une solution très pratique pour améliorer ou optimiser certains de nos usages avec nos applications Google favorites.

Comment apprendre le JavaScript ?

Si vous débutez avec le JavaScript (langage de référence pour coder en Apps Script), je vous recommande de suivre les cours proposés par la plateforme de formation Progate sur le sujet. Celle-ci propose un parcours extrêmement pertinent et ludique pour apprendre à coder sur ce langage et bien d’autres encore ! (Notez que ces cours n’ont pas été développés par Google et ne sont pas associés à Google).

Vous pouvez également commencer à apprendre le JavaScript avec l’application Grasshopper développée par les équipes de Google.

Que pouvons-nous faire avec un Google Apps script ?

Google Apps Script est un environnement extrêmement polyvalent. Nous pouvons entre autres choses, utiliser la plateforme pour réaliser les choses suivantes :

  • Ajouter des menus, des boîtes de dialogue et des barres latérales personnalisés à Google Docs, Sheets ou encore Forms.
  • Écrire des fonctions personnalisées et des macros pour Google Sheets.
  • Publier des applications Web – autonomes ou intégrées à un Google Sites.
  • Interagir avec d’autres services Google (AdSense, Analytics, Agenda, Drive, Gmail et Maps).
  • Créer et publier des modules complémentaires pour améliorer des applications comme Docs, Sheets, Slides et Forms.
  • Rationalisez les flux de travaux de discussion en créant un bot de discussion.
  • Et bien plus encore…

Réaliser son premier Apps Script !

Dans ce tutoriel nous allons créer et exécuter un script qui crée un document Google Docs (1) et qui nous transmet ensuite un Email (2) avec dans le corps de celui-ci, le lien du document.

schema-diffusion-docs-mail
Schéma de présentation du script

Voyons ci-dessous les différentes étapes de réalisation :

Accès au « G Suite Developper Hub »

1 – Pour commencer, nous allons dans ce cas ouvrir l’éditeur de script depuis la plateforme de gestion des scripts « G Suite Developper Hub » : script.google.com.

Avertissement : Pour ouvrir l’éditeur de script, vous devez être connecté à votre compte Google. Cliquez ensuite sur « Start scripting » pour accéder à l’éditeur de script.

Création d’un nouveau script

2 – Après avoir validé l’écran de bienvenue, cliquez sur le bouton « Nouveau script » pour créer un fichier dans lequel nous allons réaliser notre script.

nouveau-script-appsscript
Bouton de création d’un nouveau Script

3 – Supprimez maintenant toutes les données présentes dans le Script.

4 – Pour commencer, nous allons rédiger un commentaire précisant le but de notre script.

// Création d'un document Google Docs et envoie d'un email à l'utilisateur actuel avec un lien vers le document.

5 – Passons maintenant concrètement à la création de la fonction. Pour cela il faut taper la commande suivant :

function createAndSendDocument() {
}

6 – Ajoutons maintenant dans la fonction le code qui va nous permettre de créer une variable avec le document Google Docs (ainsi que le commentaire explicatif).

  // Création d'un Google Docs avec le nom 'Docs par Email'
  var doc = DocumentApp.create('Docs par Email');

7 – Nous allons ensuite ajouter un paragraphe dans le document que nous venons de créer.

// Accès au corps du document, puis ajout d'un paragraphe.
doc.getBody().appendParagraph('Ce document a été créé par avec Google Apps Script.');

8 – Récupérons maintenant l’URL du document en déclarant la variable « url ».

// Récupération de l'URL du document.
var url = doc.getUrl();

9 – Nous récupérons l’adresse email de l’utilisateur actif (c’est à dire nous) pour transmettre le document par mail.

// Récupération de l'adresse email de l'utilisateur actif.
var email = Session.getActiveUser().getEmail();

10 – Ensuite, nous récupérons le nom du document pour le placer dans l’objet du mail.

// Récupération du nom du document à utiliser dans l'objet du mail.
var subject = doc.getName();

11 – Ajoutons maintenant dans le corps du mail un texte afin d’introduire la présence du lien du document.

// Ajout d'une chaîne de caractère à la variable "url" présente dans le corps de l'email.
var body = 'Link to your doc: ' + url;

12 – Enfin, terminons par le code permettant de transmettre les éléments par email.

  // Envoi d'un email à soi-même avec un lien vers le document.
  GmailApp.sendEmail(email, subject, body);
}

13 – Il ne reste plus alors qu’à sauvegarder le script pour pouvoir le tester. 🙂 Cliquez pour cela sur « Fichier > Enregistrer ».

code-creation-docs-mail
Aperçu final du code présent dans le Script

Lancement du script

Maintenant pour vérifier que notre script fonctionne il nous suffit de le lancer.

Pour cela, cliquez simplement « Exécuter » dans la barre d’outils de l’éditeur Google Apps Script.

Bouton-lancement-script
Bouton de lancement du script

Avertissement : Après avoir cliqué sur le bouton d’exécution, il est nécessaire de valider les différentes fenêtres d’autorisation de Google. Il n’y a évidemment aucun risque ici, car vous avez conçu ce script par vous-même. Aucune crainte à avoir dans ce cas. 😉

Il ne nous reste alors qu’à nous diriger vers notre messagerie Gmail et vérifier si nous avons bien reçu le mail.

Mail qui devrait ressembler à la copie d’écran ci-dessous. 🙂

Mail reçu par l’intermédiaire du script

Pour conclure…

Voilà pour ce premier aperçu de Google Apps Script et la création d’un petit script permettant d’avoir une idée du fonctionnement et du potentiel de cette solution.

Pour réaliser des scripts pertinents et performants cela demande d’acquérir des connaissances en JavaScript et d’avoir un (ou plusieurs)

Quoiqu’il arrive, j’espère que cet article vous aura permis de commencer de façon simple et ludique avec Apps Script. Je tâcherais de vous proposer d’autres tutoriels dans ce genre avec des cas plus concrets à l’avenir. 😉

Portez-vous bien et à bientôt !


Source : developpers.google.com

Si vous avez trouvé une faute d’orthographe, merci de nous en informer en sélectionnant le texte en question et en appuyant sur « Ctrl + Entrée« .

Leave A Response

* Denotes Required Field