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

Interface Item

Ogólny element formularza zawierający właściwości wspólne wszystkim elementom, takie jak tytuł i tekst pomocy. Elementy można tworzyć i otwierać w ramach Form.

Aby operować na właściwościach związanych z danym typem, użyj funkcji getType(), aby sprawdzić ItemType elementu, a potem przypisz go do odpowiedniej klasy za pomocą metody takiej jak asCheckboxItem().

// Create a new form and add a text item.
const form = FormApp.create('Form Name');
form.addTextItem();

// Access the text item as a generic item.
const items = form.getItems();
const item = items[0];

// Cast the generic item to the text-item class.
if (item.getType() === 'TEXT') {
  const textItem = item.asTextItem();
  textItem.setRequired(false);
}

Implementacja klas

Nazwa	Krótki opis

Metody

Metoda	Zwracany typ	Krótki opis
`asCheckboxGridItem()`	`CheckboxGridItem`	Zwraca element jako element siatki z polem 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 czasu trwania.
`asGridItem()`	`GridItem`	Zwraca element jako element siatki.
`asImageItem()`	`ImageItem`	Zwraca element jako element obrazu.
`asListItem()`	`ListItem`	Zwraca element jako element listy.
`asMultipleChoiceItem()`	`MultipleChoiceItem`	Zwraca element jako element wielokrotnego wyboru.
`asPageBreakItem()`	`PageBreakItem`	Zwraca element jako element z przełamaniem strony.
`asParagraphTextItem()`	`ParagraphTextItem`	Zwraca element jako element tekstu akapitowego.
`asRatingItem()`	`RatingItem`	Zwraca element jako element oceny.
`asScaleItem()`	`ScaleItem`	Zwraca element jako element skali.
`asSectionHeaderItem()`	`SectionHeaderItem`	Zwraca element jako nagłówek sekcji.
`asTextItem()`	`TextItem`	Zwraca element jako tekst.
`asTimeItem()`	`TimeItem`	Zwraca element jako element czasu.
`asVideoItem()`	`VideoItem`	Zwraca element jako element wideo.
`duplicate()`	`Item`	Tworzy kopię tego elementu i dodaje ją na końcu formularza.
`getHelpText()`	`String`	Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak `ImageItems`, `PageBreakItems` i `SectionHeaderItems`).
`getId()`	`Integer`	Pobiera unikalny identyfikator produktu.
`getIndex()`	`Integer`	Pobiera indeks elementu spośród wszystkich elementów w formularzu.
`getTitle()`	`String`	Pobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku `SectionHeaderItem`).
`getType()`	`ItemType`	Pobiera typ elementu jako `ItemType`.
`setHelpText(text)`	`Item`	Ustawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak `ImageItems`, `PageBreakItems` i `SectionHeaderItems`).
`setTitle(title)`	`Item`	Ustawia tytuł elementu (czasami nazywany tekstem nagłówka w przypadku `SectionHeaderItem`).

Szczegółowa dokumentacja

`asCheckboxGridItem()`

Zwraca element jako element siatki z polem wyboru. Wyjątek skryptu, jeśli ItemType nie jest jeszcze CHECKBOX_GRID.

Powrót

CheckboxGridItem – element siatki pól wyboru

Rzuty

Error – jeśli element nie jest elementem siatki z polem wyboru

Autoryzacja

Skrypty, które korzystają 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 element pola wyboru. Wyjątek skryptu, jeśli ItemType nie jest jeszcze CHECKBOX.

Powrót

CheckboxItem – element pola wyboru

Rzuty

Error – jeśli element nie jest polem wyboru

Autoryzacja

Skrypty, które korzystają 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. Wyjątek skryptu, jeśli ItemType nie jest jeszcze DATE.

Powrót

DateItem – element daty

Rzuty

Error – jeśli element nie jest elementem daty,

Autoryzacja

Skrypty, które korzystają 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 element daty i godziny. Wyjątek skryptu, jeśli ItemType nie jest jeszcze DATETIME.

Powrót

DateTimeItem – element data-time

Rzuty

Error – jeśli element nie jest elementem z datą i godziną;

Autoryzacja

Skrypty, które korzystają 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. Wyjątek skryptu, jeśli ItemType nie jest jeszcze DURATION.

Powrót

DurationItem – element czasu trwania

Rzuty

Error – jeśli element nie jest elementem z czasem trwania,

Autoryzacja

Skrypty, które korzystają 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. Wyjątek skryptu, jeśli ItemType nie jest jeszcze GRID.

Powrót

GridItem – element siatki.

Rzuty

Error – jeśli element nie jest elementem siatki,

Autoryzacja

Skrypty, które korzystają 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 element obrazu. Wyjątek skryptu, jeśli ItemType nie jest jeszcze IMAGE.

Powrót

ImageItem – element obrazu

Rzuty

Error – jeśli element nie jest elementem graficznym,

`asListItem()`

Zwraca element jako element listy. Wyjątek skryptu, jeśli ItemType nie jest jeszcze LIST.

Powrót

ListItem – element listy.

Rzuty

Error – jeśli element nie jest elementem listy,

Autoryzacja

Skrypty, które korzystają 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 element wielokrotnego wyboru. Wyjątek skryptu, jeśli ItemType nie jest jeszcze MULTIPLE_CHOICE.

Powrót

MultipleChoiceItem – odpowiedź na pytanie jednokrotne

Rzuty

Error – jeśli element nie jest pytaniem jednokrotnego wyboru,

Autoryzacja

Skrypty, które korzystają 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 z przełamaniem strony. Wyjątek skryptu, jeśli ItemType nie jest jeszcze PAGE_BREAK.

Powrót

PageBreakItem – element podziału strony,

Rzuty

Error – jeśli element nie jest elementem z podziałem na strony;

Autoryzacja

Skrypty, które korzystają 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 jako element tekstu akapitowego. Wyjątek skryptu, jeśli ItemType nie jest jeszcze PARAGRAPH_TEXT.

Powrót

ParagraphTextItem – element tekstu akapitowego.

Rzuty

Error – jeśli element nie jest elementem tekstu akapitowego.

Autoryzacja

Skrypty, które korzystają 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

`asRatingItem()`

Zwraca element jako element oceny. Wyjątek ScriptingException jest rzucany, jeśli ItemType nie jest RATING.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Fetch any item which is of type rating.
const item = form.getItems(FormApp.ItemType.RATING)[0];

// Convert the item to a rating item.
const ratingItem = item.asRatingItem();

Powrót

RatingItem – element oceny.

Rzuty

Error – jeśli element nie jest elementem oceny

Autoryzacja

Skrypty, które korzystają 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. Wyjątek skryptu, jeśli ItemType nie jest jeszcze SCALE.

Powrót

ScaleItem – element skali

Rzuty

Error – jeśli element nie jest elementem skali.

Autoryzacja

Skrypty, które korzystają 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 nagłówek sekcji. Wyjątek skryptu, jeśli ItemType nie jest jeszcze SECTION_HEADER.

Powrót

SectionHeaderItem – element nagłówka sekcji,

Rzuty

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

Autoryzacja

Skrypty, które korzystają 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 tekst. Wyjątek skryptu, jeśli ItemType nie jest jeszcze TEXT.

Powrót

TextItem – element tekstowy

Rzuty

Error – jeśli element nie jest tekstowy,

Autoryzacja

Skrypty, które korzystają 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. Wyjątek skryptu, jeśli ItemType nie jest jeszcze TIME.

Powrót

TimeItem – element czasu

Rzuty

Error – jeśli element nie jest elementem czasowym

Autoryzacja

Skrypty, które korzystają 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 element wideo. Wyjątek skryptu, jeśli ItemType nie jest jeszcze VIDEO.

Powrót

VideoItem – element wideo

Rzuty

Error – jeśli element nie jest filmem,

`duplicate()`

Tworzy kopię tego elementu i dodaje ją na końcu formularza.

Powrót

Item – duplikat tego elementu Item, służący do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Powrót

String – tekst pomocy lub tekst opisu produktu,

Autoryzacja

Skrypty, które korzystają 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 produktu.

Powrót

Integer – identyfikator produktu

Autoryzacja

Skrypty, które korzystają 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 w formularzu.

Powrót

Integer – indeks elementu

Autoryzacja

Skrypty, które korzystają 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 (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).

Powrót

String – tytuł lub tekst nagłówka

Autoryzacja

Skrypty, które korzystają 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 jako ItemType.

Powrót

ItemType – typ elementu

Autoryzacja

Skrypty, które korzystają 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 elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Parametry

Nazwa	Typ	Opis
`text`	`String`	nowy tekst pomocy.

Powrót

Item – ta Item, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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 (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).

Parametry

Nazwa	Typ	Opis
`title`	`String`	nowy tytuł lub tekst nagłówka.

Powrót

Item – ta Item, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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