Pozwala na otwarcie istniejącego skryptu Form
lub utworzenie nowego.
// Open a form by ID. var existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Create and open a form. var newForm = FormApp.create('Form Name');
Właściwości
Właściwość | Typ | Opis |
---|---|---|
Alignment | Alignment | Lista typów wyrównania obrazu. |
DestinationType | DestinationType | Lista typów miejsc docelowych, w których mogą być przechowywane odpowiedzi na pytania z formularza. |
FeedbackType | FeedbackType | Lista typów w postaci Feedbacks . |
ItemType | ItemType | Lista typów w postaci Items . |
PageNavigationType | PageNavigationType | Lista możliwych zachowań podczas poruszania się po stronach. |
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
create(title) | Form | Tworzy i zwraca nowy element Form . |
createCheckboxGridValidation() | CheckboxGridValidationBuilder | Zwraca instancję CheckboxGridValidationBuilder, która służy do ustawiania weryfikacji CheckboxGridItem . |
createCheckboxValidation() | CheckboxValidationBuilder | Zwraca instancję CheckboxValidationBuilder, która służy do ustawiania weryfikacji CheckboxItem . |
createFeedback() | QuizFeedbackBuilder | Zwraca instancję TestfeedbackBuilder, której można użyć do ustawienia opinii na temat oceny Item . |
createGridValidation() | GridValidationBuilder | Zwraca instancję GridValidationBuilder, która może służyć do ustawiania weryfikacji GridItem . |
createParagraphTextValidation() | ParagraphTextValidationBuilder | Zwraca instancję ParagraphTextValidationBuilder, za pomocą której można ustawić weryfikację ParagraphTextItem . |
createTextValidation() | TextValidationBuilder | Zwraca instancję TextValidationBuilder, która może służyć do ustawiania weryfikacji TextItem . |
getActiveForm() | Form | Zwraca formularz, do którego skrypt jest powiązany z kontenerem. |
getUi() | Ui | Zwraca wystąpienie środowiska edytora formularzy i interfejsu użytkownika, które umożliwia skryptowi dodanie funkcji, takich jak menu, okna i paski boczne. |
openById(id) | Form | Zwraca Form o podanym identyfikatorze. |
openByUrl(url) | Form | Zwraca Form z określonym adresem URL. |
Szczegółowa dokumentacja
create(title)
Tworzy i zwraca nowy element Form
. Zwraca wyjątek, jeśli podany tytuł to null
lub jest pusty.
// Create and open a form. var form = FormApp.create('Form Name');
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | nazwa nowego formularza; |
Zwróć
Form
– nowy formularz
Narzuty
Error
– jeśli podany tytuł to null
lub jest pusty
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms
createCheckboxGridValidation()
Zwraca instancję CheckboxGridValidationBuilder, która służy do ustawiania weryfikacji CheckboxGridItem
.
Zwróć
createCheckboxValidation()
Zwraca instancję CheckboxValidationBuilder, która służy do ustawiania weryfikacji CheckboxItem
.
Zwróć
createFeedback()
Zwraca instancję TestfeedbackBuilder, której można użyć do ustawienia opinii na temat oceny Item
.
Zwróć
createGridValidation()
Zwraca instancję GridValidationBuilder, która może służyć do ustawiania weryfikacji GridItem
.
Zwróć
createParagraphTextValidation()
Zwraca instancję ParagraphTextValidationBuilder, za pomocą której można ustawić weryfikację ParagraphTextItem
.
Zwróć
createTextValidation()
Zwraca instancję TextValidationBuilder, która może służyć do ustawiania weryfikacji TextItem
.
Zwróć
getActiveForm()
Zwraca formularz, do którego skrypt jest powiązany z kontenerem. Aby wchodzić w interakcje z formularzami, które nie są powiązane z kontenerem, użyj metody openById(id)
lub openByUrl(url)
.
// Get the form to which this script is bound. var form = FormApp.getActiveForm();
Zwróć
Form
– formularz, z którym skrypt jest powiązany, lub null
, jeśli skrypt nie jest powiązany z formularzem.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getUi()
Zwraca wystąpienie środowiska edytora formularzy i interfejsu użytkownika, które umożliwia skryptowi dodanie funkcji, takich jak menu, okna i paski boczne. Skrypt może wchodzić w interakcję z interfejsem tylko w bieżącym wystąpieniu edytora formularzy (a nie w widoku, który widzi użytkownik) i tylko wtedy, gdy skrypt jest powiązany z formularzem. Więcej informacji znajdziesz w przewodnikach po menu i oknach i paskach bocznych.
// Add a custom menu to the active form, including a separator and a sub-menu. function onOpen(e) { FormApp.getUi() .createMenu('My Menu') .addItem('My menu item', 'myFunction') .addSeparator() .addSubMenu(FormApp.getUi().createMenu('My sub-menu') .addItem('One sub-menu item', 'mySecondFunction') .addItem('Another sub-menu item', 'myThirdFunction')) .addToUi(); }
Zwróć
Ui
– wystąpienie tego formularza i interfejsu użytkownika
openById(id)
Zwraca Form
o podanym identyfikatorze. Zwraca wyjątek, jeśli identyfikator jest nieprawidłowy lub użytkownik nie ma uprawnień do otwierania formularza.
// Open a form by ID. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
Parametry
Nazwa | Typ | Opis |
---|---|---|
id | String | identyfikator formularza, który chcesz otworzyć; |
Zwróć
Form
– formularz o podanym identyfikatorze.
Narzuty
Error
– jeśli podany identyfikator jest nieprawidłowy lub użytkownik nie ma wystarczających uprawnień;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms
openByUrl(url)
Zwraca Form
z określonym adresem URL. Zwraca wyjątek, jeśli URL jest nieprawidłowy lub użytkownik nie ma uprawnień do otwierania formularza.
// Open a form by URL. var form = FormApp.openByUrl( 'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit' );
Parametry
Nazwa | Typ | Opis |
---|---|---|
url | String | adres URL formularza, który chcesz otworzyć. |
Zwróć
Form
– formularz o podanym adresie URL,
Narzuty
Error
– jeśli podany adres URL jest nieprawidłowy lub użytkownik nie ma wystarczających uprawnień
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms