Class FormApp

FormApp

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àTipoDescrizione
AlignmentAlignmentUn'enumerazione dei tipi di allineamento dell'immagine.
DestinationTypeDestinationTypeUn'enumerazione dei tipi di destinazioni che possono archiviare le risposte dei moduli.
FeedbackTypeFeedbackTypeUn'enumerazione dei tipi di modulo Feedbacks.
ItemTypeItemTypeUn'enumerazione dei tipi di modulo Items.
PageNavigationTypePageNavigationTypeUn'enumerazione dei possibili comportamenti per la navigazione nelle pagine.

Metodi

MetodoTipo restituitoBreve descrizione
create(title)FormCrea e restituisce un nuovo Form.
createCheckboxGridValidation()CheckboxGridValidationBuilderRestituisce un'istanza di un CheckboxGridValidationBuilder che può essere utilizzato per impostare la convalida su una CheckboxGridItem.
createCheckboxValidation()CheckboxValidationBuilderRestituisce un'istanza di un CheckboxValidationBuilder che può essere utilizzato per impostare la convalida su un CheckboxItem.
createFeedback()QuizFeedbackBuilderRestituisce un'istanza di QuizFeedbackBuilder che può essere utilizzata per impostare il feedback su un Item.
createGridValidation()GridValidationBuilderRestituisce un'istanza di un GridValidationBuilder che può essere utilizzato per impostare la convalida su un GridItem.
createParagraphTextValidation()ParagraphTextValidationBuilderRestituisce un'istanza di un ParagraphTextValidationBuilder che può essere utilizzato per impostare la convalida su ParagraphTextItem.
createTextValidation()TextValidationBuilderRestituisce un'istanza di TextValidationBuilder che può essere utilizzata per impostare la convalida su TextItem.
getActiveForm()FormRestituisce il modulo in cui lo script è container-bound.
getUi()UiRestituisce 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)FormRestituisce Form con l'ID specificato.
openByUrl(url)FormRestituisce 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

NomeTipoDescrizione
titleStringil 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

CheckboxGridValidationBuilder


createCheckboxValidation()

Restituisce un'istanza di un CheckboxValidationBuilder che può essere utilizzato 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 Item.

Invio

QuizFeedbackBuilder


createGridValidation()

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

Invio

GridValidationBuilder


createParagraphTextValidation()

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

Invio

ParagraphTextValidationBuilder


createTextValidation()

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

Invio

TextValidationBuilder


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

NomeTipoDescrizione
idStringl'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

NomeTipoDescrizione
urlStringl'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