Ein Formular, das allgemeine Eigenschaften und Elemente enthält. Zu den Eigenschaften gehören Titel, Einstellungen und wo
werden gespeichert. Elemente umfassen Frageelemente wie Kästchen oder Optionsfelder, während
Elemente wie Seitenumbrüche. Formulare können über FormApp
erstellt oder aufgerufen werden.
// Open a form by ID and create a new spreadsheet. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var 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 | Hängt eine neue Frage an, die als Raster aus Spalten und Zeilen dargestellt wird, mit der die Teilnehmer müssen pro Zeile mehrere Antwortmöglichkeiten aus einer Reihe von Kästchen auswählen. |
addCheckboxItem() | CheckboxItem | Hängt eine neue Frage an, über die der Befragte ein oder mehrere Kästchen auswählen kann: sowie eine optionale Option ein. |
addDateItem() | DateItem | Hängt ein neues Frageelement an, mit dem der Teilnehmer ein Datum angeben kann. |
addDateTimeItem() | DateTimeItem | Hängt ein neues Frageelement an, mit dem der Teilnehmer ein Datum und eine Uhrzeit angeben kann. |
addDurationItem() | DurationItem | Hängt ein neues Frageelement an, mit dem der Teilnehmer eine Dauer angeben kann. |
addEditor(emailAddress) | Form | Fügt den angegebenen Nutzer der Liste der Bearbeiter für Form hinzu. |
addEditor(user) | Form | Fügt den angegebenen Nutzer der Liste der Bearbeiter für Form hinzu. |
addEditors(emailAddresses) | Form | Fügt das angegebene Array von Nutzern der Liste der Bearbeiter für Form hinzu. |
addGridItem() | GridItem | Hängt eine neue Frage an, die als Raster aus Spalten und Zeilen dargestellt wird, mit der die Teilnehmer müssen pro Zeile eine Antwort aus einer Reihe von Optionsfeldern auswählen. |
addImageItem() | ImageItem | Hängt ein neues Layoutelement an, das ein Bild anzeigt. |
addListItem() | ListItem | Hängt eine neue Frage an, über die der Befragte eine Antwort aus einem Drop-down-Menü auswählen kann Liste. |
addMultipleChoiceItem() | MultipleChoiceItem | Fügt eine neue Frage hinzu, mit der der Befragte eine Antwort aus einer Liste von Optionsfeldern auswählen kann. oder eine optionale Option „Sonstiges“ ein. |
addPageBreakItem() | PageBreakItem | Fügt ein neues Layoutelement hinzu, das den Anfang einer Seite markiert. |
addParagraphTextItem() | ParagraphTextItem | Fügt ein neues Frageelement hinzu, in dem der Teilnehmer einen Textblock eingeben kann. |
addScaleItem() | ScaleItem | Hängt eine neue Frage an, über die der Befragte eine Antwortoption aus einer nummerierten Liste auswählen kann. die Reihenfolge der Optionsfelder. |
addSectionHeaderItem() | SectionHeaderItem | Hängt ein neues Layoutelement an, das den Anfang eines Abschnitts visuell anzeigt. |
addTextItem() | TextItem | Hängt ein neues Frageelement an, über das der Befragte eine einzelne Textzeile eingeben kann. |
addTimeItem() | TimeItem | Hängt ein neues Frageelement an, mit dem der Befragte eine Tageszeit angeben kann. |
addVideoItem() | VideoItem | Hängt ein neues Layoutelement an, das ein Video anzeigt. |
canEditResponse() | Boolean | Legt fest, ob das Formular nach dem Senden einen Link zum Bearbeiten einer Antwort anzeigt. |
collectsEmail() | Boolean | Bestimmt, ob im Formular die Daten der Befragten E-Mail-Adressen. |
createResponse() | FormResponse | Erstellt eine neue Antwort für das Formular. |
deleteAllResponses() | Form | Löscht alle gesendeten Antworten aus dem Antwortspeicher des Formulars. |
deleteItem(index) | void | Löscht das Element bei einem bestimmten Index aus 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 | Ruft die benutzerdefinierte Nachricht ab, die angezeigt wird, wenn das Formular keine Antworten akzeptiert oder ein leeres Feld angegeben wird String, wenn keine benutzerdefinierte Nachricht festgelegt ist. |
getDescription() | String | Ruft die Formularbeschreibung ab. |
getDestinationId() | String | Ruft die ID des Antwortziels des Formulars ab. |
getDestinationType() | DestinationType | Ruft den Typ des Antwortziels des Formulars ab. |
getEditUrl() | String | Ruft die URL ab, die für den Zugriff auf den Bearbeitungsmodus des Formulars verwendet werden kann. |
getEditors() | User[] | Ruft die Liste der Bearbeiter für dieses Form -Element 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, die zum Antworten auf das Formular verwendet werden kann. |
getResponse(responseId) | FormResponse | Ruft eine einzelne Formularantwort basierend auf ihrer Antwort-ID ab. |
getResponses() | FormResponse[] | Ruft ein Array aller Formularantworten ab. |
getResponses(timestamp) | FormResponse[] | Ruft ein Array aller Formularantworten nach einem bestimmten Datum und einer bestimmten Uhrzeit ab. |
getShuffleQuestions() | Boolean | Bestimmt, ob die Reihenfolge der Fragen auf jeder Seite des Formulars zufällig ausgewählt wird. |
getSummaryUrl() | String | Ruft die URL ab, die zum Anzeigen einer Zusammenfassung der Formularantworten verwendet werden kann. |
getTitle() | String | Ruft den Titel des Formulars ab. |
hasLimitOneResponsePerUser() | Boolean | Legt fest, ob für das Formular nur eine Antwort pro Teilnehmer zulässig ist. |
hasProgressBar() | Boolean | Legt fest, ob im Formular eine Fortschrittsanzeige angezeigt wird. |
hasRespondAgainLink() | Boolean | Legt fest, ob im Formular ein Link angezeigt wird, über den ein Befragter eine weitere Antwort senden kann das Formular ausfüllt. |
isAcceptingResponses() | Boolean | Bestimmt, ob derzeit Antworten für das Formular akzeptiert werden. |
isPublishingSummary() | Boolean | Legt fest, ob im Formular ein Link zum Anzeigen einer Zusammenfassung der Antworten nach einem Befragten angezeigt wird das Formular ausfüllt. |
isQuiz() | Boolean | Bestimmt, ob es sich bei dem Formular um ein Quiz handelt. |
moveItem(from, to) | Item | Verschiebt ein Element an einem bestimmten Index aus allen Elementen im Formular in einen anderen angegebenen Index. |
moveItem(item, toIndex) | Item | Verschiebt ein bestimmtes Element in einen bestimmten Index unter allen Elementen im Formular. |
removeDestination() | Form | Hebt die Verknüpfung des Formulars mit seinem aktuellen Antwortziel auf. |
removeEditor(emailAddress) | Form | Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Form . |
removeEditor(user) | Form | Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Form . |
requiresLogin() | Boolean | Bestimmt, ob die Umfrageteilnehmer sich in einem Konto in derselben Domain anmelden müssen oder bevor Sie antworten. |
setAcceptingResponses(enabled) | Form | Legt fest, ob das Formular derzeit Antworten annimmt. |
setAllowResponseEdits(enabled) | Form | Legt fest, ob das Formular nach dem Senden einen Link zum Bearbeiten einer Antwort anzeigt. |
setCollectEmail(collect) | Form | Legt fest, ob für das Formular die Daten der Befragten erfasst werden E-Mail-Adressen. |
setConfirmationMessage(message) | Form | Legt die Bestätigungsnachricht des Formulars fest. |
setCustomClosedFormMessage(message) | Form | Legt fest, welche Nachricht angezeigt wird, wenn das Formular keine Antworten akzeptiert. |
setDescription(description) | Form | Legt die Formularbeschreibung fest. |
setDestination(type, id) | Form | Legt das Ziel fest, an dem Formularantworten gespeichert werden. |
setIsQuiz(enabled) | Form | Legt fest, ob das Formular ein Quiz ist. |
setLimitOneResponsePerUser(enabled) | Form | Legt fest, ob für das Formular nur eine Antwort pro Teilnehmer zulässig ist. |
setProgressBar(enabled) | Form | Legt fest, ob das Formular eine Fortschrittsanzeige hat. |
setPublishingSummary(enabled) | Form | Legt fest, ob das Formular einen Link zum Ansehen einer Zusammenfassung der Antworten anzeigt, nachdem ein Befragter eine Antwort gesendet hat das Formular ausfüllen. |
setRequireLogin(requireLogin) | Form | Legt fest, ob sich Umfrageteilnehmer in einem Konto in derselben Domain oder in einem bevor Sie antworten. |
setShowLinkToRespondAgain(enabled) | Form | Legt fest, ob im Formular ein Link zum Senden einer weiteren Antwort angezeigt wird, nachdem ein Befragter ausgefüllt wurde das Formular ausfüllen. |
setShuffleQuestions(shuffle) | Form | Legt fest, ob die Reihenfolge der Fragen auf jeder Seite des Formulars zufällig ausgewählt werden soll. |
setTitle(title) | Form | Legt den Titel des Formulars fest. |
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()
Hängt eine neue Frage an, die als Raster aus Spalten und Zeilen dargestellt wird, mit der die Teilnehmer müssen pro Zeile mehrere Antwortmöglichkeiten aus einer Reihe von Kästchen 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(); // Sets the title 'Where did you celebrate New Year's?' 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addCheckboxItem()
Hängt eine neue Frage an, über die der Befragte ein oder mehrere Kästchen auswählen kann: sowie eine optionale Option ein.
// 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addDateItem()
Hängt ein neues Frageelement an, mit dem der Teilnehmer 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addDateTimeItem()
Hängt ein neues Frageelement an, mit dem der Teilnehmer ein Datum und eine Uhrzeit 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 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addDurationItem()
Hängt ein neues Frageelement an, mit dem der Teilnehmer eine Dauer 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 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addEditor(emailAddress)
Fügt den angegebenen Nutzer der Liste der Bearbeiter für Form
hinzu. Wenn der Nutzer
wird der Nutzer mit dieser Methode aus der Betrachterliste hochgestuft.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die E-Mail-Adresse des hinzuzufügenden Nutzers. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addEditor(user)
Fügt den angegebenen Nutzer der Liste der Bearbeiter für Form
hinzu. Wenn der Nutzer
wird der Nutzer mit dieser Methode aus der Betrachterliste hochgestuft.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Darstellung des hinzuzufügenden Nutzers. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addEditors(emailAddresses)
Fügt das angegebene Array von Nutzern der Liste der Bearbeiter für Form
hinzu. Wenn eines der
Nutzer, die bereits auf der Liste der Betrachter stehen, werden sie mit dieser Methode aus der Liste der
Zuschauer*innen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddresses | String[] | Ein Array mit E-Mail-Adressen der Nutzer, die hinzugefügt werden sollen. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addGridItem()
Hängt eine neue Frage an, die als Raster aus Spalten und Zeilen dargestellt wird, mit der die Teilnehmer müssen pro Zeile eine Antwort aus einer Reihe von Optionsfeldern 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 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addImageItem()
Hängt ein neues Layoutelement an, das ein Bild anzeigt.
// 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addListItem()
Hängt eine neue Frage an, über die der Befragte eine Antwort aus einem Drop-down-Menü auswählen kann Liste.
// 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addMultipleChoiceItem()
Fügt eine neue Frage hinzu, mit der der Befragte eine Antwort aus einer Liste von Optionsfeldern auswählen kann. oder eine optionale Option "Sonstiges" ein.
// 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addPageBreakItem()
Fügt ein neues Layoutelement hinzu, das den Anfang 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addParagraphTextItem()
Fügt ein neues Frageelement hinzu, in dem der Teilnehmer einen Textblock eingeben 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'); // 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addScaleItem()
Hängt eine neue Frage an, über die der Befragte eine Antwortoption aus einer nummerierten Liste auswählen kann. die Reihenfolge der Optionsfelder.
// 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addSectionHeaderItem()
Hängt ein neues Layoutelement an, das den Anfang eines Abschnitts visuell anzeigt.
// 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addTextItem()
Hängt ein neues Frageelement an, über das der Befragte eine einzelne Textzeile eingeben 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 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addTimeItem()
Hängt ein neues Frageelement an, mit dem der Befragte eine Tageszeit 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 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addVideoItem()
Hängt ein neues Layoutelement an, das ein Video anzeigt.
// 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
canEditResponse()
Legt fest, ob das Formular nach dem Senden einen Link zum Bearbeiten einer Antwort anzeigt.
Unabhängig von dieser Einstellung lässt die Methode FormResponse.getEditResponseUrl()
Skriptautor, der Bearbeitungszugriff auf das Formular hat, um eine URL zu generieren, die zum Bearbeiten eines
Antwort.
// 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 die Meldung „Antwort bearbeiten“ angezeigt wird Link; false
wenn
nicht.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
collectsEmail()
Bestimmt, ob im Formular die Daten der Befragten E-Mail-Adressen.
// 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 über das Formular E-Mail-Adressen erfasst werden false
, wenn nicht.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse()
Erstellt eine neue Antwort für das Formular. Erstelle eine ItemResponse
, um eine Frage zu beantworten
aus dem Element und hängen Sie es durch Aufrufen von FormResponse.withItemResponse(response)
an diese Formularantwort an. Rufen Sie FormResponse.submit()
auf, um die zusammengefasste Antwort zu speichern.
Rückflug
FormResponse
: Die neu erstellte Formularantwort.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
deleteAllResponses()
Löscht alle gesendeten Antworten aus dem Antwortspeicher des Formulars. Diese Methode löscht nicht Kopien von Antworten, die in einem externen Antwortziel (z. B. einer Tabelle) gespeichert sind, Zusammenfassung des Formulars löschen.
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
deleteItem(index)
Löscht das Element bei einem bestimmten Index aus allen Elementen im Formular. Löst eine Skriptausnahme aus wenn am 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 im angegebenen Index kein Element vorhanden ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 Skriptausnahme 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 Element, das gelöscht werden soll. |
Löst aus
Error
– wenn das Element nicht im Formular vorhanden ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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
in einem externen Antwortziel (z. B. einer Tabelle) gespeichert sind,
in der Zusammenfassungsansicht des Formulars. Die Antwort-ID kann mit FormResponse.getId()
abgerufen werden.
<ph type="x-smartling-placeholder">
Parameter
Name | Typ | Beschreibung |
---|---|---|
responseId | String | Die ID der zu löschenden Formularantwort. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getCustomClosedFormMessage()
Ruft die benutzerdefinierte Nachricht ab, die angezeigt wird, wenn das Formular keine Antworten akzeptiert oder ein leeres Feld angegeben wird 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
: Benutzerdefinierte Nachricht, die angezeigt wird, wenn das Formular keine Antworten akzeptiert oder wenn das Formular leer ist
String, wenn keine benutzerdefinierte Nachricht festgelegt ist.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getDescription()
Ruft die Formularbeschreibung 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getDestinationType()
Ruft den Typ 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/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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getEditUrl()
Ruft die URL ab, die für den Zugriff auf den Bearbeitungsmodus des Formulars verwendet 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 zum Bearbeiten des Formulars.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getEditors()
Ruft die Liste der Bearbeiter für dieses Form
-Element ab.
Rückflug
User[]
: ein Array von Nutzern mit Bearbeitungsberechtigung.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 in entspricht
das Formular ausfüllen.
// 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 Artikel-ID. |
Rückflug
Item
: Das Element mit der angegebenen ID oder null
, wenn das Element nicht im Formular vorhanden ist.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 aller Elemente im Formular.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 | Der Typ der abzurufenden Elemente. |
Rückflug
Item[]
: Ein Array aller Elemente dieses Typs.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getPublishedUrl()
Ruft die URL ab, die zum Antworten auf das Formular verwendet 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 zum Ausfüllen des Formulars.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getResponse(responseId)
Ruft eine einzelne Formularantwort basierend auf ihrer Antwort-ID ab. Antwort-IDs können aus 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 existiert
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getResponses()
Ruft ein Array aller Formularantworten ab.
Rückflug
FormResponse[]
: Ein Array aller Formularantworten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getResponses(timestamp)
Ruft ein Array aller Formularantworten nach einem bestimmten Datum und einer bestimmten Uhrzeit ab.
Parameter
Name | Typ | Beschreibung |
---|---|---|
timestamp | Date | Datum und Uhrzeit, zu der Formularantworten frühestens zurückgegeben werden sollen. |
Rückflug
FormResponse[]
: Die Liste der Formularantworten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 ausgewählt wird.
Rückflug
Boolean
: true
, wenn die Reihenfolge der Fragen auf jeder Seite des Formulars zufällig ausgewählt wurde
false
, wenn nicht.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getSummaryUrl()
Ruft die URL ab, die zum Anzeigen einer Zusammenfassung der Formularantworten verwendet werden kann. Sofern setPublishingSummary(enabled)
nicht auf true
festgelegt ist, sind nur Nutzer mit Bearbeitungsberechtigung für die
auf die URL zugreifen 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. // 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 zum Aufrufen einer Zusammenfassung der Antworten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
hasLimitOneResponsePerUser()
Legt fest, ob für das Formular nur eine Antwort pro Teilnehmer zulässig ist. Wenn der Wert true
lautet, kann das Skript keine Formularantworten senden.
Rückflug
Boolean
: true
, wenn im Formular nur eine Antwort pro Teilnehmer zulässig ist false
, wenn nicht.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
hasProgressBar()
Legt fest, ob im Formular ein Fortschrittsbalken 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
hasRespondAgainLink()
Legt fest, ob im Formular ein Link angezeigt wird, über den ein Befragter eine weitere Antwort senden kann das Formular ausfüllt.
// 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 die Meldung „Weitere Antwort senden“ angezeigt wird Link; false
wenn
nicht.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isAcceptingResponses()
Bestimmt, ob derzeit Antworten für das Formular akzeptiert 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 das Formular Antworten akzeptiert. false
, wenn nicht.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isPublishingSummary()
Legt fest, ob im Formular ein Link zum Anzeigen einer Zusammenfassung der Antworten nach einem Befragten angezeigt wird das Formular ausfüllt.
// 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 "Vorherige Antworten ansehen" angezeigt wird Link; false
wenn
nicht.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 das Formular Antworten akzeptiert. false
, wenn nicht.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 aus allen Elementen im Formular in einen anderen angegebenen Index. Wirf einen
Skriptausnahme, wenn der Index to
außerhalb des gültigen 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 gültigen Bereichs liegt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
moveItem(item, toIndex)
Verschiebt ein bestimmtes Element in einen bestimmten Index unter allen Elementen im Formular. Ein Scripting wird ausgelöst Ausnahme, wenn der angegebene Index außerhalb des gültigen 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 für das Element unter allen Elementen im Formular. |
Rückflug
Item
: Das Element, das verschoben wurde.
Löst aus
Error
– wenn der Index außerhalb des gültigen Bereichs liegt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
removeDestination()
Hebt die Verknüpfung des Formulars mit seinem aktuellen Antwortziel auf. Das nicht verknüpfte ehemalige Ziel ist immer noch Es speichert eine Kopie aller vorherigen Antworten. Alle Formulare, einschließlich solcher, die kein explizit festlegen, speichern Sie Kopie der Antworten im Antwortspeicher des Formulars. Enthält das Formular derzeit keine Antwortziel enthält, 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
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
removeEditor(emailAddress)
Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Form
. Bei dieser Methode werden keine
Nutzer am Zugriff auf Form
blockieren, wenn sie zu einer Nutzerklasse gehören, die
allgemeinen Zugriff haben, z. B. wenn die Form
für das gesamte
Domain oder die Form
befindet sich in einer geteilten Ablage, auf die der Nutzer zugreifen kann.
Bei Drive-Dateien wird der Nutzer dadurch auch aus der Betrachterliste entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die E-Mail-Adresse des zu entfernenden Nutzers. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
removeEditor(user)
Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Form
. Bei dieser Methode werden keine
Nutzer am Zugriff auf Form
blockieren, wenn sie zu einer Nutzerklasse gehören, die
allgemeinen Zugriff haben, z. B. wenn die Form
für das gesamte
Domain oder die Form
befindet sich in einer geteilten Ablage, auf die der Nutzer zugreifen kann.
Bei Drive-Dateien wird der Nutzer dadurch auch aus der Betrachterliste entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des zu entfernenden Nutzers. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
requiresLogin()
Bestimmt, ob die Umfrageteilnehmer sich in einem Konto in derselben Domain anmelden müssen oder bevor Sie antworten.
// 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 requires respondents to log in to a Google Workspace account // before responding and logs it to the console. const login = form.requiresLogin(); console.log(login);
Rückflug
Boolean
: true
, wenn sich Nutzer für das Formular anmelden müssen; false
, wenn nicht.
setAcceptingResponses(enabled)
Legt fest, ob das Formular derzeit Antworten annimmt. 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 annehmen soll. false , wenn nicht. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setAllowResponseEdits(enabled)
Legt fest, ob das Formular nach dem Senden einen Link zum Bearbeiten einer Antwort anzeigt. Der Standardwert für
neue Formulare ist false
.
Unabhängig von dieser Einstellung lässt die Methode FormResponse.getEditResponseUrl()
Skriptautor mit Bearbeitungsberechtigung für das Formular, um eine URL zu generieren, die zum Bearbeiten eines
Antwort.
// 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 die Meldung „Antwort bearbeiten“ angezeigt werden soll Link; false , wenn nicht. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setCollectEmail(collect)
Legt fest, ob für das Formular die Daten der Befragten erfasst werden E-Mail-Adressen. Die Standardeinstellung 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 Wenn ja, false
nicht. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setConfirmationMessage(message)
Legt die Bestätigungsnachricht des Formulars fest.
// 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
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setCustomClosedFormMessage(message)
Legt fest, welche Nachricht angezeigt wird, wenn das Formular keine Antworten akzeptiert. Wenn keine Nachricht festgelegt ist, 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 Meldung, die angezeigt wird, wenn das Formular keine Antworten akzeptiert. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setDescription(description)
Legt die Formularbeschreibung fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
description | String | Die neue Beschreibung des Formulars. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setDestination(type, id)
Legt das Ziel fest, an dem Formularantworten gespeichert werden. Alle Formulare, einschließlich solcher, die nicht ausdrücklich ein Ziel festgelegt haben, speichern Sie eine Kopie der Antworten im Antwortspeicher.
Parameter
Name | Typ | Beschreibung |
---|---|---|
type | DestinationType | Der Typ des Antwortziels des Formulars. |
id | String | Die ID des Antwortziels des Formulars. |
Rückflug
Form
: Diese Form
zum Verketten.
Löst aus
Error
– wenn die Ziel-ID ungültig ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setIsQuiz(enabled)
Legt fest, ob das Formular ein Quiz ist. Der Standardwert für neue Formulare ist false
.
Benotete Fragen sind nur in Quizzen zulässig. Wenn Sie diese Option auf false
setzen, werden daher alle
Benotungsoptionen aus allen Fragen entfernt.
Die Quizeinstellungen sind nur in der neuen Google Formulare-Benutzeroberfläche verfügbar. Wenn Sie ein Formular zu einem Quiz erstellen, wird das Formular aktiviert. die neue Benutzeroberfläche verwenden.
// 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 wenn
nicht. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setLimitOneResponsePerUser(enabled)
Legt fest, ob für das Formular nur eine Antwort pro Teilnehmer zulässig ist. Die Standardeinstellung für neue Formulare ist
false
Wenn der Wert auf true
gesetzt ist, kann das Skript keine Formularantworten senden unter
alle.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | true , wenn im Formular nur eine Antwort pro Teilnehmer zulässig sein soll false , wenn nicht. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPublishingSummary(enabled)
Legt fest, ob das Formular einen Link zum Ansehen einer Zusammenfassung der Antworten anzeigt, nachdem ein Befragter eine Antwort gesendet hat
das Formular ausfüllen. Der Standardwert für neue Formulare ist false
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | true , wenn im Formular die Meldung „Vorherige Antworten ansehen“ angezeigt werden soll Link; false , wenn nicht. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequireLogin(requireLogin)
Legt fest, ob sich Umfrageteilnehmer in einem Konto in derselben Domain oder in einem
bevor Sie antworten. Die Standardeinstellung für neue Formulare ist false
, es sei denn, es handelt sich um eine Domain
Administrator die Standardeinstellung geändert.
Diese Funktion ist nur für Formulare verfügbar, die von Google Workspace-Nutzern erstellt wurden. Nutzer anderer Google-Kontotypen nicht erforderlich sein.
// 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 so that users must log in to their Google Workspace account. form.setRequireLogin(true); // Checks whether the form requires login or not and logs it to the console. console.log(form.requiresLogin());
Parameter
Name | Typ | Beschreibung |
---|---|---|
requireLogin | Boolean | true , wenn Nutzer sich für das Formular anmelden müssen; Wenn ja, false
nicht. |
Rückflug
Form
: Das aktuelle Formular (für Verkettung).
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setShowLinkToRespondAgain(enabled)
Legt fest, ob im Formular ein Link zum Senden einer weiteren Antwort angezeigt wird, nachdem ein Befragter ausgefüllt wurde
das Formular ausfüllen. Der Standardwert für neue Formulare ist true
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | true , wenn im Formular die Meldung „Weitere Antwort senden“ angezeigt werden soll Link; false , wenn nicht. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setShuffleQuestions(shuffle)
Legt fest, ob die Reihenfolge der Fragen auf jeder Seite des Formulars zufällig ausgewählt werden soll.
Parameter
Name | Typ | Beschreibung |
---|---|---|
shuffle | Boolean | true , wenn die Reihenfolge der Fragen auf jeder Seite des Formulars
randomisiert; false , wenn nicht. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Legt den Titel des Formulars fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | Der neue Titel des Formulars. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 gehören zu Google Formulare.
Parameter
Name | Typ | Beschreibung |
---|---|---|
url | String | Die zu kürzende URL. |
Rückflug
String
: Eine URL im Format http://goo.gl/forms/1234
.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
submitGrades(responses)
Sendet Noten für die angegebenen FormResponses.
Wenn der Code einen onFormSubmit
-Trigger enthält, wird submitGrades()
aufgerufen
löst die onFormSubmit
-Bedingung aus und verursacht eine Endlosschleife. Um die
Endlosschleife: Fügen Sie Code hinzu, der vor dem Aufrufen von submitGrades()
prüft, ob Noten bereits vorhanden sind.
Parameter
Name | Typ | Beschreibung |
---|---|---|
responses | FormResponse[] | Ein Array aller Formularantworten. |
Rückflug
Form
: Diese Form
zum Verketten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms