Class TextItem

Element tekstowy

Element pytania, który pozwala użytkownikowi wpisać jeden wiersz tekstu. Elementy można otworzyć lub utworzyć w Form. Elementy używane w teście 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

MetodaZwracany typKrótki opis
clearValidation()TextItemUsuwa wszystkie znaczniki tego elementu tekstowego.
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 opinię wyświetlaną użytkownikom, gdy odpowiadają na pytanie z możliwością oceny.
getHelpText()StringPobiera tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu do wszystkich elementów w formularzu.
getPoints()IntegerZwraca wartość punktową elementu możliwego do oceny.
getTitle()StringPobiera tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem).
getType()ItemTypePobiera typ elementu reprezentowany jako ItemType.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)TextItemUmożliwia wyświetlanie odpowiedzi, które mają być wyświetlane ankietowanym, gdy nie mają prawidłowej lub nieprawidłowej odpowiedzi (np. pytań wymagających ręcznego oceniania).
setHelpText(text)TextItemUstawia tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)TextItemOkreśla liczbę punktów, które może mieć wartość z możliwością oceny.
setRequired(enabled)TextItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)TextItemUstawia tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem).
setValidation(validation)TextItemUstawia weryfikację danych tego elementu tekstowego.

Szczegółowa dokumentacja

clearValidation()

Usuwa wszystkie znaczniki tego elementu tekstowego.

Zwróć

TextItem – ten TextItem do łańcucha

Autoryzacja

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

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

createResponse(response)

Tworzy nowy element: ItemResponse dla tego elementu tekstowego.

Parametry

NazwaTypOpis
responseStringodpowiedź na pytanie zadane przez element

Zwróć

ItemResponse – odpowiedź elementu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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.

Zwróć

TextItem – duplikat pytania „TextItem” dotyczący łańcucha

Autoryzacja

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

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

getGeneralFeedback()

Zwraca opinię wyświetlaną użytkownikom, gdy odpowiadają na pytanie z możliwością oceny.

Zwróć

QuizFeedback – opinia (jeśli istnieje).

Autoryzacja

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

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

getHelpText()

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

Zwróć

String – tekst pomocy lub opis elementu;

Autoryzacja

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

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

getId()

Pobiera unikalny identyfikator elementu.

Zwróć

Integer – identyfikator elementu;

Autoryzacja

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

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

getIndex()

Pobiera indeks elementu do wszystkich elementów w formularzu.

Zwróć

Integer – indeks elementu

Autoryzacja

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

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

getPoints()

Zwraca wartość punktową elementu możliwego do oceny.

Zwróć

Integer – liczba punktów przyznawanych za pytanie.

Autoryzacja

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

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

getTitle()

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

Zwróć

String – tytuł lub tekst nagłówka;

Autoryzacja

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

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

getType()

Pobiera typ elementu reprezentowany jako ItemType.

Zwróć

ItemType – typ produktu

Autoryzacja

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

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

isRequired()

Określa, czy respondent musi odpowiedzieć na pytanie.

Zwróć

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

Autoryzacja

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

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

setGeneralFeedback(feedback)

Umożliwia wyświetlanie odpowiedzi, które mają być wyświetlane ankietowanym, gdy nie mają prawidłowej lub nieprawidłowej odpowiedzi (np. pytań wymagających ręcznego oceniania).

Parametry

NazwaTypOpis
feedbackQuizFeedbacknowa opinia

Zwróć

TextItem – ten TextItem do łańcucha

Autoryzacja

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

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

setHelpText(text)

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

Parametry

NazwaTypOpis
textStringnowy tekst pomocy

Zwróć

TextItem – ten TextItem do łańcucha

Autoryzacja

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

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

setPoints(points)

Określa liczbę punktów, które może mieć wartość z możliwością oceny. Domyślnie nowe elementy mają wartość 0.

Parametry

NazwaTypOpis
pointsIntegerliczbę punktów przyznawanych za pytanie

Zwróć

TextItem – ten TextItem do łańcucha

Autoryzacja

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

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

setRequired(enabled)

Określa, czy respondent musi odpowiedzieć na pytanie.

Parametry

NazwaTypOpis
enabledBooleanczy użytkownik musi odpowiedzieć na pytanie;

Zwróć

TextItem – bieżący element (łańcuch)

Autoryzacja

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

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

setTitle(title)

Ustawia tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem).

Parametry

NazwaTypOpis
titleStringnowego tytułu lub tekstu nagłówka,

Zwróć

TextItem – ten TextItem do łańcucha

Autoryzacja

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

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

setValidation(validation)

Ustawia weryfikację danych tego elementu tekstowego. Przekazywanie wartości null lub weryfikacji, która nie wymaga żadnych funkcji, spowoduje usunięcie wcześniejszej weryfikacji.

Parametry

NazwaTypOpis
validationTextValidationdo sprawdzania poprawności, aby zastosować ją do tego elementu.

Zwróć

TextItem – ten TextItem do łańcucha

Autoryzacja

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

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