Un elemento domanda che consente al partecipante di indicare un periodo di tempo. È possibile accedere agli elementi o
crearli da un Form. Quando vengono utilizzati in un quiz, questi elementi vengono valutati.
// Open a form by ID and add a new duration item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addDurationItem();
item.setTitle('How long can you hold your breath?');
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
createResponse(hours, minutes, seconds) | ItemResponse | Crea un nuovo ItemResponse per questo elemento di data. |
duplicate() | DurationItem | 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 della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems). |
getId() | Integer | Consente di acquisire 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 | Consente di acquisire il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem). |
getType() | ItemType | Restituisce il tipo di elemento, rappresentato come ItemType. |
isRequired() | Boolean | Stabilisce se l'intervistato deve rispondere alla domanda. |
setGeneralFeedback(feedback) | DurationItem | 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 la valutazione manuale). |
setHelpText(text) | DurationItem | Imposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems). |
setPoints(points) | DurationItem | Imposta il numero di punti per il valore di un elemento valutabile. |
setRequired(enabled) | DurationItem | Consente di stabilire se l'intervistato deve rispondere alla domanda. |
setTitle(title) | DurationItem | Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem). |
Documentazione dettagliata
createResponse(hours, minutes, seconds)
Crea un nuovo ItemResponse per questo elemento di data. Gli argomenti hours, minutes e seconds sono rappresentati al meglio come numeri interi da 0 a 72 per
hours e da 0 a 59 per minutes e seconds. I valori che superano questi limiti vengono bloccati: ad esempio, 24, 60, 90 viene interpretato come 24:59:59.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
hours | Integer | le ore, rappresentate come un numero intero da 0 a 72 |
minutes | Integer | i minuti, rappresentati come un numero intero da 0 a 59 |
seconds | Integer | i secondi, rappresentati come un numero intero da 0 a 59 |
Ritorni
ItemResponse: la risposta 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
duplicate()
Crea una copia di questo elemento e la aggiunge alla fine del modulo.
Ritorni
DurationItem: duplicato di questo DurationItem, 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 che viene mostrato agli intervistati quando rispondono a una domanda valutabile.
Ritorni
QuizFeedback: feedback, se disponibile.
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 descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
Ritorni
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()
Consente di acquisire l'identificatore univoco dell'elemento.
Ritorni
Integer: 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 nel modulo.
Ritorni
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.
Ritorni
Integer: il numero di punti di 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()
Consente di acquisire il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem).
Ritorni
String: testo dell'intestazione o del titolo 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.
Ritorni
ItemType: 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()
Stabilisce se l'intervistato deve rispondere alla domanda.
Ritorni
Boolean: indica se la persona intervistata 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 la valutazione manuale).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
feedback | QuizFeedback | il nuovo feedback |
Ritorni
DurationItem: questo DurationItem, 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 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 |
Ritorni
DurationItem: questo DurationItem, 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 per il valore di un elemento valutabile. Il valore predefinito per i nuovi elementi è 0.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
points | Integer | il numero di punti di un elemento di domanda |
Ritorni
DurationItem: questo DurationItem, 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)
Consente di stabilire se l'intervistato deve rispondere alla domanda.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
enabled | Boolean | se l'intervistato deve rispondere alla domanda |
Ritorni
DurationItem: 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 SectionHeaderItem).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
title | String | il nuovo testo dell'intestazione o del titolo |
Ritorni
DurationItem: questo DurationItem, 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