Automatiser un rapport Google Sheets avec un déclencheur horaire Apps Script
Planifiez l'envoi d'un rapport par e-mail : copie de feuille, export PDF ou synthèse calculée, grâce aux déclencheurs temporels Google Apps Script.
Emmanuel Sauvage 5 min de lecture
Recevoir chaque semaine un export frais sans ouvrir le classeur : c’est le scénario classique des déclencheurs temporels (time-driven triggers) dans Google Apps Script. Couplés à MailApp ou GmailApp, ils transforment une feuille de calcul en source de rapports planifiés.
Ce que fait (et ne fait pas) un déclencheur horaire
Un déclencheur appelle une fonction nommée à intervalle fixe ou à une heure précise. Il ne « surveille » pas les modifications en temps réel : pour cela, il faudrait un déclencheur on change ou un flux externe. Pour un rapport périodique, le temporel convient : vous contrôlez la fenêtre de données (hier, semaine écoulée, mois clos).
Limite pratique : le script doit terminer dans le délai d’exécution imparti par Google. Un rapport qui recalcule tout le classeur ou parcourt des milliers de lignes sans filtre peut échouer silencieusement si vous ne consultez pas les journaux.
Architecture type
- Lecture : onglet source, plage nommée ou requête
QUERYmatérialisée. - Transformation : agrégations, formatage, éventuelle copie vers un onglet « Rapport » dédié.
- Diffusion : e-mail avec corps HTML, pièce jointe PDF ou lien vers copie datée.
Séparer l’onglet « Rapport » du onglet « Données brutes » évite d’envoyer des colonnes sensibles et stabilise la mise en page du PDF.
Exemple : rapport quotidien par e-mail avec PDF
const SPREADSHEET_ID = "REMPLACER_PAR_ID";
const REPORT_SHEET = "Rapport";
const RECIPIENTS = "equipe@example.com";
function sendDailyReport() {
const ss = SpreadsheetApp.openById(SPREADSHEET_ID);
const sheet = ss.getSheetByName(REPORT_SHEET);
if (!sheet) {
throw new Error("Onglet Rapport introuvable");
}
refreshReportData_(ss);
SpreadsheetApp.flush();
const pdfBlob = exportSheetAsPdf_(ss.getId(), sheet.getSheetId());
const fileName =
"rapport-" + Utilities.formatDate(new Date(), Session.getScriptTimeZone(), "yyyy-MM-dd") + ".pdf";
const subject = "Rapport quotidien — " + formatDateFr_(new Date());
const body =
"Bonjour,\n\nVeuillez trouver ci-joint le rapport généré automatiquement.\n\n— Automatisation Sheets";
MailApp.sendEmail({
to: RECIPIENTS,
subject: subject,
body: body,
attachments: [pdfBlob.setName(fileName)],
});
}
function refreshReportData_(ss) {
const dataSheet = ss.getSheetByName("Données");
const reportSheet = ss.getSheetByName("Rapport");
const lastRow = dataSheet.getLastRow();
if (lastRow < 2) {
reportSheet.getRange("A2:Z").clearContent();
return;
}
const values = dataSheet.getRange(2, 1, lastRow - 1, dataSheet.getLastColumn()).getValues();
const yesterday = startOfDay_(new Date());
yesterday.setDate(yesterday.getDate() - 1);
const filtered = values.filter(function (row) {
const cellDate = row[0] instanceof Date ? row[0] : new Date(row[0]);
return cellDate >= yesterday && cellDate < startOfDay_(new Date());
});
reportSheet.getRange(2, 1, Math.max(filtered.length, 1), filtered[0] ? filtered[0].length : 1).clearContent();
if (filtered.length) {
reportSheet.getRange(2, 1, filtered.length, filtered[0].length).setValues(filtered);
}
}
function exportSheetAsPdf_(spreadsheetId, sheetId) {
const url =
"https://docs.google.com/spreadsheets/d/" +
spreadsheetId +
"/export?format=pdf&size=A4&portrait=true&fitw=true&sheetnames=false&printtitle=false&pagenumbers=false&gridlines=false&fzr=false&gid=" +
sheetId;
const token = ScriptApp.getOAuthToken();
const response = UrlFetchApp.fetch(url, {
headers: { Authorization: "Bearer " + token },
muteHttpExceptions: true,
});
if (response.getResponseCode() !== 200) {
throw new Error("Export PDF échoué : " + response.getContentText());
}
return response.getBlob();
}
function startOfDay_(d) {
const x = new Date(d);
x.setHours(0, 0, 0, 0);
return x;
}
function formatDateFr_(d) {
return Utilities.formatDate(d, Session.getScriptTimeZone(), "dd/MM/yyyy");
}
Adaptez la colonne de date et les filtres à votre modèle. Exécutez sendDailyReport une fois manuellement pour accorder les autorisations.
Alternative : copie archivée au lieu du PDF
Pour permettre la reprise des chiffres, créez chaque semaine une copie du fichier :
function archiveWeeklyCopy() {
const ss = SpreadsheetApp.openById(SPREADSHEET_ID);
const folder = DriveApp.getFolderById("ID_DOSSIER_ARCHIVES");
const name =
ss.getName() +
" — " +
Utilities.formatDate(new Date(), Session.getScriptTimeZone(), "yyyy-MM-dd");
const copy = DriveApp.getFileById(ss.getId()).makeCopy(name, folder);
MailApp.sendEmail(
RECIPIENTS,
"Archive hebdomadaire disponible",
"Copie créée : " + copy.getUrl(),
);
}
L’e-mail reste léger ; les destinataires ouvrent la version figée dans Drive.
Installer le déclencheur horaire
Dans l’éditeur Apps Script :
- Déclencheurs (icône réveil) → Ajouter un déclencheur.
- Fonction :
sendDailyReportouarchiveWeeklyCopy. - Source : Temporel.
- Type : minuteur quotidien (heure choisie) ou minuteur hebdomadaire.
Vous pouvez aussi créer le déclencheur par code pour le versionner :
function installDailyTrigger() {
const handler = "sendDailyReport";
ScriptApp.getProjectTriggers().forEach(function (t) {
if (t.getHandlerFunction() === handler) {
ScriptApp.deleteTrigger(t);
}
});
ScriptApp.newTrigger(handler)
.timeBased()
.everyDays(1)
.atHour(7)
.create();
}
Exécutez installDailyTrigger une seule fois après déploiement.
Fiabilité et exploitation
- Fuseau horaire : réglez le fuseau du projet (Fichier → Paramètres) pour que « 7 h » corresponde à votre métropole.
- Journal : une feuille
Logavec horodatage, statut et message d’erreur accélère le support. - Destinataires dynamiques : lisez une petite table « Abonnés rapport » plutôt que des adresses en dur dans le script.
- Échec d’envoi :
MailAppa des quotas journaliers ; fractionnez les listes ou utilisez un relais externe si vous dépassez les limites du compte Google Workspace.
Aller plus loin dans la maîtrise des feuilles
Les déclencheurs horaires sont un bon terrain d’entraînement : plages nommées, export Drive, gestion d’erreurs. Pour structurer ces acquis en équipe — bonnes pratiques de classeur, gouvernance des scripts, passage à l’échelle — une formation ciblée sur Google Sheets permet d’aligner technique et usage métier.
En résumé : un onglet « Rapport » dédié, une fonction d’envoi testée à la main, puis un déclencheur temporel bien choisi suffisent pour automatiser la diffusion sans dépendre d’un export manuel chaque lundi matin.
Questions fréquentes
- Quelle fréquence choisir pour un déclencheur horaire ?
- Commencez par une cadence alignée sur le besoin métier (quotidien le matin, hebdomadaire le lundi). Évitez des intervalles trop courts : chaque exécution consomme du quota et peut chevaucher la précédente si le traitement est long.
- Puis-je envoyer le classeur entier en pièce jointe ?
- Oui en exportant en PDF ou XLSX via DriveApp, ou en joignant une copie générée. Pour de gros fichiers, préférez un lien vers une copie archivée dans un dossier partagé.
- Le déclencheur fonctionne-t-il si je suis déconnecté ?
- Oui : le script s'exécute sous l'identité du propriétaire du déclencheur, avec les autorisations accordées au moment de la première exécution manuelle.
- Comment déboguer un rapport vide ?
- Exécutez la fonction manuellement depuis l'éditeur, consultez Exécutions récentes, et journalisez les plages lues et le nombre de lignes traitées dans une feuille de log dédiée.