Je eerste Apps Script schrijven is verrassend eenvoudig: je hebt alleen een browser en een Google-account nodig. In deze stap-voor-stap-gids ga je van een leeg project naar een werkende functie die je begrijpt. Onderweg leer je de editor kennen, hoe logging werkt en waarom Google om toestemming vraagt.
De editor openen en een project maken
Er zijn twee plekken waar je een Apps Script begint. Voor een los script ga je naar script.google.com en klik je op Nieuw project. Wil je een script dat bij een bepaald bestand hoort, open dan dat bestand (bijvoorbeeld een Spreadsheet) en kies Extensies, daarna Apps Script. De editor die opent heeft links een bestandsoverzicht, in het midden je code en bovenaan knoppen om op te slaan, uit te voeren en te debuggen.
Geef je project meteen een herkenbare naam. Klik bovenaan op Naamloos project, typ een naam en klik op Naam wijzigen. Zo vind je het later terug tussen je andere projecten op script.google.com.
Standaardfunctie
Een nieuw project bevat altijd een lege functie myFunction(). Je mag die hernoemen of vervangen. De naam van een functie mag geen spaties bevatten en begint met een letter.
Je eerste functie schrijven
Een functie is een blok code met een naam dat je kunt uitvoeren. Vervang de standaardinhoud door dit voorbeeld:
function begroet() {
const naam = 'Patrick';
const bericht = 'Hallo ' + naam + ', je eerste script werkt!';
Logger.log(bericht);
}
Logger.log() schrijft tekst naar het uitvoeringslogboek. Dat is jouw belangrijkste hulpmiddel om te zien wat er gebeurt. De const betekent dat de waarde niet verandert; voor waarden die wel veranderen gebruik je let.
Van code naar resultaat
- Plak de functie
begroetin de editor. - Klik op het diskette-icoon of druk op Ctrl+S (Cmd+S op Mac) om op te slaan.
- Selecteer bovenaan de functie
begroetin de dropdown. - Klik op Uitvoeren.
- Open onderaan het uitvoeringslogboek en lees je begroeting.
Toestemming geven
Zodra je script een Google-dienst aanspreekt (zoals Gmail of Sheets), vraagt Google je om autorisatie. De eerste keer verschijnt een venster waarin je je account kiest en de gevraagde rechten goedkeurt. Dit heet scopes: precies omschreven toegang, bijvoorbeeld het recht om mails te versturen. Tegenwoordig kun je op het toestemmingsscherm zelfs per scope aangeven wat je wel en niet toestaat. Het voorbeeld hierboven met alleen Logger vraagt nog geen extra rechten, maar zodra je het uitbreidt wel.
Autoriseer alleen wat je vertrouwt
Geef alleen toestemming aan scripts die je zelf schrijft of die je vertrouwt. Een script met Gmail-rechten kan namens jou mails lezen en sturen. Controleer bij scripts van anderen altijd de broncode voordat je autoriseert.
Iets nuttigs laten doen
Logging is leuk om te leren, maar je wilt resultaat. Breid de functie uit zodat hij jou een mail stuurt:
function stuurTestmail() {
const mijnAdres = Session.getActiveUser().getEmail();
GmailApp.sendEmail(
mijnAdres,
'Mijn eerste script',
'Dit bericht is automatisch verstuurd door mijn eerste Apps Script.'
);
Logger.log('Mail verstuurd naar ' + mijnAdres);
}
Session.getActiveUser().getEmail() haalt jouw eigen adres op. GmailApp.sendEmail() doet het echte werk. Als je deze functie de eerste keer uitvoert, vraagt Google om toestemming voor Gmail.
Vastgelopen op autorisatie?
Krijg je een foutmelding over autorisatie? Voer het script opnieuw uit en doorloop het toestemmingsvenster volledig. Klik bij de waarschuwing op Geavanceerd en daarna op Ga naar project, want voor je eigen scripts is dat veilig.
Het uitvoeringslogboek lezen
Onder in de editor verschijnt na elke run het uitvoeringslogboek. Daar zie je je Logger.log-regels, de starttijd, de duur en eventuele fouten. Dit is de plek waar je naartoe gaat als iets niet werkt. In het artikel Apps Script debuggen gaan we hier dieper op in.
Waar sla ik mijn script op?
Automatisch in je Google Drive, gekoppeld aan je account. Je hoeft niets te downloaden. Met Ctrl+S sla je tussentijds op.
Waarom vraagt Google om toestemming?
Omdat je script bij je data komt. Google laat je vooraf precies zien welke rechten nodig zijn, zodat jij bewust akkoord gaat.
Kan ik meerdere functies in een project zetten?
Ja. Een project kan tientallen functies bevatten, verdeeld over meerdere bestanden. Je kiest bij het uitvoeren welke functie draait.
Wat als ik een typefout maak?
Dan zie je een rode foutmelding in het logboek met het regelnummer. Corrigeer de regel en voer opnieuw uit.
Moet ik JavaScript kennen om te beginnen?
Een beetje helpt, maar voor je eerste script is het niet nodig. Apps Script gebruikt gewoon JavaScript, dus voorbeelden kopieren en aanpassen is een prima manier om te leren.
Werkt mijn script ook als ik mijn computer uitzet?
Ja, want de code draait op de servers van Google, niet op jouw computer. Met een trigger kun je een script zelfs op vaste tijden automatisch laten draaien.
Volgende stap
Je weet nu hoe je een project maakt, code schrijft, autoriseert en het resultaat controleert. De logische vervolgstap is data verwerken: lees gegevens uit een spreadsheet in gegevens lezen uit een Spreadsheet. Daarmee leg je de basis voor echte automatisering.