Interface Item

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Element

Ogólny element formularza zawierający właściwości typowe dla wszystkich elementów, np. tytuł i tekst pomocy. Elementy są dostępne i można je tworzyć na stronie Form.

Aby wykonać działanie na właściwościach określonego typu, sprawdź element getType() za pomocą atrybutu ItemType, 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);
}

Implementacja zajęć

NazwaKrótki opis

Metody

MetodaZwracany typKrótki opis
asCheckboxGridItem()CheckboxGridItemZwraca element jako element siatki pól wyboru.
asCheckboxItem()CheckboxItemZwraca element jako element pola wyboru.
asDateItem()DateItemZwraca element jako element daty.
asDateTimeItem()DateTimeItemZwraca element jako element daty i godziny.
asDurationItem()DurationItemZwraca element jako element o określonym czasie trwania.
asGridItem()GridItemZwraca element jako element siatki.
asImageItem()ImageItemZwraca element jako element graficzny.
asListItem()ListItemZwraca element jako element listy.
asMultipleChoiceItem()MultipleChoiceItemZwraca element jako element jednokrotnego wyboru.
asPageBreakItem()PageBreakItemZwraca element jako element podziału na strony.
asParagraphTextItem()ParagraphTextItemZwraca element jako element w postaci tekstu akapitu.
asScaleItem()ScaleItemZwraca element jako element wagi.
asSectionHeaderItem()SectionHeaderItemZwraca element jako element nagłówka sekcji.
asTextItem()TextItemZwraca element jako element tekstowy.
asTimeItem()TimeItemZwraca element jako element czasowy.
asVideoItem()VideoItemZwraca element jako element wideo.
duplicate()ItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getHelpText()StringPobiera tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu do wszystkich elementów w formularzu.
getTitle()StringPobiera tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem).
getType()ItemTypePobiera typ elementu reprezentowany jako ItemType.
setHelpText(text)ItemUstawia tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setTitle(title)ItemUstawia tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem).

Szczegółowa dokumentacja

asCheckboxGridItem()

Zwraca element jako element siatki pól wyboru. Zwraca wyjątek skryptu, jeśli ItemType nie był jeszcze CHECKBOX_GRID.

Zwróć

CheckboxGridItem – element siatki pól wyboru;

Narzuty

Error – jeśli element nie jest elementem siatki pól wyboru.

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

asCheckboxItem()

Zwraca element jako element pola wyboru. Zwraca wyjątek skryptu, jeśli ItemType nie był jeszcze CHECKBOX.

Zwróć

CheckboxItem – element pola wyboru,

Narzuty

Error – jeśli element nie jest polem wyboru

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

asDateItem()

Zwraca element jako element daty. Zwraca wyjątek skryptu, jeśli ItemType nie był jeszcze DATE.

Zwróć

DateItem – element daty

Narzuty

Error – jeśli element nie jest datą;

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

asDateTimeItem()

Zwraca element jako element daty i godziny. Zwraca wyjątek skryptu, jeśli ItemType nie był jeszcze DATETIME.

Zwróć

DateTimeItem – element daty i godziny

Narzuty

Error – jeśli element nie jest datą i datą.

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

asDurationItem()

Zwraca element jako element o określonym czasie trwania. Zwraca wyjątek skryptu, jeśli ItemType nie był jeszcze DURATION.

Zwróć

DurationItem – czas trwania elementu;

Narzuty

Error – jeśli element nie jest elementem czasu trwania

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

asGridItem()

Zwraca element jako element siatki. Zwraca wyjątek skryptu, jeśli ItemType nie był jeszcze GRID.

Zwróć

GridItem – element siatki,

Narzuty

Error – jeśli element nie jest elementem siatki;

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

asImageItem()

Zwraca element jako element graficzny. Zwraca wyjątek skryptu, jeśli ItemType nie był jeszcze IMAGE.

Zwróć

ImageItem – element graficzny,

Narzuty

Error – jeśli element nie jest obrazem


asListItem()

Zwraca element jako element listy. Zwraca wyjątek skryptu, jeśli ItemType nie był jeszcze LIST.

Zwróć

ListItem – element listy.

Narzuty

Error – jeśli element nie jest listą

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

asMultipleChoiceItem()

Zwraca element jako element jednokrotnego wyboru. Zwraca wyjątek skryptu, jeśli ItemType nie był jeszcze MULTIPLE_CHOICE.

Zwróć

MultipleChoiceItem – element jednokrotnego wyboru

Narzuty

Error – jeśli produkt nie jest wielokrotnym wyborem

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

asPageBreakItem()

Zwraca element jako element podziału na strony. Zwraca wyjątek skryptu, jeśli ItemType nie był jeszcze PAGE_BREAK.

Zwróć

PageBreakItem – element podziału strony

Narzuty

Error – jeśli element nie jest elementem podziału strony,

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

asParagraphTextItem()

Zwraca element jako element w postaci tekstu akapitu. Zwraca wyjątek skryptu, jeśli ItemType nie był jeszcze PARAGRAPH_TEXT.

Zwróć

ParagraphTextItem – element tekstu akapitu

Narzuty

Error – jeśli element nie jest elementem akapitu

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

asScaleItem()

Zwraca element jako element wagi. Zwraca wyjątek skryptu, jeśli ItemType nie był jeszcze SCALE.

Zwróć

ScaleItem – element skali;

Narzuty

Error – jeśli element nie jest skalą.

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

asSectionHeaderItem()

Zwraca element jako element nagłówka sekcji. Zwraca wyjątek skryptu, jeśli ItemType nie był jeszcze SECTION_HEADER.

Zwróć

SectionHeaderItem – element nagłówka nagłówka

Narzuty

Error – jeśli element nie jest nagłówkiem nagłówka sekcji.

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

asTextItem()

Zwraca element jako element tekstowy. Zwraca wyjątek skryptu, jeśli ItemType nie był jeszcze TEXT.

Zwróć

TextItem – element tekstowy

Narzuty

Error – jeśli element nie jest elementem tekstowym

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

asTimeItem()

Zwraca element jako element czasowy. Zwraca wyjątek skryptu, jeśli ItemType nie był jeszcze TIME.

Zwróć

TimeItem – element czasowy

Narzuty

Error – jeśli element nie jest godziną

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

asVideoItem()

Zwraca element jako element wideo. Zwraca wyjątek skryptu, jeśli ItemType nie był jeszcze VIDEO.

Zwróć

VideoItem – element wideo.

Narzuty

Error – jeśli element nie jest elementem wideo,


duplicate()

Tworzy kopię tego elementu i dołącza ją na końcu formularza.

Zwróć

Item – duplikat pytania „Item” dotyczący łańcucha

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

getHelpText()

Pobiera tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Zwróć

String – tekst pomocy lub opis elementu;

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

getId()

Pobiera unikalny identyfikator elementu.

Zwróć

Integer – identyfikator elementu;

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

getIndex()

Pobiera indeks elementu do wszystkich elementów w formularzu.

Zwróć

Integer – indeks elementu

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

getTitle()

Pobiera tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem).

Zwróć

String – tytuł lub tekst nagłówka;

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

getType()

Pobiera typ elementu reprezentowany jako ItemType.

Zwróć

ItemType – typ produktu

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

setHelpText(text)

Ustawia tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Parametry

NazwaTypOpis
textStringnowy tekst pomocy

Zwróć

Item – ten Item do łańcucha

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

setTitle(title)

Ustawia tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem).

Parametry

NazwaTypOpis
titleStringnowego tytułu lub tekstu nagłówka,

Zwróć

Item – ten Item do łańcucha

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