Element pytania, który umożliwia respondentowi wpisanie bloku tekstu. Elementy można tworzyć i do nich uzyskiwać dostęp z poziomu Form
. Gdy są używane w teście, są oceniane.
// Open a form by ID and add a new paragraph text item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addParagraphTextItem(); item.setTitle('What is your address?');
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
clear | Paragraph | Usuwa wszelkie reguły sprawdzania poprawności dotyczące tego elementu tekstu akapitu. |
create | Item | Tworzy nowy element Item dla tego elementu tekstu akapitu. |
duplicate() | Paragraph | Tworzy kopię tego elementu i dodaje ją na końcu formularza. |
get | Quiz | Zwraca opinię, która jest wyświetlana respondentom, gdy odpowiadają na pytanie oceniane. |
get | String | Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak Image , Page i Section ). |
get | Integer | Pobiera unikalny identyfikator produktu. |
get | Integer | Pobiera indeks elementu spośród wszystkich elementów w formularzu. |
get | Integer | Zwraca liczbę punktów za element, który można ocenić. |
get | String | Pobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku Section ). |
get | Item | Pobiera typ elementu jako Item . |
is | Boolean | Określa, czy respondent musi odpowiedzieć na pytanie. |
set | Paragraph | Określa informacje zwrotne, które mają być wyświetlane respondentom, gdy odpowiadają na oceniane pytanie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (czyli pytania, które wymagają ręcznego oceniania). |
set | Paragraph | Ustawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak Image , Page i Section ). |
set | Paragraph | Określa liczbę punktów, które można przyznać ocenianemu elementowi. |
set | Paragraph | Określa, czy respondent musi odpowiedzieć na pytanie. |
set | Paragraph | Ustawia tytuł elementu (czasami nazywany tekstem nagłówka w przypadku Section ). |
set | Paragraph | Ustawia sprawdzanie poprawności danych dla tego elementu tekstu akapitu. |
Szczegółowa dokumentacja
clearValidation()
Usuwa wszelkie reguły sprawdzania poprawności dotyczące tego elementu tekstu akapitu.
Powrót
Paragraph
– ta Paragraph
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają 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 nowy element Item
dla tego elementu tekstu akapitu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
response | String | odpowiedź na pytanie zawarte w elemencie; |
Powrót
Item
– odpowiedź na element
Autoryzacja
Skrypty, które korzystają 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 dodaje ją na końcu formularza.
Powrót
Paragraph
– duplikat tego elementu Paragraph
, służący do łańcuchowania.
Autoryzacja
Skrypty, które korzystają 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 opinię, która jest wyświetlana respondentom, gdy odpowiadają na pytanie oceniane.
Powrót
Quiz
– opinia (jeśli została przesłana).
Autoryzacja
Skrypty, które korzystają 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 elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak Image
, Page
i Section
).
Powrót
String
– tekst pomocy lub tekst opisu produktu,
Autoryzacja
Skrypty, które korzystają 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 produktu.
Powrót
Integer
– identyfikator produktu
Autoryzacja
Skrypty, które korzystają 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, które korzystają 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 liczbę punktów za element, który można ocenić.
Powrót
Integer
– liczba punktów, jaką można uzyskać za pytanie.
Autoryzacja
Skrypty, które korzystają 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 (czasami nazywany tekstem nagłówka w przypadku Section
).
Powrót
String
– tytuł lub tekst nagłówka
Autoryzacja
Skrypty, które korzystają 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()
isRequired()
Określa, czy respondent musi odpowiedzieć na pytanie.
Powrót
Boolean
– czy respondent musi odpowiedzieć na pytanie
Autoryzacja
Skrypty, które korzystają 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)
Określa informacje zwrotne, które mają być wyświetlane respondentom, gdy odpowiadają na oceniane pytanie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (czyli pytania, które wymagają ręcznego oceniania).
Parametry
Nazwa | Typ | Opis |
---|---|---|
feedback | Quiz | nowe opinie |
Powrót
Paragraph
– ta Paragraph
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają 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 (czasami nazywany tekstem opisu dla elementów układu, takich jak Image
, Page
i Section
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | nowy tekst pomocy. |
Powrót
Paragraph
– ta Paragraph
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają 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, które można przyznać ocenianemu elementowi. Wartość domyślna dla nowych elementów to 0.
Parametry
Nazwa | Typ | Opis |
---|---|---|
points | Integer | liczba punktów za pytanie |
Powrót
Paragraph
– ta Paragraph
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają 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 respondent musi odpowiedzieć na pytanie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | czy respondent musi udzielić odpowiedzi na pytanie. |
Powrót
Paragraph
– bieżący element (do łańcuchowania).
Autoryzacja
Skrypty, które korzystają 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)
Ustawia tytuł elementu (czasami nazywany tekstem nagłówka w przypadku Section
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | nowy tytuł lub tekst nagłówka. |
Powrót
Paragraph
– ta Paragraph
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają 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 tekstu akapitu. Przekazanie wartości null lub walidacji bez wywołania funkcji wymagających spowoduje usunięcie wcześniejszej walidacji.
Parametry
Nazwa | Typ | Opis |
---|---|---|
validation | Paragraph | a ParagraphTextValidation, który ma zastosowanie do tego elementu. |
Powrót
Paragraph
– ta Paragraph
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają 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