Class TextItem

TextItem

Element pytania, który pozwala respondentowi na wpisanie jednego wiersza tekstu. Elementy są dostępne lub utworzone na podstawie: Form. Zastosowane w quizie elementy są oceniane.

// Open a form by ID and add a new text item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addTextItem();
item.setTitle('What is your name?');

Metody

Metoda	Zwracany typ	Krótki opis
clearValidation()	TextItem	Usuwa sprawdzanie poprawności danych w przypadku tego elementu tekstowego.
createResponse(response)	ItemResponse	Tworzy nową wartość ItemResponse dla tego elementu tekstowego.
duplicate()	TextItem	Tworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()	QuizFeedback	Zwraca informację zwrotną, która jest wyświetlana respondentom podczas odpowiadania na pytanie, które można ocenić.
getHelpText()	String	Pobiera tekst pomocy dotyczący elementu (nazywany czasem opisem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()	Integer	Pobiera unikalny identyfikator elementu.
getIndex()	Integer	Pobiera indeks elementu spośród wszystkich elementów w formularzu.
getPoints()	Integer	Zwraca wartość punktową elementu podlegającego ocenie.
getTitle()	String	Pobiera tytuł elementu (w przypadku SectionHeaderItem nazywany tekstem nagłówka).
getType()	ItemType	Pobiera typ elementu reprezentowany przez ItemType.
isRequired()	Boolean	Określa, czy użytkownik musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)	TextItem	Ustawia informację, że odpowiedzi będą wyświetlane respondentom, gdy odpowiedzą na pytanie podlegające ocenie, które nie ma poprawnej lub nieprawidłowej odpowiedzi (np. pytania, które wymagają ręcznego oceniania).
setHelpText(text)	TextItem	Ustawia tekst pomocy elementu (nazywany czasem opisu tekstem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)	TextItem	Określa liczbę punktów wartą oceniany element.
setRequired(enabled)	TextItem	Określa, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)	TextItem	Określa tytuł elementu (w przypadku SectionHeaderItem nazywany też tekstem nagłówka).
setValidation(validation)	TextItem	Ustawia sprawdzanie poprawności danych dla tego elementu tekstowego.

Szczegółowa dokumentacja

clearValidation()

Usuwa sprawdzanie poprawności danych w przypadku tego elementu tekstowego.

Powrót

TextItem – TextItem, łańcuch

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

createResponse(response)

Tworzy nową wartość ItemResponse dla tego elementu tekstowego.

Parametry

Nazwa	Typ	Opis
response	String	odpowiedź na pytanie zadane przez produkt,

Powrót

ItemResponse – odpowiedź dotycząca produktu,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

duplicate()

Tworzy kopię tego elementu i dołącza ją na końcu formularza.

Powrót

TextItem – duplikat kodu TextItem, na potrzeby tworzenia łańcuchów;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getGeneralFeedback()

Zwraca informację zwrotną, która jest wyświetlana respondentom podczas odpowiadania na pytanie, które można ocenić.

Powrót

QuizFeedback – ewentualne opinie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getHelpText()

Pobiera tekst pomocy dotyczący elementu (nazywany czasem opisem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Powrót

String – tekst pomocy dotyczący produktu lub opis.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getId()

Pobiera unikalny identyfikator elementu.

Powrót

Integer – identyfikator produktu,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getIndex()

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

Powrót

Integer – indeks elementu,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getPoints()

Zwraca wartość punktową elementu podlegającego ocenie.

Powrót

Integer – liczba punktów warte dane pytanie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getTitle()

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

Powrót

String – tytuł lub tekst nagłówka elementu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getType()

Pobiera typ elementu reprezentowany przez ItemType.

Powrót

ItemType – typ elementu,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

isRequired()

Określa, czy użytkownik musi odpowiedzieć na pytanie.

Powrót

Boolean – czy użytkownik musi odpowiedzieć na pytanie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

setGeneralFeedback(feedback)

Ustawia informację, że odpowiedzi będą wyświetlane respondentom, gdy odpowiedzą na pytanie podlegające ocenie, które nie ma poprawnej lub nieprawidłowej odpowiedzi (np. pytania, które wymagają ręcznego oceniania).

Parametry

Nazwa	Typ	Opis
feedback	QuizFeedback	nowa opinia

Powrót

TextItem – TextItem, łańcuch

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

setHelpText(text)

Ustawia tekst pomocy elementu (nazywany czasem opisu tekstem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Parametry

Nazwa	Typ	Opis
text	String	nowy tekst pomocy

Powrót

TextItem – TextItem, łańcuch

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

setPoints(points)

Określa liczbę punktów wartą oceniany element. Wartość domyślna nowych elementów to 0.

Parametry

Nazwa	Typ	Opis
points	Integer	liczba punktów warta przedmiot pytania

Powrót

TextItem – TextItem, łańcuch

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

setRequired(enabled)

Określa, czy użytkownik musi odpowiedzieć na pytanie.

Parametry

Nazwa	Typ	Opis
enabled	Boolean	czy respondent musi odpowiedzieć na pytanie,

Powrót

TextItem – bieżący element (do tworzenia łańcuchów),

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

setTitle(title)

Określa tytuł elementu (w przypadku SectionHeaderItem nazywany też tekstem nagłówka).

Parametry

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

Powrót

TextItem – TextItem, łańcuch

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

setValidation(validation)

Ustawia sprawdzanie poprawności danych dla tego elementu tekstowego. Wartość null lub weryfikacja bez wartości wymaga wywołania funkcji, co spowoduje usunięcie wcześniejszej weryfikacji.

Parametry

Nazwa	Typ	Opis
validation	TextValidation	wartość TextValidation, która ma zostać zastosowana do tego elementu.

Powrót

TextItem – TextItem, łańcuch

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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