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.

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

réception de mail avec un script docs — Mail reçu par l’intermédiaire du script

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

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

Apps Script Code G Suite google Google Developper JavaScript

6 replies to "Apprendre à réaliser son premier Google Apps Script !"

blanc
23 décembre 2019

Si on veut accéder au document sur un site Web, ne faut-il pas publier le document pour qu’il soit « Public » ?

Répondre
- Régis
  24 décembre 2019
  
  Bonjour,
  
  C’est en effet l’une des possibilités!
  Il est également possible de donner accès à n’importe qui à un document Google en utilisant le partage par lien (en savoir plus).
  
  Répondre
Pô
11 février 2020

Bonjour,

J’ai créer des fonctions avec apps script pour un fichier sheet. J’ai mis une sideBar avec des boutons que je fait apparaître à l’ouverture avec un déclencheur. Ce code nécessite des autorisations que j’ai accepter et cela fonctionne très bien mais lorsque je partage ce fichier, les autre utilisateurs n’ont pas la sideBar à cause des autorisations. Est-il possible que la demande d’autorisation soit automatique à l’ouverture du fichier pour les personnes non autorisé?

Répondre
- Fabrice
  17 novembre 2021
  
  Bonjour,
  Avez vous eu une réponse ?
  
  Répondre
bertrand delcroix
16 octobre 2020

bonjour,

Merci pour votre site Tutorial concernant la fusion entre google doc et mail à l’aide du google app script. ça fonctionne suite à mon test.

Mon projet est d’installer le format de signature en HTML, attaché avec le google sheet, dans la paramètre de signature GMAIL.

J’ai développé une partie 75 % pour la présentation de la signature, traité par le google app script depuis le google sheet. ça marche . Et maintenant, j’ai beaucoup du mal à comprendre comment faire pour l’installer dans le paramètre de signature GMAIL.
Bien sur j’ai suivi les documentations google . dans l’ensemble, j’ai du mal à comprendre …

Avez vous le Tutorial sur ce sujet la ? ( à eviter le python car je ne le connais pas du tout.. )

D’avance, merci pour votre retour

Bien cordialement

Répondre
Shadow
27 octobre 2020

Bonjour,

J’aimerai récupérer et afficher la valeur d’une variable (que j’ai incrémentée dans un script) dans un custom dialog (en html donc) mais je n’y arrive pas et je ne trouve rien qui puisse m’aider sur internet.

Avez-vous une solution ?

Merci d’avance

Répondre