Forms Service

Formularze

Ta usługa umożliwia skryptom tworzenie, otwieranie i modyfikowanie Formularzy Google.

// Create a new unpublished form, then add a checkbox question, a multiple choice question,
// a page break, then a date question and a grid of questions, then publish the form and share
// with responders.
var form = FormApp.create('New Form', /* isPublished= */ false);
var item = form.addCheckboxItem();
item.setTitle('What condiments would you like on your hot dog?');
item.setChoices([
        item.createChoice('Ketchup'),
        item.createChoice('Mustard'),
        item.createChoice('Relish')
    ]);
form.addMultipleChoiceItem()
    .setTitle('Do you prefer cats or dogs?')
    .setChoiceValues(['Cats','Dogs'])
    .showOtherOption(true);
form.addPageBreakItem()
    .setTitle('Getting to know you');
form.addDateItem()
    .setTitle('When were you born?');
form.addGridItem()
    .setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

form.setPublished(true);
form.addPublishedReaders(['user@example.com', 'group@example.com']);

Logger.log('Published URL: ' + form.getPublishedUrl());
Logger.log('Editor URL: ' + form.getEditUrl());

Zajęcia

NazwaKrótki opis
AlignmentWyliczenie reprezentujące obsługiwane typy wyrównania obrazu.
CheckboxGridItemPytanie w formie siatki kolumn i wierszy, które umożliwia respondentowi wybranie wielu opcji w każdym wierszu z ciągu pól wyboru.
CheckboxGridValidationObiekt DataValidation dla CheckboxGridItem.
CheckboxGridValidationBuilderObiekt DataValidationBuilder dla obiektu CheckboxGridValidation.
CheckboxItemPytanie, w którym respondent może zaznaczyć co najmniej jedno pole wyboru, a także opcjonalne pole „Inne”.
CheckboxValidationObiekt DataValidation dla CheckboxItem.
CheckboxValidationBuilderObiekt DataValidationBuilder dla obiektu CheckboxValidation.
ChoicePojedynczy wybór powiązany z typem Item, który obsługuje wybory, np. CheckboxItem, ListItem lub MultipleChoiceItem.
DateItemPytanie, w którym użytkownik może podać datę.
DateTimeItemElement pytania, który umożliwia użytkownikowi wskazanie daty i godziny.
DestinationTypeWyliczenie reprezentujące obsługiwane typy miejsc docelowych odpowiedzi na formularz.
DurationItemElement pytania, który umożliwia użytkownikowi określenie długości czasu.
FeedbackTypeWyliczenie reprezentujące obsługiwane typy opinii.
FormFormularz zawierający ogólne właściwości i elementy.
FormAppUmożliwia skryptowi otwarcie istniejącego Form lub utworzenie nowego.
FormResponseOdpowiedź na formularz jako całość.
GridItemPytanie w formie siatki kolumn i wierszy, które umożliwia respondentowi wybranie jednej odpowiedzi w każdym wierszu z ciągu przycisków opcji.
GridValidationObiekt DataValidation dla GridItem.
GridValidationBuilderObiekt DataValidationBuilder dla obiektu GridValidation.
ImageItemElement układu, który wyświetla obraz.
ItemOgólny element formularza, który zawiera właściwości wspólne dla wszystkich elementów, takie jak tytuł i tekst pomocy.
ItemResponseOdpowiedź na jedno pytanie w formularzu.
ItemTypeWyliczenie reprezentujące obsługiwane typy elementów formularza.
ListItemPytanie, w którym respondent może wybrać jedną odpowiedź z listy.
MultipleChoiceItemPytanie, w którym respondent może wybrać jedną odpowiedź z listy przycisków opcji lub opcjonalnego pola „Inne”.
PageBreakItemElement układu, który oznacza początek strony.
PageNavigationTypeWyliczenie reprezentujące obsługiwane typy nawigacji na stronie.
ParagraphTextItemPytanie, które umożliwia respondentowi wpisanie bloku tekstu.
ParagraphTextValidationObiekt DataValidation dla ParagraphTextItem.
ParagraphTextValidationBuilderObiekt DataValidationBuilder dla obiektu ParagraphTextValidation.
QuizFeedbackReprezentuje opinię, którą można powiązać z elementami formularza podlegającymi ocenie. Zawiera właściwości takie jak tekst wyświetlany i przydatne linki.
QuizFeedbackBuilderPodstawowy element FeedbackBuilder, który zawiera metody ustawiające właściwości wspólne dla wszystkich opinii, takie jak tekst wyświetlany.
RatingIconTypeWyliczenie reprezentujące obsługiwane typy ikon ocen.
RatingItemPytanie, które umożliwia użytkownikowi wystawienie oceny.
ScaleItemPytanie, które umożliwia użytkownikowi wybranie jednej opcji z numerowanego ciągu przycisków opcji.
SectionHeaderItemElement układu, który wizualnie wskazuje początek sekcji.
TextItemPytanie, na które respondent może odpowiedzieć w jednym wierszu tekstu.
TextValidationObiekt DataValidation dla TextItem.
TextValidationBuilderObiekt DataValidationBuilder dla obiektu TextValidation.
TimeItemElement pytania, który umożliwia użytkownikowi wskazanie pory dnia.
VideoItemElement układu, który wyświetla film.

Alignment

Właściwości

WłaściwośćTypOpis
LEFTEnumWyrównaj obraz do lewej strony formularza.
CENTEREnumWyrównaj obraz do środka formularza.
RIGHTEnumWyrównaj obraz do prawej strony formularza.

CheckboxGridItem

Metody

MetodaZwracany typKrótki opis
clearValidation()CheckboxGridItemUsuwa sprawdzanie poprawności danych w tym elemencie siatki.
createResponse(responses)ItemResponseTworzy nowy ItemResponse dla tego elementu siatki pól wyboru.
duplicate()CheckboxGridItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getColumns()String[]Pobiera wartości z każdej kolumny w siatce.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getRows()String[]Pobiera wartości z każdego wiersza w siatce.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setColumns(columns)CheckboxGridItemUstawia kolumny siatki na podstawie tablicy wartości.
setHelpText(text)CheckboxGridItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setRequired(enabled)CheckboxGridItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setRows(rows)CheckboxGridItemUstawia wiersze siatki na podstawie tablicy wartości.
setTitle(title)CheckboxGridItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
setValidation(validation)CheckboxGridItemUstawia sprawdzanie poprawności danych dla tego elementu siatki pól wyboru.

CheckboxGridValidation

CheckboxGridValidationBuilder

Metody

MetodaZwracany typKrótki opis
requireLimitOneResponsePerColumn()CheckboxGridValidationBuilderWymaga ograniczenia do 1 odpowiedzi na kolumnę w przypadku elementu siatki.

CheckboxItem

Metody

MetodaZwracany typKrótki opis
clearValidation()CheckboxItemUsuwa sprawdzanie poprawności danych w przypadku tego pola wyboru.
createChoice(value)ChoiceTworzy nowy wybór.
createChoice(value, isCorrect)ChoiceTworzy nowy wybór.
createResponse(responses)ItemResponseTworzy nowy element ItemResponse dla tego pola wyboru.
duplicate()CheckboxItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getChoices()Choice[]Pobiera wszystkie opcje elementu.
getFeedbackForCorrect()QuizFeedback|nullZwraca opinię, która jest wyświetlana użytkownikom, gdy poprawnie odpowiedzą na pytanie.
getFeedbackForIncorrect()QuizFeedback|nullZwraca opinię, która jest wyświetlana użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getPoints()IntegerZwraca liczbę punktów elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
hasOtherOption()BooleanOkreśla, czy element ma opcję „Inne”.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setChoiceValues(values)CheckboxItemUstawia wybory dla elementu z tablicy ciągów znaków.
setChoices(choices)CheckboxItemUstawia tablicę opcji dla elementu.
setFeedbackForCorrect(feedback)CheckboxItemUstawia informację zwrotną, która ma być wyświetlana użytkownikom, gdy poprawnie odpowiedzą na pytanie.
setFeedbackForIncorrect(feedback)CheckboxItemUstawia opinię, która ma być wyświetlana użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
setHelpText(text)CheckboxItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setPoints(points)CheckboxItemUstawia liczbę punktów, jaką jest warta oceniana pozycja.
setRequired(enabled)CheckboxItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)CheckboxItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
setValidation(validation)CheckboxItemUstawia sprawdzanie poprawności danych dla tego pola wyboru.
showOtherOption(enabled)CheckboxItemOkreśla, czy element ma opcję „Inna odpowiedź”.

CheckboxValidation

CheckboxValidationBuilder

Metody

MetodaZwracany typKrótki opis
requireSelectAtLeast(number)CheckboxValidationBuilderWymagaj wybrania co najmniej tej liczby opcji.
requireSelectAtMost(number)CheckboxValidationBuilderWymagaj wybrania maksymalnie tylu opcji.
requireSelectExactly(number)CheckboxValidationBuilderWymagaj wybrania dokładnie tylu opcji.

Choice

Metody

MetodaZwracany typKrótki opis
getGotoPage()PageBreakItemPobiera PageBreakItem ustawiony jako GO_TO_PAGE miejsce docelowe, jeśli osoba odpowiadająca wybierze tę opcję i wypełni bieżącą stronę.
getPageNavigationType()PageNavigationTypeZwraca wartość PageNavigationType, która występuje, jeśli osoba odpowiadająca wybierze tę opcję i wypełni bieżącą stronę.
getValue()StringPobiera wartość wyboru, która jest wyświetlana respondentom jako etykieta podczas przeglądania formularza.
isCorrectAnswer()BooleanSprawdza, czy wybrana odpowiedź jest prawidłowa.

DateItem

Metody

MetodaZwracany typKrótki opis
createResponse(response)ItemResponseTworzy nowy ItemResponse dla tego elementu daty.
duplicate()DateItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedback|nullZwraca opinię, która jest wyświetlana osobom odpowiadającym na pytanie podlegające ocenie.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getPoints()IntegerZwraca liczbę punktów elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
includesYear()BooleanOkreśla, czy element daty zawiera opcję roku.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)DateItemUstawia informacje zwrotne, które mają być wyświetlane użytkownikom, gdy odpowiadają na pytanie podlegające ocenie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (np. pytania wymagające ręcznego oceniania).
setHelpText(text)DateItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setIncludesYear(enableYear)DateItemOkreśla, czy element daty zawiera ustawienie roku.
setPoints(points)DateItemUstawia liczbę punktów, jaką jest warta oceniana pozycja.
setRequired(enabled)DateItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)DateItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

DateTimeItem

Metody

MetodaZwracany typKrótki opis
createResponse(response)ItemResponseTworzy nowy ItemResponse dla tego elementu daty i godziny.
duplicate()DateTimeItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedback|nullZwraca opinię, która jest wyświetlana osobom odpowiadającym na pytanie podlegające ocenie.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getPoints()IntegerZwraca liczbę punktów elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
includesYear()BooleanOkreśla, czy element daty zawiera opcję roku.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)DateTimeItemUstawia informacje zwrotne, które mają być wyświetlane użytkownikom, gdy odpowiadają na pytanie podlegające ocenie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (np. pytania wymagające ręcznego oceniania).
setHelpText(text)DateTimeItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setIncludesYear(enableYear)DateTimeItemOkreśla, czy element daty zawiera ustawienie roku.
setPoints(points)DateTimeItemUstawia liczbę punktów, jaką jest warta oceniana pozycja.
setRequired(enabled)DateTimeItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)DateTimeItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

DestinationType

Właściwości

WłaściwośćTypOpis
SPREADSHEETEnumarkusz kalkulacyjny w Arkuszach Google jako miejsce docelowe odpowiedzi na pytania z formularza.

DurationItem

Metody

MetodaZwracany typKrótki opis
createResponse(hours, minutes, seconds)ItemResponseTworzy nowy ItemResponse dla tego elementu daty.
duplicate()DurationItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedback|nullZwraca opinię, która jest wyświetlana osobom odpowiadającym na pytanie podlegające ocenie.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getPoints()IntegerZwraca liczbę punktów elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)DurationItemUstawia informacje zwrotne, które mają być wyświetlane użytkownikom, gdy odpowiadają na pytanie podlegające ocenie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (np. pytania wymagające ręcznego oceniania).
setHelpText(text)DurationItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setPoints(points)DurationItemUstawia liczbę punktów, jaką jest warta oceniana pozycja.
setRequired(enabled)DurationItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)DurationItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

FeedbackType

Właściwości

WłaściwośćTypOpis
CORRECTEnumKomentarz, który jest automatycznie wyświetlany użytkownikom w przypadku prawidłowej odpowiedzi na pytanie.
INCORRECTEnumKomentarz, który jest automatycznie wyświetlany użytkownikom w przypadku pytania, na które udzielono nieprawidłowej odpowiedzi.
GENERALEnumOpinie, które są automatycznie wyświetlane osobom odpowiadającym po przesłaniu odpowiedzi.

Form

Metody

MetodaZwracany typKrótki opis
addCheckboxGridItem()CheckboxGridItemDodaje nowe pytanie w formie siatki kolumn i wierszy, w której użytkownik może wybrać wiele opcji w każdym wierszu z ciągu pól wyboru.
addCheckboxItem()CheckboxItemDodaje nowy element pytania, który umożliwia użytkownikowi zaznaczenie co najmniej jednego pola wyboru, a także opcjonalnego pola „Inne”.
addDateItem()DateItemDodaje nowe pytanie, które umożliwia użytkownikowi podanie daty.
addDateTimeItem()DateTimeItemDodaje nowe pytanie, które umożliwia użytkownikowi podanie daty i godziny.
addDurationItem()DurationItemDodaje nowe pytanie, które umożliwia użytkownikowi określenie czasu.
addEditor(emailAddress)FormDodaje podanego użytkownika do listy edytujących Form.
addEditor(user)FormDodaje podanego użytkownika do listy edytujących Form.
addEditors(emailAddresses)FormDodaje podaną tablicę użytkowników do listy edytujących Form.
addGridItem()GridItemDodaje nowe pytanie w formie siatki kolumn i wierszy, w której respondent może wybrać jedną odpowiedź w każdym wierszu z ciągu przycisków opcji.
addImageItem()ImageItemDodaje nowy element układu, który wyświetla obraz.
addListItem()ListItemDodaje nowe pytanie, w którym użytkownik może wybrać jedną odpowiedź z listy rozwijanej.
addMultipleChoiceItem()MultipleChoiceItemDodaje nowy element pytania, który umożliwia użytkownikowi wybranie jednej opcji z listy opcji lub opcjonalnego pola „Inne”.
addPageBreakItem()PageBreakItemDodaje nowy element układu, który oznacza początek strony.
addParagraphTextItem()ParagraphTextItemDodaje nowe pytanie, w którym respondent może wpisać blok tekstu.
addPublishedReader(emailAddress)FormDodaje podanego użytkownika do listy osób odpowiadających na Form.
addPublishedReader(user)FormDodaje podanego użytkownika do listy osób odpowiadających na Form.
addPublishedReaders(emailAddresses)FormDodaje podaną tablicę użytkowników do listy osób odpowiadających na Form.
addRatingItem()RatingItemDołącza nowy element pytania, który umożliwia użytkownikowi wystawienie oceny.
addScaleItem()ScaleItemDodaje nowe pytanie, które umożliwia użytkownikowi wybranie jednej opcji z numerowanego ciągu przycisków opcji.
addSectionHeaderItem()SectionHeaderItemDodaje nowy element układu, który wizualnie wskazuje początek sekcji.
addTextItem()TextItemDodaje nowy element pytania, który umożliwia użytkownikowi wpisanie jednego wiersza tekstu.
addTimeItem()TimeItemDodaje nowe pytanie, które umożliwia użytkownikowi wskazanie pory dnia.
addVideoItem()VideoItemDodaje nowy element układu, który wyświetla film.
canEditResponse()BooleanOkreśla, czy po przesłaniu formularza wyświetla się link umożliwiający edytowanie odpowiedzi.
collectsEmail()BooleanOkreśla, czy formularz zbiera adresy e-mail użytkowników.
createResponse()FormResponseTworzy nową odpowiedź w formularzu.
deleteAllResponses()FormUsuwa wszystkie przesłane odpowiedzi z miejsca przechowywania odpowiedzi w formularzu.
deleteItem(index)voidUsuwa element o podanym indeksie spośród wszystkich elementów w formularzu.
deleteItem(item)voidUsuwa dany element.
deleteResponse(responseId)FormUsuwa pojedynczą odpowiedź z miejsca przechowywania odpowiedzi w formularzu.
getConfirmationMessage()StringPobiera wiadomość potwierdzającą przesłanie formularza.
getCustomClosedFormMessage()StringPobiera niestandardowy komunikat wyświetlany, gdy formularz nie akceptuje odpowiedzi, lub pusty ciąg znaków, jeśli nie ustawiono żadnego niestandardowego komunikatu.
getDescription()StringPobiera opis formularza.
getDestinationId()StringPobiera identyfikator miejsca docelowego odpowiedzi na formularz.
getDestinationType()DestinationTypePobiera typ miejsca docelowego odpowiedzi formularza.
getEditUrl()StringPobiera adres URL, którego można użyć, aby uzyskać dostęp do trybu edycji formularza.
getEditors()User[]Pobiera listę edytorów tego Form.
getId()StringPobiera identyfikator formularza.
getItemById(id)Item|nullPobiera element o podanym identyfikatorze.
getItems()Item[]Pobiera tablicę wszystkich elementów w formularzu.
getItems(itemType)Item[]Pobiera tablicę wszystkich elementów danego typu.
getPublishedReaders()User[]Pobiera listę osób, które odpowiedziały na ten Form.
getPublishedUrl()StringPobiera adres URL, który można wykorzystać do odpowiedzi na formularz.
getResponse(responseId)FormResponsePobiera pojedynczą odpowiedź na formularz na podstawie jej identyfikatora.
getResponses()FormResponse[]Zwraca tablicę wszystkich odpowiedzi w formularzu.
getResponses(timestamp)FormResponse[]Zwraca tablicę wszystkich odpowiedzi na formularz po określonej dacie i godzinie.
getShuffleQuestions()BooleanOkreśla, czy kolejność pytań na każdej stronie formularza jest losowa.
getSummaryUrl()StringPobiera adres URL, którego można użyć do wyświetlenia podsumowania odpowiedzi w formularzu.
getTitle()StringPobiera tytuł formularza.
hasLimitOneResponsePerUser()BooleanOkreśla, czy formularz zezwala na tylko jedną odpowiedź na użytkownika.
hasProgressBar()BooleanOkreśla, czy w formularzu ma być wyświetlany pasek postępu.
hasRespondAgainLink()BooleanOkreśla, czy po wypełnieniu formularza przez użytkownika wyświetla się link do przesłania kolejnej odpowiedzi.
isAcceptingResponses()BooleanOkreśla, czy formularz obecnie przyjmuje odpowiedzi.
isPublished()BooleanOkreśla, czy formularz jest opublikowany.
isPublishingSummary()BooleanOkreśla, czy po wypełnieniu formularza przez użytkownika ma się w nim wyświetlać link do podsumowania odpowiedzi.
isQuiz()BooleanOkreśla, czy formularz jest testem.
moveItem(from, to)ItemPrzenosi element o podanym indeksie w formularzu na inny podany indeks.
moveItem(item, toIndex)ItemPrzenosi dany element na podany indeks wśród wszystkich elementów formularza.
removeDestination()FormRozłącza formularz z bieżącym miejscem docelowym odpowiedzi.
removeEditor(emailAddress)FormUsuwa podanego użytkownika z listy osób edytujących Form.
removeEditor(user)FormUsuwa podanego użytkownika z listy osób edytujących Form.
removePublishedReader(emailAddress)FormUsuwa danego użytkownika z listy osób, które odpowiedziały na Form.
removePublishedReader(user)FormUsuwa danego użytkownika z listy osób, które odpowiedziały na Form.
setAcceptingResponses(enabled)FormOkreśla, czy formularz obecnie przyjmuje odpowiedzi.
setAllowResponseEdits(enabled)FormOkreśla, czy po przesłaniu odpowiedzi w formularzu ma się wyświetlać link do jej edycji.
setCollectEmail(collect)FormOkreśla, czy formularz ma zbierać adresy e-mail respondentów.
setConfirmationMessage(message)FormUstawia wiadomość potwierdzającą przesłanie formularza.
setCustomClosedFormMessage(message)FormUstawia wiadomość, która ma się wyświetlać, jeśli formularz nie przyjmuje odpowiedzi.
setDescription(description)FormUstawia opis formularza.
setDestination(type, id)FormUstawia miejsce docelowe, w którym zapisywane są odpowiedzi z formularza.
setIsQuiz(enabled)FormOkreśla, czy formularz jest testem.
setLimitOneResponsePerUser(enabled)FormOkreśla, czy formularz zezwala na przesłanie tylko jednej odpowiedzi przez użytkownika.
setProgressBar(enabled)FormOkreśla, czy formularz ma pasek postępu.
setPublished(enabled)FormOkreśla, czy formularz jest opublikowany.
setPublishingSummary(enabled)FormOkreśla, czy po przesłaniu formularza przez użytkownika ma się w nim wyświetlać link do podsumowania odpowiedzi.
setShowLinkToRespondAgain(enabled)FormOkreśla, czy po wypełnieniu formularza przez użytkownika wyświetla się link do przesłania kolejnej odpowiedzi.
setShuffleQuestions(shuffle)FormOkreśla, czy kolejność pytań na każdej stronie formularza jest losowa.
setTitle(title)FormUstawia tytuł formularza.
shortenFormUrl(url)StringKonwertuje długi adres URL formularza na krótki adres URL.
submitGrades(responses)FormPrzesyła oceny dla podanych odpowiedzi w Formularzach.
supportsAdvancedResponderPermissions()BooleanOkreśla, czy formularz obsługuje publikowanie.

FormApp

Właściwości

WłaściwośćTypOpis
AlignmentAlignmentWyliczenie typów wyrównania obrazu.
DestinationTypeDestinationTypeWyliczenie typów miejsc docelowych, w których można przechowywać odpowiedzi na pytania z formularza.
FeedbackTypeFeedbackTypeWyliczenie typów formularza Feedbacks.
ItemTypeItemTypeWyliczenie typów formularza Items.
PageNavigationTypePageNavigationTypeWyliczenie możliwych zachowań podczas poruszania się po stronach.
RatingIconTypeRatingIconTypeWyliczenie typów ikon ocen RatingIcons

Metody

MetodaZwracany typKrótki opis
create(title)FormTworzy i zwraca nowy obiekt Form.
create(title, isPublished)FormTworzy i zwraca nowy obiekt Form w żądanym stanie publikacji.
createCheckboxGridValidation()CheckboxGridValidationBuilderZwraca instancję klasy CheckboxGridValidationBuilder, której można użyć do ustawienia weryfikacji w CheckboxGridItem.
createCheckboxValidation()CheckboxValidationBuilderZwraca instancję klasy CheckboxValidationBuilder, której można użyć do ustawienia weryfikacji elementu CheckboxItem.
createFeedback()QuizFeedbackBuilderZwraca instancję klasy QuizFeedbackBuilder, której można użyć do ustawienia opinii na temat elementu podlegającego ocenieItem.
createGridValidation()GridValidationBuilderZwraca instancję klasy GridValidationBuilder, której można użyć do ustawienia weryfikacji w obiekcie GridItem.
createParagraphTextValidation()ParagraphTextValidationBuilderZwraca instancję klasy ParagraphTextValidationBuilder, której można użyć do ustawienia weryfikacji w przypadku elementu ParagraphTextItem.
createTextValidation()TextValidationBuilderZwraca instancję klasy TextValidationBuilder, której można użyć do ustawienia weryfikacji w przypadku elementu TextItem.
getActiveForm()FormZwraca formularz, z którym skrypt jest powiązany.
getUi()UiZwraca instancję środowiska interfejsu użytkownika edytora formularzy, która umożliwia skryptowi dodawanie funkcji takich jak menu, okna i paski boczne.
openById(id)FormZwraca Form o określonym identyfikatorze.
openByUrl(url)FormZwraca obiekt Form o określonym adresie URL.

FormResponse

Metody

MetodaZwracany typKrótki opis
getEditResponseUrl()StringGeneruje adres URL, którego można użyć do edytowania przesłanej już odpowiedzi.
getGradableItemResponses()ItemResponse[]Pobiera wszystkie odpowiedzi na pytania zawarte w odpowiedzi na formularz w tej samej kolejności, w jakiej pytania pojawiają się w formularzu.
getGradableResponseForItem(item)ItemResponsePobiera odpowiedź na pytanie zawartą w odpowiedzi na formularz dla danego pytania.
getId()String|nullPobiera identyfikator odpowiedzi na formularz.
getItemResponses()ItemResponse[]Pobiera wszystkie odpowiedzi na pytania zawarte w odpowiedzi na formularz w tej samej kolejności, w jakiej pytania pojawiają się w formularzu.
getRespondentEmail()StringPobiera adres e-mail osoby, która przesłała odpowiedź, jeśli włączone jest ustawienie Form.setCollectEmail(collect).
getResponseForItem(item)ItemResponsePobiera odpowiedź na element zawartą w tej odpowiedzi na formularz dla danego elementu.
getTimestamp()DatePobiera sygnaturę czasową przesłania odpowiedzi na formularz.
submit()FormResponseprzesyła odpowiedź.
toPrefilledUrl()StringGeneruje adres URL formularza, w którym odpowiedzi są wstępnie wypełnione na podstawie odpowiedzi w tym formularzu.
withItemGrade(gradedResponse)FormResponseDodaje oceny z odpowiedzi na pytanie do odpowiedzi na formularz.
withItemResponse(response)FormResponseDodaje do odpowiedzi w formularzu podaną odpowiedź na pytanie.

GridItem

Metody

MetodaZwracany typKrótki opis
clearValidation()GridItemUsuwa sprawdzanie poprawności danych w tym elemencie siatki.
createResponse(responses)ItemResponseTworzy nowy ItemResponse dla tego elementu siatki.
duplicate()GridItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getColumns()String[]Pobiera wartości z każdej kolumny w siatce.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getRows()String[]Pobiera wartości z każdego wiersza w siatce.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setColumns(columns)GridItemUstawia kolumny siatki na podstawie tablicy wartości.
setHelpText(text)GridItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setRequired(enabled)GridItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setRows(rows)GridItemUstawia wiersze siatki na podstawie tablicy wartości.
setTitle(title)GridItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
setValidation(validation)GridItemUstawia sprawdzanie poprawności danych dla tego elementu siatki.

GridValidation

GridValidationBuilder

Metody

MetodaZwracany typKrótki opis
requireLimitOneResponsePerColumn()GridValidationBuilderWymaga ograniczenia do 1 odpowiedzi na kolumnę w przypadku elementu siatki.

ImageItem

Metody

MetodaZwracany typKrótki opis
duplicate()ImageItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getAlignment()AlignmentPobiera wyrównanie obrazu w poziomie.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getImage()BlobPobiera obraz, który jest obecnie przypisany do produktu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
getWidth()IntegerPobiera szerokość obrazu w pikselach.
setAlignment(alignment)ImageItemUstawia wyrównanie poziome obrazu.
setHelpText(text)ImageItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setImage(image)ImageItemUstawia sam obraz.
setTitle(title)ImageItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
setWidth(width)ImageItemUstawia szerokość obrazu w pikselach.

Item

Metody

MetodaZwracany typKrótki opis
asCheckboxGridItem()CheckboxGridItemZwraca element jako element siatki z polami 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, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
setHelpText(text)ItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setTitle(title)ItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

ItemResponse

Metody

MetodaZwracany typKrótki opis
getFeedback()ObjectPobiera opinię przesłaną przez respondenta na temat jego odpowiedzi.
getItem()ItemPobiera element pytania, na które odpowiada ta odpowiedź.
getResponse()ObjectPobiera odpowiedź przesłaną przez użytkownika.
getScore()ObjectPobiera wynik przesłanej odpowiedzi respondenta.
setFeedback(feedback)ItemResponseUstawia opinię, która powinna być wyświetlana w odpowiedzi na przesłaną odpowiedź respondenta.
setScore(score)ItemResponseUstawia wynik przesłanej odpowiedzi.

ItemType

Właściwości

WłaściwośćTypOpis
CHECKBOXEnumPytanie, w którym respondent może zaznaczyć co najmniej jedno pole wyboru, a także opcjonalne pole „Inne”.
CHECKBOX_GRIDEnumPytanie w formie siatki kolumn i wierszy, które umożliwia respondentowi wybranie wielu opcji w każdym wierszu z ciągu pól wyboru.
DATEEnumPytanie, w którym użytkownik może podać datę.
DATETIMEEnumElement pytania, który umożliwia użytkownikowi wskazanie daty i godziny.
DURATIONEnumElement pytania, który umożliwia użytkownikowi określenie długości czasu.
GRIDEnumPytanie w formie siatki kolumn i wierszy, które umożliwia respondentowi wybranie jednej odpowiedzi w każdym wierszu z ciągu przycisków opcji.
IMAGEEnumElement układu, który wyświetla obraz.
LISTEnumPytanie, w którym respondent może wybrać jedną odpowiedź z listy.
MULTIPLE_CHOICEEnumPytanie, w którym respondent może wybrać jedną odpowiedź z listy przycisków opcji lub opcjonalnego pola „Inne”.
PAGE_BREAKEnumElement układu, który oznacza początek strony.
PARAGRAPH_TEXTEnumPytanie, które umożliwia respondentowi wpisanie bloku tekstu.
RATINGEnumPytanie, które umożliwia użytkownikowi wystawienie oceny.
SCALEEnumPytanie, które umożliwia użytkownikowi wybranie jednej opcji z numerowanego ciągu przycisków opcji.
SECTION_HEADEREnumElement układu, który wizualnie wskazuje początek sekcji.
TEXTEnumPytanie, na które respondent może odpowiedzieć w jednym wierszu tekstu.
TIMEEnumElement pytania, który umożliwia użytkownikowi wskazanie pory dnia.
VIDEOEnumElement układu, który wyświetla film na YouTube.
FILE_UPLOADEnumPytanie, które umożliwia użytkownikowi przesłanie pliku.
UNSUPPORTEDEnumElement, który nie jest obecnie obsługiwany przez interfejsy API.

ListItem

Metody

MetodaZwracany typKrótki opis
createChoice(value)ChoiceTworzy nowy wybór.
createChoice(value, isCorrect)ChoiceTworzy nowy wybór.
createChoice(value, navigationItem)ChoiceTworzy nowy wybór z opcją nawigacji po stronie, która przenosi użytkownika do danego elementu podziału strony.
createChoice(value, navigationType)ChoiceTworzy nowy wybór z opcją nawigacji po stronie.
createResponse(response)ItemResponseTworzy nowy ItemResponse dla tego elementu listy.
duplicate()ListItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getChoices()Choice[]Pobiera wszystkie opcje elementu.
getFeedbackForCorrect()QuizFeedback|nullZwraca opinię, która jest wyświetlana użytkownikom, gdy poprawnie odpowiedzą na pytanie.
getFeedbackForIncorrect()QuizFeedback|nullZwraca opinię, która jest wyświetlana użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getPoints()IntegerZwraca liczbę punktów elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setChoiceValues(values)ListItemUstawia wybory dla elementu z tablicy ciągów znaków.
setChoices(choices)ListItemUstawia tablicę opcji dla elementu.
setFeedbackForCorrect(feedback)ListItemUstawia informację zwrotną, która ma być wyświetlana użytkownikom, gdy poprawnie odpowiedzą na pytanie.
setFeedbackForIncorrect(feedback)ListItemUstawia opinię, która ma być wyświetlana użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
setHelpText(text)ListItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setPoints(points)ListItemUstawia liczbę punktów, jaką jest warta oceniana pozycja.
setRequired(enabled)ListItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)ListItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

MultipleChoiceItem

Metody

MetodaZwracany typKrótki opis
createChoice(value)ChoiceTworzy nowy wybór.
createChoice(value, isCorrect)ChoiceTworzy nowy wybór.
createChoice(value, navigationItem)ChoiceTworzy nowy wybór z opcją nawigacji po stronie, która przenosi użytkownika do danego elementu podziału strony.
createChoice(value, navigationType)ChoiceTworzy nowy wybór z opcją nawigacji po stronie.
createResponse(response)ItemResponseTworzy nowy ItemResponse dla tego pytania jednokrotnego wyboru.
duplicate()MultipleChoiceItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getChoices()Choice[]Pobiera wszystkie opcje elementu.
getFeedbackForCorrect()QuizFeedback|nullZwraca opinię, która jest wyświetlana użytkownikom, gdy poprawnie odpowiedzą na pytanie.
getFeedbackForIncorrect()QuizFeedback|nullZwraca opinię, która jest wyświetlana użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getPoints()IntegerZwraca liczbę punktów elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
hasOtherOption()BooleanOkreśla, czy element ma opcję „Inne”.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setChoiceValues(values)MultipleChoiceItemUstawia wybory dla elementu z tablicy ciągów znaków.
setChoices(choices)MultipleChoiceItemUstawia tablicę opcji dla elementu.
setFeedbackForCorrect(feedback)MultipleChoiceItemUstawia informację zwrotną, która ma być wyświetlana użytkownikom, gdy poprawnie odpowiedzą na pytanie.
setFeedbackForIncorrect(feedback)MultipleChoiceItemUstawia opinię, która ma być wyświetlana użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
setHelpText(text)MultipleChoiceItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setPoints(points)MultipleChoiceItemUstawia liczbę punktów, jaką jest warta oceniana pozycja.
setRequired(enabled)MultipleChoiceItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)MultipleChoiceItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
showOtherOption(enabled)MultipleChoiceItemOkreśla, czy element ma opcję „Inna odpowiedź”.

PageBreakItem

Metody

MetodaZwracany typKrótki opis
duplicate()PageBreakItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGoToPage()PageBreakItemPobiera PageBreakItem, do którego formularz przejdzie po wypełnieniu strony przed tym podziałem strony (czyli po osiągnięciu tego podziału strony w wyniku normalnego liniowego przechodzenia przez formularz).
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getPageNavigationType()PageNavigationTypeOkreśla typ nawigacji na stronie, która następuje po wypełnieniu strony przed tym podziałem strony (czyli po osiągnięciu tego podziału strony w wyniku normalnego liniowego przechodzenia przez formularz).
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
setGoToPage(goToPageItem)PageBreakItemUstawia stronę, na którą użytkownik ma przejść po wypełnieniu strony poprzedzającej ten podział (czyli po dotarciu do tego podziału strony w normalnym, liniowym procesie wypełniania formularza).
setGoToPage(navigationType)PageBreakItemOkreśla typ nawigacji na stronie, która następuje po wypełnieniu strony przed tym podziałem strony (czyli po osiągnięciu tego podziału strony w wyniku normalnego liniowego przechodzenia przez formularz).
setHelpText(text)PageBreakItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setTitle(title)PageBreakItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

Właściwości

WłaściwośćTypOpis
CONTINUEEnumPo wypełnieniu bieżącej strony przejdź do następnej.
GO_TO_PAGEEnumPrzejdź do określonej strony formularza po wypełnieniu bieżącej strony.
RESTARTEnumPo zakończeniu bieżącej strony możesz ponownie uruchomić formularz od początku bez usuwania dotychczasowych odpowiedzi.
SUBMITEnumPrześlij odpowiedź z formularza po wypełnieniu bieżącej strony.

ParagraphTextItem

Metody

MetodaZwracany typKrótki opis
clearValidation()ParagraphTextItemUsuwa sprawdzanie poprawności danych w przypadku tego elementu tekstowego akapitu.
createResponse(response)ItemResponseTworzy nowy element ItemResponse dla tego elementu tekstowego akapitu.
duplicate()ParagraphTextItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedback|nullZwraca opinię, która jest wyświetlana osobom odpowiadającym na pytanie podlegające ocenie.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getPoints()IntegerZwraca liczbę punktów elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)ParagraphTextItemUstawia informacje zwrotne, które mają być wyświetlane użytkownikom, gdy odpowiadają na pytanie podlegające ocenie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (np. pytania wymagające ręcznego oceniania).
setHelpText(text)ParagraphTextItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setPoints(points)ParagraphTextItemUstawia liczbę punktów, jaką jest warta oceniana pozycja.
setRequired(enabled)ParagraphTextItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)ParagraphTextItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
setValidation(validation)ParagraphTextItemUstawia sprawdzanie poprawności danych dla tego elementu tekstowego akapitu.

ParagraphTextValidation

ParagraphTextValidationBuilder

Metody

MetodaZwracany typKrótki opis
requireTextContainsPattern(pattern)ParagraphTextValidationBuilderWymaga, aby odpowiedź zawierała wzorzec.
requireTextDoesNotContainPattern(pattern)ParagraphTextValidationBuilderWymaga, aby odpowiedź nie zawierała wzorca.
requireTextDoesNotMatchPattern(pattern)ParagraphTextValidationBuilderWymaga, aby odpowiedź nie pasowała do wzorca.
requireTextLengthGreaterThanOrEqualTo(number)ParagraphTextValidationBuilderWymaga, aby długość odpowiedzi była równa lub większa od wartości.
requireTextLengthLessThanOrEqualTo(number)ParagraphTextValidationBuilderWymaga, aby długość odpowiedzi była mniejsza niż wartość.
requireTextMatchesPattern(pattern)ParagraphTextValidationBuilderWymaga odpowiedzi zgodnej ze wzorcem.

QuizFeedback

Metody

MetodaZwracany typKrótki opis
getLinkUrls()String[]Pobiera listę adresów URL powiązanych z opinią.
getText()StringPobiera tekst wyświetlany opinii.

QuizFeedbackBuilder

Metody

MetodaZwracany typKrótki opis
addLink(url)QuizFeedbackBuilderDodaje link do materiałów dodatkowych opinii.
addLink(url, displayText)QuizFeedbackBuilderDodaje link do materiałów dodatkowych opinii.
build()QuizFeedbackTworzy opinię odpowiedniego typu dla tego kreatora.
copy()QuizFeedbackBuilderZwraca kopię tego narzędzia do tworzenia.
setText(text)QuizFeedbackBuilderUstawia tekst opinii.

RatingIconType

Właściwości

WłaściwośćTypOpis
STAREnumIkona gwiazdki.
HEARTEnumIkona serca.
THUMB_UPEnumIkona kciuka w górę.

RatingItem

Metody

MetodaZwracany typKrótki opis
createResponse(response)ItemResponseTworzy nowy ItemResponse dla tego elementu oceny.
duplicate()RatingItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedback|nullZwraca opinię, która jest wyświetlana osobom odpowiadającym na pytanie podlegające ocenie.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getPoints()IntegerZwraca liczbę punktów elementu podlegającego ocenie.
getRatingIcon()RatingIconTypePobiera ikonę wybraną dla oceny.
getRatingScaleLevel()IntegerPobiera poziom skali oceny.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)RatingItemUstawia informacje zwrotne, które mają być wyświetlane użytkownikom, gdy odpowiadają na pytanie podlegające ocenie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (np. pytania wymagające ręcznego oceniania).
setHelpText(text)RatingItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setPoints(points)RatingItemUstawia liczbę punktów, jaką jest warta oceniana pozycja.
setRatingIcon(ratingIcon)RatingItemUstawia ikonę oceny.
setRatingScaleLevel(ratingScaleLevel)RatingItemUstawia maksymalny poziom skali oceny.
setRequired(enabled)RatingItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)RatingItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

ScaleItem

Metody

MetodaZwracany typKrótki opis
createResponse(response)ItemResponseTworzy nowy ItemResponse dla tego elementu skali.
duplicate()ScaleItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedback|nullZwraca opinię, która jest wyświetlana osobom odpowiadającym na pytanie podlegające ocenie.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getLeftLabel()StringPobiera etykietę dolnej granicy skali (jeśli istnieje).
getLowerBound()IntegerPobiera dolną granicę skali.
getPoints()IntegerZwraca liczbę punktów elementu podlegającego ocenie.
getRightLabel()StringZwraca etykietę górnej granicy skali (jeśli taka istnieje).
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
getUpperBound()IntegerPobiera górną granicę skali.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setBounds(lower, upper)ScaleItemUstawia dolną i górną granicę skali.
setGeneralFeedback(feedback)ScaleItemUstawia informacje zwrotne, które mają być wyświetlane użytkownikom, gdy odpowiadają na pytanie podlegające ocenie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (np. pytania wymagające ręcznego oceniania).
setHelpText(text)ScaleItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setLabels(lower, upper)ScaleItemUstawia etykiety dolnej i górnej granicy skali.
setPoints(points)ScaleItemUstawia liczbę punktów, jaką jest warta oceniana pozycja.
setRequired(enabled)ScaleItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)ScaleItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

SectionHeaderItem

Metody

MetodaZwracany typKrótki opis
duplicate()SectionHeaderItemTworzy 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, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
setHelpText(text)SectionHeaderItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setTitle(title)SectionHeaderItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

TextItem

Metody

MetodaZwracany typKrótki opis
clearValidation()TextItemUsuwa sprawdzanie poprawności danych dla tego elementu tekstowego.
createResponse(response)ItemResponseTworzy nowy ItemResponse dla tego elementu tekstowego.
duplicate()TextItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedback|nullZwraca opinię, która jest wyświetlana osobom odpowiadającym na pytanie podlegające ocenie.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getPoints()IntegerZwraca liczbę punktów elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)TextItemUstawia informacje zwrotne, które mają być wyświetlane użytkownikom, gdy odpowiadają na pytanie podlegające ocenie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (np. pytania wymagające ręcznego oceniania).
setHelpText(text)TextItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setPoints(points)TextItemUstawia liczbę punktów, jaką jest warta oceniana pozycja.
setRequired(enabled)TextItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)TextItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
setValidation(validation)TextItemUstawia sprawdzanie poprawności danych dla tego elementu tekstowego.

TextValidation

TextValidationBuilder

Metody

MetodaZwracany typKrótki opis
requireNumber()TextValidationBuilderWymaga, aby element tekstowy był liczbą.
requireNumberBetween(start, end)TextValidationBuilderWymaga, aby element tekstowy był liczbą z zakresu od wartości początkowej do końcowej (włącznie).
requireNumberEqualTo(number)TextValidationBuilderWymaga, aby element tekstowy był liczbą równą określonej wartości.
requireNumberGreaterThan(number)TextValidationBuilderWymaga, aby element tekstowy był liczbą większą od podanej wartości.
requireNumberGreaterThanOrEqualTo(number)TextValidationBuilderWymaga, aby element tekstowy był liczbą większą lub równą podanej wartości.
requireNumberLessThan(number)TextValidationBuilderWymaga, aby element tekstowy był liczbą mniejszą niż podana wartość.
requireNumberLessThanOrEqualTo(number)TextValidationBuilderWymaga, aby element tekstowy był liczbą mniejszą lub równą podanej wartości.
requireNumberNotBetween(start, end)TextValidationBuilderWymaga, aby element tekstowy był liczbą, która nie mieści się w zakresie od wartości początkowej do końcowej (włącznie).
requireNumberNotEqualTo(number)TextValidationBuilderWymaga, aby element tekstowy był liczbą różną od podanej wartości.
requireTextContainsPattern(pattern)TextValidationBuilderWymaga, aby odpowiedź zawierała wzorzec.
requireTextDoesNotContainPattern(pattern)TextValidationBuilderWymaga, aby odpowiedź nie zawierała wzorca.
requireTextDoesNotMatchPattern(pattern)TextValidationBuilderWymaga, aby odpowiedź nie pasowała do wzorca.
requireTextIsEmail()TextValidationBuilderWymaga, aby element tekstowy był adresem e-mail.
requireTextIsUrl()TextValidationBuilderWymaga, aby element tekstowy był adresem URL.
requireTextLengthGreaterThanOrEqualTo(number)TextValidationBuilderWymaga, aby długość odpowiedzi była równa lub większa od wartości.
requireTextLengthLessThanOrEqualTo(number)TextValidationBuilderWymaga, aby długość odpowiedzi była mniejsza niż wartość.
requireTextMatchesPattern(pattern)TextValidationBuilderWymaga odpowiedzi zgodnej ze wzorcem.
requireWholeNumber()TextValidationBuilderWymaga, aby element tekstowy był liczbą całkowitą.

TimeItem

Metody

MetodaZwracany typKrótki opis
createResponse(hour, minute)ItemResponseTworzy nowy ItemResponse dla tego elementu czasu.
duplicate()TimeItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedback|nullZwraca opinię, która jest wyświetlana osobom odpowiadającym na pytanie podlegające ocenie.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getPoints()IntegerZwraca liczbę punktów elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)TimeItemUstawia informacje zwrotne, które mają być wyświetlane użytkownikom, gdy odpowiadają na pytanie podlegające ocenie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (np. pytania wymagające ręcznego oceniania).
setHelpText(text)TimeItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setPoints(points)TimeItemUstawia liczbę punktów, jaką jest warta oceniana pozycja.
setRequired(enabled)TimeItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)TimeItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

VideoItem

Metody

MetodaZwracany typKrótki opis
duplicate()VideoItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getAlignment()AlignmentPobiera wyrównanie filmu w poziomie.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
getWidth()IntegerPobiera szerokość filmu w pikselach.
setAlignment(alignment)VideoItemUstawia poziome wyrównanie filmu.
setHelpText(text)VideoItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItemsSectionHeaderItems).
setTitle(title)VideoItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
setVideoUrl(youtubeUrl)VideoItemUstawia film na YouTube na podstawie podanego adresu URL lub identyfikatora filmu w YouTube.
setWidth(width)VideoItemUstawia szerokość filmu w pikselach.