Interface Item

Produkt

Ogólny element formularza, który zawiera właściwości wspólne dla wszystkich elementów, takie jak tytuł i tekst pomocy. Dostęp do elementów można uzyskać lub utworzyć je z poziomu Form.

Aby operować na właściwościach specyficznych dla typu, użyj operatora getType(), aby sprawdzić ItemType elementu, a następnie przekształć element w odpowiednią klasę 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);
}

Implementowanie klas

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 czasu trwania.
asGridItem()GridItemZwraca element jako element siatki.
asImageItem()ImageItemZwraca element jako element obrazu.
asListItem()ListItemZwraca element jako element listy.
asMultipleChoiceItem()MultipleChoiceItemZwraca element jako pytanie jednokrotnego wyboru.
asPageBreakItem()PageBreakItemZwraca element jako element podziału strony.
asParagraphTextItem()ParagraphTextItemZwraca element jako element tekstowy akapitu.
asRatingItem()RatingItemZwraca element jako element oceny.
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 element wideo.
duplicate()ItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getHelpText()StringPobiera tekst pomocy 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 wśród wszystkich elementów w formularzu.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu reprezentowany jako ItemType.
setHelpText(text)ItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setTitle(title)ItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

Szczegółowa dokumentacja

asCheckboxGridItem()

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

Powrót

CheckboxGridItem – element siatki pól wyboru.

Rzuty

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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. Wyrzuca wyjątek skryptu, jeśli ItemType nie było jeszcze CHECKBOX.

Powrót

CheckboxItem – element pola wyboru.

Rzuty

Error – jeśli element nie jest polem wyboru.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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. Wyrzuca wyjątek skryptu, jeśli ItemType nie było jeszcze DATE.

Powrót

DateItem – element daty;

Rzuty

Error – jeśli element nie jest datą.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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. Wyrzuca wyjątek skryptu, jeśli ItemType nie było jeszcze DATETIME.

Powrót

DateTimeItem – element daty i godziny.

Rzuty

Error – jeśli element nie jest elementem daty i godziny;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 czasu trwania. Wyrzuca wyjątek skryptu, jeśli ItemType nie było jeszcze DURATION.

Powrót

DurationItem – element czasu trwania.

Rzuty

Error – jeśli produkt nie jest produktem o określonym czasie trwania.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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. Wyrzuca wyjątek skryptu, jeśli ItemType nie było jeszcze GRID.

Powrót

GridItem – element siatki.

Rzuty

Error – jeśli element nie jest elementem siatki.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 obrazu. Wyrzuca wyjątek skryptu, jeśli ItemType nie było jeszcze IMAGE.

Powrót

ImageItem – element obrazu;

Rzuty

Error – jeśli element nie jest elementem graficznym

asListItem()

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

Powrót

ListItem – element listy.

Rzuty

Error – jeśli element nie jest elementem listy.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asMultipleChoiceItem()

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

Powrót

MultipleChoiceItem – odpowiedź w pytaniu jednokrotnego wyboru.

Rzuty

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 strony. Wyrzuca wyjątek skryptu, jeśli ItemType nie było jeszcze PAGE_BREAK.

Powrót

PageBreakItem – element podziału strony;

Rzuty

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 tekstowy akapitu. Wyrzuca wyjątek skryptu, jeśli ItemType nie było jeszcze PARAGRAPH_TEXT.

Powrót

ParagraphTextItem – element tekstowy akapitu.

Rzuty

Error – jeśli element nie jest elementem tekstowym akapitu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

asRatingItem()

Zwraca element jako element oceny. Zgłasza wyjątek ScriptingException, jeśli ItemType nie jest jeszcze 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 korzystające z tej metody wymagają autoryzacji z użyciem 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 skali. Wyrzuca wyjątek skryptu, jeśli ItemType nie było jeszcze SCALE.

Powrót

ScaleItem – element skali

Rzuty

Error – jeśli produkt nie jest produktem sprzedawanym na wagę;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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. Wyrzuca wyjątek skryptu, jeśli ItemType nie było jeszcze SECTION_HEADER.

Powrót

SectionHeaderItem – element nagłówka sekcji;

Rzuty

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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. Wyrzuca wyjątek skryptu, jeśli ItemType nie było jeszcze TEXT.

Powrót

TextItem – element tekstowy.

Rzuty

Error – jeśli element nie jest elementem tekstowym.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 czasu. Wyrzuca wyjątek skryptu, jeśli ItemType nie było jeszcze TIME.

Powrót

TimeItem – element czasu.

Rzuty

Error – jeśli element nie jest elementem czasowym.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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. Wyrzuca wyjątek skryptu, jeśli ItemType nie było jeszcze VIDEO.

Powrót

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.

Powrót

Item – duplikat tego Item do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Powrót

String – tekst pomocy lub opis produktu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Powrót

Integer – identyfikator produktu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getIndex()

Pobiera indeks elementu wśród wszystkich elementów w formularzu.

Powrót

Integer – indeks elementu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getTitle()

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

Powrót

String – tytuł lub tekst nagłówka produktu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Powrót

ItemType – typ produktu

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Parametry

NazwaTypOpis
textStringnowy tekst pomocy,

Powrót

Item – ten Item, do tworzenia łańcuszków

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

Parametry

NazwaTypOpis
titleStringnowy tytuł lub tekst nagłówka;

Powrót

Item – ten Item, do tworzenia łańcuszków

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms