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 . 

Considérez Google Apps Script comme la version Google du script VBA de Microsoft^{(Microsoft’s VBA script)} . Tout comme vous pouvez automatiser des actions et des tâches ou personnaliser des macros dans Microsoft Word et Excel avec VBA^{(Excel with VBA)} , vous pouvez automatiser des tâches et des actions dans les services Google . Dans des services tels que Sheets et Docs , vous pouvez même écrire vos propres menus personnalisés.

Dans cet article, vous apprendrez comment accéder à Apps Script et l'activer dans vos différents services Google^{(various Google services)} , comment naviguer dans Apps Script Editor et comment connecter des services. Vous n'apprendrez pas de fonctions de script spécifiques^{(learn specific script functions)} , mais Google propose une excellente documentation et des didacticiels sur les scripts d'applications pour apprendre à écrire Apps Script .

Comment accéder à l'éditeur de script Google Apps^{(Access Google Apps Script Editor)}

Vous pouvez ouvrir l' éditeur de code Google Apps Script à partir d'un certain nombre de services ^{(Google Apps Script)}Google . Par exemple, vous trouverez Apps Script dans le menu Extensions de Google Sheets.

Dans d'autres services, vous pouvez ouvrir l' éditeur Google Apps Script des manières suivantes :

• Google Docs : sélectionnez Éditeur de script^{(Script editor)} dans le menu Outils .^(Tools)
• Google Slides : sélectionnez Éditeur de script^{(Script editor)} dans le menu Outils .^(Tools)
• Google Forms : sélectionnez Éditeur de script^{(Script editor)} dans le menu à trois points.
• Google Drive : cliquez avec le bouton droit sur un espace vide, sélectionnez Plus^(More) , puis sélectionnez Google Apps Script .

En utilisant l'une de ces méthodes, vous verrez l' éditeur de code Apps Script s'ouvrir dans un nouvel onglet. C'est la fenêtre où vous écrirez chacune des fonctions qui composent votre script entier. Par défaut, vous verrez une fonction vide nommée myFunction() qui est prête pour que vous commenciez à remplir votre code.

Remarque^(Note) : 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 à l'intérieur des sections de code. Ceci est très similaire au fonctionnement des commentaires dans le code HTML avec la programmation Web.

Lorsque vous naviguez dans 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 de l' éditeur^(Editor) . 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^(Overview) d'ensemble est l'endroit où vous pouvez trouver des statistiques sur votre script, comme le nombre d'erreurs qui se sont produites, le nombre de fois qu'il a été exécuté, etc.

Nous couvrirons chacune des autres sections de l' éditeur Google Apps Script dans chaque section ci-dessous.^{(Google Apps Script)}

Navigation dans l' éditeur de script Google Apps^{(Google Apps Script Editor)}

Lorsque vous modifiez votre code dans l'éditeur, il est conseillé de sélectionner souvent l'icône du disque ( Enregistrer^(Save) ) afin de ne pas perdre votre travail.

Une fois enregistré, vous verrez les autres options de menu s'allumer. 

Ceux-ci inclus:

• Exécuter^(Run) : Essayez d'exécuter votre script entier du début à la fin.
• Debug : parcourez votre script une ligne à la fois.
• Liste déroulante des fonctions^{(Function dropdown)} : parcourez et accédez à chacune des fonctions que vous avez créées.
• Journal d'exécution^{(Execution log)} : consultez les messages d'état ou d'erreur de chaque tentative d'exécution de votre script.

L' option Bibliothèques^(Libraries) 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 vous souhaitez ajouter des fonctionnalités supplémentaires en plus de cela.

Tout ce dont vous avez besoin pour ajouter ces bibliothèques dans votre projet est le Script ID . 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 Google Apps Script Services

La section Services est la plus utile. C'est là que vous pouvez intégrer votre script actuel à d'autres services Google que vous pouvez utiliser. 

Lorsque vous le sélectionnez, la fenêtre Ajouter un service s'ouvre. ^{(Add a service)}Faites défiler^(Scroll) jusqu'au service que vous souhaitez utiliser comme complément à 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^{(Google Analytics API)} , puis sélectionner Ajouter^(Add) .

Si vous souhaitez trouver des détails sur les fonctions disponibles pour ce nouveau service complémentaire et sur la façon de les utiliser, sélectionnez les trois points à droite de l' API et sélectionnez Voir la documentation^{(See documentation)} .

Cela ouvrira la documentation de Google Apps Script dans un nouvel onglet, ouvert automatiquement à la section de ce service Google .

Explorez la documentation pour 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 , vérifiez la section Sheets dans le menu de documentation pour les fonctions Google Sheets que vous pouvez utiliser dans votre script.

Configuration et utilisation des déclencheurs de script Apps^{(Using Apps Script Triggers)}

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^(Triggers) dans le menu de navigation à l'extrême gauche. Dans la nouvelle fenêtre Déclencheurs qui s'ouvre, sélectionnez le bouton ^(Triggers)Ajouter un déclencheur^{(Add Trigger)} .

La fenêtre Ajouter un déclencheur^{(Add Trigger)} contient une longue liste d'options qui vous aident à personnaliser exactement comment et quand vous voulez que votre script s'exécute. 

Remarque^(Note) : La plupart de ces options dépendent du service pour lequel vous écrivez votre script ou des API que vous avez ajoutées^{(the APIs that you’ve added)} .

Pour configurer votre déclencheur, vous devrez choisir :

• Quelle fonction lancer initialement
• La source de l'événement, telle qu'une heure, une date ou un événement spécifique dans votre service, comme lorsqu'une cellule de feuille de calcul Google change ou qu'un document est ouvert pour la première fois
• Le type d'événement, par exemple lorsqu'un élément de votre feuille de calcul ou document Google est ouvert ou modifié, ou le paramètre spécifique de date ou d'heure
• Fréquence de notification indiquant la fréquence à laquelle vous souhaitez recevoir des mises à jour sur l'échec de vos scripts

Une fois que vous avez sélectionné Enregistrer^(Save) , 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 vous avez activé un bloqueur de pop-up 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^{(Always allow pop-ups)} et sélectionnez Terminé^(Done) .

Lorsque vous sélectionnerez à nouveau Enregistrer^(Save) , 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'affiche 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^{(Google Account)} ou Google Workspace .

Pour contourner cet avertissement, sélectionnez simplement Avancé^(Advanced) , puis sélectionnez le lien Go to <project> (unsafe) en bas.

Enfin, dans la fenêtre des autorisations, sélectionnez Autoriser^(Allow) 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, uniquement la première fois que vous enregistrez ou exécutez vos projets de script  Google Apps personnalisés.^{(Google Apps)}

Accéder à votre identifiant Google Script

Une dernière note - vous voudrez peut-être fournir votre script à des amis ou à des collègues afin qu'ils puissent soit utiliser votre script, soit l'ajouter en tant que bibliothèque à leur propre script. 

Vous pouvez trouver votre ID de script^{(Script ID)} sous l' icône Paramètres dans le volet de navigation à l'extrême gauche.^(Settings)

L' ID de script^{(Script ID)} se trouve dans la section ID^(IDs) , à droite de l' ID de script^{(Script ID)} .

Comme vous pouvez le constater, l' éditeur de script Google Apps^{(Google Apps Script)} est assez simple si vous savez comment accéder à chaque fonctionnalité que vous souhaitez utiliser. Assurez-vous simplement^(Just) de bien étudier la documentation Google Apps Script afin de pouvoir commencer à apprendre à écrire vos scripts et toutes les fonctions disponibles.

Google Apps Script Editor: Everything You Need to Know to Get Started

If you use Google services like Goоgle Doсѕ, Google Sheets, Google Αnalytics, Gmail, and others, you could connect and automate those services using Google Apps Ѕcript. 

Think of Google Apps Script like Google’s version of Microsoft’s VBA script. Just like you can automate actions and tasks or customize macros in Microsoft Word and Excel with VBA, you can automate tasks and actions across Google services. In services like Sheets and Docs, you can even write your own custom menus.

In this article you will learn how to access and enable Apps Script in your various Google services, how to navigate the Apps Script Editor, and how to connect services. You won’t learn specific script functions, but Google has excellent documentation and apps script tutorials available to learn how to write Apps Script.

How to Access Google Apps Script Editor

You can open the Google Apps Script code editor from within a number of Google services. For example, you’ll find Apps Script in the Extensions menu inside Google Sheets.

In other services, you can open the Google Apps Script editor in the following ways:

• Google Docs: Select Script editor in the Tools menu.
• Google Slides: Select Script editor in the Tools menu.
• Google Forms: Select Script editor in the three-dot menu.
• Google Drive: Right-click any blank space, select More, and select Google Apps Script.

Using any of these methods, you’ll see the Apps Script code editor open in a new tab. This is the window where you’ll write each of the functions that make up your entire script. By default, you’ll see an empty function named myFunction() that’s ready for you to start filling in your code.

Note: Code formatting is very important in order to avoid errors. Use commenting as shown in the following code to remind yourself what you were trying to do inside sections of code. This is very similar to how commenting works in HTML code with web programming.

As you navigate the code editor, you can return to this section by selecting Code.gs in the left navigation pane in the Editor window. To see other available windows, hover over the icons in the far left pane and the main navigation pane will open.

The Overview section is where you can find statistics about your script like how many errors have occurred, how many times it’s executed, and more.

We’ll cover each of the other sections of the Google Apps Script editor in each section below.

Navigating the Google Apps Script Editor

As you edit your code in the editor, it’s a good idea to select the disk (Save) icon often so that you don’t lose your work.

Once saved, you’ll see the other menu options light up. 

These include:

• Run: Attempt to run your entire script from beginning to end.
• Debug: Step through your script one line at a time.
• Function dropdown: Browse through and navigate to each of the functions you’ve created.
• Execution log: See any status or error messages from each attempt you’ve made to run your script.

The Libraries option in the left navigation menu is where you can access libraries that other people have written (or you’ve written and saved elsewhere). This is useful if you have a friend who already wrote a feature you’d like to use in Google Sheets or Google Docs but you’d like to add additional features on top of that.

All you need to add those libraries into your project is the Script ID. You can find this in the project settings section, which we’ll show you how to find toward the end of this article.

Google Apps Script Services Add-Ons

The Services section is the most useful. It’s where you can integrate your current script with other Google services you may use. 

When you select it, you’ll see the Add a service window open. Scroll down to the service you want to use as an add-on to your existing project. 

For example, if you’d like to pull data from your Google Analytics account into this script, you can select the Google Analytics API, and select Add.

If you want to find details about what functions are available to use for that new add-on service and how to use them, select the three dots to the right of the API and select See documentation.

This will open the Google Apps Script documentation in a new tab, opened automatically to the section for that Google service.

Explore the documentation for function syntax, tutorials, and code examples that you can use in your own script.

Also, note that you can navigate to other sections of the documentation to see what general functions are available in your script based on the service you were using when you originally opened the Apps Script code editor.

For example, if you opened the editor in Google Sheets, check the Sheets section in the documentation menu for Google Sheets functions you’re able to use in your script.

Setting Up and Using Apps Script Triggers

Another useful feature in Google Apps Script is the ability to set triggers based on a number of events or schedules.

To configure a new trigger for your script, select Triggers from the far left navigation menu. In the new Triggers window that opens, select the Add Trigger button.

The Add Trigger window has a long list of options that help you customize exactly how and when you want your script to run. 

Note: Many of these options depend on the service you’re writing your script for or the APIs that you’ve added.

To set up your trigger, you’ll need to choose:

• Which function to initially launch
• The event source such as a specific time, date, or an event in your service like when a Google spreadsheet cell changes or a document is initially opened
• The event type such as when something in your Google spreadsheet or document is opened or edited, or the specific setting for date or time
• Notification frequency for how often you want to get updates about when your scripts have failed

Once you select Save, you may see a “Script authorization failed” message if it’s the first time you’ve saved a new trigger.

This is usually triggered if you have a pop-up blocker enabled in your browser. If you’re using Google Chrome, just select the small window icon with a red “X” over it. Change the setting to Always allow pop-ups and select Done.

When you select Save again, you’ll need to step through the process to authorize the script you’ve written to run under your Google account or Google Workspace.

First, select the Google account that you want to allow your script to run under.

You’ll see a warning that the custom function or script you wrote isn’t “verified” by Google. If you’re the person who wrote the script, then this doesn’t matter and it’s safe to run under your own Google Account or Google Workspace.

To bypass this warning, just select Advanced and then select the Go to <project> (unsafe) link at the bottom.

Finally, in the permissions window, select Allow to allow your custom functions and script to run under your Google account or Google Workspace.

You won’t have to repeat this process again, only the first time you save or run your custom Google Apps script projects. 

Accessing Your Google Script ID

One final note – you may want to provide your script to friends or colleagues so they can either use your script or add it as a library to their own script. 

You can find your Script ID under the Settings icon in the far left navigation pane.

The Script ID can be found under the IDs section, to the right of Script ID.

As you can see, the Google Apps Script editor is fairly straightforward if you know how to navigate to each feature you want to use. Just make sure to study Google’s Apps Script documentation well so that you can start learning how to write your scripts and all functions that are available to use.

Related posts

• Comment les applications expérimentales de Google peuvent vous aider à lutter contre la dépendance numérique

• Les 5 meilleures applications de filtrage de la lumière bleue pour Windows, Mac et Linux

• 5 applications portables que vous voulez absolument avoir sur votre clé USB

• Remplissage automatique de Google Chrome : un guide complet

• 4 meilleures applications logicielles de transfert de port et comment les utiliser

• Choses à considérer avant de créer votre propre wiki

• Quel est le meilleur service de conférence téléphonique - Les meilleures applications comparées

• Utilisez une ancienne webcam pour surveiller votre propriété gratuitement

• La récupération de fichiers Windows de Microsoft fonctionne-t-elle ? Nous l'avons testé.

• Meilleurs éditeurs Markdown : toutes les plateformes et en ligne

• Comment ripper vos DVD et Blu-Ray sans effort avec MakeMKV

• Les 4 meilleures alternatives à Google Chromecast

• Les 11 meilleures applications Microsoft Teams en 2022

• Comment l'application de bureau Signal peut aider à protéger votre vie privée

• Paramètres de contenu de Google Chrome : un guide complet

• 7 meilleures applications de dessin pour Windows

• Google Draw : un guide complet pour les débutants

• Les meilleures applications d'analyse WiFi pour Windows, iOS, macOS et Android

• Qu'est-ce que Microsoft Power Automate et des modèles gratuits à télécharger

• Déplacer, supprimer ou copier automatiquement des fichiers dans Windows