Introduction
Google Apps Script permet d'automatiser les outils Google Workspace comme Sheets, Docs ou Gmail sans serveur externe. Ce tutoriel vous guide pas à pas pour créer vos premiers scripts. Vous apprendrez à lire et écrire des données dans Sheets, ajouter des menus personnalisés et envoyer des emails automatiques. Idéal pour les débutants, chaque étape inclut du code complet et prêt à l'emploi. L'objectif est de transformer des tâches manuelles répétitives en processus automatisés en quelques minutes.
Prérequis
- Un compte Google gratuit
- Accès à Google Sheets
- Connaissances basiques de JavaScript
- Navigateur web moderne
Créer le projet Apps Script
function helloWorld() {
console.log('Bonjour depuis Google Apps Script !');
}
helloWorld();Cette fonction simple affiche un message dans la console. Ouvrez l'éditeur de script depuis Extensions > Apps Script dans votre Sheet.
Première exécution
Sauvegardez le script puis cliquez sur Exécuter. Autorisez les permissions la première fois. Le message apparaît dans le journal d'exécution.
Lire des données Sheets
function lireDonnees() {
const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
const range = sheet.getRange('A1:B5');
const values = range.getValues();
console.log(values);
}Ce code récupère les valeurs des cellules A1 à B5 et les affiche. Adaptez la plage selon vos besoins.
Écrire des données
function ecrireDonnees() {
const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
sheet.getRange('C1').setValue('Total');
sheet.getRange('C2').setValue(150);
}Cette fonction écrit du texte et un nombre dans des cellules précises. Très utile pour générer des rapports automatiques.
Ajouter un menu personnalisé
function onOpen() {
const ui = SpreadsheetApp.getUi();
ui.createMenu('Mon Menu')
.addItem('Lire données', 'lireDonnees')
.addItem('Écrire données', 'ecrireDonnees')
.addToUi();
}La fonction onOpen s'exécute automatiquement à l'ouverture du fichier. Elle ajoute un menu personnalisé dans l'interface Sheets.
Envoyer un email automatique
function envoyerEmail() {
const email = 'destinataire@example.com';
const sujet = 'Rapport automatique';
const corps = 'Voici les données du jour.';
GmailApp.sendEmail(email, sujet, corps);
}Ce script envoie un email via Gmail. Testez avec votre propre adresse avant de l'automatiser.
Bonnes pratiques
- Toujours tester les scripts sur une copie du fichier
- Utiliser des noms de fonctions clairs et descriptifs
- Ajouter des commentaires dans le code
- Gérer les erreurs avec try/catch
- Limiter les appels API pour éviter les quotas
Erreurs courantes
- Oublier d'autoriser les permissions OAuth
- Utiliser des plages incorrectes qui provoquent des erreurs
- Ne pas déclencher onOpen correctement
- Dépasser les quotas d'exécution quotidiens
Pour aller plus loin
Découvrez nos formations complètes sur l'automatisation Google Workspace : https://learni-group.com/formations