Class Form

Form

Un modulo che contiene proprietà ed elementi complessivi. Le proprietà includono titolo, impostazioni e posizione vengono memorizzate. Gli elementi includono domande come caselle di controllo o elementi di opzione, mentre il layout per elementi come le interruzioni di pagina. È possibile accedere o creare moduli da FormApp.

// Open a form by ID and create a new spreadsheet.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var ss = SpreadsheetApp.create('Spreadsheet Name');

// Update form properties via chaining.
form.setTitle('Form Name')
    .setDescription('Description of form')
    .setConfirmationMessage('Thanks for responding!')
    .setAllowResponseEdits(true)
    .setAcceptingResponses(false);

// Update the form's response destination.
form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId());

Metodi

MetodoTipo restituitoBreve descrizione
addCheckboxGridItem()CheckboxGridItemAggiunge un nuovo elemento domanda, presentato come una griglia di colonne e righe, che consente intervistato di selezionare più opzioni per riga da una sequenza di caselle di controllo.
addCheckboxItem()CheckboxItemAggiunge una nuova domanda che consente al partecipante di selezionare una o più caselle di controllo, e un'opzione "Altro" .
addDateItem()DateItemConsente di aggiungere un nuovo elemento domanda che consente all'intervistato di indicare una data.
addDateTimeItem()DateTimeItemConsente di aggiungere un nuovo elemento domanda che consente al partecipante di indicare una data e un'ora.
addDurationItem()DurationItemConsente di aggiungere un nuovo elemento domanda che consente all'intervistato di indicare un periodo di tempo.
addEditor(emailAddress)FormAggiunge l'utente specificato all'elenco di editor per Form.
addEditor(user)FormAggiunge l'utente specificato all'elenco di editor per Form.
addEditors(emailAddresses)FormAggiunge l'array di utenti specificato all'elenco di editor per Form.
addGridItem()GridItemAggiunge un nuovo elemento domanda, presentato come una griglia di colonne e righe, che consente intervistato di selezionare una scelta per riga da una sequenza di pulsanti di opzione.
addImageItem()ImageItemConsente di aggiungere un nuovo elemento di layout che mostra un'immagine.
addListItem()ListItemAggiunge un nuovo elemento domanda che consente al partecipante di selezionare un'opzione da un menu a discesa dall'elenco di lettura.
addMultipleChoiceItem()MultipleChoiceItemAggiunge un nuovo elemento della domanda che consente al partecipante di selezionare una scelta da un elenco di pulsanti di opzione pulsanti o un pulsante "Altro" facoltativo .
addPageBreakItem()PageBreakItemAggiunge un nuovo elemento di layout che segna l'inizio di una pagina.
addParagraphTextItem()ParagraphTextItemAggiunge un nuovo elemento domanda che consente all'intervistato di inserire un blocco di testo.
addScaleItem()ScaleItemConsente di aggiungere un nuovo elemento domanda che consente al partecipante di scegliere un'opzione tra una serie una sequenza di pulsanti di opzione.
addSectionHeaderItem()SectionHeaderItemAggiunge un nuovo elemento di layout che indica visivamente l'inizio di una sezione.
addTextItem()TextItemConsente di aggiungere un nuovo elemento domanda che consente al partecipante di inserire una singola riga di testo.
addTimeItem()TimeItemConsente di aggiungere un nuovo elemento domanda che consente all'intervistato di indicare un'ora del giorno.
addVideoItem()VideoItemAggiunge un nuovo elemento di layout che mostra un video.
canEditResponse()BooleanDetermina se il modulo visualizza un link per modificare una risposta dopo averla inviata.
collectsEmail()BooleanDetermina se il modulo raccoglie le risposte degli intervistati .
createResponse()FormResponseCrea una nuova risposta al modulo.
deleteAllResponses()FormElimina tutte le risposte inviate dall'archivio risposte del modulo.
deleteItem(index)voidElimina l'elemento in un determinato indice tra tutti gli elementi nel modulo.
deleteItem(item)voidElimina l'elemento specificato.
deleteResponse(responseId)FormElimina una singola risposta dall'archivio delle risposte del modulo.
getConfirmationMessage()StringRecupera il messaggio di conferma del modulo.
getCustomClosedFormMessage()StringRecupera il messaggio personalizzato che viene visualizzato se il modulo non accetta risposte o se è vuoto se non viene impostato alcun messaggio personalizzato.
getDescription()StringOttiene la descrizione del modulo.
getDestinationId()StringOttiene l'ID della destinazione della risposta del modulo.
getDestinationType()DestinationTypeRestituisce il tipo di destinazione della risposta del modulo.
getEditUrl()StringRecupera l'URL che può essere utilizzato per accedere alla modalità di modifica del modulo.
getEditors()User[]Ottiene l'elenco degli editor per questo Form.
getId()StringRecupera l'ID del modulo.
getItemById(id)ItemRecupera l'elemento con un determinato ID.
getItems()Item[]Restituisce un array di tutti gli elementi del modulo.
getItems(itemType)Item[]Restituisce un array di tutti gli elementi di un determinato tipo.
getPublishedUrl()StringRecupera l'URL che può essere utilizzato per rispondere al modulo.
getResponse(responseId)FormResponseRiceve una singola risposta al modulo in base al relativo ID risposta.
getResponses()FormResponse[]Restituisce un array di tutte le risposte del modulo.
getResponses(timestamp)FormResponse[]Restituisce un array di tutte le risposte del modulo dopo una determinata data e ora.
getShuffleQuestions()BooleanDetermina se l'ordine delle domande in ogni pagina del modulo è randomizzato.
getSummaryUrl()StringOttiene l'URL che può essere utilizzato per visualizzare un riepilogo delle risposte del modulo.
getTitle()StringOttiene il titolo del modulo.
hasLimitOneResponsePerUser()BooleanDetermina se il modulo consente una sola risposta per intervistato.
hasProgressBar()BooleanDetermina se il modulo visualizza una barra di avanzamento.
hasRespondAgainLink()BooleanDetermina se il modulo visualizza un link per inviare un'altra risposta dopo l'intervistato per compilare il modulo.
isAcceptingResponses()BooleanDetermina se il modulo accetta risposte.
isPublishingSummary()BooleanDetermina se il modulo mostra un link per visualizzare un riepilogo delle risposte dopo che l'intervistato per compilare il modulo.
isQuiz()BooleanDetermina se il modulo è un quiz.
moveItem(from, to)ItemSposta un elemento in un determinato indice tra tutti gli elementi del modulo in un altro indice specificato.
moveItem(item, toIndex)ItemSposta un determinato elemento in un determinato indice tra tutti gli elementi del modulo.
removeDestination()FormScollega il modulo dalla destinazione attuale della risposta.
removeEditor(emailAddress)FormRimuove l'utente specificato dall'elenco degli editor per Form.
removeEditor(user)FormRimuove l'utente specificato dall'elenco degli editor per Form.
requiresLogin()BooleanDetermina se il modulo richiede agli intervistati di accedere a un account dello stesso dominio o un sottodominio prima di rispondere.
setAcceptingResponses(enabled)FormConsente di impostare se il modulo al momento accetta risposte.
setAllowResponseEdits(enabled)FormImposta se il modulo visualizza un link per modificare una risposta dopo averla inviata.
setCollectEmail(collect)FormImposta se il modulo raccoglie le risposte degli intervistati .
setConfirmationMessage(message)FormImposta il messaggio di conferma del modulo.
setCustomClosedFormMessage(message)FormImposta il messaggio da visualizzare se il modulo non accetta risposte.
setDescription(description)FormImposta la descrizione del modulo.
setDestination(type, id)FormImposta la destinazione in cui vengono salvate le risposte del modulo.
setIsQuiz(enabled)FormConsente di impostare se il modulo è un quiz.
setLimitOneResponsePerUser(enabled)FormImposta se il modulo consente una sola risposta per intervistato.
setProgressBar(enabled)FormConsente di impostare se il modulo ha una barra di avanzamento.
setPublishingSummary(enabled)FormImposta se il modulo visualizza un link per visualizzare un riepilogo delle risposte dopo che l'intervistato ha inviato il modulo.
setRequireLogin(requireLogin)FormImposta se il modulo richiede agli intervistati di accedere a un account dello stesso dominio o a un un sottodominio prima di rispondere.
setShowLinkToRespondAgain(enabled)FormImposta se il modulo visualizza un link per inviare un'altra risposta dopo il completamento dell'intervistato il modulo.
setShuffleQuestions(shuffle)FormConsente di impostare se l'ordine delle domande in ogni pagina del modulo è randomizzato.
setTitle(title)FormImposta il titolo del modulo.
shortenFormUrl(url)StringConverte l'URL lungo di un modulo in un URL breve.
submitGrades(responses)FormInvia i voti per le risposte FormResponse.

Documentazione dettagliata

addCheckboxGridItem()

Aggiunge un nuovo elemento domanda, presentato come una griglia di colonne e righe, che consente intervistato di selezionare più opzioni per riga da una sequenza di caselle di controllo.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a checkbox grid item.
const item = form.addCheckboxGridItem();

// Sets the title 'Where did you celebrate New Year's?'
item.setTitle('Where did you celebrate New Year's?');

// Sets the grid's rows and columns.
item.setRows(['New York', 'San Francisco', 'London'])
  .setColumns(['2014', '2015', '2016', '2017']);

Invio

CheckboxGridItem: l'elemento appena creato.

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

addCheckboxItem()

Aggiunge una nuova domanda che consente al partecipante di selezionare una o più caselle di controllo, e un'opzione "Altro" .

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a checkbox item.
const item = form.addCheckboxItem();

// Sets the title of the checkbox item to 'Do you prefer cats or dogs?'
item.setTitle('Do you prefer cats or dogs?');

// Sets the choices.
item.setChoiceValues(['Cats', 'Dogs']);

Invio

CheckboxItem: l'elemento appena creato.

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

addDateItem()

Consente di aggiungere un nuovo elemento domanda che consente all'intervistato di indicare una data.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a date item.
const item = form.addDateItem();

// Sets the title to 'When were you born?'
item.setTitle('When were you born?');

// Sets the description for the date item.
item.setHelpText('Some helper text.');

Invio

DateItem: l'elemento appena creato.

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

addDateTimeItem()

Consente di aggiungere un nuovo elemento domanda che consente al partecipante di indicare una data e un'ora.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a question with date and time inputs.
const item = form.addDateTimeItem();

// Sets the title to 'When were you born?'
item.setTitle('When were you born?');

// Sets the question as required.
item.setRequired(true);

Invio

DateTimeItem: l'elemento appena creato.

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

addDurationItem()

Consente di aggiungere un nuovo elemento domanda che consente all'intervistato di indicare un periodo di tempo.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a question with a duration input.
const item = form.addDurationItem();

// Sets the title to 'How long can you hold your breath?'
item.setTitle('How long can you hold your breath?');

// Sets the question as required.
item.setRequired(true);

Invio

DurationItem: l'elemento appena creato.

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

addEditor(emailAddress)

Aggiunge l'utente specificato all'elenco di editor per Form. Se l'utente era già nell'elenco dei visualizzatori, questo metodo promuove l'utente all'esterno dell'elenco dei visualizzatori.

Parametri

NomeTipoDescrizione
emailAddressStringL'indirizzo email dell'utente da aggiungere.

Invio

Form: Form, 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

addEditor(user)

Aggiunge l'utente specificato all'elenco di editor per Form. Se l'utente era già nell'elenco dei visualizzatori, questo metodo promuove l'utente all'esterno dell'elenco dei visualizzatori.

Parametri

NomeTipoDescrizione
userUserUna rappresentazione dell'utente da aggiungere.

Invio

Form: Form, 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

addEditors(emailAddresses)

Aggiunge l'array di utenti specificato all'elenco di editor per Form. Se uno dei utenti erano già presenti nell'elenco dei visualizzatori, questo metodo li promuove dall'elenco dei spettatori.

Parametri

NomeTipoDescrizione
emailAddressesString[]Un array di indirizzi email degli utenti da aggiungere.

Invio

Form: Form, 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

addGridItem()

Aggiunge un nuovo elemento domanda, presentato come una griglia di colonne e righe, che consente intervistato di selezionare una scelta per riga da una sequenza di pulsanti di opzione.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a multiple choice grid.
const item = form.addGridItem();

// Sets the title to 'Rate your interests.'
item.setTitle('Rate your interests');

// Sets the grid's rows and columns.
item.setRows(['Cars', 'Computers', 'Celebrities'])
  .setColumns(['Boring', 'So-so', 'Interesting']);

Invio

GridItem: l'elemento appena creato.

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

addImageItem()

Consente di aggiungere un nuovo elemento di layout che mostra un'immagine.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds an image item.
const item = form.addImageItem();

// Gets the Google icon to use as the image.
const img = UrlFetchApp.fetch('https://fonts.gstatic.com/s/i/productlogos/googleg/v6/web-24dp/logo_googleg_color_1x_web_24dp.png');

// Sets the image, title, and description for the item.
item.setTitle('Google icon').setHelpText('Google icon').setImage(img);

Invio

ImageItem: l'elemento appena creato.

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

addListItem()

Aggiunge un nuovo elemento domanda che consente al partecipante di selezionare un'opzione da un menu a discesa dall'elenco di lettura.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a dropdown list to the form.
const item = form.addListItem();

// Sets the title to 'Do you prefer cats or dogs?'
item.setTitle('Do you prefer cats or dogs?');

// Sets the description to 'This is description text...'
item.setHelpText('This is description text...');

// Creates and adds choices to the dropdown list.
item.setChoices([
  item.createChoice('dog'),
  item.createChoice('cat')
]);

Invio

ListItem: l'elemento appena creato.

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

addMultipleChoiceItem()

Aggiunge un nuovo elemento della domanda che consente al partecipante di selezionare una scelta da un elenco di pulsanti di opzione pulsanti o un pulsante "Altro" facoltativo .

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a multiple choice item to the form.
const item = form.addMultipleChoiceItem();

// Sets the title.
item.setTitle('What is your favorite ice cream flavor?');

// Creates some choice items.
const vanilla = item.createChoice('vanilla');
const chocolate = item.createChoice('chocolate');
const strawberry = item.createChoice('strawberry');

// Sets the choices.
item.setChoices([vanilla, chocolate, strawberry]);

Invio

MultipleChoiceItem: l'elemento appena creato.

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

addPageBreakItem()

Aggiunge un nuovo elemento di layout che segna l'inizio di una pagina.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds page break items to create a second and third page for the form.
const pageTwo = form.addPageBreakItem();
const pageThree = form.addPageBreakItem();

// Sets the titles for the pages.
pageTwo.setTitle('Page two');
pageThree.setTitle('Page three');

// Upon completion of the first page, sets the form to navigate to the third page.
pageTwo.setGoToPage(pageThree);

// Upon completion of the second page, sets the form to navigate back to the first page.
pageThree.setGoToPage(FormApp.PageNavigationType.RESTART);

Invio

PageBreakItem: l'elemento appena creato.

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

addParagraphTextItem()

Aggiunge un nuovo elemento domanda che consente all'intervistato di inserire un blocco di testo.

// Opens the form by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds the paragraph text item.
const item = form.addParagraphTextItem();

// Sets the title to 'What is your address?'
item.setTitle('What is your address?');

Invio

ParagraphTextItem: l'elemento appena creato.

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

addScaleItem()

Consente di aggiungere un nuovo elemento domanda che consente al partecipante di scegliere un'opzione tra una serie una sequenza di pulsanti di opzione.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds the scale item.
const item = form.addScaleItem();

// Sets the title of the scale item to 'Choose a number.'
item.setTitle('Choose a number');

// Sets the scale to 1-5.
item.setBounds(1, 5);

// Sets the label for the lower and upper bounds.
item.setLabels('Lowest', 'Highest');

Invio

ScaleItem: l'elemento appena creato.

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

addSectionHeaderItem()

Aggiunge un nuovo elemento di layout che indica visivamente l'inizio di una sezione.

 // Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds the section heading item.
const item = form.addSectionHeaderItem();

// Sets the title to 'Title of new section.'
item.setTitle('Title of new section');

// Sets the description.
item.setHelpText('Description of new section');

Invio

SectionHeaderItem: l'elemento appena creato.

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

addTextItem()

Consente di aggiungere un nuovo elemento domanda che consente al partecipante di inserire una singola riga di testo.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a single-line text item.
const item = form.addTextItem();

// Sets the title to 'What is your name?'
item.setTitle('What is your name?');

Invio

TextItem: l'elemento appena creato.

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

addTimeItem()

Consente di aggiungere un nuovo elemento domanda che consente all'intervistato di indicare un'ora del giorno.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a question with a time input.
const item = form.addTimeItem();

// Sets the title to 'What time do you usually wake up in the morning?'
item.setTitle('What time do you usually wake up in the morning?');

Invio

TimeItem: l'elemento appena creato.

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

addVideoItem()

Aggiunge un nuovo elemento di layout che mostra un video.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a video item.
const item = form.addVideoItem();

// Sets the title, description, and video.
item.setTitle('YouTube video')
  .setHelpText('Send content automatically via Google Sheets and Apps Script')
  .setVideoUrl('https://youtu.be/xxgQr-jSu9o');

// Sets the alignment to the center.
item.setAlignment(FormApp.Alignment.CENTER);

Invio

VideoItem: l'elemento appena creato.

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

canEditResponse()

Determina se il modulo visualizza un link per modificare una risposta dopo averla inviata.

Indipendentemente da questa impostazione, il metodo FormResponse.getEditResponseUrl() consente autore dello script che ha accesso in modifica al modulo per generare un URL che possa essere utilizzato per modificare un la risposta corretta.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Checks if the form displays a link to edit a response after submitting it.
// The default is false. To let people edit their responses, use
// form.setAllowResponseEdits(true).
const edit = form.canEditResponse();

// If the form doesn't let people edit responses, logs false to the console.
console.log(edit);

Invio

Boolean: true se nel modulo è presente il messaggio "Modifica la risposta" link; false se non lo fa.

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

collectsEmail()

Determina se il modulo raccoglie le risposte degli intervistati .

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form to not collect respondents' email addresses.
form.setCollectEmail(false);

// Checks whether the form collects respondents' email addresses and logs it to the console.
const bool = form.collectsEmail();

console.log(bool);

Invio

Boolean - true se il modulo raccoglie indirizzi email; false in caso contrario.

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()

Crea una nuova risposta al modulo. Per rispondere a una domanda, crea un ItemResponse dall'elemento, quindi allegalo a questa risposta del modulo chiamando il FormResponse.withItemResponse(response). Per salvare la risposta assemblata, chiama FormResponse.submit().

Invio

FormResponse: la risposta del modulo appena creata.

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

deleteAllResponses()

Elimina tutte le risposte inviate dall'archivio risposte del modulo. Questo metodo non elimina delle risposte archiviate in una destinazione esterna per le risposte (come un foglio di lavoro), ma cancella la visualizzazione di riepilogo del modulo.

Invio

Form: Form, 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

deleteItem(index)

Elimina l'elemento in un determinato indice tra tutti gli elementi nel modulo. Genera un'eccezione di scripting se non esistono elementi nell'indice specificato.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets all the items from the form.
const items = form.getItems();

// Finds the index of a paragraph text item and deletes it by the item's index.
const index = items.findIndex(item => item.getType() === FormApp.ItemType.PARAGRAPH_TEXT);
if (index !== -1) {
  form.deleteItem(index);
}

Parametri

NomeTipoDescrizione
indexIntegerL'indice dell'elemento tra tutti gli elementi nel modulo.

Lanci

Error: se non esistono elementi nell'indice specificato

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

deleteItem(item)

Elimina l'elemento specificato. Genera un'eccezione di script se l'elemento è già stato eliminato.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets all of the items from the form.
const items = form.getItems();

// Finds a paragraph text item and deletes it.
const item = items.find(item => item.getType() === FormApp.ItemType.PARAGRAPH_TEXT);
if (item) {
  form.deleteItem(item);
}

Parametri

NomeTipoDescrizione
itemItemL'elemento da eliminare.

Lanci

Error: se l'elemento non esiste nel 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

deleteResponse(responseId)

Elimina una singola risposta dall'archivio delle risposte del modulo. Questo metodo non elimina copie di archiviate in una destinazione esterna delle risposte (come un foglio di lavoro), ma rimuove dalla visualizzazione di riepilogo del modulo. L'ID risposta può essere recuperato con FormResponse.getId().

Parametri

NomeTipoDescrizione
responseIdStringL'ID della risposta del modulo da eliminare.

Invio

Form: Form, 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

getConfirmationMessage()

Recupera il messaggio di conferma del modulo.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the confirmation message to display after someone submits the form.
form.setConfirmationMessage('You successfully submitted the form.');

// Gets the confirmation message and logs it to the console.
const message = form.getConfirmationMessage();

console.log(message);

Invio

String: il messaggio di conferma del 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

getCustomClosedFormMessage()

Recupera il messaggio personalizzato che viene visualizzato se il modulo non accetta risposte o se è vuoto se non viene impostato alcun messaggio personalizzato.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets a custom closed form message to display to the user when the form
// no longer accepts responses.
form.setCustomClosedFormMessage('The form is no longer accepting responses.');

// Gets the custom message set for the form and logs it to the console.
const message = form.getCustomClosedFormMessage();

console.log(message);

Invio

String: il messaggio personalizzato da mostrare se il modulo non accetta risposte o è vuoto se non viene impostato alcun messaggio personalizzato.

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

getDescription()

Ottiene la descrizione del modulo.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form description.
form.setDescription('This is the form description.');

// Gets the form description and logs it to the console.
const description = form.getDescription();

console.log(description);

Invio

String: descrizione del 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

getDestinationId()

Ottiene l'ID della destinazione della risposta del modulo.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Creates a spreadsheet to use as the response destination.
const ss = SpreadsheetApp.create('Test_Spreadsheet');

// Updates the form's response destination.
form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId());

// Gets the ID of the form's response destination and logs it to the console.
const destinationId = form.getDestinationId();

console.log(destinationId);

Invio

String: l'ID della destinazione della risposta del 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

getDestinationType()

Restituisce il tipo di destinazione della risposta del modulo.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc1234556/edit');

// Gets the type of the form's response destination and logs it to the console.
const destinationType = form.getDestinationType().name();

console.log(destinationType);

Invio

DestinationType: il tipo di destinazione della risposta del 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

getEditUrl()

Recupera l'URL che può essere utilizzato per accedere alla modalità di modifica del modulo.

// Opens the form by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the URL that accesses the form's edit mode and logs it to the console.
const url = form.getEditUrl();

console.log(url);

Invio

String: l'URL per modificare il 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

getEditors()

Ottiene l'elenco degli editor per questo Form.

Invio

User[]: un array di utenti con autorizzazione di modifica.

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()

Recupera l'ID del modulo.

// Opens the form by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the ID of the form and logs it to the console.
const id = form.getId();

console.log(id);

Invio

String: l'ID del 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

getItemById(id)

Recupera l'elemento con un determinato ID. Restituisce null se l'ID non corrisponde a un articolo in il modulo.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the ID of the first item on the form.
const itemId = form.getItems()[0].getId();

// Gets the item from the ID.
const item = form.getItemById(itemId);

// Gets the name of the item type and logs it to the console.
const type = item.getType().name();

console.log(type);

Parametri

NomeTipoDescrizione
idIntegerL'ID dell'articolo.

Invio

Item: l'elemento con l'ID specificato o null se l'elemento non esiste nel 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

getItems()

Restituisce un array di tutti gli elementi del modulo.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the list of items in the form.
const items = form.getItems();

// Gets the type for each item and logs them to the console.
const types = items.map((item) => item.getType().name());

console.log(types);

Invio

Item[]: un array di tutti gli elementi nel 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

getItems(itemType)

Restituisce un array di tutti gli elementi di un determinato tipo.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets a list of all checkbox items on the form.
const items = form.getItems(FormApp.ItemType.CHECKBOX);

// Gets the title of each checkbox item and logs them to the console.
const checkboxItemsTitle = items.map((item) => item.asCheckboxItem().getTitle());
console.log(checkboxItemsTitle);

Parametri

NomeTipoDescrizione
itemTypeItemTypeIl tipo di elementi da recuperare.

Invio

Item[]: un array di tutti gli elementi di quel tipo.

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

getPublishedUrl()

Recupera l'URL che può essere utilizzato per rispondere al modulo.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the URL to respond to the form and logs it to the console.
const url = form.getPublishedUrl();
console.log(url);

Invio

String: l'URL per rispondere al 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

getResponse(responseId)

Riceve una singola risposta al modulo in base al relativo ID risposta. Gli ID risposta possono essere recuperati da FormResponse.getId().

Parametri

NomeTipoDescrizione
responseIdStringL'ID della risposta del modulo.

Invio

FormResponse: la risposta del modulo.

Lanci

Error: se la risposta non esiste

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

getResponses()

Restituisce un array di tutte le risposte del modulo.

Invio

FormResponse[]: un array di tutte le risposte del 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

getResponses(timestamp)

Restituisce un array di tutte le risposte del modulo dopo una determinata data e ora.

Parametri

NomeTipoDescrizione
timestampDateLa data e l'ora in cui devono essere restituite le risposte del modulo.

Invio

FormResponse[]: l'elenco di risposte del 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

getShuffleQuestions()

Determina se l'ordine delle domande in ogni pagina del modulo è randomizzato.

Invio

Boolean - true se l'ordine delle domande in ogni pagina del modulo è casuale; false in caso contrario.

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

getSummaryUrl()

Ottiene l'URL che può essere utilizzato per visualizzare un riepilogo delle risposte del modulo. A meno che setPublishingSummary(enabled) non sia impostato su true, solo gli utenti con autorizzazione di modifica per modulo sia in grado di accedere all'URL.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// Opens the form by its URL.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the URL to view a summary of the form's responses and logs it to the console.
const url = form.getSummaryUrl();
console.log(url);

Invio

String: l'URL per visualizzare un riepilogo delle risposte.

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()

Ottiene il titolo del modulo.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the title of the form to 'For_Testing.'
form.setTitle('For_Testing');

// Gets the title of the form and logs it to the console.
const title = form.getTitle();
console.log(title);

Invio

String: titolo del 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

hasLimitOneResponsePerUser()

Determina se il modulo consente una sola risposta per intervistato. Se il valore è true, lo script non può inviare risposte del modulo.

Invio

Boolean - true se il modulo consente una sola risposta per intervistato; false in caso contrario.

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

hasProgressBar()

Determina se il modulo visualizza una barra di avanzamento.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// Opens the form by its URL.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Displays the progress bar on the form.
form.setProgressBar(true);

// Checks if the form displays a progress bar and logs it to the console.
console.log(form.hasProgressBar());

Invio

Boolean - true se il modulo mostra una barra di avanzamento; false in caso contrario.

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

Determina se il modulo visualizza un link per inviare un'altra risposta dopo l'intervistato per compilare il modulo.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form to display a link to submit another
// response after someone submits the form.
form.setShowLinkToRespondAgain(true);

// Checks if the form displays a 'Submit another response' link and logs it to the console.
console.log(form.hasRespondAgainLink());

Invio

Boolean: true se nel modulo è visualizzato il messaggio "Invia un'altra risposta" link; false se non lo fa.

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

isAcceptingResponses()

Determina se il modulo accetta risposte.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form to accept responses.
form.setAcceptingResponses(true);

// Checks if the form is accepting responses or not and logs it to the console.
const accepting = form.isAcceptingResponses();
console.log(accepting);

Invio

Boolean - true se il modulo accetta risposte; false in caso contrario.

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

isPublishingSummary()

Determina se il modulo mostra un link per visualizzare un riepilogo delle risposte dopo che l'intervistato per compilare il modulo.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form to display a link to a summary of
// the responses after someone submits the form.
form.setPublishingSummary(true);

// Checks if the form displays a "See previous responses" link and logs it to the console.
const publishingLink = form.isPublishingSummary();
console.log(publishingLink);

Invio

Boolean: true se nel modulo è visualizzato il messaggio "Visualizza risposte precedenti" link; false se non lo fa.

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

isQuiz()

Determina se il modulo è un quiz.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form as a quiz.
form.setIsQuiz(true);

// Checks if the form is a quiz or not and logs it to the console.
console.log(form.isQuiz());

Invio

Boolean - true se il modulo accetta risposte; false in caso contrario.

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

moveItem(from, to)

Sposta un elemento in un determinato indice tra tutti gli elementi del modulo in un altro indice specificato. Lancia eccezione dello scripting se l'indice to è fuori intervallo.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Moves the first item to be the last item.
form.moveItem(0, form.getItems().length - 1);

Parametri

NomeTipoDescrizione
fromIntegerL'indice corrente dell'elemento tra tutti gli elementi nel modulo.
toIntegerIl nuovo indice dell'elemento tra tutti gli elementi nel modulo.

Invio

Item: l'elemento spostato.

Lanci

Error: se uno dei due indici è fuori intervallo.

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

moveItem(item, toIndex)

Sposta un determinato elemento in un determinato indice tra tutti gli elementi del modulo. Propone uno scripting un'eccezione se l'indice specificato è fuori intervallo.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the first item.
const item = form.getItems()[0];

// Moves the item to be the last item.
form.moveItem(item, form.getItems().length - 1);

Parametri

NomeTipoDescrizione
itemItemL'elemento da spostare.
toIndexIntegerIl nuovo indice dell'elemento tra tutti gli elementi nel modulo.

Invio

Item: l'elemento spostato.

Lanci

Error: se l'indice è fuori intervallo.

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

removeDestination()

Scollega il modulo dalla destinazione attuale della risposta. La precedente destinazione scollegata è ancora conserva una copia di tutte le risposte precedenti. Tutti i moduli, inclusi quelli che non includono destinazione impostata in modo esplicito, salva copia delle risposte nell'archivio delle risposte del modulo. Se il modulo al momento non dispone di un destinazione di risposta, questo metodo non ha alcun effetto.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Opens a spreadsheet to use for the response destination.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Updates the form's response destination to the spreadsheet.
form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId());

// Unlinks the form from the spreadsheet.
form.removeDestination();

Invio

Form: Form, 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

removeEditor(emailAddress)

Rimuove l'utente specificato dall'elenco degli editor per Form. Questo metodo non impedisce agli utenti di accedere a Form se appartengono a una classe di utenti con accesso generale, ad esempio se Form viene condiviso con l'intera organizzazione dominio o se Form si trova in un Drive condiviso a cui l'utente può accedere.

Per i file di Drive, l'utente viene rimosso anche dall'elenco dei visualizzatori.

Parametri

NomeTipoDescrizione
emailAddressStringL'indirizzo email dell'utente da rimuovere.

Invio

Form: Form, 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

removeEditor(user)

Rimuove l'utente specificato dall'elenco degli editor per Form. Questo metodo non impedisce agli utenti di accedere a Form se appartengono a una classe di utenti con accesso generale, ad esempio se Form viene condiviso con l'intera organizzazione dominio o se Form si trova in un Drive condiviso a cui l'utente può accedere.

Per i file di Drive, l'utente viene rimosso anche dall'elenco dei visualizzatori.

Parametri

NomeTipoDescrizione
userUserUna rappresentazione dell'utente da rimuovere.

Invio

Form: Form, 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

requiresLogin()

Determina se il modulo richiede agli intervistati di accedere a un account dello stesso dominio o un sottodominio prima di rispondere.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Checks if the form requires respondents to log in to a Google Workspace account
// before responding and logs it to the console.
const login = form.requiresLogin();
console.log(login);

Invio

Boolean - true se il modulo richiede l'accesso da parte degli utenti; false in caso contrario.


setAcceptingResponses(enabled)

Consente di impostare se il modulo al momento accetta risposte. Il valore predefinito per i nuovi moduli è true.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form to accept responses.
form.setAcceptingResponses(true);

// Checks whether the form is accepting responses or not and logs it to the console.
console.log(form.isAcceptingResponses());

Parametri

NomeTipoDescrizione
enabledBooleantrue se il modulo deve accettare risposte. false se non è necessario.

Invio

Form: Form, 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

setAllowResponseEdits(enabled)

Imposta se il modulo visualizza un link per modificare una risposta dopo averla inviata. L'impostazione predefinita per nuovo modulo è false.

Indipendentemente da questa impostazione, il metodo FormResponse.getEditResponseUrl() consente autore dello script che dispone dell'autorizzazione di modifica per il modulo per generare un URL che possa essere utilizzato per modificare un la risposta corretta.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Shows "Edit your response" link after someone submits the form.
form.setAllowResponseEdits(true);

// Checks whether the option to edit the form after a user submits it is set to true or not
// and logs it to the console.
console.log(form.canEditResponse());

Parametri

NomeTipoDescrizione
enabledBooleantrue se nel modulo deve essere visualizzato il messaggio "Modifica la risposta" link; false in caso contrario.

Invio

Form: Form, 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

setCollectEmail(collect)

Imposta se il modulo raccoglie le risposte degli intervistati . L'impostazione predefinita per i nuovi moduli è false.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form to collect respondents' email addresses.
form.setCollectEmail(true);

// Checks whether the value is set to true or false and logs it to the console.
const collect = form.collectsEmail();
console.log(collect);

Parametri

NomeTipoDescrizione
collectBooleantrue se il modulo deve raccogliere indirizzi email; false se non lo fa.

Invio

Form: Form, 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

setConfirmationMessage(message)

Imposta il messaggio di conferma del modulo.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets a custom confirmation message to display after someone submits the form.
form.setConfirmationMessage('Your form has been successfully submitted.');

// Gets the confirmation message set for the form and logs it to the console.
const message = form.getConfirmationMessage();
console.log(message);

Parametri

NomeTipoDescrizione
messageStringIl nuovo messaggio di conferma del modulo.

Invio

Form: Form, 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

setCustomClosedFormMessage(message)

Imposta il messaggio da visualizzare se il modulo non accetta risposte. Se non viene impostato alcun messaggio, utilizza un messaggio predefinito.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form to not accept responses.
form.setAcceptingResponses(false);

// Sets a custom closed form message to display to the user.
form.setCustomClosedFormMessage('The form is no longer accepting responses.');

// Gets the custom message set for the form and logs it to the console.
const message = form.getCustomClosedFormMessage();
console.log(message);

Parametri

NomeTipoDescrizione
messageStringIl messaggio da visualizzare se il modulo non accetta risposte.

Invio

Form: Form, 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

setDescription(description)

Imposta la descrizione del modulo.

Parametri

NomeTipoDescrizione
descriptionStringLa nuova descrizione del modulo.

Invio

Form: Form, 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

setDestination(type, id)

Imposta la destinazione in cui vengono salvate le risposte del modulo. Tutti i moduli, inclusi quelli che non una destinazione impostata in modo esplicito, salva una copia delle risposte nel di archiviazione delle risposte.

Parametri

NomeTipoDescrizione
typeDestinationTypeIl tipo di destinazione della risposta del modulo.
idStringL'ID della destinazione della risposta del modulo.

Invio

Form: Form, per il concatenamento.

Lanci

Error: se l'ID destinazione fornito non è valido

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

setIsQuiz(enabled)

Consente di impostare se il modulo è un quiz. Il valore predefinito per i nuovi moduli è false.

Le domande valutate sono consentite solo nei quiz, pertanto l'impostazione di questo criterio su false fa sì che le opzioni di valutazione da rimuovere da tutte le domande.

Le impostazioni dei quiz sono disponibili solo nella nuova UI di Moduli. la creazione di un modulo Quiz attiva il modulo a utilizzare la nuova UI.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Makes the form a quiz.
form.setIsQuiz(true);

// Checks whether the form is a quiz or not and logs it to the console.
console.log(form.isQuiz());

Parametri

NomeTipoDescrizione
enabledBooleantrue se le funzionalità relative ai quiz devono essere attivate per il modulo. false se .

Invio

Form: Form, 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

setLimitOneResponsePerUser(enabled)

Imposta se il modulo consente una sola risposta per intervistato. L'impostazione predefinita per i nuovi moduli è false. Se il valore è impostato su true, lo script non può inviare risposte del modulo in tutti.

Parametri

NomeTipoDescrizione
enabledBooleantrue se il modulo deve consentire una sola risposta per intervistato. false in caso contrario.

Invio

Form: Form, 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

setProgressBar(enabled)

Consente di impostare se il modulo ha una barra di avanzamento. Il valore predefinito per i nuovi moduli è false.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Displays the progress bar on the form.
form.setProgressBar(true);

// Checks whether the form has a progress bar and logs it to the console.
console.log(form.hasProgressBar());

Parametri

NomeTipoDescrizione
enabledBooleantrue se il modulo mostra una barra di avanzamento; false in caso contrario.

Invio

Form: Form, 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

setPublishingSummary(enabled)

Imposta se il modulo visualizza un link per visualizzare un riepilogo delle risposte dopo che l'intervistato ha inviato il modulo. Il valore predefinito per i nuovi moduli è false.

Parametri

NomeTipoDescrizione
enabledBooleantrue se nel modulo deve essere visualizzato il messaggio "Visualizza le risposte precedenti" link; false in caso contrario.

Invio

Form: Form, 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

setRequireLogin(requireLogin)

Imposta se il modulo richiede agli intervistati di accedere a un account dello stesso dominio o a un un sottodominio prima di rispondere. L'impostazione predefinita per i nuovi moduli è false, a meno che non si tratti di un dominio amministratore cambia l'impostazione predefinita.

Questa funzionalità è disponibile solo per i moduli creati dagli utenti di Google Workspace. Utenti di altri tipi di Account Google non possono essere richiesti per accedere.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form so that users must log in to their Google Workspace account.
form.setRequireLogin(true);

// Checks whether the form requires login or not and logs it to the console.
console.log(form.requiresLogin());

Parametri

NomeTipoDescrizione
requireLoginBooleantrue se il modulo richiede l'accesso da parte degli utenti; false se non lo fa.

Invio

Form: il modulo 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

setShowLinkToRespondAgain(enabled)

Imposta se il modulo visualizza un link per inviare un'altra risposta dopo il completamento dell'intervistato il modulo. Il valore predefinito per i nuovi moduli è true.

Parametri

NomeTipoDescrizione
enabledBooleantrue se nel modulo deve essere visualizzato il messaggio "Invia un'altra risposta" link; false in caso contrario.

Invio

Form: Form, 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

setShuffleQuestions(shuffle)

Consente di impostare se l'ordine delle domande in ogni pagina del modulo è randomizzato.

Parametri

NomeTipoDescrizione
shuffleBooleantrue se l'ordine delle domande in ogni pagina del modulo deve essere randomizzato; false in caso contrario.

Invio

Form: Form, 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 del modulo.

Parametri

NomeTipoDescrizione
titleStringIl nuovo titolo del modulo.

Invio

Form: Form, 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

shortenFormUrl(url)

Converte l'URL lungo di un modulo in un URL breve. Genera un'eccezione se l'URL lungo non appartengono a Moduli Google.

Parametri

NomeTipoDescrizione
urlStringL'URL da abbreviare.

Invio

String: un URL nel formato http://goo.gl/forms/1234.

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

submitGrades(responses)

Invia i voti per le risposte FormResponse.

Se il codice include un trigger onFormSubmit, la chiamata a submitGrades() attiva la condizione onFormSubmit e genera un ciclo infinito. Per evitare loop infinito, aggiungi un codice che verifichi se esistono già voti prima di chiamare submitGrades().

Parametri

NomeTipoDescrizione
responsesFormResponse[]Un array di tutte le risposte del modulo.

Invio

Form: Form, 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