Consente a uno script di aprire un elemento Form
esistente o di crearne uno nuovo.
// Open a form by ID. var existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Create and open a form. var newForm = FormApp.create('Form Name');
Proprietà
Proprietà | Tipo | Descrizione |
---|---|---|
Alignment | Alignment | Un'enumerazione dei tipi di allineamento dell'immagine. |
DestinationType | DestinationType | Un'enumerazione dei tipi di destinazioni che possono archiviare le risposte dei moduli. |
FeedbackType | FeedbackType | Un'enumerazione dei tipi di modulo Feedbacks . |
ItemType | ItemType | Un'enumerazione dei tipi di modulo Items . |
PageNavigationType | PageNavigationType | Un'enumerazione dei possibili comportamenti per la navigazione nelle pagine. |
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
create(title) | Form | Crea e restituisce un nuovo Form . |
createCheckboxGridValidation() | CheckboxGridValidationBuilder | Restituisce un'istanza di un CheckboxGridValidationBuilder che può essere utilizzato per impostare la convalida su una
CheckboxGridItem . |
createCheckboxValidation() | CheckboxValidationBuilder | Restituisce un'istanza di un CheckboxValidationBuilder che può essere utilizzato per impostare la convalida su un
CheckboxItem . |
createFeedback() | QuizFeedbackBuilder | Restituisce un'istanza di QuizFeedbackBuilder che può essere utilizzata per impostare il feedback su un
Item . |
createGridValidation() | GridValidationBuilder | Restituisce un'istanza di un GridValidationBuilder che può essere utilizzato per impostare la convalida su un GridItem . |
createParagraphTextValidation() | ParagraphTextValidationBuilder | Restituisce un'istanza di un ParagraphTextValidationBuilder che può essere utilizzato per impostare la convalida su
ParagraphTextItem . |
createTextValidation() | TextValidationBuilder | Restituisce un'istanza di TextValidationBuilder che può essere utilizzata per impostare la convalida su TextItem . |
getActiveForm() | Form | Restituisce il modulo in cui lo script è container-bound. |
getUi() | Ui | Restituisce un'istanza dell'ambiente di interfaccia utente dell'editor di moduli che consente allo script di Aggiungere funzionalità come menu, finestre di dialogo e barre laterali. |
openById(id) | Form | Restituisce Form con l'ID specificato. |
openByUrl(url) | Form | Restituisce Form con l'URL specificato. |
Documentazione dettagliata
create(title)
Crea e restituisce un nuovo Form
. Genera un'eccezione se il titolo specificato è null
o vuoto.
// Create and open a form. var form = FormApp.create('Form Name');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
title | String | il nome del nuovo modulo |
Invio
Form
: il nuovo modulo
Lanci
Error
: se il titolo specificato è null
o vuoto
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms
createCheckboxGridValidation()
Restituisce un'istanza di un CheckboxGridValidationBuilder che può essere utilizzato per impostare la convalida su una
CheckboxGridItem
.
Invio
createCheckboxValidation()
Restituisce un'istanza di un CheckboxValidationBuilder che può essere utilizzato per impostare la convalida su un
CheckboxItem
.
Invio
createFeedback()
Restituisce un'istanza di QuizFeedbackBuilder che può essere utilizzata per impostare il feedback su un
Item
.
Invio
createGridValidation()
Restituisce un'istanza di un GridValidationBuilder che può essere utilizzato per impostare la convalida su un GridItem
.
Invio
createParagraphTextValidation()
Restituisce un'istanza di un ParagraphTextValidationBuilder che può essere utilizzato per impostare la convalida su
ParagraphTextItem
.
Invio
createTextValidation()
Restituisce un'istanza di TextValidationBuilder che può essere utilizzata per impostare la convalida su TextItem
.
Invio
getActiveForm()
Restituisce il modulo in cui lo script è container-bound. Per interagire con i moduli a cui
lo script non è legato a un container, utilizza openById(id)
o openByUrl(url)
.
// Get the form to which this script is bound. var form = FormApp.getActiveForm();
Invio
Form
: il modulo a cui è associato lo script o null
se lo script non è associato a uno script.
modulo
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
getUi()
Restituisce un'istanza dell'ambiente di interfaccia utente dell'editor di moduli che consente allo script di Aggiungere funzionalità come menu, finestre di dialogo e barre laterali. Uno script può interagire con l'interfaccia utente solo l'istanza corrente di un editor di moduli aperti (non la visualizzazione visualizzata per l'intervistato) e solo se lo script è legato al modulo. Per ulteriori informazioni informazioni, consulta le guide ai menu, alle finestre di dialogo e alle barre laterali.
// Add a custom menu to the active form, including a separator and a sub-menu. function onOpen(e) { FormApp.getUi() .createMenu('My Menu') .addItem('My menu item', 'myFunction') .addSeparator() .addSubMenu(FormApp.getUi().createMenu('My sub-menu') .addItem('One sub-menu item', 'mySecondFunction') .addItem('Another sub-menu item', 'myThirdFunction')) .addToUi(); }
Invio
Ui
: un'istanza dell'ambiente di interfaccia utente di questo modulo
openById(id)
Restituisce Form
con l'ID specificato. Genera un'eccezione se l'ID non è valido o se il valore
l'utente non dispone dell'autorizzazione per aprire il modulo.
// Open a form by ID. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
id | String | l'ID del modulo per aprire |
Invio
Form
: il modulo con l'ID specificato
Lanci
Error
: se l'ID fornito non è valido o se l'utente non dispone di elementi sufficienti
autorizzazioni
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms
openByUrl(url)
Restituisce Form
con l'URL specificato. Genera un'eccezione se l'URL non è valido o
l'utente non dispone dell'autorizzazione per aprire il modulo.
// Open a form by URL. var form = FormApp.openByUrl( 'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit' );
Parametri
Nome | Tipo | Descrizione |
---|---|---|
url | String | l'URL del modulo da aprire |
Invio
Form
: il modulo con l'URL specificato.
Lanci
Error
: se l'URL fornito non è valido o l'utente non dispone di elementi sufficienti
autorizzazioni
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms