Ta strona została przetłumaczona przez Cloud Translation API.

Interface Item

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

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 element pola wyboru.
`asDateItem()`	`DateItem`	Zwraca element jako element daty.
`asDateTimeItem()`	`DateTimeItem`	Zwraca element jako element daty i godziny.
`asDurationItem()`	`DurationItem`	Zwraca element jako element o określonym czasie trwania.
`asGridItem()`	`GridItem`	Zwraca element jako element siatki.
`asImageItem()`	`ImageItem`	Zwraca element jako element graficzny.
`asListItem()`	`ListItem`	Zwraca element jako element listy.
`asMultipleChoiceItem()`	`MultipleChoiceItem`	Zwraca element jako element jednokrotnego wyboru.
`asPageBreakItem()`	`PageBreakItem`	Zwraca element jako element podziału na strony.
`asParagraphTextItem()`	`ParagraphTextItem`	Zwraca element jako element w postaci tekstu akapitu.
`asScaleItem()`	`ScaleItem`	Zwraca element jako element wagi.
`asSectionHeaderItem()`	`SectionHeaderItem`	Zwraca element jako element nagłówka sekcji.
`asTextItem()`	`TextItem`	Zwraca element jako element tekstowy.
`asTimeItem()`	`TimeItem`	Zwraca element jako element czasowy.
`asVideoItem()`	`VideoItem`	Zwraca element jako element wideo.
`duplicate()`	`Item`	Tworzy kopię tego elementu i dołącza ją na końcu formularza.
`getHelpText()`	`String`	Pobiera tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak `ImageItems`, `PageBreakItems` i `SectionHeaderItems`).
`getId()`	`Integer`	Pobiera unikalny identyfikator elementu.
`getIndex()`	`Integer`	Pobiera indeks elementu do wszystkich elementów w formularzu.
`getTitle()`	`String`	Pobiera tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku `SectionHeaderItem`).
`getType()`	`ItemType`	Pobiera typ elementu reprezentowany jako `ItemType`.
`setHelpText(text)`	`Item`	Ustawia tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak `ImageItems`, `PageBreakItems` i `SectionHeaderItems`).
`setTitle(title)`	`Item`	Ustawia 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

Nazwa	Typ	Opis
`text`	`String`	nowy 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

Nazwa	Typ	Opis
`title`	`String`	nowego 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