Google Groups beheren via de API

Wanneer de API gebruiken

De Admin Console is voldoende voor handmatig beheer van groepen, maar voor geautomatiseerde of grootschalige bewerkingen is de API de juiste keuze. Typische gebruiksscenario's:

• Automatisch groepen aanmaken bij het onboarden van nieuwe afdelingen.
• Groepslidmaatschappen synchroniseren vanuit een HR-systeem.
• Bulk-updates van groepsinstellingen.
• Integreren met Slack, Jira of andere tools die Workspace-groepen als basis gebruiken.

Benodigde API's en scopes

Je hebt twee API's nodig:

Admin SDK Directory API voor het aanmaken, bewerken en verwijderen van groepen en leden.

• Scope: https://www.googleapis.com/auth/admin.directory.group

Groups Settings API voor geavanceerde instellingen zoals berichtmoderatie, spaminstellingen en toegangsbeleid.

• Scope: https://www.googleapis.com/auth/apps.groups.settings

Beperk de scopes tot wat je echt nodig hebt. Voor alleen-lezen toegang tot groepen kun je bijvoorbeeld admin.directory.group.readonly gebruiken in plaats van de volledige scope.

Authenticatie instellen

Voor server-naar-server-automatisering gebruik je een service account met domeinbrede delegatie. Het service account doet zich dan voor als een beheerder in je domein.

Groep aanmaken via de API

Voorbeeld in Python met de Google API Client Library. Let op with_subject, dat is het beheerderaccount waarvoor het service account handelt.

from googleapiclient.discovery import build
from google.oauth2 import service_account

SCOPES = ['https://www.googleapis.com/auth/admin.directory.group']
SERVICE_ACCOUNT_FILE = 'service-account.json'
ADMIN_EMAIL = 'admin@bedrijf.nl'

credentials = service_account.Credentials.from_service_account_file(
    SERVICE_ACCOUNT_FILE, scopes=SCOPES
).with_subject(ADMIN_EMAIL)

service = build('admin', 'directory_v1', credentials=credentials)

group = {
    'email': 'nieuweteam@bedrijf.nl',
    'name': 'Nieuw Team',
    'description': 'Groep voor het nieuwe projectteam'
}

result = service.groups().insert(body=group).execute()
print(result['id'])

Leden toevoegen

member = {
    'email': 'gebruiker@bedrijf.nl',
    'role': 'MEMBER'
}

service.members().insert(groupKey='nieuweteam@bedrijf.nl', body=member).execute()

Geldige rollen zijn MEMBER, MANAGER en OWNER.

Groepsinstellingen via de Groups Settings API

groups_settings_service = build('groupssettings', 'v1', credentials=credentials)

settings = {
    'whoCanPostMessage': 'ALL_MEMBERS_CAN_POST',
    'isArchived': 'true',
    'messageModerationLevel': 'MODERATE_NON_MEMBERS'
}

groups_settings_service.groups().update(
    groupUniqueId='nieuweteam@bedrijf.nl',
    body=settings
).execute()

Apps Script als alternatief

Voor minder technische beheerders is Google Apps Script een toegankelijker alternatief. Via de ingebouwde AdminDirectory-service beheer je groepen zonder zelf een service account te hoeven opzetten:

function maakGroepAan() {
  AdminDirectory.Groups.insert({
    email: 'scriptgroep@bedrijf.nl',
    name: 'Script Groep'
  });
}

Apps Script draait met de rechten van de gebruiker die het script uitvoert. Zorg dat die gebruiker een beheerdersrol heeft die groepsbeheer toestaat, en activeer de Admin SDK-service in de scripteditor onder Diensten.

Foutafhandeling en rate-limiting

Veelvoorkomende fouten: