Admin SDK Groups via Apps Script

Groepen ophalen en doorzoeken

De Admin SDK Groups service geeft je toegang tot alle Google Workspace groepen in je domein. Net als de Users service moet je de Admin SDK Advanced Service activeren in je project. Dit doe je via Services (het plusje) in de Apps Script editor, of in appsscript.json onder dependencies.enabledAdvancedServices.

function haalGroepenOp() {
  const opties = {
    domain: 'bedrijf.nl',
    maxResults: 200,
  };

  let pageToken;
  const alleGroepen = [];

  do {
    if (pageToken) opties.pageToken = pageToken;
    const resultaat = AdminDirectory.Groups.list(opties);

    if (resultaat.groups) {
      alleGroepen.push(...resultaat.groups);
    }
    pageToken = resultaat.nextPageToken;
  } while (pageToken);

  alleGroepen.forEach(g => Logger.log(`${g.name}: ${g.email} (${g.directMembersCount} leden)`));
  return alleGroepen;
}

Groepen aanmaken en verwijderen

function maakGroepAan() {
  const nieuweGroep = {
    email: 'sales-team@bedrijf.nl',
    name: 'Sales Team',
    description: 'Alle medewerkers in de sales afdeling',
  };

  const aangemaakt = AdminDirectory.Groups.insert(nieuweGroep);
  Logger.log(`Groep aangemaakt: ${aangemaakt.email} (ID: ${aangemaakt.id})`);
  return aangemaakt.id;
}

function verwijderGroep() {
  AdminDirectory.Groups.remove('sales-team@bedrijf.nl');
  Logger.log('Groep verwijderd');
}

function wijzigGroep() {
  AdminDirectory.Groups.update({
    name: 'Sales & Marketing Team',
    description: 'Bijgewerkte beschrijving',
  }, 'sales-team@bedrijf.nl');
}

Leden beheren

function voegLidToe() {
  const groepEmail = 'sales-team@bedrijf.nl';

  AdminDirectory.Members.insert({
    email: 'nieuwlid@bedrijf.nl',
    role: 'MEMBER',
  }, groepEmail);

  AdminDirectory.Members.insert({
    email: 'manager@bedrijf.nl',
    role: 'OWNER',
  }, groepEmail);

  Logger.log('Leden toegevoegd');
}

function verwijderLid() {
  AdminDirectory.Members.delete('sales-team@bedrijf.nl', 'oudlid@bedrijf.nl');
}

function controleerLidmaatschap() {
  try {
    const lid = AdminDirectory.Members.get('sales-team@bedrijf.nl', 'gebruiker@bedrijf.nl');
    Logger.log(`Rol: ${lid.role}, Status: ${lid.status}`);
    return true;
  } catch(e) {
    Logger.log('Geen lid');
    return false;
  }
}

Alle leden van een groep ophalen

function haalLedenOp(groepEmail) {
  const opties = {maxResults: 200};
  let pageToken;
  const alleleden = [];

  do {
    if (pageToken) opties.pageToken = pageToken;
    const resultaat = AdminDirectory.Members.list(groepEmail, opties);

    if (resultaat.members) {
      alleleden.push(...resultaat.members);
    }
    pageToken = resultaat.nextPageToken;
  } while (pageToken);

  return alleleden;
}

Groepslidmaatschappen synchroniseren vanuit spreadsheet

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

  const groepEmail = 'projectteam-alpha@bedrijf.nl';

  const gewensteLeden = new Set(
    data.slice(1)
      .filter(rij => rij[1] === 'Actief')
      .map(rij => rij[0].toLowerCase())
  );

  const huidigeLeden = new Set(
    haalLedenOp(groepEmail).map(l => l.email.toLowerCase())
  );

  gewensteLeden.forEach(email => {
    if (!huidigeLeden.has(email)) {
      try {
        AdminDirectory.Members.insert({email, role: 'MEMBER'}, groepEmail);
        Logger.log(`Toegevoegd: ${email}`);
      } catch(e) {
        Logger.log(`Fout toevoegen ${email}: ${e.message}`);
      }
      Utilities.sleep(100);
    }
  });

  huidigeLeden.forEach(email => {
    if (!gewensteLeden.has(email)) {
      try {
        AdminDirectory.Members.delete(groepEmail, email);
        Logger.log(`Verwijderd: ${email}`);
      } catch(e) {
        Logger.log(`Fout verwijderen ${email}: ${e.message}`);
      }
      Utilities.sleep(100);
    }
  });
}

Groepsinstellingen beheren

function beheerGroepsinstellingen() {
  const instellingen = AdminGroupsSettings.Groups.get('sales-team@bedrijf.nl');
  Logger.log(JSON.stringify(instellingen));

  AdminGroupsSettings.Groups.update({
    whoCanPostMessage: 'ALL_IN_DOMAIN_CAN_POST',
    whoCanViewMembership: 'ALL_MEMBERS_CAN_VIEW',
    isArchived: 'true',
  }, 'sales-team@bedrijf.nl');
}

Combineer de Groups service met de Users service voor volledig geautomatiseerd lifecycle management. Bij onboarding voeg je een nieuwe gebruiker direct toe aan de juiste groepen, en bij offboarding verwijder je hem of haar in één run uit alle groepen.