Google Forms API gebruiken voor formulierintegraties

Formulieren zijn een eenvoudige manier om data te verzamelen, maar die data wil je vaak verder verwerken: doorsturen naar een CRM, een ticket aanmaken of een bevestiging sturen. Met de Google Forms API maak je formulieren als code en lees je inzendingen uit. Zo verbind je de eenvoud van Forms met de kracht van je eigen systemen.

In dit artikel bouw je het aanmaken, het uitlezen en het realtime verwerken stap voor stap op.

Een formulier aanmaken

Je maakt eerst een leeg formulier met een titel, en voegt daarna vragen toe via een aparte batchUpdate-call.

formulier = service.forms().create(
    body={'info': {'title': 'Aanmelding webinar'}}
).execute()
form_id = formulier['formId']

Vragen toevoegen

Met batchUpdate stuur je een lijst van requests, elk met een createItem. De requests worden als groep verwerkt: faalt er een, dan wordt niets uit de batch weggeschreven.

service.forms().batchUpdate(formId=form_id, body={'requests': [{
    'createItem': {
        'item': {'title': 'Wat is je naam?',
                  'questionItem': {'question': {'required': True,
                  'textQuestion': {}}}},
        'location': {'index': 0}
    }
}]}).execute()

Antwoorden ophalen

Inzendingen vraag je op met responses.list. Elk antwoord bevat de waarden per vraag, gekoppeld aan question-ID's.

antwoorden = service.forms().responses().list(formId=form_id).execute()
for response in antwoorden.get('responses', []):
    print(response['answers'])

Realtime verwerken met een watch

In plaats van te pollen, laat je Forms je een seintje geven bij elke nieuwe inzending. Je maakt een watch aan op het event-type RESPONSES, die meldingen publiceert naar een Cloud Pub/Sub-topic.

1. Maak in Google Cloud een Pub/Sub-topic aan en geef de Forms-serviceaccount publiceerrechten op dat topic.
2. Maak met forms.watches.create() een watch aan op het formulier voor het event-type RESPONSES.
3. Forms publiceert bij elke nieuwe of gewijzigde inzending een melding naar je topic.
4. Je verwerker ontvangt de melding en haalt het nieuwe antwoord op met forms.responses.list(), gefilterd op een timestamp groter dan de laatste die je al verwerkte.
5. Je verwerkt het antwoord, bijvoorbeeld door een record in je CRM aan te maken.
6. Vernieuw de watch met forms.watches.renew() voordat die verloopt.

Welke scopes heb je nodig

Vraag alleen de OAuth-scopes aan die je echt gebruikt. Een te brede scope is een onnodig veiligheidsrisico bij je verificatie.

Veelgestelde vragen

Met de Forms API verander je losse formulieren in een geintegreerd onderdeel van je dataverwerking, van aanmaken tot realtime opvolging.