Un elemento domanda che consente al rispondente di inserire un blocco di testo. È possibile accedere agli elementi o
crearli da un Form. Se utilizzati in un quiz, questi elementi vengono valutati.
// 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?');
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
clear | Paragraph | Rimuove qualsiasi convalida dei dati per questo elemento di testo del paragrafo. |
create | Item | Crea un nuovo Item per questo elemento di testo del paragrafo. |
duplicate() | Paragraph | Crea una copia di questo elemento e la aggiunge alla fine del modulo. |
get | Quiz | Restituisce il feedback mostrato ai rispondenti quando rispondono a una domanda valutabile. |
get | String | Recupera il testo della guida dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come Image, Page e Section). |
get | Integer | Recupera l'identificatore univoco dell'elemento. |
get | Integer | Restituisce l'indice dell'elemento tra tutti gli elementi del modulo. |
get | Integer | Restituisce il valore in punti di un elemento valutabile. |
get | String | Recupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un Section). |
get | Item | Recupera il tipo dell'elemento, rappresentato come Item. |
is | Boolean | Determina se chi risponde deve rispondere alla domanda. |
set | Paragraph | Imposta il feedback da mostrare ai rispondenti quando rispondono a una domanda valutabile che non ha una risposta corretta o errata (ad es. domande che richiedono una valutazione manuale). |
set | Paragraph | Imposta il testo di assistenza dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come Image, Page e Section). |
set | Paragraph | Imposta il numero di punti che vale un elemento valutabile. |
set | Paragraph | Determina se il rispondente deve rispondere alla domanda. |
set | Paragraph | Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un Section). |
set | Paragraph | Imposta la convalida dei dati per questo elemento di testo del paragrafo. |
Documentazione dettagliata
clearValidation()
Rimuove qualsiasi convalida dei dati per questo elemento di testo del paragrafo.
Indietro
ParagraphTextItem: questo ParagraphTextItem, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
createResponse(response)
Crea un nuovo ItemResponse per questo elemento di testo del paragrafo.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
response | String | una risposta alla domanda posta dall'elemento |
Indietro
ItemResponse: la risposta all'elemento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
duplicate()
Crea una copia di questo elemento e la aggiunge alla fine del modulo.
Indietro
ParagraphTextItem: un duplicato di questo ParagraphTextItem, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getGeneralFeedback()
Restituisce il feedback mostrato ai rispondenti quando rispondono a una domanda valutabile.
Indietro
QuizFeedback|null: il feedback, se presente.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getHelpText()
Recupera il testo della guida dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
Indietro
String: il testo della guida o la descrizione dell'elemento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getId()
Recupera l'identificatore univoco dell'elemento.
Indietro
Integer: l'ID dell'articolo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getIndex()
Restituisce l'indice dell'elemento tra tutti gli elementi del modulo.
Indietro
Integer: l'indice dell'elemento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getPoints()
Restituisce il valore in punti di un elemento valutabile.
Indietro
Integer: il numero di punti che vale una domanda.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getTitle()
Recupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
Indietro
String: il titolo o il testo dell'intestazione dell'elemento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getType()
Recupera il tipo dell'elemento, rappresentato come ItemType.
Indietro
ItemType: il tipo di elemento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
isRequired()
Determina se chi risponde deve rispondere alla domanda.
Indietro
Boolean: indica se chi risponde deve rispondere alla domanda
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
Imposta il feedback da mostrare ai rispondenti quando rispondono a una domanda valutabile che non ha una risposta corretta o errata (ad es. domande che richiedono una valutazione manuale).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
feedback | Quiz | il nuovo feedback |
Indietro
ParagraphTextItem: questo ParagraphTextItem, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setHelpText(text)
Imposta il testo di assistenza dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
text | String | il nuovo testo della guida |
Indietro
ParagraphTextItem: questo ParagraphTextItem, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setPoints(points)
Imposta il numero di punti che vale un elemento valutabile. Il valore predefinito per i nuovi elementi è 0.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
points | Integer | il numero di punti che vale una domanda |
Indietro
ParagraphTextItem: questo ParagraphTextItem, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setRequired(enabled)
Determina se il rispondente deve rispondere alla domanda.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
enabled | Boolean | se chi risponde deve rispondere alla domanda |
Indietro
ParagraphTextItem: l'elemento corrente (per il concatenamento)
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setTitle(title)
Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
title | String | il nuovo testo del titolo o dell'intestazione |
Indietro
ParagraphTextItem: questo ParagraphTextItem, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setValidation(validation)
Imposta la convalida dei dati per questo elemento di testo del paragrafo. Il passaggio di null o di un'istanza ParagraphTextValidation su cui non sono state chiamate funzioni di richiesta rimuove qualsiasi convalida precedente.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
validation | Paragraph | un ParagraphTextValidation da applicare a questo elemento. |
Indietro
ParagraphTextItem: questo ParagraphTextItem, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms