Google Forms API voor automatisering

Inleiding tot de Forms API

De Google Forms API is een REST-API waarmee je Google Forms programmatisch kunt aanmaken, aanpassen, publiceren en antwoorden kunt ophalen. Je benadert de API via directe HTTP-aanroepen, de Google API Client Libraries of Google Apps Script.

Typische use cases:

• Automatisch formulieren aanmaken op basis van een database of configuratie.
• Antwoorden opvragen voor verwerking in een eigen systeem.
• Formulierdata in workflows integreren via push-notificaties.

API activeren

Formulier aanmaken

from googleapiclient.discovery import build
from google.oauth2.credentials import Credentials

creds = Credentials.from_authorized_user_file('token.json')
service = build('forms', 'v1', credentials=creds)

nieuw_formulier = {
    'info': {
        'title': 'Mijn automatisch formulier',
        'documentTitle': 'Mijn formulier'
    }
}

formulier = service.forms().create(body=nieuw_formulier).execute()
formulier_id = formulier['formId']
print(f'Formulier aangemaakt: {formulier_id}')

Vragen toevoegen via batchUpdate

Met batchUpdate voeg je een of meer items in een enkele aanroep toe. Houd er rekening mee dat het veld bij meerkeuzevragen RADIO als type gebruikt:

requests = {
    'requests': [
        {
            'createItem': {
                'item': {
                    'title': 'Wat is je naam?',
                    'questionItem': {
                        'question': {
                            'required': True,
                            'textQuestion': {
                                'paragraph': False
                            }
                        }
                    }
                },
                'location': {'index': 0}
            }
        },
        {
            'createItem': {
                'item': {
                    'title': 'Op welke afdeling werk je?',
                    'questionItem': {
                        'question': {
                            'required': True,
                            'choiceQuestion': {
                                'type': 'RADIO',
                                'options': [
                                    {'value': 'Sales'},
                                    {'value': 'Marketing'},
                                    {'value': 'Engineering'}
                                ]
                            }
                        }
                    }
                },
                'location': {'index': 1}
            }
        }
    ]
}

service.forms().batchUpdate(formId=formulier_id, body=requests).execute()

Formulier publiceren

Sinds april 2025 publiceer je een formulier programmatisch met setPublishSettings. Dit is belangrijk, want vanaf 30 juni 2026 worden nieuwe formulieren die via de API zijn aangemaakt standaard in een ongepubliceerde staat geplaatst. Zonder publiceren kunnen respondenten het formulier dan niet invullen.

publish_body = {
    'publishSettings': {
        'publishState': {
            'isPublished': True,
            'isAcceptingResponses': True
        }
    }
}

service.forms().setPublishSettings(formId=formulier_id, body=publish_body).execute()

Wil je sturen wie mag reageren? Combineer dit met de permissions.create-methode van de Drive API voor granulaire toegangscontrole.

Antwoorden ophalen

antwoorden = service.forms().responses().list(formId=formulier_id).execute()

for antwoord in antwoorden.get('responses', []):
    for vraag_id, antwoord_data in antwoord['answers'].items():
        print(vraag_id, antwoord_data['textAnswers']['answers'][0]['value'])

Push-notificaties (watches)

De Forms API ondersteunt watch-notificaties via Google Cloud Pub/Sub. Je kiest een eventType: RESPONSES voor nieuwe of bijgewerkte inzendingen, of SCHEMA voor wijzigingen aan de inhoud en instellingen van het formulier. Een watch verloopt na zeven dagen en kun je daarna vernieuwen.

watch_body = {
    'watch': {
        'target': {
            'topic': {
                'topicName': 'projects/JOUW_PROJECT/topics/JOUW_TOPIC'
            }
        },
        'eventType': 'RESPONSES'
    }
}

service.forms().watches().create(formId=formulier_id, body=watch_body).execute()

Quota en limieten

Blijf je binnen de minuutlimieten, dan is er geen dagelijkse limiet op het aantal aanvragen. Overschrijd je een quotum, dan krijg je een 429-fout en moet je een exponentiële backoff toepassen voor herhaalpogingen.

Verwacht je structureel meer verkeer? Vraag een quotumverhoging aan via de pagina Quota en systeemlimieten in de Cloud Console.