Cache Service voor snellere Apps Script-scripts

Cache Service overzicht

De Cache Service biedt een tijdelijke sleutel-waarde store die scripts aanzienlijk kan versnellen. Het is ideaal voor het cachen van externe API-resultaten, zware berekeningen en configuratiedata die niet bij elke uitvoering opnieuw opgehaald hoeft te worden.

Er zijn drie cache-typen:

• Script cache: gedeeld door alle gebruikers van het script.
• Document cache: gedeeld door alle gebruikers in het huidige document.
• User cache: privé per gebruiker.

const scriptCache = CacheService.getScriptCache();
const docCache = CacheService.getDocumentCache();
const userCache = CacheService.getUserCache();

Basis caching-patroon

function haalDataOpMetCache(key) {
  const cache = CacheService.getScriptCache();

  const gecached = cache.get(key);
  if (gecached) {
    Logger.log('Cache hit voor: ' + key);
    return JSON.parse(gecached);
  }

  Logger.log('Cache miss, data ophalen...');
  const data = haalDataOpVanBron(key);

  cache.put(key, JSON.stringify(data), 3600);

  return data;
}

function haalDataOpVanBron(key) {
  const response = UrlFetchApp.fetch(`https://api.voorbeeld.nl/data/${key}`);
  return JSON.parse(response.getContentText());
}

Bulk-caching met putAll en getAll

Met putAll() en getAll() schrijf en lees je meerdere sleutels in een enkele aanroep. Dat is sneller dan een lus met losse put()- en get()-aanroepen.

function cacheMeerderItemsInEenKeer() {
  const cache = CacheService.getScriptCache();

  const items = {
    'config_versie': '2.1.0',
    'max_rijen': '500',
    'api_endpoint': 'https://api.voorbeeld.nl/v2',
    'timeout_sec': '30',
  };

  cache.putAll(items, 7200);

  const sleutels = ['config_versie', 'max_rijen', 'api_endpoint'];
  const resultaten = cache.getAll(sleutels);

  Object.entries(resultaten).forEach(([k, v]) => {
    Logger.log(`${k}: ${v || '(niet gecached)'}`);
  });
}

Cache invalideren

function verwijderCacheItems() {
  const cache = CacheService.getScriptCache();

  cache.remove('config_versie');

  cache.removeAll(['max_rijen', 'api_endpoint', 'timeout_sec']);

  Logger.log('Cache geleegd');
}

Configuratie cachen

Een veelgebruikt patroon is om configuratie uit een Spreadsheet eenmalig in te lezen en daarna te cachen. Zo voorkom je dat elke uitvoering opnieuw de hele sheet uitleest.

function getConfig() {
  const cache = CacheService.getScriptCache();
  const cacheKey = 'app_config';

  const gecachede = cache.get(cacheKey);
  if (gecachede) {
    return JSON.parse(gecachede);
  }

  const blad = SpreadsheetApp.openById('CONFIG_SHEET_ID').getSheetByName('Config');
  const data = blad.getDataRange().getValues();

  const config = {};
  data.forEach(rij => {
    if (rij[0] && rij[1]) {
      config[rij[0]] = rij[1];
    }
  });

  cache.put(cacheKey, JSON.stringify(config), 1800);
  return config;
}

API-resultaten cachen

Externe API's hebben vaak hun eigen rate limits en kosten. Door resultaten kort te cachen verminder je het aantal verzoeken en blijf je binnen het Apps Script-quotum voor UrlFetchApp.

function haalWeersdata(stad) {
  const cache = CacheService.getScriptCache();
  const key = `weer_${stad.toLowerCase().replace(/\s/g, '_')}`;

  const gecached = cache.get(key);
  if (gecached) {
    return JSON.parse(gecached);
  }

  const props = PropertiesService.getScriptProperties();
  const apiKey = props.getProperty('WEATHER_API_KEY');

  const url = `https://api.openweathermap.org/data/2.5/weather?q=${encodeURIComponent(stad)}&appid=${apiKey}&units=metric&lang=nl`;
  const response = UrlFetchApp.fetch(url);
  const data = JSON.parse(response.getContentText());

  cache.put(key, JSON.stringify(data), 600);

  return data;
}

De Cache Service is een eenvoudige maar krachtige tool om quota-verbruik te verminderen en scripts sneller te maken. Combineer het met PropertiesService voor een gelaagde caching-strategie die zowel snel als betrouwbaar is.