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.

[toc]

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.

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.

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.

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.

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 ».

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.

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. 🙂

Pour conclure…

Voilà pour ce premier aperçu de Google Apps Script avec la création d’un script permettant d’avoir une idée du fonctionnement et du potentiel de cette solution. Mais comme vous pouvez le constater, cela demande d’acquérir des connaissances en JavaScript pour réaliser ce genre de scripts.

J’espère que cet article vous aura permis de commencer de façon simple et ludique avec Apps Script. Je tâcherai 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