Forms Service

Formularze

Ta usługa umożliwia skryptom tworzenie i modyfikowanie Formularzy Google oraz uzyskiwanie do nich dostępu.

// Create a new form, then add a checkbox question, a multiple choice question,
// a page break, then a date question and a grid of questions.
var form = FormApp.create('New Form');
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']);
Logger.log('Published URL: ' + form.getPublishedUrl());
Logger.log('Editor URL: ' + form.getEditUrl());

Zajęcia

NazwaKrótki opis
AlignmentWyliczenie reprezentujące obsługiwane typy wyrównywania obrazów.
CheckboxGridItemElement pytania, prezentowany jako siatka kolumn i wierszy, która umożliwia respondentowi wybranie w każdym wierszu wielu odpowiedzi z sekwencji pól wyboru.
CheckboxGridValidationWeryfikacja poprawności danych na potrzeby elementu CheckboxGridItem.
CheckboxGridValidationBuilderElement DataValidationBuilder dla: CheckboxGridValidation.
CheckboxItemElement pytania, który umożliwia użytkownikowi zaznaczenie jednego lub wielu pól wyboru, a także opcjonalne pole „inne”.
CheckboxValidationWeryfikacja poprawności danych na potrzeby elementu CheckboxItem.
CheckboxValidationBuilderElement DataValidationBuilder dla: CheckboxValidation.
ChoiceJedna opcja powiązana z typem Item, który obsługuje opcje takie jak CheckboxItem, ListItem lub MultipleChoiceItem.
DateItemElement pytania, który umożliwia użytkownikowi wskazanie daty.
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 pozwala respondentowi określić czas trwania.
FeedbackTypeWyliczenie reprezentujące obsługiwane typy opinii.
FormFormularz zawierający ogólne właściwości i elementy.
FormAppZezwala skryptowi na otwarcie istniejącego elementu Form lub utworzenie nowego.
FormResponseOdpowiedź na cały formularz.
GridItemPozycja pytania przedstawiona w postaci siatki kolumn i wierszy, która umożliwia respondentom wybranie w każdym wierszu jednej opcji z sekwencji przycisków opcji.
GridValidationWeryfikacja poprawności danych na potrzeby elementu GridItem.
GridValidationBuilderElement DataValidationBuilder dla: 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, np. tytuł i tekst pomocy.
ItemResponseOdpowiedź na jedno pytanie w formularzu.
ItemTypeWyliczenie reprezentujące obsługiwane typy elementów formularza.
ListItemElement pytania, który umożliwia użytkownikowi wybranie jednej opcji z listy.
MultipleChoiceItemElement pytania, który umożliwia respondentowi wybranie jednej opcji z listy przycisków lub opcjonalnego pola „inne”.
PageBreakItemElement układu oznaczający początek strony.
PageNavigationTypeWyliczenie reprezentujące obsługiwane typy nawigacji po stronie.
ParagraphTextItemElement pytania, który umożliwia użytkownikowi wpisanie bloku tekstu.
ParagraphTextValidationWeryfikacja poprawności danych na potrzeby elementu ParagraphTextItem.
ParagraphTextValidationBuilderElement DataValidationBuilder dla: ParagraphTextValidation.
QuizFeedbackImplementacja danych typu bean opinii, która zawiera właściwości wspólne dla wszystkich opinii, takie jak wyświetlany tekst czy linki.
QuizFeedbackBuilderPodstawowy obiekt opinii zawierający elementy ustawiające właściwości wspólne dla wszystkich opinii, np. wyświetlanego tekstu.
ScaleItemElement pytania, który umożliwia respondentowi wybranie 1 opcji z sekwencji numerowanych przycisków.
SectionHeaderItemElement układu, który wizualnie wskazuje początek sekcji.
TextItemElement pytania, który umożliwia użytkownikowi wpisanie pojedynczej linii tekstu.
TextValidationWeryfikacja poprawności danych na potrzeby elementu TextItem.
TextValidationBuilderElement DataValidationBuilder dla: TextValidation.
TimeItemElement pytania, który pozwala użytkownikowi określić porę 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 wszystkie reguły sprawdzania poprawności danych związane z tym elementem siatki.
createResponse(responses)ItemResponseTworzy nowy element 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 dotyczący 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 spośród wszystkich elementów formularza.
getRows()String[]Pobiera wartości z każdego wiersza w siatce.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setColumns(columns)CheckboxGridItemUstawia kolumny siatki na podstawie tablicy wartości.
setHelpText(text)CheckboxGridItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setRequired(enabled)CheckboxGridItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setRows(rows)CheckboxGridItemUstawia wiersze siatki na podstawie tablicy wartości.
setTitle(title)CheckboxGridItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest 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()CheckboxGridValidationBuilderWymagana jest maksymalnie 1 odpowiedź na kolumnę dla elementu siatki.

CheckboxItem

Metody

MetodaZwracany typKrótki opis
clearValidation()CheckboxItemUsuwa weryfikację danych dla tego elementu pola wyboru.
createChoice(value)ChoiceTworzy nową opcję wyboru.
createChoice(value, isCorrect)ChoiceTworzy nową opcję wyboru.
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 dotyczące elementu.
getFeedbackForCorrect()QuizFeedbackZwraca komentarz wyświetlany użytkownikom, którzy odpowiedzą prawidłowo na pytanie.
getFeedbackForIncorrect()QuizFeedbackZwraca informacje zwrotne, które są wyświetlane użytkownikom, którzy odpowiedzieli nieprawidłowo na pytanie.
getHelpText()StringPobiera tekst pomocy dotyczący 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 spośród wszystkich elementów formularza.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
hasOtherOption()BooleanOkreśla, czy dla elementu jest dostępna opcja „inne”.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setChoiceValues(values)CheckboxItemUstawia opcje elementu z tablicy ciągów tekstowych.
setChoices(choices)CheckboxItemUstawia tablicę opcji dla elementu.
setFeedbackForCorrect(feedback)CheckboxItemOkreśla informacje, które będą wyświetlane respondentom, gdy odpowiedzą na pytanie poprawnie.
setFeedbackForIncorrect(feedback)CheckboxItemOkreśla komentarz, który będzie wyświetlany użytkownikom, którzy odpowiedzą nieprawidłowo na pytanie.
setHelpText(text)CheckboxItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)CheckboxItemOkreśla liczbę punktów za element, który można ocenić.
setRequired(enabled)CheckboxItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)CheckboxItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
setValidation(validation)CheckboxItemUstawia sprawdzanie poprawności danych dla tego elementu pola wyboru.
showOtherOption(enabled)CheckboxItemOkreśla, czy dla elementu jest dostępna opcja „inne”.

CheckboxValidation

CheckboxValidationBuilder

Metody

MetodaZwracany typKrótki opis
requireSelectAtLeast(number)CheckboxValidationBuilderWymagaj co najmniej tak wielu opcji wyboru.
requireSelectAtMost(number)CheckboxValidationBuilderWymagaj wybrania maksymalnie tak wielu opcji.
requireSelectExactly(number)CheckboxValidationBuilderWymagaj wyboru dokładnie tak wielu opcji wyboru.

Choice

Metody

MetodaZwracany typKrótki opis
getGotoPage()PageBreakItemPobiera obiekt PageBreakItem ustawiony jako miejsce docelowe GO_TO_PAGE, jeśli ankietowany wybierze tę opcję i uzupełni bieżącą stronę.
getPageNavigationType()PageNavigationTypePobiera parametr PageNavigationType, który pojawia się, gdy ankietowany wybierze tę opcję i ukończy bieżącą stronę.
getValue()StringPobiera wartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza.
isCorrectAnswer()BooleanSprawdza, czy wybrana odpowiedź jest prawidłową odpowiedzią na pytanie.

DateItem

Metody

MetodaZwracany typKrótki opis
createResponse(response)ItemResponseTworzy nowy element ItemResponse dla tego elementu daty.
duplicate()DateItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedbackZwraca informacje wyświetlane użytkownikom, gdy odpowiadają na pytanie, które można ocenić.
getHelpText()StringPobiera tekst pomocy dotyczący 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 spośród wszystkich elementów formularza.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
includesYear()BooleanOkreśla, czy element daty zawiera opcję roku.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)DateItemOkreśla informacje, które będą wyświetlane respondentom, gdy odpowiadają na pytanie, które można ocenić, ale na które nie ma prawidłowej lub niepoprawnej odpowiedzi (np. na pytanie, które wymaga oceny ręcznej).
setHelpText(text)DateItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setIncludesYear(enableYear)DateItemOkreśla, czy element daty zawiera ustawienie roku.
setPoints(points)DateItemOkreśla liczbę punktów za element, który można ocenić.
setRequired(enabled)DateItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)DateItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).

DateTimeItem

Metody

MetodaZwracany typKrótki opis
createResponse(response)ItemResponseTworzy nowy element ItemResponse dla tego elementu daty i godziny.
duplicate()DateTimeItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedbackZwraca informacje wyświetlane użytkownikom, gdy odpowiadają na pytanie, które można ocenić.
getHelpText()StringPobiera tekst pomocy dotyczący 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 spośród wszystkich elementów formularza.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
includesYear()BooleanOkreśla, czy element daty zawiera opcję roku.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)DateTimeItemOkreśla informacje, które będą wyświetlane respondentom, gdy odpowiadają na pytanie, które można ocenić, ale na które nie ma prawidłowej lub niepoprawnej odpowiedzi (np. na pytanie, które wymaga oceny ręcznej).
setHelpText(text)DateTimeItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setIncludesYear(enableYear)DateTimeItemOkreśla, czy element daty zawiera ustawienie roku.
setPoints(points)DateTimeItemOkreśla liczbę punktów za element, który można ocenić.
setRequired(enabled)DateTimeItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)DateTimeItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).

DestinationType

Właściwości

WłaściwośćTypOpis
SPREADSHEETEnumArkusz kalkulacyjny Arkuszy Google przeznaczony do odpowiedzi na pytania z formularza.

DurationItem

Metody

MetodaZwracany typKrótki opis
createResponse(hours, minutes, seconds)ItemResponseTworzy nowy element ItemResponse dla tego elementu daty.
duplicate()DurationItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedbackZwraca informacje wyświetlane użytkownikom, gdy odpowiadają na pytanie, które można ocenić.
getHelpText()StringPobiera tekst pomocy dotyczący 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 spośród wszystkich elementów formularza.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)DurationItemOkreśla informacje, które będą wyświetlane respondentom, gdy odpowiadają na pytanie, które można ocenić, ale na które nie ma prawidłowej lub niepoprawnej odpowiedzi (np. na pytanie, które wymaga oceny ręcznej).
setHelpText(text)DurationItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)DurationItemOkreśla liczbę punktów za element, który można ocenić.
setRequired(enabled)DurationItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)DurationItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).

FeedbackType

Właściwości

WłaściwośćTypOpis
CORRECTEnumInformacja wyświetlana automatycznie użytkownikom w przypadku odpowiedzi na pytanie, na które udzielono prawidłowej odpowiedzi.
INCORRECTEnumInformacja wyświetlana automatycznie użytkownikom w przypadku odpowiedzi na pytanie, na które udzielono niepoprawnej odpowiedzi.
GENERALEnumOpinia, która jest automatycznie wyświetlana użytkownikom po przesłaniu odpowiedzi.

Form

Metody

MetodaZwracany typKrótki opis
addCheckboxGridItem()CheckboxGridItemDodaje nowe pytanie, które jest prezentowane w formie siatki kolumn i wierszy, co umożliwia respondentom wybranie wielu opcji w każdym wierszu z sekwencji pól wyboru.
addCheckboxItem()CheckboxItemDodaje nowe pytanie, które pozwala respondentowi zaznaczyć jedno lub więcej pól wyboru, a także opcjonalne pole „inne”.
addDateItem()DateItemDodaje nowy element pytania, który umożliwia respondentowi wskazanie daty.
addDateTimeItem()DateTimeItemDodaje nowy element pytania, który umożliwia respondentowi wskazanie daty i godziny.
addDurationItem()DurationItemDodaje nowy element pytania, który pozwala respondentowi określić czas trwania.
addEditor(emailAddress)FormDodaje wskazanego użytkownika do listy edytorów w Form.
addEditor(user)FormDodaje wskazanego użytkownika do listy edytorów w Form.
addEditors(emailAddresses)FormDodaje podaną tablicę użytkowników do listy edytorów elementu Form.
addGridItem()GridItemDodaje nowe pytanie, przedstawione w postaci siatki kolumn i wierszy, co umożliwia respondentom wybranie w każdym wierszu jednej odpowiedzi z sekwencji przycisków.
addImageItem()ImageItemDodaje nowy element układu, który wyświetla obraz.
addListItem()ListItemDodaje nowe pytanie, które pozwala respondentowi wybrać jedną odpowiedź z listy.
addMultipleChoiceItem()MultipleChoiceItemDodaje nowe pytanie, które umożliwia respondentowi wybranie jednej opcji z listy przycisków lub opcjonalnego pola „inne”.
addPageBreakItem()PageBreakItemDodaje nowy element układu, który oznacza początek strony.
addParagraphTextItem()ParagraphTextItemDodaje nowy element pytania, który umożliwia użytkownikowi wpisanie bloku tekstu.
addScaleItem()ScaleItemDodaje nowy element pytania, który umożliwia respondentowi wybranie jednej opcji z sekwencji numerowanych 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 pozwala respondentowi określić porę dnia.
addVideoItem()VideoItemDodaje nowy element układu, który wyświetla film.
canEditResponse()BooleanOkreśla, czy w formularzu wyświetlany jest link umożliwiający edytowanie odpowiedzi po jej przesłaniu.
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 magazynu odpowiedzi formularza.
deleteItem(index)voidUsuwa element o danym indeksie spośród wszystkich elementów formularza.
deleteItem(item)voidUsuwa dany element.
deleteResponse(responseId)FormUsuwa pojedynczą odpowiedź z magazynu odpowiedzi formularza.
getConfirmationMessage()StringPobiera komunikat z potwierdzeniem formularza.
getCustomClosedFormMessage()StringPobiera komunikat niestandardowy, który jest wyświetlany, jeśli formularz nie przyjmuje odpowiedzi, lub pusty ciąg, jeśli nie ustawiono komunikatów niestandardowych.
getDescription()StringPobiera opis formularza.
getDestinationId()StringPobiera identyfikator miejsca docelowego odpowiedzi formularza.
getDestinationType()DestinationTypePobiera typ miejsca docelowego odpowiedzi formularza.
getEditUrl()StringPobiera adres URL, za pomocą którego można uzyskać dostęp do trybu edycji formularza.
getEditors()User[]Pobiera listę edytorów tego elementu (Form).
getId()StringPobiera identyfikator formularza.
getItemById(id)ItemPobiera element o podanym identyfikatorze.
getItems()Item[]Pobiera tablicę ze wszystkimi elementami formularza.
getItems(itemType)Item[]Pobiera tablicę ze wszystkimi elementami określonego typu.
getPublishedUrl()StringPobiera adres URL, którego można użyć w odpowiedzi na formularz.
getResponse(responseId)FormResponsePobiera pojedynczą odpowiedź z formularza na podstawie identyfikatora odpowiedzi.
getResponses()FormResponse[]Pobiera tablicę wszystkich odpowiedzi formularza.
getResponses(timestamp)FormResponse[]Pobiera tablicę wszystkich odpowiedzi formularza 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 z formularza.
getTitle()StringPobiera tytuł formularza.
hasLimitOneResponsePerUser()BooleanOkreśla, czy formularz może zawierać tylko 1 odpowiedź na użytkownika.
hasProgressBar()BooleanOkreśla, czy w formularzu będzie wyświetlany pasek postępu.
hasRespondAgainLink()BooleanOkreśla, czy po wypełnieniu formularza przez użytkownika wyświetla się link umożliwiający przesłanie kolejnej odpowiedzi.
isAcceptingResponses()BooleanOkreśla, czy formularz przyjmuje obecnie odpowiedzi.
isPublishingSummary()BooleanOkreśla, czy po wypełnieniu formularza przez użytkownika ma być wyświetlany link do podsumowania odpowiedzi.
isQuiz()BooleanOkreśla, czy formularz jest quizem.
moveItem(from, to)ItemPrzenosi element znajdujący się w danym indeksie wśród wszystkich elementów formularza do innego indeksu.
moveItem(item, toIndex)ItemPrzenosi dany element do wskazanego indeksu wśród wszystkich elementów formularza.
removeDestination()FormOdłącza formularz od bieżącego miejsca docelowego odpowiedzi.
removeEditor(emailAddress)FormUsuwa danego użytkownika z listy edytorów Form.
removeEditor(user)FormUsuwa danego użytkownika z listy edytorów Form.
requiresLogin()BooleanOkreśla, czy przed wysłaniem odpowiedzi użytkownik musi zalogować się na konto w tej samej domenie czy w subdomenie.
setAcceptingResponses(enabled)FormOkreśla, czy formularz przyjmuje obecnie odpowiedzi.
setAllowResponseEdits(enabled)FormOkreśla, czy w formularzu wyświetlany jest link umożliwiający edytowanie odpowiedzi po jej przesłaniu.
setCollectEmail(collect)FormOkreśla, czy formularz ma zbierać adresy e-mail użytkowników.
setConfirmationMessage(message)FormUstawia komunikat z potwierdzeniem formularza.
setCustomClosedFormMessage(message)FormPowoduje, że komunikat będzie wyświetlany, gdy formularz nie przyjmuje odpowiedzi.
setDescription(description)FormUstawia opis formularza.
setDestination(type, id)FormOkreśla miejsce docelowe, w którym są zapisywane odpowiedzi z formularza.
setIsQuiz(enabled)FormOkreśla, czy formularz jest quizem.
setLimitOneResponsePerUser(enabled)FormOkreśla, czy formularz może zawierać tylko 1 odpowiedź na użytkownika.
setProgressBar(enabled)FormOkreśla, czy formularz ma pasek postępu.
setPublishingSummary(enabled)FormOkreśla, czy po przesłaniu formularza przez użytkownika ma być wyświetlany link do podsumowania odpowiedzi.
setRequireLogin(requireLogin)FormOkreśla, czy przed wysłaniem odpowiedzi użytkownicy muszą zalogować się na konto w tej samej domenie czy w subdomenie.
setShowLinkToRespondAgain(enabled)FormOkreśla, czy po wypełnieniu formularza przez użytkownika ma być wyświetlany link umożliwiający przesłanie kolejnej odpowiedzi.
setShuffleQuestions(shuffle)FormOkreśla, czy kolejność pytań na każdej stronie formularza ma być losowa.
setTitle(title)FormUstawia tytuł formularza.
shortenFormUrl(url)StringKonwertuje długi adres URL formularza na krótki adres URL.
submitGrades(responses)FormPrzesyłam oceny dla podanych formularzy FormResponses.

FormApp

Właściwości

WłaściwośćTypOpis
AlignmentAlignmentLista typów wyrównania obrazów.
DestinationTypeDestinationTypeLista typów miejsc docelowych, w których mogą być przechowywane odpowiedzi z formularza.
FeedbackTypeFeedbackTypeLista typów formularza Feedbacks.
ItemTypeItemTypeLista typów formularza Items.
PageNavigationTypePageNavigationTypeLista możliwych zachowań podczas poruszania się po stronach.

Metody

MetodaZwracany typKrótki opis
create(title)FormTworzy i zwraca nowy obiekt Form.
createCheckboxGridValidation()CheckboxGridValidationBuilderZwraca wystąpienie obiektu CheckboxGridValidationBuilder, którego można użyć do ustawienia weryfikacji obiektu CheckboxGridItem.
createCheckboxValidation()CheckboxValidationBuilderZwraca wystąpienie obiektu CheckboxValidationBuilder, którego można użyć do ustawienia weryfikacji obiektu CheckboxItem.
createFeedback()QuizFeedbackBuilderZwraca wystąpienie obiektu QuizfeedbackBuilder, którego można używać do ustawiania opinii na temat elementu Item z możliwością oceny.
createGridValidation()GridValidationBuilderZwraca wystąpienie obiektu GridValidationBuilder, którego można użyć do ustawienia weryfikacji obiektu GridItem.
createParagraphTextValidation()ParagraphTextValidationBuilderZwraca wystąpienie obiektu ParagraphTextValidationBuilder, którego można użyć do ustawienia weryfikacji na obiekcie ParagraphTextItem.
createTextValidation()TextValidationBuilderZwraca wystąpienie obiektu TextValidationBuilder, którego można użyć do sprawdzenia poprawności elementu TextItem.
getActiveForm()FormZwraca formę, do której skrypt jest powiązany z kontenerem container-bound.
getUi()UiZwraca wystąpienie środowiska interfejsu użytkownika edytora formularzy, które umożliwia skryptowi dodawanie takich funkcji jak menu, okna i paski boczne.
openById(id)FormZwraca wartość Form o określonym identyfikatorze.
openByUrl(url)FormZwraca wartość Form z określonym adresem URL.

FormResponse

Metody

MetodaZwracany typKrótki opis
getEditResponseUrl()Stringgeneruje adres URL, którego można używać do edytowania odpowiedzi, która została już przesłana.
getGradableItemResponses()ItemResponse[]Pobiera wszystkie odpowiedzi na elementy zawarte w odpowiedzi formularza w tej samej kolejności, w jakiej elementy występują w formularzu.
getGradableResponseForItem(item)ItemResponsePobiera odpowiedź dotyczącą elementu zawartą w formularzu odpowiedzi dotyczącej danego elementu.
getId()StringPobiera identyfikator odpowiedzi z formularza.
getItemResponses()ItemResponse[]Pobiera wszystkie odpowiedzi na elementy zawarte w odpowiedzi formularza w tej samej kolejności, w jakiej elementy występują w formularzu.
getRespondentEmail()StringPobiera adres e-mail osoby, która przesłała odpowiedź (jeśli jest włączone ustawienie Form.setCollectEmail(collect)).
getResponseForItem(item)ItemResponsePobiera odpowiedź dotyczącą danego elementu znajdującą się w tej odpowiedzi formularza.
getTimestamp()DatePobiera sygnaturę czasową przesłania odpowiedzi z formularza.
submit()FormResponsePrzesłanie odpowiedzi.
toPrefilledUrl()StringGeneruje adres URL formularza, w którym odpowiedzi są wstępnie wypełnione na podstawie odpowiedzi w tym formularzu.
withItemGrade(gradedResponse)FormResponseDodaje oceny danej odpowiedzi dotyczącej elementu do odpowiedzi do formularza.
withItemResponse(response)FormResponseDodaje podaną odpowiedź dotyczącą elementu do odpowiedzi do formularza.

GridItem

Metody

MetodaZwracany typKrótki opis
clearValidation()GridItemUsuwa wszystkie reguły sprawdzania poprawności danych związane z tym elementem siatki.
createResponse(responses)ItemResponseTworzy nowy element 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 dotyczący 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 spośród wszystkich elementów formularza.
getRows()String[]Pobiera wartości z każdego wiersza w siatce.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setColumns(columns)GridItemUstawia kolumny siatki na podstawie tablicy wartości.
setHelpText(text)GridItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setRequired(enabled)GridItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setRows(rows)GridItemUstawia wiersze siatki na podstawie tablicy wartości.
setTitle(title)GridItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
setValidation(validation)GridItemUstawia sprawdzanie poprawności danych dla tego elementu siatki.

GridValidation

GridValidationBuilder

Metody

MetodaZwracany typKrótki opis
requireLimitOneResponsePerColumn()GridValidationBuilderWymagana jest maksymalnie 1 odpowiedź na kolumnę dla elementu siatki.

ImageItem

Metody

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

Item

Metody

MetodaZwracany typKrótki opis
asCheckboxGridItem()CheckboxGridItemZwraca element jako element siatki pól wyboru.
asCheckboxItem()CheckboxItemZwraca element jako pole wyboru.
asDateItem()DateItemZwraca element jako element daty.
asDateTimeItem()DateTimeItemZwraca element jako datę i godzinę.
asDurationItem()DurationItemZwraca element jako element czasu trwania.
asGridItem()GridItemZwraca element jako element siatki.
asImageItem()ImageItemZwraca element jako obraz.
asListItem()ListItemZwraca element jako element listy.
asMultipleChoiceItem()MultipleChoiceItemZwraca element jako produkt wielokrotnego wyboru.
asPageBreakItem()PageBreakItemZwraca element jako element podziału strony.
asParagraphTextItem()ParagraphTextItemZwraca element w postaci tekstu akapitu.
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 film.
duplicate()ItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getHelpText()StringPobiera tekst pomocy dotyczący 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 spośród wszystkich elementów formularza.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
setHelpText(text)ItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setTitle(title)ItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).

ItemResponse

Metody

MetodaZwracany typKrótki opis
getFeedback()Objectpobiera opinię o przesłanej odpowiedzi użytkownika,
getItem()ItemPobiera pytanie, na które odpowiada ta odpowiedź.
getResponse()Object– pobiera odpowiedź przesłaną przez respondenta.
getScore()ObjectZbiera wynik dla odpowiedzi użytkownika.
setFeedback(feedback)ItemResponseOkreśla komentarz, który powinien być wyświetlany dla odpowiedzi użytkownika.
setScore(score)ItemResponseUstawia wynik przesłanej odpowiedzi użytkownika.

ItemType

Właściwości

WłaściwośćTypOpis
CHECKBOXEnumElement pytania, który umożliwia użytkownikowi zaznaczenie jednego lub wielu pól wyboru, a także opcjonalne pole „inne”.
CHECKBOX_GRIDEnumElement pytania, prezentowany jako siatka kolumn i wierszy, która umożliwia respondentowi wybranie w każdym wierszu wielu odpowiedzi z sekwencji pól wyboru.
DATEEnumElement pytania, który umożliwia użytkownikowi wskazanie daty.
DATETIMEEnumElement pytania, który umożliwia użytkownikowi wskazanie daty i godziny.
DURATIONEnumElement pytania, który pozwala respondentowi określić czas trwania.
GRIDEnumPozycja pytania przedstawiona w postaci siatki kolumn i wierszy, która umożliwia respondentom wybranie w każdym wierszu jednej opcji z sekwencji przycisków opcji.
IMAGEEnumElement układu, który wyświetla obraz.
LISTEnumElement pytania, który umożliwia użytkownikowi wybranie jednej opcji z listy.
MULTIPLE_CHOICEEnumElement pytania, który umożliwia respondentowi wybranie jednej opcji z listy przycisków lub opcjonalnego pola „inne”.
PAGE_BREAKEnumElement układu oznaczający początek strony.
PARAGRAPH_TEXTEnumElement pytania, który umożliwia użytkownikowi wpisanie bloku tekstu.
SCALEEnumElement pytania, który umożliwia respondentowi wybranie jednej opcji z sekwencji ponumerowanych przycisków.
SECTION_HEADEREnumElement układu, który wizualnie wskazuje początek sekcji.
TEXTEnumElement pytania, który umożliwia użytkownikowi wpisanie pojedynczej linii tekstu.
TIMEEnumElement pytania, który pozwala użytkownikowi określić porę dnia.
VIDEOEnumElement układu, który wyświetla film z YouTube.
FILE_UPLOADEnumElement pytania, który umożliwia użytkownikowi przesłanie pliku.

ListItem

Metody

MetodaZwracany typKrótki opis
createChoice(value)ChoiceTworzy nową opcję wyboru.
createChoice(value, isCorrect)ChoiceTworzy nową opcję wyboru.
createChoice(value, navigationItem)ChoiceTworzy nową opcję z opcją nawigacji, która przechodzi do konkretnego elementu podziału strony.
createChoice(value, navigationType)ChoiceTworzy nową opcję z opcją nawigacji po stronie.
createResponse(response)ItemResponseTworzy nowy element ItemResponse dla tej pozycji na liście.
duplicate()ListItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getChoices()Choice[]Pobiera wszystkie opcje dotyczące elementu.
getFeedbackForCorrect()QuizFeedbackZwraca komentarz wyświetlany użytkownikom, którzy odpowiedzą prawidłowo na pytanie.
getFeedbackForIncorrect()QuizFeedbackZwraca informacje zwrotne, które są wyświetlane użytkownikom, którzy odpowiedzieli nieprawidłowo na pytanie.
getHelpText()StringPobiera tekst pomocy dotyczący 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 spośród wszystkich elementów formularza.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setChoiceValues(values)ListItemUstawia opcje elementu z tablicy ciągów tekstowych.
setChoices(choices)ListItemUstawia tablicę opcji dla elementu.
setFeedbackForCorrect(feedback)ListItemOkreśla informacje, które będą wyświetlane respondentom, gdy odpowiedzą na pytanie poprawnie.
setFeedbackForIncorrect(feedback)ListItemOkreśla komentarz, który będzie wyświetlany użytkownikom, którzy odpowiedzą nieprawidłowo na pytanie.
setHelpText(text)ListItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)ListItemOkreśla liczbę punktów za element, który można ocenić.
setRequired(enabled)ListItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)ListItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).

MultipleChoiceItem

Metody

MetodaZwracany typKrótki opis
createChoice(value)ChoiceTworzy nową opcję wyboru.
createChoice(value, isCorrect)ChoiceTworzy nową opcję wyboru.
createChoice(value, navigationItem)ChoiceTworzy nową opcję z opcją nawigacji, która przechodzi do konkretnego elementu podziału strony.
createChoice(value, navigationType)ChoiceTworzy nową opcję z opcją nawigacji po stronie.
createResponse(response)ItemResponseTworzy nowy element ItemResponse dla tego produktu wielokrotnego wyboru.
duplicate()MultipleChoiceItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getChoices()Choice[]Pobiera wszystkie opcje dotyczące elementu.
getFeedbackForCorrect()QuizFeedbackZwraca komentarz wyświetlany użytkownikom, którzy odpowiedzą prawidłowo na pytanie.
getFeedbackForIncorrect()QuizFeedbackZwraca informacje zwrotne, które są wyświetlane użytkownikom, którzy odpowiedzieli nieprawidłowo na pytanie.
getHelpText()StringPobiera tekst pomocy dotyczący 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 spośród wszystkich elementów formularza.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
hasOtherOption()BooleanOkreśla, czy dla elementu jest dostępna opcja „inne”.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setChoiceValues(values)MultipleChoiceItemUstawia opcje elementu z tablicy ciągów tekstowych.
setChoices(choices)MultipleChoiceItemUstawia tablicę opcji dla elementu.
setFeedbackForCorrect(feedback)MultipleChoiceItemOkreśla informacje, które będą wyświetlane respondentom, gdy odpowiedzą na pytanie poprawnie.
setFeedbackForIncorrect(feedback)MultipleChoiceItemOkreśla komentarz, który będzie wyświetlany użytkownikom, którzy odpowiedzą nieprawidłowo na pytanie.
setHelpText(text)MultipleChoiceItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)MultipleChoiceItemOkreśla liczbę punktów za element, który można ocenić.
setRequired(enabled)MultipleChoiceItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)MultipleChoiceItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
showOtherOption(enabled)MultipleChoiceItemOkreśla, czy dla elementu jest dostępna opcja „inne”.

PageBreakItem

Metody

MetodaZwracany typKrótki opis
duplicate()PageBreakItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGoToPage()PageBreakItemPobiera element PageBreakItem, do którego przejdzie formularz po wypełnieniu strony przed tym podziałem strony (czyli po dotarciu do tej przerwy na stronie w ramach zwykłego, liniowego przejścia przez formularz).
getHelpText()StringPobiera tekst pomocy dotyczący 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 spośród wszystkich elementów formularza.
getPageNavigationType()PageNavigationTypePobiera typ nawigacji na stronie, która następuje po ukończeniu strony przed tym podziałem strony (czyli po dotarciu do tej przerwy na stronie przez normalny liniowy przebieg formularza).
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
setGoToPage(goToPageItem)PageBreakItemUstawia stronę, która ma przechodzić po zakończeniu danego podziału strony przed tym podziałem (czyli po dotarciu do danej strony w ramach zwykłego, liniowego postępu w formularzu).
setGoToPage(navigationType)PageBreakItemUstawia typ nawigacji na stronie, która następuje po ukończeniu strony przed tym podziałem strony (czyli po dotarciu do danej przerwy na stronę według zwykłego, liniowego przejścia przez formularz).
setHelpText(text)PageBreakItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setTitle(title)PageBreakItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).

Właściwości

WłaściwośćTypOpis
CONTINUEEnumPo wypełnieniu bieżącej strony przejdź do następnej strony formularza.
GO_TO_PAGEEnumPo wypełnieniu bieżącej strony przejdź na określoną stronę formularza.
RESTARTEnumPo ukończeniu bieżącej strony uruchom formularz ponownie 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 weryfikację danych związanych z tym elementem tekstu 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()QuizFeedbackZwraca informacje wyświetlane użytkownikom, gdy odpowiadają na pytanie, które można ocenić.
getHelpText()StringPobiera tekst pomocy dotyczący 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 spośród wszystkich elementów formularza.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)ParagraphTextItemOkreśla informacje, które będą wyświetlane respondentom, gdy odpowiadają na pytanie, które można ocenić, ale na które nie ma prawidłowej lub niepoprawnej odpowiedzi (np. na pytanie, które wymaga oceny ręcznej).
setHelpText(text)ParagraphTextItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)ParagraphTextItemOkreśla liczbę punktów za element, który można ocenić.
setRequired(enabled)ParagraphTextItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)ParagraphTextItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest 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 odpowiedzi na wzorzec.
requireTextDoesNotContainPattern(pattern)ParagraphTextValidationBuilderWymaga odpowiedzi na brak wzorca.
requireTextDoesNotMatchPattern(pattern)ParagraphTextValidationBuilderWymaga odpowiedzi na brak dopasowania do wzorca.
requireTextLengthGreaterThanOrEqualTo(number)ParagraphTextValidationBuilderWymagana jest długość odpowiedzi nie mniejsza niż wartość.
requireTextLengthLessThanOrEqualTo(number)ParagraphTextValidationBuilderWymagana jest długość odpowiedzi krótsza od wartości.
requireTextMatchesPattern(pattern)ParagraphTextValidationBuilderWymaga odpowiedzi w celu dopasowania do wzorca.

QuizFeedback

Metody

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

QuizFeedbackBuilder

Metody

MetodaZwracany typKrótki opis
addLink(url)QuizFeedbackBuilderDodaje link do dodatkowych materiałów z opinią.
addLink(url, displayText)QuizFeedbackBuilderDodaje link do dodatkowych materiałów z opinią.
build()QuizFeedbackGeneruje opinię odpowiedniego typu dla tego konstruktora.
copy()QuizFeedbackBuilderZwraca kopię tego konstruktora.
setText(text)QuizFeedbackBuilderUstawia tekst opinii.

ScaleItem

Metody

MetodaZwracany typKrótki opis
createResponse(response)ItemResponseTworzy nowy element (ItemResponse) dla tego elementu wagi.
duplicate()ScaleItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedbackZwraca informacje wyświetlane użytkownikom, gdy odpowiadają na pytanie, które można ocenić.
getHelpText()StringPobiera tekst pomocy dotyczący 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 spośród wszystkich elementów formularza.
getLeftLabel()StringPobiera etykietę dolnej granicy skali (jeśli istnieje).
getLowerBound()IntegerPobiera dolną granicę wagi.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getRightLabel()StringPobiera etykietę górnej granicy skali (jeśli istnieje).
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
getUpperBound()IntegerPobiera górną granicę wagi.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setBounds(lower, upper)ScaleItemOkreśla dolną i górną granicę skali.
setGeneralFeedback(feedback)ScaleItemOkreśla informacje, które będą wyświetlane respondentom, gdy odpowiadają na pytanie, które można ocenić, ale na które nie ma prawidłowej lub niepoprawnej odpowiedzi (np. na pytanie, które wymaga oceny ręcznej).
setHelpText(text)ScaleItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setLabels(lower, upper)ScaleItemUstawia etykiety dolnej i górnej granicy skali.
setPoints(points)ScaleItemOkreśla liczbę punktów za element, który można ocenić.
setRequired(enabled)ScaleItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)ScaleItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest 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 dotyczący 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 spośród wszystkich elementów formularza.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
setHelpText(text)SectionHeaderItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setTitle(title)SectionHeaderItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).

TextItem

Metody

MetodaZwracany typKrótki opis
clearValidation()TextItemUsuwa wszystkie mechanizmy sprawdzania poprawności danych związane z tym elementem tekstowym.
createResponse(response)ItemResponseTworzy nowy element ItemResponse dla tego elementu tekstowego.
duplicate()TextItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedbackZwraca informacje wyświetlane użytkownikom, gdy odpowiadają na pytanie, które można ocenić.
getHelpText()StringPobiera tekst pomocy dotyczący 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 spośród wszystkich elementów formularza.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)TextItemOkreśla informacje, które będą wyświetlane respondentom, gdy odpowiadają na pytanie, które można ocenić, ale na które nie ma prawidłowej lub niepoprawnej odpowiedzi (np. na pytanie, które wymaga oceny ręcznej).
setHelpText(text)TextItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)TextItemOkreśla liczbę punktów za element, który można ocenić.
setRequired(enabled)TextItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)TextItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
setValidation(validation)TextItemUstawia sprawdzanie poprawności danych dla tego elementu tekstowego.

TextValidation

TextValidationBuilder

Metody

MetodaZwracany typKrótki opis
requireNumber()TextValidationBuilderElementem tekstowym musi być liczba.
requireNumberBetween(start, end)TextValidationBuilderWymaga, aby element tekstowy był liczbą między początkiem a końcem włącznie.
requireNumberEqualTo(number)TextValidationBuilderWymaga, aby element tekstowy był liczbą równą podanej wartości.
requireNumberGreaterThan(number)TextValidationBuilderWymaga podania w elemencie tekstowym liczby większej niż określona wartość.
requireNumberGreaterThanOrEqualTo(number)TextValidationBuilderWymagana jest w elemencie tekstowym liczba większa od podanej wartości lub jej równa.
requireNumberLessThan(number)TextValidationBuilderWymagana jest w elemencie tekstowym liczba mniejsza od podanej wartości.
requireNumberLessThanOrEqualTo(number)TextValidationBuilderWymagana jest w elemencie tekstowym liczba mniejsza od podanej wartości lub jej równa.
requireNumberNotBetween(start, end)TextValidationBuilderElement tekstowy musi być liczbą spoza zakresu czasowego włącznie.
requireNumberNotEqualTo(number)TextValidationBuilderWymaga, aby element tekstowy był liczbą inną niż podana wartość.
requireTextContainsPattern(pattern)TextValidationBuilderWymaga odpowiedzi na wzorzec.
requireTextDoesNotContainPattern(pattern)TextValidationBuilderWymaga odpowiedzi na brak wzorca.
requireTextDoesNotMatchPattern(pattern)TextValidationBuilderWymaga odpowiedzi na brak dopasowania do wzorca.
requireTextIsEmail()TextValidationBuilderElementem tekstowym musi być adres e-mail.
requireTextIsUrl()TextValidationBuilderWymaga, aby element tekstowy był adresem URL.
requireTextLengthGreaterThanOrEqualTo(number)TextValidationBuilderWymagana jest długość odpowiedzi nie mniejsza niż wartość.
requireTextLengthLessThanOrEqualTo(number)TextValidationBuilderWymagana jest długość odpowiedzi krótsza od wartości.
requireTextMatchesPattern(pattern)TextValidationBuilderWymaga odpowiedzi w celu dopasowania do wzorca.
requireWholeNumber()TextValidationBuilderWymagana jest liczba całkowita.

TimeItem

Metody

MetodaZwracany typKrótki opis
createResponse(hour, minute)ItemResponseTworzy nowy element ItemResponse dla tego elementu czasu.
duplicate()TimeItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedbackZwraca informacje wyświetlane użytkownikom, gdy odpowiadają na pytanie, które można ocenić.
getHelpText()StringPobiera tekst pomocy dotyczący 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 spośród wszystkich elementów formularza.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)TimeItemOkreśla informacje, które będą wyświetlane respondentom, gdy odpowiadają na pytanie, które można ocenić, ale na które nie ma prawidłowej lub niepoprawnej odpowiedzi (np. na pytanie, które wymaga oceny ręcznej).
setHelpText(text)TimeItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)TimeItemOkreśla liczbę punktów za element, który można ocenić.
setRequired(enabled)TimeItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)TimeItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest 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()AlignmentWyrównuje film w poziomie.
getHelpText()StringPobiera tekst pomocy dotyczący 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 spośród wszystkich elementów formularza.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
getWidth()IntegerPobiera szerokość filmu w pikselach.
setAlignment(alignment)VideoItemWyrównuje film w poziomie.
setHelpText(text)VideoItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setTitle(title)VideoItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
setVideoUrl(youtubeUrl)VideoItemUstawia film na podstawie podanego adresu URL lub identyfikatora filmu w YouTube.
setWidth(width)VideoItemUstawia szerokość filmu w pikselach.