Zezwala skryptowi na otwarcie istniejącego elementu 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 obrazów. |
DestinationType | DestinationType | Lista typów miejsc docelowych, w których mogą być przechowywane odpowiedzi z formularza. |
FeedbackType | FeedbackType | Lista typów formularza Feedbacks . |
ItemType | ItemType | Lista typów formularza 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 obiekt Form . |
createCheckboxGridValidation() | CheckboxGridValidationBuilder | Zwraca wystąpienie obiektu CheckboxGridValidationBuilder, którego można użyć do ustawienia weryfikacji obiektu CheckboxGridItem . |
createCheckboxValidation() | CheckboxValidationBuilder | Zwraca wystąpienie obiektu CheckboxValidationBuilder, którego można użyć do ustawienia weryfikacji obiektu CheckboxItem . |
createFeedback() | QuizFeedbackBuilder | Zwraca wystąpienie obiektu QuizfeedbackBuilder, którego można używać do ustawiania opinii na temat elementu Item z możliwością oceny. |
createGridValidation() | GridValidationBuilder | Zwraca wystąpienie obiektu GridValidationBuilder, którego można użyć do ustawienia weryfikacji obiektu GridItem . |
createParagraphTextValidation() | ParagraphTextValidationBuilder | Zwraca wystąpienie obiektu ParagraphTextValidationBuilder, którego można użyć do ustawienia weryfikacji na obiekcie ParagraphTextItem . |
createTextValidation() | TextValidationBuilder | Zwraca wystąpienie obiektu TextValidationBuilder, którego można użyć do sprawdzenia poprawności elementu TextItem . |
getActiveForm() | Form | Zwraca formę, do której skrypt jest powiązany z kontenerem container-bound. |
getUi() | Ui | Zwraca wystąpienie środowiska interfejsu użytkownika edytora formularzy, które umożliwia skryptowi dodawanie takich funkcji jak menu, okna i paski boczne. |
openById(id) | Form | Zwraca wartość Form o określonym identyfikatorze. |
openByUrl(url) | Form | Zwraca wartość Form z określonym adresem URL. |
Szczegółowa dokumentacja
create(title)
Tworzy i zwraca nowy obiekt Form
. Jeśli podany tytuł ma wartość null
lub jest pusty, powoduje zgłoszenie wyjątku.
// Create and open a form. var form = FormApp.create('Form Name');
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | nazwa nowego formularza; |
Powroty
Form
– nowy formularz
Rzuty
Error
– jeśli tytuł ma wartość null
lub jest pusty.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms
createCheckboxGridValidation()
Zwraca wystąpienie obiektu CheckboxGridValidationBuilder, którego można użyć do ustawienia weryfikacji obiektu CheckboxGridItem
.
Powroty
createCheckboxValidation()
Zwraca wystąpienie obiektu CheckboxValidationBuilder, którego można użyć do ustawienia weryfikacji obiektu CheckboxItem
.
Powroty
createFeedback()
Zwraca wystąpienie obiektu QuizfeedbackBuilder, którego można używać do ustawiania opinii na temat elementu Item
z możliwością oceny.
Powroty
createGridValidation()
Zwraca wystąpienie obiektu GridValidationBuilder, którego można użyć do ustawienia weryfikacji obiektu GridItem
.
Powroty
createParagraphTextValidation()
Zwraca wystąpienie obiektu ParagraphTextValidationBuilder, którego można użyć do ustawienia weryfikacji na obiekcie ParagraphTextItem
.
Powroty
createTextValidation()
Zwraca wystąpienie obiektu TextValidationBuilder, którego można użyć do sprawdzenia poprawności elementu TextItem
.
Powroty
getActiveForm()
Zwraca formę, do której skrypt jest powiązany z kontenerem container-bound. Do interakcji z formularzami, do których skrypt nie jest powiązany z kontenerem, użyj openById(id)
lub openByUrl(url)
.
// Get the form to which this script is bound. var form = FormApp.getActiveForm();
Powroty
Form
– forma, z którą powiązany jest skrypt, lub null
, jeśli skrypt nie jest powiązany z formularzem;
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getUi()
Zwraca wystąpienie środowiska interfejsu użytkownika edytora formularzy, które umożliwia skryptowi dodawanie takich funkcji jak menu, okna i paski boczne. Skrypt może wchodzić w interakcje z interfejsem tylko w przypadku bieżącego wystąpienia otwartego edytora formularzy (a nie widoku wyświetlanego użytkownikowi) i tylko wtedy, gdy skrypt jest powiązany z formularzem. Więcej informacji znajdziesz w przewodnikach po menu oraz oknach dialogowych 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(); }
Powroty
Ui
– wystąpienie środowiska interfejsu użytkownika tego formularza
openById(id)
Zwraca wartość Form
o określonym identyfikatorze. Zwraca wyjątek, jeśli identyfikator jest nieprawidłowy lub użytkownik nie ma uprawnień do otwarcia formularza.
// Open a form by ID. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
Parametry
Nazwa | Typ | Opis |
---|---|---|
id | String | identyfikator formularza, który chcesz otworzyć |
Powroty
Form
– formularz o podanym identyfikatorze,
Rzuty
Error
– jeśli podany identyfikator jest nieprawidłowy lub użytkownik nie ma wystarczających uprawnień
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms
openByUrl(url)
Zwraca wartość Form
z określonym adresem URL. Jeśli adres URL jest nieprawidłowy lub użytkownik nie ma uprawnień do otwierania formularza, tworzy wyjątek.
// 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ć |
Powroty
Form
– formularz o podanym adresie URL,
Rzuty
Error
– jeśli podany adres URL jest nieprawidłowy lub użytkownik nie ma wystarczających uprawnień
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms