Una domanda che consente al partecipante di inserire un blocco di testo. Gli elementi a cui è possibile accedere o
creato da un Form
. Quando vengono utilizzati in un quiz, questi elementi vengono valutati.
// Open a form by ID and add a new paragraph text item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addParagraphTextItem(); item.setTitle('What is your address?');
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
clearValidation() | ParagraphTextItem | Rimuove qualsiasi convalida dei dati per questo elemento di testo del paragrafo. |
createResponse(response) | ItemResponse | Crea un nuovo ItemResponse per questo elemento di testo del paragrafo. |
duplicate() | ParagraphTextItem | Crea una copia di questo elemento e la aggiunge alla fine del modulo. |
getGeneralFeedback() | QuizFeedback | Restituisce il feedback che viene mostrato agli intervistati quando rispondono a una domanda valutabile. |
getHelpText() | String | Recupera il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems , PageBreakItems e SectionHeaderItems ). |
getId() | Integer | Restituisce l'identificatore univoco dell'elemento. |
getIndex() | Integer | Restituisce l'indice dell'elemento tra tutti gli elementi nel modulo. |
getPoints() | Integer | Restituisce il valore in punti di un elemento valutabile. |
getTitle() | String | Restituisce il titolo dell'elemento (a volte denominato testo dell'intestazione, nel caso di un SectionHeaderItem ). |
getType() | ItemType | Restituisce il tipo di elemento, rappresentato come ItemType . |
isRequired() | Boolean | Determina se l'intervistato deve rispondere alla domanda. |
setGeneralFeedback(feedback) | ParagraphTextItem | Imposta il feedback da mostrare agli intervistati quando rispondono a una domanda valutabile che Non ha una risposta corretta o errata (ovvero domande che richiedono una valutazione manuale). |
setHelpText(text) | ParagraphTextItem | Imposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems , PageBreakItems e SectionHeaderItems ). |
setPoints(points) | ParagraphTextItem | Consente di impostare il numero di punti che un elemento valutabile merita. |
setRequired(enabled) | ParagraphTextItem | Consente di impostare se l'intervistato deve rispondere alla domanda. |
setTitle(title) | ParagraphTextItem | Imposta il titolo dell'elemento (a volte denominato testo dell'intestazione, nel caso di un SectionHeaderItem ). |
setValidation(validation) | ParagraphTextItem | 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.
Invio
ParagraphTextItem
: ParagraphTextItem
, per 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 |
Invio
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.
Invio
ParagraphTextItem
: un duplicato di questa ParagraphTextItem
, per il collegamento
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 che viene mostrato agli intervistati quando rispondono a una domanda valutabile.
Invio
QuizFeedback
: 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 di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems
, PageBreakItems
e SectionHeaderItems
).
Invio
String
: testo della guida o testo descrittivo 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()
Restituisce l'identificatore univoco dell'elemento.
Invio
Integer
: l'ID 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
getIndex()
Restituisce l'indice dell'elemento tra tutti gli elementi nel modulo.
Invio
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.
Invio
Integer
: il numero di punti che valgono per 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()
Restituisce il titolo dell'elemento (a volte denominato testo dell'intestazione, nel caso di un SectionHeaderItem
).
Invio
String
: testo del titolo o 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()
Restituisce il tipo di elemento, rappresentato come ItemType
.
Invio
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 l'intervistato deve rispondere alla domanda.
Invio
Boolean
: se l'intervistato 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 agli intervistati quando rispondono a una domanda valutabile che Non ha una risposta corretta o errata (ovvero domande che richiedono una valutazione manuale).
Parametri
Nome | Tipo | Descrizione |
---|---|---|
feedback | QuizFeedback | il nuovo feedback |
Invio
ParagraphTextItem
: ParagraphTextItem
, per 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 della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems
, PageBreakItems
e SectionHeaderItems
).
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | il nuovo testo della guida |
Invio
ParagraphTextItem
: ParagraphTextItem
, per 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)
Consente di impostare il numero di punti che un elemento valutabile merita. Il valore predefinito per i nuovi elementi è 0.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
points | Integer | il numero di punti su cui vale una domanda |
Invio
ParagraphTextItem
: ParagraphTextItem
, per 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)
Consente di impostare se l'intervistato deve rispondere alla domanda.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
enabled | Boolean | se l'intervistato deve rispondere alla domanda |
Invio
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 denominato testo dell'intestazione, nel caso di un SectionHeaderItem
).
Parametri
Nome | Tipo | Descrizione |
---|---|---|
title | String | Il nuovo titolo o il nuovo testo dell'intestazione |
Invio
ParagraphTextItem
: ParagraphTextItem
, per 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 un valore nullo o una convalida senza qualsiasi funzione di richiesta chiamata rimuoverà qualsiasi convalida precedente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
validation | ParagraphTextValidation | a ParagraphTextValidation da applicare a questo elemento. |
Invio
ParagraphTextItem
: ParagraphTextItem
, per 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