GmailApp voor e-mailautomatisering

Introductie tot GmailApp

GmailApp geeft je programmatische toegang tot Gmail vanuit Apps Script. Je kunt e-mails versturen, threads beheren, labels toewijzen en bijlagen verwerken. Dit maakt het ideaal voor het automatiseren van notificaties, rapporten en inbox-workflows.

De service werkt op het account van de uitvoerende gebruiker. Wil je e-mail versturen namens een ander adres, dan moet dat adres als afzender zijn ingesteld in Gmail onder "Verzenden als".

E-mails versturen

function stuurBasisMail() {
  GmailApp.sendEmail(
    'ontvanger@voorbeeld.nl',
    'Onderwerp van de mail',
    'Dit is de platte tekst versie.'
  );
}

function stuurHtmlMail() {
  const opties = {
    htmlBody: '<h1>Welkom</h1><p>Dit is een <strong>HTML</strong> e-mail.</p>',
    cc: 'cc@voorbeeld.nl',
    bcc: 'bcc@voorbeeld.nl',
    replyTo: 'antwoord@voorbeeld.nl',
    name: 'Automatisch Rapportsysteem',
  };

  GmailApp.sendEmail(
    'ontvanger@voorbeeld.nl',
    'HTML Rapport',
    'Platte tekst fallback',
    opties
  );
}

Bijlagen toevoegen

function stuurMetBijlage() {
  const spreadsheet = SpreadsheetApp.openById('SPREADSHEET_ID');
  const pdf = spreadsheet.getAs('application/pdf');
  pdf.setName('rapport.pdf');

  const bestand = DriveApp.getFileById('BESTAND_ID');

  GmailApp.sendEmail(
    'ontvanger@voorbeeld.nl',
    'Rapport bijgevoegd',
    'Zie bijlage',
    {
      attachments: [pdf, bestand.getBlob()],
      htmlBody: '<p>Zie bijgevoegd rapport.</p>',
    }
  );
}

E-mails zoeken en lezen

function zoekMails() {
  const threads = GmailApp.search('from:klant@voorbeeld.nl is:unread', 0, 50);

  threads.forEach(thread => {
    const berichten = thread.getMessages();
    berichten.forEach(bericht => {
      const onderwerp = bericht.getSubject();
      const afzender = bericht.getFrom();
      const datum = bericht.getDate();
      const tekst = bericht.getPlainBody();

      Logger.log(`${datum} | ${afzender} | ${onderwerp}`);
      Logger.log(tekst.substring(0, 200));
    });
  });
}

De zoeksyntax van GmailApp.search() is identiek aan de zoekbalk in Gmail. Je kunt gebruikmaken van from:, to:, subject:, has:attachment, label:, is:unread, after:, before: en alle andere Gmail-operatoren.

Labels beheren

function beheerLabels() {
  const label = GmailApp.getUserLabelByName('Verwerkt')
    || GmailApp.createLabel('Verwerkt');

  const threads = GmailApp.search('subject:Orderbevestiging is:unread');

  threads.forEach(thread => {
    thread.addLabel(label);
    thread.markRead();
  });
}

function verwijderLabel() {
  const label = GmailApp.getUserLabelByName('OudLabel');
  if (label) {
    label.deleteLabel();
  }
}

Bijlagen verwerken

function verwerkBijlagen() {
  const threads = GmailApp.search('has:attachment subject:Factuur');
  const map = DriveApp.getFolderById('MAP_ID');

  threads.forEach(thread => {
    thread.getMessages().forEach(bericht => {
      bericht.getAttachments().forEach(bijlage => {
        if (bijlage.getContentType() === 'application/pdf') {
          map.createFile(bijlage);
          Logger.log(`Opgeslagen: ${bijlage.getName()}`);
        }
      });
      bericht.markRead();
    });
  });
}

Thread-bewerkingen

function threadBewerkingen() {
  const threads = GmailApp.search('older_than:30d label:Verwerkt');

  threads.forEach(thread => {
    thread.moveToTrash();
  });

  const inboxThreads = GmailApp.getInboxThreads(0, 10);
  inboxThreads.forEach(thread => {
    const berichtAantal = thread.getMessageCount();
    const eersteOnderwerp = thread.getFirstMessageSubject();
    Logger.log(`${eersteOnderwerp} (${berichtAantal} berichten)`);
  });
}

Automatisch bijlagen opslaan in Drive

E-mailworkflow met Sheets koppelen

Een veelgebruikt patroon is het genereren van gepersonaliseerde e-mails op basis van data in een spreadsheet:

function mailMerge() {
  const blad = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Ontvangers');
  const data = blad.getDataRange().getValues();

  const headers = data[0];
  const naamIdx = headers.indexOf('Naam');
  const emailIdx = headers.indexOf('E-mail');
  const verzondenIdx = headers.indexOf('Verzonden');

  for (let i = 1; i < data.length; i++) {
    if (data[i][verzondenIdx] === true) continue;

    const naam = data[i][naamIdx];
    const email = data[i][emailIdx];

    GmailApp.sendEmail(email, 'Persoonlijk bericht', `Beste ${naam},`);
    blad.getRange(i + 1, verzondenIdx + 1).setValue(true);

    Utilities.sleep(100);
  }
}

De Utilities.sleep(100) geeft Apps Script een kleine adempauze en vermindert het risico op quota-fouten bij grote lijsten. Door de kolom "Verzonden" bij te werken voorkom je dubbele verzendingen als het script halverwege stopt.