Een automatisch dashboard bouwen met Apps Script en Sheets

Waarom een Apps Script-dashboard?

Google Sheets is een uitstekend platform voor dashboards: eenvoudig te begrijpen voor eindgebruikers, krachtig genoeg voor complexe berekeningen en gemakkelijk te delen. Met Apps Script voeg je automatisering toe, zodat data automatisch wordt opgehaald en verwerkt zonder dat iemand handmatig iets hoeft te doen.

Typische toepassingen:

• Verkoopdashboard dat elke ochtend wordt bijgewerkt
• Website-statistieken vanuit een analytics-bron
• Social media-metrics
• Inventarisoverzicht vanuit een externe API

Stap 1: spreadsheet en script aanmaken

Stap 2: data ophalen via UrlFetchApp

function fetchApiData(url, apiKey) {
  var options = {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer ' + apiKey,
      'Content-Type': 'application/json'
    },
    muteHttpExceptions: true
  };

  var response = UrlFetchApp.fetch(url, options);
  var statusCode = response.getResponseCode();

  if (statusCode !== 200) {
    console.error('API fout: ' + statusCode + ' - ' + response.getContentText());
    return null;
  }

  return JSON.parse(response.getContentText());
}

Met muteHttpExceptions: true gooit Apps Script geen uitzondering bij een foutstatus, zodat je de respons zelf netjes kunt afhandelen in plaats van dat het script abrupt stopt.

Stap 3: data naar Sheets schrijven

function updateDataSheet(data) {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var dataSheet = ss.getSheetByName('Data');

  dataSheet.clearContents();

  var headers = ['Datum', 'Metriek', 'Waarde', 'Verandering'];
  dataSheet.getRange(1, 1, 1, headers.length).setValues([headers]);
  dataSheet.getRange(1, 1, 1, headers.length).setFontWeight('bold');

  var rows = data.map(function(item) {
    return [
      new Date(item.date),
      item.metric,
      item.value,
      item.change
    ];
  });

  if (rows.length > 0) {
    dataSheet.getRange(2, 1, rows.length, headers.length).setValues(rows);
    dataSheet.getRange(2, 1, rows.length, 1).setNumberFormat('dd/mm/yyyy');
  }

  dataSheet.autoResizeColumns(1, headers.length);
}

Stap 4: dashboard-tabblad bijwerken

function updateDashboard() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var dashboardSheet = ss.getSheetByName('Dashboard');

  var bijgewerktOp = new Date().toLocaleString('nl-NL', {
    timeZone: 'Europe/Amsterdam'
  });
  dashboardSheet.getRange('B1').setValue('Bijgewerkt: ' + bijgewerktOp);

  var dataSheet = ss.getSheetByName('Data');
  var lastRow = dataSheet.getLastRow();

  if (lastRow < 2) return;

  var data = dataSheet.getRange(2, 1, lastRow - 1, 4).getValues();

  var totaal = data.reduce(function(som, rij) {
    return som + (rij[2] || 0);
  }, 0);

  dashboardSheet.getRange('B3').setValue(totaal);
  dashboardSheet.getRange('B4').setValue(lastRow - 1);
}

Stap 5: hoofdfunctie samenstellen

function runDashboardUpdate() {
  console.log('Dashboard update gestart: ' + new Date());

  var apiKey = PropertiesService.getScriptProperties().getProperty('API_KEY');
  var apiUrl = 'https://api.voorbeeld.com/v1/metrics?period=30days';

  var data = fetchApiData(apiUrl, apiKey);

  if (!data) {
    console.error('Geen data ontvangen, update gestopt.');
    return;
  }

  updateDataSheet(data.items || []);
  updateDashboard();

  console.log('Dashboard update voltooid.');
}

Stap 6: tijdgestuurde trigger instellen

De trigger draait automatisch op de ingestelde tijd, ook als het Sheets-bestand niet open is.

Grafieken automatisch bijwerken

Grafieken in Google Sheets die naar het Data-tabblad verwijzen, werken automatisch bij wanneer de data verandert. Maak een grafiek aan via Invoegen > Grafiek en selecteer het databereik in het Data-tabblad. Omdat updateDataSheet steeds hetzelfde bereik vult, blijft de grafiek meebewegen.

Quota en limieten in de gaten houden

Apps Script werkt met dagelijkse quota die per gebruiker gelden en 24 uur na de eerste aanroep resetten. De twee die voor dit dashboard het meest tellen:

• Uitvoeringstijd per run: maximaal 6 minuten. Loopt je verwerking langer, verdeel het werk dan over meerdere runs.
• UrlFetchApp-aanroepen per dag: 20.000 voor een gratis consumentenaccount en 100.000 voor een Google Workspace-account (stand juni 2026).