Ein Formular mit allgemeinen Properties und Elementen. Zu den Properties gehören Titel, Einstellungen und Speicherort der Antworten. Zu den Elementen gehören Frageelemente wie Kästchen oder Optionsfelder, während Layoutelemente sich auf Dinge wie Seitenumbrüche beziehen. Auf Formulare kann über FormApp
zugegriffen oder sie können dort erstellt werden.
// Open a form by ID and create a new spreadsheet. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const ss = SpreadsheetApp.create('Spreadsheet Name'); // Update form properties via chaining. form.setTitle('Form Name') .setDescription('Description of form') .setConfirmationMessage('Thanks for responding!') .setAllowResponseEdits(true) .setAcceptingResponses(false); // Update the form's response destination. form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId());
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
addCheckboxGridItem() | CheckboxGridItem | Hiermit wird ein neues Frageelement angehängt, das als Raster aus Spalten und Zeilen dargestellt wird. Die Teilnehmer können dann aus einer Reihe von Kästchen mehrere Optionen pro Zeile auswählen. |
addCheckboxItem() | CheckboxItem | Hiermit wird ein neues Frageelement angehängt, mit dem die Befragten ein oder mehrere Kästchen auswählen können. Außerdem wird ein optionales Feld für „Sonstiges“ hinzugefügt. |
addDateItem() | DateItem | Hiermit wird ein neues Frageelement angehängt, mit dem die Person ein Datum angeben kann. |
addDateTimeItem() | DateTimeItem | Fügen Sie ein neues Frageelement hinzu, mit dem die Befragten ein Datum und eine Uhrzeit angeben können. |
addDurationItem() | DurationItem | Hiermit wird ein neues Frageelement angehängt, mit dem die Befragten einen Zeitraum angeben können. |
addEditor(emailAddress) | Form | Der angegebene Nutzer wird der Liste der Mitbearbeiter für die Form hinzugefügt. |
addEditor(user) | Form | Der angegebene Nutzer wird der Liste der Mitbearbeiter für die Form hinzugefügt. |
addEditors(emailAddresses) | Form | Fügt der Liste der Mitbearbeiter für die Form das angegebene Nutzerarray hinzu. |
addGridItem() | GridItem | Hiermit wird ein neues Frageelement angehängt, das als Raster aus Spalten und Zeilen dargestellt wird. Der Teilnehmer kann dann aus einer Reihe von Optionsfeldern eine Auswahl pro Zeile treffen. |
addImageItem() | ImageItem | Hiermit wird ein neues Layoutelement angehängt, in dem ein Bild angezeigt wird. |
addListItem() | ListItem | Hiermit wird ein neues Frageelement angehängt, mit dem die Teilnehmer eine Option aus einer Drop-down-Liste auswählen können. |
addMultipleChoiceItem() | MultipleChoiceItem | Hiermit wird ein neues Frageelement hinzugefügt, mit dem die Befragten eine Option aus einer Liste von Optionsfeldern oder einem optionalen Feld „Sonstiges“ auswählen können. |
addPageBreakItem() | PageBreakItem | Hiermit wird ein neues Layoutelement hinzugefügt, das den Beginn einer Seite markiert. |
addParagraphTextItem() | ParagraphTextItem | Fügt ein neues Frageelement hinzu, mit dem die Befragten einen Textblock eingeben können. |
addScaleItem() | ScaleItem | Hiermit wird ein neues Frageelement angehängt, über das die Person eine Option aus einer nummerierten Reihe von Optionsfeldern auswählen kann. |
addSectionHeaderItem() | SectionHeaderItem | Hiermit wird ein neues Layoutelement angehängt, das den Beginn eines Abschnitts visuell kennzeichnet. |
addTextItem() | TextItem | Hiermit wird ein neues Frageelement angehängt, über das die Befragten eine einzelne Textzeile eingeben können. |
addTimeItem() | TimeItem | Hiermit wird ein neues Frageelement angehängt, mit dem die Befragten eine Tageszeit angeben können. |
addVideoItem() | VideoItem | Hiermit wird ein neues Layoutelement angehängt, in dem ein Video angezeigt wird. |
canEditResponse() | Boolean | Bestimmt, ob im Formular nach dem Senden einer Antwort ein Link zum Bearbeiten angezeigt wird. |
collectsEmail() | Boolean | Bestimmt, ob im Formular die E-Mail-Adressen der Teilnehmer erfasst werden. |
createResponse() | FormResponse | Erstellt eine neue Antwort auf das Formular. |
deleteAllResponses() | Form | Löscht alle eingereichten Antworten aus dem Antwortspeicher des Formulars. |
deleteItem(index) | void | Löscht das Element an einem bestimmten Index unter allen Elementen im Formular. |
deleteItem(item) | void | Löscht das angegebene Element. |
deleteResponse(responseId) | Form | Löscht eine einzelne Antwort aus dem Antwortspeicher des Formulars. |
getConfirmationMessage() | String | Ruft die Bestätigungsnachricht des Formulars ab. |
getCustomClosedFormMessage() | String | Die benutzerdefinierte Nachricht, die angezeigt wird, wenn im Formular keine Antworten akzeptiert werden, oder ein leerer String, wenn keine benutzerdefinierte Nachricht festgelegt ist. |
getDescription() | String | Ruft die Beschreibung des Formulars ab. |
getDestinationId() | String | Ruft die ID des Antwortziels des Formulars ab. |
getDestinationType() | DestinationType | Der Typ des Antwortziels des Formulars. |
getEditUrl() | String | Die URL, über die der Bearbeitungsmodus des Formulars aufgerufen werden kann. |
getEditors() | User[] | Ruft die Liste der Mitbearbeiter für diese Form ab. |
getId() | String | Ruft die ID des Formulars ab. |
getItemById(id) | Item | Ruft das Element mit einer bestimmten ID ab. |
getItems() | Item[] | Ruft ein Array aller Elemente im Formular ab. |
getItems(itemType) | Item[] | Ruft ein Array aller Elemente eines bestimmten Typs ab. |
getPublishedUrl() | String | Ruft die URL ab, über die das Formular ausgefüllt werden kann. |
getResponse(responseId) | FormResponse | Ruft eine einzelne Formularantwort anhand ihrer Antwort-ID ab. |
getResponses() | FormResponse[] | Ruft ein Array aller Antworten des Formulars ab. |
getResponses(timestamp) | FormResponse[] | Ruft ein Array aller Antworten des Formulars nach einem bestimmten Datum und einer bestimmten Uhrzeit ab. |
getShuffleQuestions() | Boolean | Bestimmt, ob die Reihenfolge der Fragen auf jeder Seite des Formulars zufällig ist. |
getSummaryUrl() | String | Die URL, über die eine Zusammenfassung der Antworten auf das Formular aufgerufen werden kann. |
getTitle() | String | Ruft den Titel des Formulars ab. |
hasLimitOneResponsePerUser() | Boolean | Bestimmt, ob im Formular nur eine Antwort pro Teilnehmer zulässig ist. |
hasProgressBar() | Boolean | Bestimmt, ob im Formular eine Fortschrittsanzeige angezeigt wird. |
hasRespondAgainLink() | Boolean | Bestimmt, ob im Formular nach dem Ausfüllen ein Link zum Einreichen einer weiteren Antwort angezeigt wird. |
isAcceptingResponses() | Boolean | Bestimmt, ob für das Formular derzeit Antworten angenommen werden. |
isPublishingSummary() | Boolean | Bestimmt, ob im Formular ein Link zu einer Zusammenfassung der Antworten angezeigt wird, nachdem ein Teilnehmer das Formular ausgefüllt hat. |
isQuiz() | Boolean | Bestimmt, ob es sich bei dem Formular um ein Quiz handelt. |
moveItem(from, to) | Item | Verschiebt ein Element an einem bestimmten Index unter allen Elementen im Formular an einen anderen Index. |
moveItem(item, toIndex) | Item | Verschiebt ein bestimmtes Element zu einem bestimmten Index unter allen Elementen im Formular. |
removeDestination() | Form | Die Verknüpfung des Formulars mit dem aktuellen Antwortziel wird aufgehoben. |
removeEditor(emailAddress) | Form | Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der Form entfernt. |
removeEditor(user) | Form | Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der Form entfernt. |
setAcceptingResponses(enabled) | Form | Gibt an, ob derzeit Antworten für das Formular akzeptiert werden. |
setAllowResponseEdits(enabled) | Form | Hier legen Sie fest, ob im Formular nach dem Senden einer Antwort ein Link zum Bearbeiten angezeigt wird. |
setCollectEmail(collect) | Form | Hier legen Sie fest, ob im Formular die E-Mail-Adressen der Teilnehmer erfasst werden. |
setConfirmationMessage(message) | Form | Hiermit wird die Bestätigungsnachricht für das Formular festgelegt. |
setCustomClosedFormMessage(message) | Form | Hier legen Sie fest, welche Meldung angezeigt werden soll, wenn für das Formular keine Antworten akzeptiert werden. |
setDescription(description) | Form | Hier legen Sie die Beschreibung des Formulars fest. |
setDestination(type, id) | Form | Hier legen Sie den Speicherort für Formularantworten fest. |
setIsQuiz(enabled) | Form | Hiermit wird festgelegt, ob es sich bei dem Formular um ein Quiz handelt. |
setLimitOneResponsePerUser(enabled) | Form | Hiermit wird festgelegt, ob im Formular nur eine Antwort pro Teilnehmer zulässig ist. |
setProgressBar(enabled) | Form | Legt fest, ob das Formular eine Fortschrittsanzeige hat. |
setPublishingSummary(enabled) | Form | Hiermit wird festgelegt, ob im Formular nach dem Senden ein Link zu einer Zusammenfassung der Antworten angezeigt wird. |
setShowLinkToRespondAgain(enabled) | Form | Hier legen Sie fest, ob im Formular ein Link zum Einreichen einer weiteren Antwort angezeigt wird, nachdem ein Teilnehmer das Formular ausgefüllt hat. |
setShuffleQuestions(shuffle) | Form | Hier legen Sie fest, ob die Reihenfolge der Fragen auf jeder Seite des Formulars zufällig ist. |
setTitle(title) | Form | Hiermit wird der Titel des Formulars festgelegt. |
shortenFormUrl(url) | String | Wandelt eine lange URL für ein Formular in eine kurze URL um. |
submitGrades(responses) | Form | Sendet Noten für die angegebenen FormResponses. |
Detaillierte Dokumentation
addCheckboxGridItem()
Hiermit wird ein neues Frageelement angehängt, das als Raster aus Spalten und Zeilen dargestellt wird. Die Teilnehmer können dann aus einer Reihe von Kästchen mehrere Optionen pro Zeile auswählen.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds a checkbox grid item. const item = form.addCheckboxGridItem(); item.setTitle('Where did you celebrate New Year\'s?'); // Sets the grid's rows and columns. item.setRows(['New York', 'San Francisco', 'London']).setColumns([ '2014', '2015', '2016', '2017' ]);
Rückflug
CheckboxGridItem
: Das neu erstellte Element.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addCheckboxItem()
Hiermit wird ein neues Frageelement angehängt, mit dem die Befragten ein oder mehrere Kästchen auswählen können. Außerdem wird ein optionales Feld für „Sonstiges“ hinzugefügt.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds a checkbox item. const item = form.addCheckboxItem(); // Sets the title of the checkbox item to 'Do you prefer cats or dogs?' item.setTitle('Do you prefer cats or dogs?'); // Sets the choices. item.setChoiceValues(['Cats', 'Dogs']);
Rückflug
CheckboxItem
: Das neu erstellte Element.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addDateItem()
Hiermit wird ein neues Frageelement angehängt, mit dem die Person ein Datum angeben kann.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds a date item. const item = form.addDateItem(); // Sets the title to 'When were you born?' item.setTitle('When were you born?'); // Sets the description for the date item. item.setHelpText('Some helper text.');
Rückflug
DateItem
: Das neu erstellte Element.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addDateTimeItem()
Fügen Sie ein neues Frageelement hinzu, mit dem die Befragten ein Datum und eine Uhrzeit angeben können.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds a question with date and time inputs. const item = form.addDateTimeItem(); // Sets the title to 'When were you born?' item.setTitle('When were you born?'); // Sets the question as required. item.setRequired(true);
Rückflug
DateTimeItem
: Das neu erstellte Element.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addDurationItem()
Hiermit wird ein neues Frageelement angehängt, mit dem die Befragten einen Zeitraum angeben können.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds a question with a duration input. const item = form.addDurationItem(); // Sets the title to 'How long can you hold your breath?' item.setTitle('How long can you hold your breath?'); // Sets the question as required. item.setRequired(true);
Rückflug
DurationItem
: Das neu erstellte Element.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addEditor(emailAddress)
Der angegebene Nutzer wird der Liste der Mitbearbeiter für die Form
hinzugefügt. Wenn der Nutzer bereits auf der Liste der Zuschauer stand, wird er durch diese Methode aus der Liste entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die E-Mail-Adresse des Nutzers, den Sie hinzufügen möchten. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addEditor(user)
Der angegebene Nutzer wird der Liste der Mitbearbeiter für die Form
hinzugefügt. Wenn der Nutzer bereits in der Liste der Zuschauer stand, wird er durch diese Methode aus der Liste entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des hinzuzufügenden Nutzers. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addEditors(emailAddresses)
Fügt der Liste der Mitbearbeiter für die Form
das angegebene Nutzerarray hinzu. Wenn sich einer der Nutzer bereits in der Liste der Zuschauer befand, wird er durch diese Methode aus der Liste entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddresses | String[] | Ein Array mit den E-Mail-Adressen der Nutzer, die hinzugefügt werden sollen. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addGridItem()
Hiermit wird ein neues Frageelement angehängt, das als Raster aus Spalten und Zeilen dargestellt wird. Der Teilnehmer kann dann aus einer Reihe von Optionsfeldern eine Auswahl pro Zeile treffen.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds a multiple choice grid. const item = form.addGridItem(); // Sets the title to 'Rate your interests.' item.setTitle('Rate your interests'); // Sets the grid's rows and columns. item.setRows(['Cars', 'Computers', 'Celebrities']).setColumns([ 'Boring', 'So-so', 'Interesting' ]);
Rückflug
GridItem
: Das neu erstellte Element.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addImageItem()
Hiermit wird ein neues Layoutelement angehängt, in dem ein Bild angezeigt wird.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds an image item. const item = form.addImageItem(); // Gets the Google icon to use as the image. const img = UrlFetchApp.fetch( 'https://fonts.gstatic.com/s/i/productlogos/googleg/v6/web-24dp/logo_googleg_color_1x_web_24dp.png', ); // Sets the image, title, and description for the item. item.setTitle('Google icon').setHelpText('Google icon').setImage(img);
Rückflug
ImageItem
: Das neu erstellte Element.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addListItem()
Hiermit wird ein neues Frageelement angehängt, mit dem die Teilnehmer eine Option aus einer Drop-down-Liste auswählen können.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds a dropdown list to the form. const item = form.addListItem(); // Sets the title to 'Do you prefer cats or dogs?' item.setTitle('Do you prefer cats or dogs?'); // Sets the description to 'This is description text...' item.setHelpText('This is description text...'); // Creates and adds choices to the dropdown list. item.setChoices([item.createChoice('dog'), item.createChoice('cat')]);
Rückflug
ListItem
: Das neu erstellte Element.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addMultipleChoiceItem()
Hiermit wird ein neues Frageelement hinzugefügt, mit dem die Befragten eine Option aus einer Liste von Optionsfeldern oder einem optionalen Feld „Sonstiges“ auswählen können.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds a multiple choice item to the form. const item = form.addMultipleChoiceItem(); // Sets the title. item.setTitle('What is your favorite ice cream flavor?'); // Creates some choice items. const vanilla = item.createChoice('vanilla'); const chocolate = item.createChoice('chocolate'); const strawberry = item.createChoice('strawberry'); // Sets the choices. item.setChoices([vanilla, chocolate, strawberry]);
Rückflug
MultipleChoiceItem
: Das neu erstellte Element.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addPageBreakItem()
Hiermit wird ein neues Layoutelement hinzugefügt, das den Beginn einer Seite markiert.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds page break items to create a second and third page for the form. const pageTwo = form.addPageBreakItem(); const pageThree = form.addPageBreakItem(); // Sets the titles for the pages. pageTwo.setTitle('Page two'); pageThree.setTitle('Page three'); // Upon completion of the first page, sets the form to navigate to the third // page. pageTwo.setGoToPage(pageThree); // Upon completion of the second page, sets the form to navigate back to the // first page. pageThree.setGoToPage(FormApp.PageNavigationType.RESTART);
Rückflug
PageBreakItem
: Das neu erstellte Element.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addParagraphTextItem()
Hiermit fügen Sie ein neues Frageelement hinzu, über das die Befragten einen Textblock eingeben können.
// Opens the form by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds the paragraph text item. const item = form.addParagraphTextItem(); // Sets the title to 'What is your address?' item.setTitle('What is your address?');
Rückflug
ParagraphTextItem
: Das neu erstellte Element.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addScaleItem()
Hiermit wird ein neues Frageelement angehängt, über das die Person eine Option aus einer nummerierten Reihe von Optionsfeldern auswählen kann.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds the scale item. const item = form.addScaleItem(); // Sets the title of the scale item to 'Choose a number.' item.setTitle('Choose a number'); // Sets the scale to 1-5. item.setBounds(1, 5); // Sets the label for the lower and upper bounds. item.setLabels('Lowest', 'Highest');
Rückflug
ScaleItem
: Das neu erstellte Element.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addSectionHeaderItem()
Hiermit wird ein neues Layoutelement angehängt, das den Beginn eines Abschnitts visuell kennzeichnet.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds the section heading item. const item = form.addSectionHeaderItem(); // Sets the title to 'Title of new section.' item.setTitle('Title of new section'); // Sets the description. item.setHelpText('Description of new section');
Rückflug
SectionHeaderItem
: Das neu erstellte Element.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addTextItem()
Hiermit wird ein neues Frageelement angehängt, über das die Befragten eine einzelne Textzeile eingeben können.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds a single-line text item. const item = form.addTextItem(); // Sets the title to 'What is your name?' item.setTitle('What is your name?');
Rückflug
TextItem
: Das neu erstellte Element.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addTimeItem()
Hiermit wird ein neues Frageelement angehängt, mit dem die Befragten eine Tageszeit angeben können.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds a question with a time input. const item = form.addTimeItem(); // Sets the title to 'What time do you usually wake up in the morning?' item.setTitle('What time do you usually wake up in the morning?');
Rückflug
TimeItem
: Das neu erstellte Element.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addVideoItem()
Hiermit wird ein neues Layoutelement angehängt, in dem ein Video angezeigt wird.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds a video item. const item = form.addVideoItem(); // Sets the title, description, and video. item.setTitle('YouTube video') .setHelpText('Send content automatically via Google Sheets and Apps Script') .setVideoUrl('https://youtu.be/xxgQr-jSu9o'); // Sets the alignment to the center. item.setAlignment(FormApp.Alignment.CENTER);
Rückflug
VideoItem
: Das neu erstellte Element.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
canEditResponse()
Bestimmt, ob im Formular nach dem Senden einer Antwort ein Link zum Bearbeiten angezeigt wird.
Unabhängig von dieser Einstellung ermöglicht die Methode FormResponse.getEditResponseUrl()
einem Scripter, der Bearbeitungszugriff auf das Formular hat, eine URL zu generieren, mit der eine Antwort bearbeitet werden kann.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Checks if the form displays a link to edit a response after submitting it. // The default is false. To let people edit their responses, use // form.setAllowResponseEdits(true). const edit = form.canEditResponse(); // If the form doesn't let people edit responses, logs false to the console. console.log(edit);
Rückflug
Boolean
– true
, wenn im Formular der Link „Antwort bearbeiten“ angezeigt wird; false
, wenn nicht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
collectsEmail()
Bestimmt, ob im Formular die E-Mail-Adressen der Teilnehmer erfasst werden.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Sets the form to not collect respondents' email addresses. form.setCollectEmail(false); // Checks whether the form collects respondents' email addresses and logs it to // the console. const bool = form.collectsEmail(); console.log(bool);
Rückflug
Boolean
– true
, wenn im Formular E-Mail-Adressen erfasst werden; false
, wenn nicht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse()
Erstellt eine neue Antwort auf das Formular. Wenn Sie ein Frageelement beantworten möchten, erstellen Sie einen ItemResponse
aus dem Element und hängen Sie ihn dann an diese Formularantwort an, indem Sie FormResponse.withItemResponse(response)
aufrufen. Rufen Sie FormResponse.submit()
auf, um die zusammengestellte Antwort zu speichern.
Rückflug
FormResponse
: Die neu erstellte Formularantwort.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
deleteAllResponses()
Löscht alle eingereichten Antworten aus dem Antwortspeicher des Formulars. Mit dieser Methode werden keine Kopien von Antworten gelöscht, die in einem externen Antwortziel (z. B. einer Tabelle) gespeichert sind. Die Zusammenfassungsansicht des Formulars wird jedoch gelöscht.
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
deleteItem(index)
Löscht das Element an einem bestimmten Index unter allen Elementen im Formular. Es wird eine Scripting-Ausnahme geworfen, wenn unter dem angegebenen Index kein Element vorhanden ist.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Gets all the items from the form. const items = form.getItems(); // Finds the index of a paragraph text item and deletes it by the item's index. const index = items.findIndex( (item) => item.getType() === FormApp.ItemType.PARAGRAPH_TEXT, ); if (index !== -1) { form.deleteItem(index); }
Parameter
Name | Typ | Beschreibung |
---|---|---|
index | Integer | Der Index des Elements unter allen Elementen im Formular. |
Löst aus
Error
: Wenn an der angegebenen Position kein Element vorhanden ist
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
deleteItem(item)
Löscht das angegebene Element. Löst eine Scripting-Ausnahme aus, wenn das Element bereits gelöscht wurde.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Gets all of the items from the form. const items = form.getItems(); // Finds a paragraph text item and deletes it. const item = items.find( (item) => item.getType() === FormApp.ItemType.PARAGRAPH_TEXT, ); if (item) { form.deleteItem(item); }
Parameter
Name | Typ | Beschreibung |
---|---|---|
item | Item | Das zu löschende Element. |
Löst aus
Error
: wenn das Element nicht im Formular vorhanden ist
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
deleteResponse(responseId)
Löscht eine einzelne Antwort aus dem Antwortspeicher des Formulars. Mit dieser Methode werden keine Kopien von Antworten gelöscht, die in einem externen Antwortziel (z. B. einer Tabelle) gespeichert sind. Die Antwort wird jedoch aus der Zusammenfassungsansicht des Formulars entfernt. Die Antwort-ID kann mit FormResponse.getId()
abgerufen werden.
Parameter
Name | Typ | Beschreibung |
---|---|---|
responseId | String | Die ID der zu löschenden Formularantwort. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getConfirmationMessage()
Ruft die Bestätigungsnachricht des Formulars ab.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Sets the confirmation message to display after someone submits the form. form.setConfirmationMessage('You successfully submitted the form.'); // Gets the confirmation message and logs it to the console. const message = form.getConfirmationMessage(); console.log(message);
Rückflug
String
: Die Bestätigungsnachricht des Formulars.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getCustomClosedFormMessage()
Die benutzerdefinierte Nachricht, die angezeigt wird, wenn im Formular keine Antworten akzeptiert werden, oder ein leerer String, wenn keine benutzerdefinierte Nachricht festgelegt ist.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Sets a custom closed form message to display to the user when the form // no longer accepts responses. form.setCustomClosedFormMessage('The form is no longer accepting responses.'); // Gets the custom message set for the form and logs it to the console. const message = form.getCustomClosedFormMessage(); console.log(message);
Rückflug
String
: Die benutzerdefinierte Nachricht, die angezeigt wird, wenn im Formular keine Antworten akzeptiert werden, oder ein leerer String, wenn keine benutzerdefinierte Nachricht festgelegt ist.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getDescription()
Ruft die Beschreibung des Formulars ab.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Sets the form description. form.setDescription('This is the form description.'); // Gets the form description and logs it to the console. const description = form.getDescription(); console.log(description);
Rückflug
String
: Die Beschreibung des Formulars.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getDestinationId()
Ruft die ID des Antwortziels des Formulars ab.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Creates a spreadsheet to use as the response destination. const ss = SpreadsheetApp.create('Test_Spreadsheet'); // Updates the form's response destination. form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId()); // Gets the ID of the form's response destination and logs it to the console. const destinationId = form.getDestinationId(); console.log(destinationId);
Rückflug
String
: Die ID des Antwortziels des Formulars.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getDestinationType()
Der Typ des Antwortziels des Formulars.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc1234556/edit', ); // Gets the type of the form's response destination and logs it to the console. const destinationType = form.getDestinationType().name(); console.log(destinationType);
Rückflug
DestinationType
: Der Typ des Antwortziels des Formulars.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getEditUrl()
Die URL, über die der Bearbeitungsmodus des Formulars aufgerufen werden kann.
// Opens the form by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Gets the URL that accesses the form's edit mode and logs it to the console. const url = form.getEditUrl(); console.log(url);
Rückflug
String
: Die URL, unter der das Formular bearbeitet werden kann.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getEditors()
Ruft die Liste der Mitbearbeiter für diese Form
ab.
Rückflug
User[]
: Ein Array von Nutzern mit Bearbeitungsberechtigung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Ruft die ID des Formulars ab.
// Opens the form by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Gets the ID of the form and logs it to the console. const id = form.getId(); console.log(id);
Rückflug
String
: Die ID des Formulars.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getItemById(id)
Ruft das Element mit einer bestimmten ID ab. Gibt null
zurück, wenn die ID keinem Element im Formular entspricht.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Gets the ID of the first item on the form. const itemId = form.getItems()[0].getId(); // Gets the item from the ID. const item = form.getItemById(itemId); // Gets the name of the item type and logs it to the console. const type = item.getType().name(); console.log(type);
Parameter
Name | Typ | Beschreibung |
---|---|---|
id | Integer | Die ID des Artikels. |
Rückflug
Item
: Das Element mit der angegebenen ID oder null
, wenn das Element im Formular nicht vorhanden ist.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getItems()
Ruft ein Array aller Elemente im Formular ab.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Gets the list of items in the form. const items = form.getItems(); // Gets the type for each item and logs them to the console. const types = items.map((item) => item.getType().name()); console.log(types);
Rückflug
Item[]
: Ein Array mit allen Elementen im Formular.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getItems(itemType)
Ruft ein Array aller Elemente eines bestimmten Typs ab.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Gets a list of all checkbox items on the form. const items = form.getItems(FormApp.ItemType.CHECKBOX); // Gets the title of each checkbox item and logs them to the console. const checkboxItemsTitle = items.map( (item) => item.asCheckboxItem().getTitle(), ); console.log(checkboxItemsTitle);
Parameter
Name | Typ | Beschreibung |
---|---|---|
itemType | ItemType | Die Art der abzurufenden Elemente. |
Rückflug
Item[]
: Ein Array aller Elemente dieses Typs.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getPublishedUrl()
Ruft die URL ab, über die das Formular ausgefüllt werden kann.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Gets the URL to respond to the form and logs it to the console. const url = form.getPublishedUrl(); console.log(url);
Rückflug
String
: Die URL, unter der das Formular ausgefüllt werden kann.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getResponse(responseId)
Ruft eine einzelne Formularantwort anhand ihrer Antwort-ID ab. Antwort-IDs können unter FormResponse.getId()
abgerufen werden.
Parameter
Name | Typ | Beschreibung |
---|---|---|
responseId | String | Die ID für die Formularantwort. |
Rückflug
FormResponse
: Die Formularantwort.
Löst aus
Error
– wenn die Antwort nicht vorhanden ist
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getResponses()
Ruft ein Array aller Antworten des Formulars ab.
Rückflug
FormResponse[]
: Ein Array mit allen Antworten des Formulars.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getResponses(timestamp)
Ruft ein Array aller Antworten des Formulars nach einem bestimmten Datum und einer bestimmten Uhrzeit ab.
Parameter
Name | Typ | Beschreibung |
---|---|---|
timestamp | Date | Das früheste Datum und die früheste Uhrzeit, zu dem bzw. zu der Formularantworten zurückgegeben werden sollen. |
Rückflug
FormResponse[]
: Liste der Formularantworten.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getShuffleQuestions()
Bestimmt, ob die Reihenfolge der Fragen auf jeder Seite des Formulars zufällig ist.
Rückflug
Boolean
– true
, wenn die Reihenfolge der Fragen auf jeder Seite des Formulars zufällig ist; false
, wenn nicht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getSummaryUrl()
Die URL, über die eine Zusammenfassung der Antworten auf das Formular aufgerufen werden kann. Sofern setPublishingSummary(enabled)
nicht auf true
festgelegt ist, können nur Nutzer mit Bearbeitungsberechtigung für das Formular auf die URL zugreifen.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // Opens the form by its URL. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Gets the URL to view a summary of the form's responses and logs it to the // console. const url = form.getSummaryUrl(); console.log(url);
Rückflug
String
: Die URL, unter der eine Zusammenfassung der Antworten angezeigt wird.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Ruft den Titel des Formulars ab.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Sets the title of the form to 'For_Testing.' form.setTitle('For_Testing'); // Gets the title of the form and logs it to the console. const title = form.getTitle(); console.log(title);
Rückflug
String
: Der Titel des Formulars.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
hasLimitOneResponsePerUser()
Bestimmt, ob im Formular nur eine Antwort pro Teilnehmer zulässig ist. Wenn der Wert true
ist, kann das Script keine Formularantworten senden.
Rückflug
Boolean
– true
, wenn im Formular nur eine Antwort pro Teilnehmer zulässig ist; false
, wenn nicht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
hasProgressBar()
Bestimmt, ob im Formular eine Fortschrittsanzeige angezeigt wird.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // Opens the form by its URL. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Displays the progress bar on the form. form.setProgressBar(true); // Checks if the form displays a progress bar and logs it to the console. console.log(form.hasProgressBar());
Rückflug
Boolean
– true
, wenn im Formular eine Fortschrittsanzeige angezeigt wird, false
, wenn nicht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
hasRespondAgainLink()
Bestimmt, ob im Formular nach dem Ausfüllen ein Link zum Einreichen einer weiteren Antwort angezeigt wird.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Sets the form to display a link to submit another // response after someone submits the form. form.setShowLinkToRespondAgain(true); // Checks if the form displays a 'Submit another response' link and logs it to // the console. console.log(form.hasRespondAgainLink());
Rückflug
Boolean
– true
, wenn im Formular der Link „Weitere Antwort senden“ angezeigt wird; false
, wenn nicht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isAcceptingResponses()
Bestimmt, ob für das Formular derzeit Antworten angenommen werden.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Sets the form to accept responses. form.setAcceptingResponses(true); // Checks if the form is accepting responses or not and logs it to the console. const accepting = form.isAcceptingResponses(); console.log(accepting);
Rückflug
Boolean
– true
, wenn für das Formular Antworten angenommen werden; false
, wenn nicht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isPublishingSummary()
Bestimmt, ob im Formular ein Link zu einer Zusammenfassung der Antworten angezeigt wird, nachdem ein Teilnehmer das Formular ausgefüllt hat.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Sets the form to display a link to a summary of // the responses after someone submits the form. form.setPublishingSummary(true); // Checks if the form displays a "See previous responses" link and logs it to // the console. const publishingLink = form.isPublishingSummary(); console.log(publishingLink);
Rückflug
Boolean
– true
, wenn im Formular der Link „Vorherige Antworten ansehen“ angezeigt wird; false
, wenn nicht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isQuiz()
Bestimmt, ob es sich bei dem Formular um ein Quiz handelt.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Sets the form as a quiz. form.setIsQuiz(true); // Checks if the form is a quiz or not and logs it to the console. console.log(form.isQuiz());
Rückflug
Boolean
– true
, wenn für das Formular Antworten angenommen werden; false
, wenn nicht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
moveItem(from, to)
Verschiebt ein Element an einem bestimmten Index unter allen Elementen im Formular an einen anderen Index. Löst eine Scripting-Ausnahme aus, wenn der Index von to
außerhalb des zulässigen Bereichs liegt.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Moves the first item to be the last item. form.moveItem(0, form.getItems().length - 1);
Parameter
Name | Typ | Beschreibung |
---|---|---|
from | Integer | Der aktuelle Index des Elements unter allen Elementen im Formular. |
to | Integer | Der neue Index für das Element unter allen Elementen im Formular. |
Rückflug
Item
: Das Element, das verschoben wurde.
Löst aus
Error
, wenn einer der Indexe außerhalb des zulässigen Bereichs liegt.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
moveItem(item, toIndex)
Verschiebt ein bestimmtes Element an einen bestimmten Index unter allen Elementen im Formular. Löst eine Scripting-Ausnahme aus, wenn der angegebene Index außerhalb des zulässigen Bereichs liegt.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Gets the first item. const item = form.getItems()[0]; // Moves the item to be the last item. form.moveItem(item, form.getItems().length - 1);
Parameter
Name | Typ | Beschreibung |
---|---|---|
item | Item | Das Element, das verschoben werden soll. |
toIndex | Integer | Der neue Index des Artikels unter allen Artikeln im Formular. |
Rückflug
Item
: Das Element, das verschoben wurde.
Löst aus
Error
: Wenn der Index außerhalb des zulässigen Bereichs liegt.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
removeDestination()
Die Verknüpfung des Formulars mit dem aktuellen Antwortziel wird aufgehoben. Für das getrennte vorherige Ziel wird weiterhin eine Kopie aller bisherigen Antworten aufbewahrt. Bei allen Formularen, auch bei solchen, für die kein Ziel explizit festgelegt ist, wird eine Kopie der Antworten im Antwortspeicher des Formulars gespeichert. Wenn das Formular derzeit kein Antwortziel hat, hat diese Methode keine Auswirkungen.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Opens a spreadsheet to use for the response destination. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Updates the form's response destination to the spreadsheet. form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId()); // Unlinks the form from the spreadsheet. form.removeDestination();
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
removeEditor(emailAddress)
Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der Form
entfernt. Mit dieser Methode wird der Zugriff von Nutzern auf die Form
nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die Form
für die gesamte Domain des Nutzers freigegeben wurde oder sich die Form
in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.
Bei Drive-Dateien wird der Nutzer dadurch auch aus der Liste der Betrachter entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die E-Mail-Adresse des Nutzers, der entfernt werden soll. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
removeEditor(user)
Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der Form
entfernt. Mit dieser Methode wird der Zugriff von Nutzern auf die Form
nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die Form
für die gesamte Domain des Nutzers freigegeben wurde oder sich die Form
in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.
Bei Drive-Dateien wird der Nutzer dadurch auch aus der Liste der Betrachter entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des zu entfernenden Nutzers. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setAcceptingResponses(enabled)
Gibt an, ob derzeit Antworten für das Formular akzeptiert werden. Der Standardwert für neue Formulare ist true
.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Sets the form to accept responses. form.setAcceptingResponses(true); // Checks whether the form is accepting responses or not and logs it to the // console. console.log(form.isAcceptingResponses());
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | true , wenn das Formular Antworten akzeptieren soll, oder false , wenn das nicht der Fall sein soll. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setAllowResponseEdits(enabled)
Hier legen Sie fest, ob im Formular nach dem Senden einer Antwort ein Link zum Bearbeiten angezeigt wird. Der Standardwert für neue Formulare ist false
.
Unabhängig von dieser Einstellung ermöglicht die Methode FormResponse.getEditResponseUrl()
einem Script-Autor, der die Berechtigung zum Bearbeiten des Formulars hat, eine URL zu generieren, mit der eine Antwort bearbeitet werden kann.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Shows "Edit your response" link after someone submits the form. form.setAllowResponseEdits(true); // Checks whether the option to edit the form after a user submits it is set to // true or not and logs it to the console. console.log(form.canEditResponse());
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | true , wenn im Formular der Link „Antwort bearbeiten“ angezeigt werden soll, false andernfalls. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setCollectEmail(collect)
Hier legen Sie fest, ob im Formular die E-Mail-Adressen der Teilnehmer erfasst werden. Der Standardwert für neue Formulare ist false
.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Sets the form to collect respondents' email addresses. form.setCollectEmail(true); // Checks whether the value is set to true or false and logs it to the console. const collect = form.collectsEmail(); console.log(collect);
Parameter
Name | Typ | Beschreibung |
---|---|---|
collect | Boolean | true , wenn im Formular E-Mail-Adressen erfasst werden sollen, false , wenn nicht. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setConfirmationMessage(message)
Hiermit wird die Bestätigungsnachricht für das Formular festgelegt.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Sets a custom confirmation message to display after someone submits the form. form.setConfirmationMessage('Your form has been successfully submitted.'); // Gets the confirmation message set for the form and logs it to the console. const message = form.getConfirmationMessage(); console.log(message);
Parameter
Name | Typ | Beschreibung |
---|---|---|
message | String | Die neue Bestätigungsnachricht des Formulars. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setCustomClosedFormMessage(message)
Hier legen Sie fest, welche Meldung angezeigt werden soll, wenn für das Formular keine Antworten akzeptiert werden. Wenn keine Nachricht festgelegt ist, wird im Formular eine Standardnachricht verwendet.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Sets the form to not accept responses. form.setAcceptingResponses(false); // Sets a custom closed form message to display to the user. form.setCustomClosedFormMessage('The form is no longer accepting responses.'); // Gets the custom message set for the form and logs it to the console. const message = form.getCustomClosedFormMessage(); console.log(message);
Parameter
Name | Typ | Beschreibung |
---|---|---|
message | String | Die Nachricht, die angezeigt werden soll, wenn für das Formular keine Antworten akzeptiert werden. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setDescription(description)
Hier legen Sie die Beschreibung des Formulars fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
description | String | Die neue Beschreibung des Formulars. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setDestination(type, id)
Hier legen Sie den Speicherort für Formularantworten fest. Bei allen Formularen, auch bei denen, für die kein Ziel explizit festgelegt ist, wird eine Kopie der Antworten im Antwortspeicher des Formulars gespeichert.
Parameter
Name | Typ | Beschreibung |
---|---|---|
type | DestinationType | Der Typ des Antwortziels des Formulars. |
id | String | Die ID des Antwortziels des Formulars. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Löst aus
Error
: Die angegebene Ziel-ID ist ungültig.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setIsQuiz(enabled)
Hiermit wird festgelegt, ob es sich bei dem Formular um ein Quiz handelt. Der Standardwert für neue Formulare ist false
.
Benotete Fragen sind nur in Quizzen zulässig. Wenn Sie diese Option auf false
festlegen, werden alle Benotungsoptionen aus allen Fragen entfernt.
Die Quizeinstellungen sind nur in der neuen Google Formulare-Benutzeroberfläche verfügbar. Wenn Sie ein Formular in ein Quiz umwandeln, wird die neue Benutzeroberfläche verwendet.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Makes the form a quiz. form.setIsQuiz(true); // Checks whether the form is a quiz or not and logs it to the console. console.log(form.isQuiz());
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | true , wenn Quizfunktionen für das Formular aktiviert werden sollen, false andernfalls. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setLimitOneResponsePerUser(enabled)
Hiermit wird festgelegt, ob im Formular nur eine Antwort pro Teilnehmer zulässig ist. Der Standardwert für neue Formulare ist false
. Wenn der Wert auf true
gesetzt ist, kann das Script keine Formularantworten senden.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | true , wenn im Formular nur eine Antwort pro Teilnehmer zulässig sein soll, false andernfalls. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setProgressBar(enabled)
Legt fest, ob das Formular eine Fortschrittsanzeige hat. Der Standardwert für neue Formulare ist false
.
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Displays the progress bar on the form. form.setProgressBar(true); // Checks whether the form has a progress bar and logs it to the console. console.log(form.hasProgressBar());
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | true , wenn im Formular eine Fortschrittsanzeige angezeigt wird, false , wenn nicht. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPublishingSummary(enabled)
Hiermit wird festgelegt, ob im Formular ein Link zu einer Zusammenfassung der Antworten angezeigt wird, nachdem ein Teilnehmer das Formular gesendet hat. Der Standardwert für neue Formulare ist false
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | true , wenn im Formular der Link „Vorherige Antworten ansehen“ angezeigt werden soll, false andernfalls. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setShowLinkToRespondAgain(enabled)
Hiermit wird festgelegt, ob im Formular ein Link zum Einreichen einer weiteren Antwort angezeigt wird, nachdem ein Teilnehmer das Formular ausgefüllt hat. Der Standardwert für neue Formulare ist true
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | true , wenn im Formular der Link „Weitere Antwort senden“ angezeigt werden soll, false andernfalls. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setShuffleQuestions(shuffle)
Hier legen Sie fest, ob die Reihenfolge der Fragen auf jeder Seite des Formulars zufällig ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
shuffle | Boolean | true , wenn die Reihenfolge der Fragen auf jeder Seite des Formulars zufällig sein soll, false , wenn nicht. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Hiermit wird der Titel des Formulars festgelegt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | Der neue Titel des Formulars. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
shortenFormUrl(url)
Wandelt eine lange URL für ein Formular in eine kurze URL um. Löst eine Ausnahme aus, wenn die lange URL nicht zu Google Formulare gehört.
Parameter
Name | Typ | Beschreibung |
---|---|---|
url | String | Die URL, die verkürzt werden soll. |
Rückflug
String
: Eine URL im Format http://goo.gl/forms/1234
.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
submitGrades(responses)
Reicht Noten für die angegebenen FormResponses ein.
Wenn Ihr Code einen onFormSubmit
-Trigger enthält, löst der Aufruf von submitGrades()
die onFormSubmit
-Bedingung aus und führt zu einer Endlosschleife. Fügen Sie Code hinzu, der prüft, ob Noten bereits vorhanden sind, bevor submitGrades()
aufgerufen wird, um einen unendlichen Schleifenlauf zu vermeiden.
Parameter
Name | Typ | Beschreibung |
---|---|---|
responses | FormResponse[] | Ein Array mit allen Antworten des Formulars. |
Rückflug
Form
– Dieses Form
für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms