Si vous utilisez des services Google tels que Google Docs, Google Sheets, Google Analytics, Gmail et autres, vous pouvez connecter et automatiser ces services à l'aide de Google Apps Script.
Pensez à Google Apps Script comme à la version Le script VBA de Microsoft de Google. Tout comme vous pouvez automatiser des actions et des tâches ou personnaliser des macros dans Microsoft Word et Exceller avec VBA, vous pouvez automatiser des tâches et des actions dans les services Google. Dans des services comme Sheets et Docs, vous pouvez même rédiger vos propres menus personnalisés.
Dans cet article, vous apprendrez comment accéder à Apps Script et l'activer dans votre divers services Google, comment naviguer dans l'éditeur Apps Script et comment connecter des services. Vous n'en aurez pas apprendre des fonctions de script spécifiques, mais Google propose une excellente documentation et des didacticiels sur les scripts d'applications pour apprendre à écrire des scripts d'applications.
Comment accéder à l'éditeur de script Google Apps
Vous pouvez ouvrir l'éditeur de code Google Apps Script à partir d'un certain nombre de services Google. Par exemple, vous trouverez Apps Script dans le menu Extensions de Google Sheets.
Dans d'autres services, vous pouvez ouvrir l'éditeur de script Google Apps des manières suivantes :
En utilisant l'une de ces méthodes, l'éditeur de code Apps Script s'ouvre dans un nouvel onglet. C'est la fenêtre dans laquelle vous écrirez chacune des fonctions qui composent l'intégralité de votre script. Par défaut, vous verrez une fonction vide nommée myFunction() qui est prête à commencer à remplir votre code.
Remarque : le formatage du code est très important afin d'éviter les erreurs. Utilisez les commentaires comme indiqué dans le code suivant pour vous rappeler ce que vous essayiez de faire dans les sections du code. Ceci est très similaire au fonctionnement des commentaires dans le code HTML avec la programmation Web..
Lorsque vous parcourez l'éditeur de code, vous pouvez revenir à cette section en sélectionnant Code.gs dans le volet de navigation de gauche de la fenêtre Éditeur . Pour voir les autres fenêtres disponibles, survolez les icônes dans le volet le plus à gauche et le volet de navigation principal s'ouvrira.
La section Vue d'ensemble vous permet de trouver des statistiques sur votre script, telles que le nombre d'erreurs survenues, le nombre de fois qu'il a été exécuté, et bien plus encore.
Nous aborderons chacune des autres sections de l'éditeur de script Google Apps dans chaque section ci-dessous.
Navigation dans l'éditeur de script Google Apps
Lorsque vous modifiez votre code dans l'éditeur, c'est une bonne idée de sélectionner souvent l'icône du disque (Enregistrer) afin de ne pas perdre votre travail.
Une fois enregistré, vous verrez les autres options du menu s'allumer.
Il s'agit notamment :
L'option Bibliothèques dans le menu de navigation de gauche vous permet d'accéder aux bibliothèques que d'autres personnes ont écrites (ou que vous avez écrites et enregistrées ailleurs). Ceci est utile si vous avez un ami qui a déjà écrit une fonctionnalité que vous aimeriez utiliser dans Google Sheets ou Google Docs, mais que vous souhaitez ajouter des fonctionnalités supplémentaires en plus de cela.
Tout ce dont vous avez besoin pour ajouter ces bibliothèques à votre projet est l'ID de script. Vous pouvez le trouver dans la section des paramètres du projet, que nous vous montrerons comment trouver vers la fin de cet article.
Modules complémentaires des services de script Google Apps
La section Services est la plus utile. C'est ici que vous pouvez intégrer votre script actuel avec d'autres services Google que vous pouvez utiliser.
Lorsque vous le sélectionnez, la fenêtre Ajouter un service s'ouvre. Faites défiler jusqu'au service que vous souhaitez utiliser comme module complémentaire à votre projet existant..
Par exemple, si vous souhaitez extraire des données de votre compte Google Analytics dans ce script, vous pouvez sélectionner l'API Google Analytics , puis sélectionner Ajouter .
Si vous souhaitez trouver des détails sur les fonctions disponibles pour ce nouveau service complémentaire et comment les utiliser, sélectionnez les trois points à droite de l'API et sélectionnez Voir la documentation . .
Cela ouvrira la documentation Google Apps Script dans un nouvel onglet, ouvert automatiquement à la section relative à ce service Google.
Explorez la documentation pour découvrir la syntaxe des fonctions, les didacticiels et les exemples de code que vous pouvez utiliser dans votre propre script.
Notez également que vous pouvez accéder à d'autres sections de la documentation pour voir quelles fonctions générales sont disponibles dans votre script en fonction du service que vous utilisiez lorsque vous avez initialement ouvert l'éditeur de code Apps Script.
Par exemple, si vous avez ouvert l'éditeur dans Google Sheets, consultez la section Sheets du menu de documentation pour connaître les fonctions Google Sheets que vous pouvez utiliser dans votre script.
Configuration et utilisation des déclencheurs Apps Script
Une autre fonctionnalité utile de Google Apps Script est la possibilité de définir des déclencheurs en fonction d'un certain nombre d'événements ou de calendriers.
Pour configurer un nouveau déclencheur pour votre script, sélectionnez Déclencheurs dans le menu de navigation le plus à gauche. Dans la nouvelle fenêtre Déclencheurs qui s'ouvre, sélectionnez le bouton Ajouter un déclencheur .
La fenêtre Ajouter un déclencheur contient une longue liste d'options qui vous aident à personnaliser exactement comment et quand vous souhaitez que votre script s'exécute.
Remarque : La plupart de ces options dépendent du service pour lequel vous écrivez votre script ou les API que vous avez ajoutées.
Pour configurer votre déclencheur, vous devrez choisir :
Une fois que vous avez sélectionné Enregistrer , vous pouvez voir un message « Échec de l'autorisation du script » si c'est la première fois que vous enregistrez un nouveau déclencheur.
Ceci est généralement déclenché si un bloqueur de pop-up est activé dans votre navigateur. Si vous utilisez Google Chrome, sélectionnez simplement la petite icône de fenêtre avec un « X » rouge dessus. Modifiez le paramètre sur Toujours autoriser les fenêtres contextuelles et sélectionnez Terminé .
Lorsque vous sélectionnez à nouveau Enregistrer , vous devrez suivre le processus pour autoriser l'exécution du script que vous avez écrit sous votre compte Google ou Google Workspace.
Tout d'abord, sélectionnez le compte Google sous lequel vous souhaitez autoriser l'exécution de votre script.
Un avertissement s'affichera indiquant que la fonction ou le script personnalisé que vous avez écrit n'est pas « vérifié » par Google. Si vous êtes la personne qui a écrit le script, cela n'a pas d'importance et vous pouvez l'exécuter en toute sécurité sous votre propre compte Google ou Google Workspace.
Pour contourner cet avertissement, sélectionnez simplement Avancé , puis sélectionnez le lien Aller au
Enfin, dans la fenêtre des autorisations, sélectionnez Autoriser pour autoriser l'exécution de vos fonctions et scripts personnalisés sous votre compte Google ou Google Workspace.
Vous n'aurez pas à répéter ce processus, mais uniquement la première fois que vous enregistrerez ou exécuterez vos projets de script Google Apps personnalisés.
Accès à votre identifiant de script Google
Une dernière remarque : vous souhaiterez peut-être fournir votre script à des amis ou des collègues afin qu'ils puissent soit l'utiliser, soit l'ajouter en tant que bibliothèque à leur propre script.
Vous pouvez trouver votre ID de script sous l'icône Paramètres dans le volet de navigation le plus à gauche.
L'ID du script se trouve dans la section ID , à droite de l'ID du script .
Comme vous pouvez le constater, l'éditeur de script Google Apps est assez simple si vous savez comment accéder à chaque fonctionnalité que vous souhaitez utiliser. Assurez-vous simplement de bien étudier la documentation Apps Script de Google afin de pouvoir commencer à apprendre à écrire vos scripts et toutes les fonctions disponibles.
.