Ogólny element formularza, który zawiera właściwości wspólne dla wszystkich elementów, np. tytuł i tekst pomocy.
Elementy można otworzyć lub utworzyć za pomocą: Form
.
Aby przeprowadzać operacje na właściwościach konkretnego typu, użyj funkcji getType()
, aby sprawdzić ItemType
elementu, a następnie prześlij go do odpowiedniej klasy za pomocą metody takiej jak asCheckboxItem()
.
// Create a new form and add a text item. var form = FormApp.create('Form Name'); form.addTextItem(); // Access the text item as a generic item. var items = form.getItems(); var item = items[0]; // Cast the generic item to the text-item class. if (item.getType() == 'TEXT') { var textItem = item.asTextItem(); textItem.setRequired(false); }
Wdrażanie zajęć
Nazwa | Krótki opis |
---|
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
asCheckboxGridItem() | CheckboxGridItem | Zwraca element jako element siatki pól wyboru. |
asCheckboxItem() | CheckboxItem | Zwraca element jako pole wyboru. |
asDateItem() | DateItem | Zwraca element jako element daty. |
asDateTimeItem() | DateTimeItem | Zwraca element jako datę i godzinę. |
asDurationItem() | DurationItem | Zwraca element jako element czasu trwania. |
asGridItem() | GridItem | Zwraca element jako element siatki. |
asImageItem() | ImageItem | Zwraca element jako obraz. |
asListItem() | ListItem | Zwraca element jako element listy. |
asMultipleChoiceItem() | MultipleChoiceItem | Zwraca element jako produkt wielokrotnego wyboru. |
asPageBreakItem() | PageBreakItem | Zwraca element jako element podziału strony. |
asParagraphTextItem() | ParagraphTextItem | Zwraca element w postaci tekstu akapitu. |
asScaleItem() | ScaleItem | Zwraca element jako element skali. |
asSectionHeaderItem() | SectionHeaderItem | Zwraca element jako element nagłówka sekcji. |
asTextItem() | TextItem | Zwraca element jako element tekstowy. |
asTimeItem() | TimeItem | Zwraca element jako element czasu. |
asVideoItem() | VideoItem | Zwraca element jako film. |
duplicate() | Item | Tworzy kopię tego elementu i dołącza ją na końcu formularza. |
getHelpText() | String | Pobiera tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems , PageBreakItems i SectionHeaderItems ). |
getId() | Integer | Pobiera unikalny identyfikator elementu. |
getIndex() | Integer | Pobiera indeks elementu spośród wszystkich elementów formularza. |
getTitle() | String | Pobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka). |
getType() | ItemType | Pobiera typ elementu, reprezentowany jako ItemType . |
setHelpText(text) | Item | Ustawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems , PageBreakItems i SectionHeaderItems ). |
setTitle(title) | Item | Ustawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka). |
Szczegółowa dokumentacja
asCheckboxGridItem()
Zwraca element jako element siatki pól wyboru. Jeśli ItemType
nie zawiera jeszcze elementu CHECKBOX_GRID
, zgłasza wyjątek od obsługi skryptów.
Powroty
CheckboxGridItem
– element siatki pól wyboru.
Rzuty
Error
– jeśli element nie jest elementem siatki pól wyboru
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
asCheckboxItem()
Zwraca element jako pole wyboru. Jeśli ItemType
nie zawiera jeszcze elementu CHECKBOX
, zgłasza wyjątek od obsługi skryptów.
Powroty
CheckboxItem
– element pola wyboru,
Rzuty
Error
– jeśli element nie jest polem wyboru;
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
asDateItem()
Zwraca element jako element daty. Jeśli ItemType
nie zawiera jeszcze elementu DATE
, zgłasza wyjątek od obsługi skryptów.
Powroty
DateItem
– element daty,
Rzuty
Error
– jeśli element nie jest elementem daty
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
asDateTimeItem()
Zwraca element jako datę i godzinę. Jeśli ItemType
nie zawiera jeszcze elementu DATETIME
, zgłasza wyjątek od obsługi skryptów.
Powroty
DateTimeItem
– element daty i godziny;
Rzuty
Error
– jeśli element nie jest elementem daty i godziny;
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
asDurationItem()
Zwraca element jako element czasu trwania. Jeśli ItemType
nie zawiera jeszcze elementu DURATION
, zgłasza wyjątek od obsługi skryptów.
Powroty
DurationItem
– element, który określa czas trwania;
Rzuty
Error
– jeśli element nie jest elementem, który nie jest czasem trwania;
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
asGridItem()
Zwraca element jako element siatki. Jeśli ItemType
nie zawiera jeszcze elementu GRID
, zgłasza wyjątek od obsługi skryptów.
Powroty
GridItem
– element siatki
Rzuty
Error
– jeśli element nie jest elementem siatki
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
asImageItem()
asListItem()
Zwraca element jako element listy. Jeśli ItemType
nie zawiera jeszcze elementu LIST
, zgłasza wyjątek od obsługi skryptów.
Powroty
ListItem
– element listy,
Rzuty
Error
– jeśli element nie jest elementem listy
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
asMultipleChoiceItem()
Zwraca element jako produkt wielokrotnego wyboru. Jeśli ItemType
nie zawiera jeszcze elementu MULTIPLE_CHOICE
, zgłasza wyjątek od obsługi skryptów.
Powroty
MultipleChoiceItem
– produkt wielokrotnego wyboru,
Rzuty
Error
– jeśli element nie jest elementem wielokrotnego wyboru;
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
asPageBreakItem()
Zwraca element jako element podziału strony. Jeśli ItemType
nie zawiera jeszcze elementu PAGE_BREAK
, zgłasza wyjątek od obsługi skryptów.
Powroty
PageBreakItem
– element podziału stron;
Rzuty
Error
– jeśli element nie jest elementem podziału strony
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
asParagraphTextItem()
Zwraca element w postaci tekstu akapitu. Jeśli ItemType
nie zawiera jeszcze elementu PARAGRAPH_TEXT
, zgłasza wyjątek od obsługi skryptów.
Powroty
ParagraphTextItem
– element tekstu akapitu,
Rzuty
Error
– jeśli element nie jest tekstem akapitu;
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
asScaleItem()
Zwraca element jako element skali. Jeśli ItemType
nie zawiera jeszcze elementu SCALE
, zgłasza wyjątek od obsługi skryptów.
Powroty
ScaleItem
– element wagi
Rzuty
Error
– jeśli element nie jest elementem wagi
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
asSectionHeaderItem()
Zwraca element jako element nagłówka sekcji. Jeśli ItemType
nie zawiera jeszcze elementu SECTION_HEADER
, zgłasza wyjątek od obsługi skryptów.
Powroty
SectionHeaderItem
– element nagłówka sekcji,
Rzuty
Error
– jeśli element nie jest elementem nagłówka sekcji
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
asTextItem()
Zwraca element jako element tekstowy. Jeśli ItemType
nie zawiera jeszcze elementu TEXT
, zgłasza wyjątek od obsługi skryptów.
Powroty
TextItem
– element tekstowy,
Rzuty
Error
– jeśli element nie jest elementem tekstowym;
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
asTimeItem()
Zwraca element jako element czasu. Jeśli ItemType
nie zawiera jeszcze elementu TIME
, zgłasza wyjątek od obsługi skryptów.
Powroty
TimeItem
– element czasu,
Rzuty
Error
– jeśli element nie jest elementem czasu
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
asVideoItem()
duplicate()
Tworzy kopię tego elementu i dołącza ją na końcu formularza.
Powroty
Item
– duplikat elementu Item
na potrzeby łańcuchów
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
getHelpText()
Pobiera tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems
, PageBreakItems
i SectionHeaderItems
).
Powroty
String
– tekst pomocy lub opis dotyczący produktu.
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
getId()
Pobiera unikalny identyfikator elementu.
Powroty
Integer
– identyfikator produktu,
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
getIndex()
Pobiera indeks elementu spośród wszystkich elementów formularza.
Powroty
Integer
– indeks elementu;
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
getTitle()
Pobiera tytuł elementu (w przypadku elementu SectionHeaderItem
jest czasami nazywany tekstem nagłówka).
Powroty
String
– tytuł lub tekst nagłówka elementu;
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
getType()
setHelpText(text)
Ustawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems
, PageBreakItems
i SectionHeaderItems
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | nowy tekst pomocy |
Powroty
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
setTitle(title)
Ustawia tytuł elementu (w przypadku elementu SectionHeaderItem
jest czasami nazywany tekstem nagłówka).
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | nowy tytuł lub tekst nagłówka. |
Powroty
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