Die Google Forms API ist eine RESTful-Oberfläche, mit der Sie Formulare und Quizze erstellen und ändern, Formularantworten und Quiznoten abrufen, Quizantwortschlüssel mit automatischem Feedback einrichten und Push-Benachrichtigungen erhalten können. Diese API wird am häufigsten für die folgenden Aufgaben verwendet:
- Formulare oder Quiz erstellen
- Formulare oder Quiz aktualisieren
- Antworten aus einem Formular oder Quiz abrufen
- Formularinhalte und Metadaten lesen
- Push-Benachrichtigungen einrichten und erhalten
Nachfolgend finden Sie eine Liste häufig verwendeter Begriffe, die in der Forms API verwendet werden:
- Form
Ein Google Formulare-Dokument, das in Google Drive erstellt und gespeichert wurde. Jedes Formular wird durch eine
Form
-Ressource dargestellt und hat einen eindeutigenformId
-Wert, der Buchstaben, Ziffern, Bindestriche und Unterstriche enthält. Die Formular-ID finden Sie in der Google Formulare-URL:https://docs.google.com/forms/d/FORM_ID/edit
- Quiz
Ein bestimmter Typ von Google Formulare-Dokument, mit dem die Formularantworten anhand eines Antwortschlüssels bewertet werden können. Ein Quiz kann nur mit der Methode
batchUpdate()
erstellt werden, um die EinstellungisQuiz
für ein vorhandenes Formular auftrue
zu aktualisieren.- Benotung
- Eine Punktzahl, ein Antwortschlüssel und Feedback zu einer Frage werden angewendet, wenn
isQuiz
den Werttrue
hat. Wird durch die RessourceGrading
dargestellt. - Feedback
- Eine Antwort, die der Endnutzer bei der Beantwortung einer Frage in einem Quiz erhält. Sie wird durch die Ressource
Feedback
dargestellt.
- Punkt
Ein einzelnes Element in einem Formular, das durch die Ressource Item dargestellt wird.
Item
ist ein wiederkehrendes Element, das einen Abschnitt, eine Fragegruppe, eine Frage, einen Text, ein Bild oder ein Video enthalten kann.- Frage
Eine einzelne Frage im Formular, dargestellt durch die Ressource
Question
.- Fragengruppe
Eine Gruppe von Fragen, die alle die gleichen möglichen Antworten haben (z. B. ein Raster mit Bewertungen von 1 bis 5). Wird durch die Ressource
QuestionGroupItem
dargestellt.- Section
Mit einem Abschnitt können Sie ein Formular auf mehrere Seiten aufteilen und bedingte Logik hinzufügen (z. B. werden nur bestimmte Fragen angezeigt, je nachdem, wie der Nutzer geantwortet hat). Abschnitte entsprechen der Ressource
PageBreakItem
.- Antwort
Die Antwort des Endnutzers auf eine Frage, dargestellt durch die Ressource
Answer
. Enthält sowohl Informationen zur Note (falls vorhanden), Metadaten und den Inhalt der Antwort.- Antwort
Das Senden eines Formulars durch den Endnutzer, dargestellt durch die Ressource
FormResponse
.- Ansehen
Ein Trigger, der Änderungen an Formularschemaänderungen (z. B. Änderungen an Fragen) oder das Senden von Formularantworten verfolgt und eine Push-Benachrichtigung sendet, wenn eine Änderung erfolgt. Wird durch die Ressource
Watch
dargestellt.
Formularstruktur
Bei der Verwaltung von Formularen und Quizzen kann es kompliziert sein, verschiedene Felder anzugeben, da viele der Formularobjekte auf unterschiedliche Weise ineinander verschachtelt werden können. Wenn Sie sehen möchten, wie die visuelle Darstellung eines Formulars den Feldern zugeordnet wird, sollten Sie in der Benutzeroberfläche einige Beispiele für Formulare erstellen, die Ihre Anwendung generieren könnte. Rufen Sie dann die entsprechende JSON-Datei mit der Methode forms.get()
ab, um sie zu vergleichen. Dieses Beispielquiz entspricht beispielsweise der folgenden JSON-Datei:
{
"formId": "FORM_ID",
"info": {
"title": "Famous Black Women",
"description": "Please complete this quiz based off of this week's readings for class.",
"documentTitle": "API Example Quiz"
},
"settings": {
"quizSettings": {
"isQuiz": true
}
},
"revisionId": "00000021",
"responderUri": "https://docs.google.com/forms/d/e/1FAIpQLSd0iBLPh4suZoGW938EU1WIxzObQv_jXto0nT2U8HH2KsI5dg/viewform",
"items": [
{
"itemId": "5d9f9786",
"imageItem": {
"image": {
"contentUri": "DIRECT_URL",
"properties": {
"alignment": "LEFT"
}
}
}
},
{
"itemId": "72b30353",
"title": "Which African American woman authored \"I Know Why the Caged Bird Sings\"?",
"questionItem": {
"question": {
"questionId": "25405d4e",
"required": true,
"grading": {
"pointValue": 2,
"correctAnswers": {
"answers": [
{
"value": "Maya Angelou"
}
]
}
},
"choiceQuestion": {
"type": "RADIO",
"options": [
{
"value": "Maya Angelou"
},
{
"value": "bell hooks"
},
{
"value": "Alice Walker"
},
{
"value": "Roxane Gay"
}
]
}
}
}
},
{
"itemId": "0a4859c8",
"title": "Who was the first Dominican-American woman elected to state office?",
"questionItem": {
"question": {
"questionId": "37fff47a",
"grading": {
"pointValue": 2,
"correctAnswers": {
"answers": [
{
"value": "Grace Diaz"
}
]
}
},
"choiceQuestion": {
"type": "RADIO",
"options": [
{
"value": "Rosa Clemente"
},
{
"value": "Grace Diaz"
},
{
"value": "Juana Matias"
},
{
"value": "Sabrina Matos"
}
]
}
}
}
}
]
}
Nächste Schritte
- Weitere Informationen zur Entwicklung mit Google Workspace APIs, einschließlich der Authentifizierung und Autorisierung, finden Sie unter Erste Schritte als Workspace-Entwickler.
- Informationen zum Konfigurieren und Ausführen einer einfachen Forms API-Anwendung finden Sie in der Kurzanleitung.