Interface Item

Element

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ęć

NazwaKrótki opis

Metody

MetodaZwracany typKrótki opis
asCheckboxGridItem()CheckboxGridItemZwraca element jako element siatki pól wyboru.
asCheckboxItem()CheckboxItemZwraca element jako pole wyboru.
asDateItem()DateItemZwraca element jako element daty.
asDateTimeItem()DateTimeItemZwraca element jako datę i godzinę.
asDurationItem()DurationItemZwraca element jako element czasu trwania.
asGridItem()GridItemZwraca element jako element siatki.
asImageItem()ImageItemZwraca element jako obraz.
asListItem()ListItemZwraca element jako element listy.
asMultipleChoiceItem()MultipleChoiceItemZwraca element jako produkt wielokrotnego wyboru.
asPageBreakItem()PageBreakItemZwraca element jako element podziału strony.
asParagraphTextItem()ParagraphTextItemZwraca element w postaci tekstu akapitu.
asScaleItem()ScaleItemZwraca element jako element skali.
asSectionHeaderItem()SectionHeaderItemZwraca element jako element nagłówka sekcji.
asTextItem()TextItemZwraca element jako element tekstowy.
asTimeItem()TimeItemZwraca element jako element czasu.
asVideoItem()VideoItemZwraca element jako film.
duplicate()ItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getHelpText()StringPobiera tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów formularza.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
setHelpText(text)ItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setTitle(title)ItemUstawia 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()

Zwraca element jako obraz. Jeśli ItemType nie zawiera jeszcze elementu IMAGE, zgłasza wyjątek od obsługi skryptów.

Powroty

ImageItem – element obrazu,

Rzuty

Error – jeśli element nie jest obrazem.

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()

Zwraca element jako film. Jeśli ItemType nie zawiera jeszcze elementu VIDEO, zgłasza wyjątek od obsługi skryptów.

Powroty

VideoItem – element wideo,

Rzuty

Error – jeśli element nie jest elementem wideo,

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()

Pobiera typ elementu, reprezentowany jako ItemType.

Powroty

ItemType – typ 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

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

NazwaTypOpis
textStringnowy tekst pomocy

Powroty

Item – ten Item, do ł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

setTitle(title)

Ustawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).

Parametry

NazwaTypOpis
titleStringnowy tytuł lub tekst nagłówka.

Powroty

Item – ten Item, do ł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