Questa pagina è stata tradotta dall'API Cloud Translation.

Class FormApp

Consente a uno script di aprire un Form esistente o crearne uno nuovo.

// Open a form by ID.
const existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Create and open a form.
const newForm = FormApp.create('Form Name');

Proprietà

Proprietà	Tipo	Descrizione
`Alignment`	`Alignment`	Un'enumerazione dei tipi di allineamento delle immagini.
`DestinationType`	`DestinationType`	Un'enumerazione dei tipi di destinazioni che possono memorizzare le risposte ai 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.
`RatingIconType`	`RatingIconType`	Un'enumerazione dei tipi di icone di valutazione `RatingIcons`

Metodi

Metodo	Tipo restituito	Breve descrizione
`create(title)`	`Form`	Crea e restituisce un nuovo `Form`.
`createCheckboxGridValidation()`	`CheckboxGridValidationBuilder`	Restituisce un'istanza di CheckboxGridValidationBuilder che può essere utilizzata per impostare la convalida su un `CheckboxGridItem`.
`createCheckboxValidation()`	`CheckboxValidationBuilder`	Restituisce un'istanza di CheckboxValidationBuilder che può essere utilizzata per impostare la convalida su un `CheckboxItem`.
`createFeedback()`	`QuizFeedbackBuilder`	Restituisce un'istanza di QuizFeedbackBuilder che può essere utilizzata per impostare il feedback su un compito con voto`Item`.
`createGridValidation()`	`GridValidationBuilder`	Restituisce un'istanza di GridValidationBuilder che può essere utilizzata per impostare la convalida su un `GridItem`.
`createParagraphTextValidation()`	`ParagraphTextValidationBuilder`	Restituisce un'istanza di ParagraphTextValidationBuilder che può essere utilizzata per impostare la convalida su un `ParagraphTextItem`.
`createTextValidation()`	`TextValidationBuilder`	Restituisce un'istanza di TextValidationBuilder che può essere utilizzata per impostare la convalida su un `TextItem`.
`getActiveForm()`	`Form`	Restituisce il modulo a cui lo script è legato al contenitore.
`getUi()`	`Ui`	Restituisce un'istanza dell'ambiente dell'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 il `Form` con l'ID specificato.
`openByUrl(url)`	`Form`	Restituisce il `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.
const 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 CheckboxGridValidationBuilder che può essere utilizzata per impostare la convalida su un CheckboxGridItem.

Invio

CheckboxGridValidationBuilder

`createCheckboxValidation()`

Restituisce un'istanza di CheckboxValidationBuilder che può essere utilizzata per impostare la convalida su un CheckboxItem.

Invio

CheckboxValidationBuilder

`createFeedback()`

Restituisce un'istanza di QuizFeedbackBuilder che può essere utilizzata per impostare il feedback su un compito con votoItem.

Invio

QuizFeedbackBuilder

`createGridValidation()`

Restituisce un'istanza di GridValidationBuilder che può essere utilizzata per impostare la convalida su un GridItem.

Invio

GridValidationBuilder

`createParagraphTextValidation()`

Restituisce un'istanza di ParagraphTextValidationBuilder che può essere utilizzata per impostare la convalida su un ParagraphTextItem.

Invio

ParagraphTextValidationBuilder

`createTextValidation()`

Restituisce un'istanza di TextValidationBuilder che può essere utilizzata per impostare la convalida su un TextItem.

Invio

TextValidationBuilder

`getActiveForm()`

Restituisce il modulo a cui lo script è legato al contenitore. Per interagire con i moduli a cui lo script non è associato al contenitore, utilizza openById(id) o openByUrl(url).

// Get the form to which this script is bound.
const form = FormApp.getActiveForm();

Invio

Form: il modulo a cui è associato lo script o null se lo script non è associato a un 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 dell'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 per l'istanza corrente di un editor di moduli aperto (non per la visualizzazione visualizzata da chi risponde) e solo se lo script è associato al modulo. Per ulteriori informazioni, consulta le guide relative a menu e finestre di dialogo e 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 dell'interfaccia utente di questo modulo

`openById(id)`

Restituisce il Form con l'ID specificato. Genera un'eccezione se l'ID non è valido o se l'utente non ha l'autorizzazione per aprire il modulo.

// Open a form by ID.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

Parametri

Nome	Tipo	Descrizione
`id`	`String`	l'ID del modulo da aprire

Invio

Form: il modulo con l'ID specificato

Lanci

Error: se l'ID specificato non è valido o l'utente non dispone di autorizzazioni sufficienti

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 il Form con l'URL specificato. Viene lanciata un'eccezione se l'URL non è valido o se l'utente non dispone dell'autorizzazione per aprire il modulo.

// Open a form by URL.
const 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 specificato non è valido o se l'utente non dispone di autorizzazioni sufficienti

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/forms