Class Form

Un modulo che contiene proprietà e elementi generali. Le proprietà includono il titolo, le impostazioni e la posizione in cui vengono memorizzate le risposte. Gli elementi includono domande come caselle di controllo o pulsanti di opzione, mentre gli elementi di layout si riferiscono a elementi come le interruzioni di pagina. È possibile accedere ai moduli o crearli da FormApp.

// Open a form by ID and create a new spreadsheet.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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

Metodo	Tipo restituito	Breve descrizione
`addCheckboxGridItem()`	`CheckboxGridItem`	Aggiunge un nuovo elemento domanda, presentato come una griglia di colonne e righe, che consente al rispondente di selezionare più opzioni per riga da una sequenza di caselle di controllo.
`addCheckboxItem()`	`CheckboxItem`	Aggiunge un nuovo elemento domanda che consente al rispondente di selezionare una o più caselle di controllo, nonché un campo "altro" facoltativo.
`addDateItem()`	`DateItem`	Aggiunge un nuovo elemento domanda che consente al rispondente di indicare una data.
`addDateTimeItem()`	`DateTimeItem`	Aggiunge un nuovo elemento domanda che consente al rispondente di indicare una data e un'ora.
`addDurationItem()`	`DurationItem`	Aggiunge un nuovo elemento domanda che consente al rispondente di indicare un periodo di tempo.
`addEditor(emailAddress)`	`Form`	Aggiunge l'utente specificato all'elenco degli editor per `Form`.
`addEditor(user)`	`Form`	Aggiunge l'utente specificato all'elenco degli editor per `Form`.
`addEditors(emailAddresses)`	`Form`	Aggiunge l'array di utenti specificato all'elenco degli editor per `Form`.
`addGridItem()`	`GridItem`	Aggiunge un nuovo elemento domanda, presentato come una griglia di colonne e righe, che consente al rispondente di selezionare un'opzione per riga da una sequenza di pulsanti di opzione.
`addImageItem()`	`ImageItem`	Aggiunge un nuovo elemento di layout che mostra un'immagine.
`addListItem()`	`ListItem`	Aggiunge un nuovo elemento di domanda che consente all'intervistato di selezionare una scelta da un elenco a discesa.
`addMultipleChoiceItem()`	`MultipleChoiceItem`	Aggiunge un nuovo elemento domanda che consente all'intervistato di selezionare una scelta da un elenco di pulsanti di opzione o un campo "altro" facoltativo.
`addPageBreakItem()`	`PageBreakItem`	Aggiunge un nuovo elemento di layout che contrassegna l'inizio di una pagina.
`addParagraphTextItem()`	`ParagraphTextItem`	Aggiunge un nuovo elemento domanda che consente al rispondente di inserire un blocco di testo.
`addPublishedReader(emailAddress)`	`Form`	Aggiunge l'utente specificato all'elenco dei rispondenti per `Form`.
`addPublishedReader(user)`	`Form`	Aggiunge l'utente specificato all'elenco dei rispondenti per `Form`.
`addPublishedReaders(emailAddresses)`	`Form`	Aggiunge l'array di utenti specificato all'elenco dei rispondenti per `Form`.
`addRatingItem()`	`RatingItem`	Aggiunge un nuovo elemento domanda che consente al rispondente di fornire una valutazione.
`addScaleItem()`	`ScaleItem`	Aggiunge un nuovo elemento domanda che consente all'intervistato di scegliere un'opzione da una sequenza numerata di pulsanti di opzione.
`addSectionHeaderItem()`	`SectionHeaderItem`	Aggiunge un nuovo elemento di layout che indica visivamente l'inizio di una sezione.
`addTextItem()`	`TextItem`	Aggiunge un nuovo elemento domanda che consente al rispondente di inserire una singola riga di testo.
`addTimeItem()`	`TimeItem`	Aggiunge un nuovo elemento domanda che consente al rispondente di indicare un orario del giorno.
`addVideoItem()`	`VideoItem`	Aggiunge un nuovo elemento di layout che mostra un video.
`canEditResponse()`	`Boolean`	Determina se il modulo mostra un link per modificare una risposta dopo l'invio.
`collectsEmail()`	`Boolean`	Determina se il modulo raccoglie gli indirizzi email degli intervistati.
`createResponse()`	`FormResponse`	Crea una nuova risposta al modulo.
`deleteAllResponses()`	`Form`	Elimina tutte le risposte inviate dall'archivio delle risposte del modulo.
`deleteItem(index)`	`void`	Elimina l'elemento in un determinato indice tra tutti gli elementi del modulo.
`deleteItem(item)`	`void`	Elimina l'elemento specificato.
`deleteResponse(responseId)`	`Form`	Elimina una singola risposta dall'archivio delle risposte del modulo.
`getConfirmationMessage()`	`String`	Recupera il messaggio di conferma del modulo.
`getCustomClosedFormMessage()`	`String`	Recupera il messaggio personalizzato visualizzato se il modulo non accetta risposte o una stringa vuota se non è impostato alcun messaggio personalizzato.
`getDescription()`	`String`	Recupera la descrizione del modulo.
`getDestinationId()`	`String`	Recupera l'ID della destinazione delle risposte del modulo.
`getDestinationType()`	`DestinationType`	Restituisce il tipo di destinazione di risposta del modulo.
`getEditUrl()`	`String`	Recupera l'URL che può essere utilizzato per accedere alla modalità di modifica del modulo.
`getEditors()`	`User[]`	Recupera l'elenco degli editor per questo `Form`.
`getId()`	`String`	Recupera l'ID del modulo.
`getItemById(id)`	`Item\|null`	Recupera l'elemento con un determinato ID.
`getItems()`	`Item[]`	Restituisce un array di tutti gli elementi nel modulo.
`getItems(itemType)`	`Item[]`	Recupera un array di tutti gli elementi di un determinato tipo.
`getPublishedReaders()`	`User[]`	Visualizza l'elenco di chi ha risposto a questo `Form`.
`getPublishedUrl()`	`String`	Restituisce l'URL che può essere utilizzato per rispondere al modulo.
`getResponse(responseId)`	`FormResponse`	Recupera 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()`	`Boolean`	Determina se l'ordine delle domande in ogni pagina del modulo è casuale.
`getSummaryUrl()`	`String`	Recupera l'URL che può essere utilizzato per visualizzare un riepilogo delle risposte del modulo.
`getTitle()`	`String`	Recupera il titolo del modulo.
`hasLimitOneResponsePerUser()`	`Boolean`	Determina se il modulo consente una sola risposta per partecipante.
`hasProgressBar()`	`Boolean`	Determina se il modulo mostra una barra di avanzamento.
`hasRespondAgainLink()`	`Boolean`	Determina se il modulo mostra un link per inviare un'altra risposta dopo che un rispondente ha completato il modulo.
`isAcceptingResponses()`	`Boolean`	Determina se il modulo accetta attualmente risposte.
`isPublished()`	`Boolean`	Determina se il modulo è pubblicato.
`isPublishingSummary()`	`Boolean`	Determina se il modulo mostra un link per visualizzare un riepilogo delle risposte dopo che un rispondente ha completato il modulo.
`isQuiz()`	`Boolean`	Determina se il modulo è un quiz.
`moveItem(from, to)`	`Item`	Sposta un elemento in un determinato indice tra tutti gli elementi del modulo in un altro indice specificato.
`moveItem(item, toIndex)`	`Item`	Sposta un determinato elemento in un determinato indice tra tutti gli elementi del modulo.
`removeDestination()`	`Form`	Scollega il modulo dalla destinazione di risposta corrente.
`removeEditor(emailAddress)`	`Form`	Rimuove l'utente specificato dall'elenco degli editor per `Form`.
`removeEditor(user)`	`Form`	Rimuove l'utente specificato dall'elenco degli editor per `Form`.
`removePublishedReader(emailAddress)`	`Form`	Rimuove l'utente specificato dall'elenco dei rispondenti per il `Form`.
`removePublishedReader(user)`	`Form`	Rimuove l'utente specificato dall'elenco dei rispondenti per il `Form`.
`setAcceptingResponses(enabled)`	`Form`	Indica se il modulo accetta attualmente risposte.
`setAllowResponseEdits(enabled)`	`Form`	Imposta se il modulo mostra un link per modificare una risposta dopo l'invio.
`setCollectEmail(collect)`	`Form`	Determina se il modulo raccoglie gli indirizzi email degli intervistati.
`setConfirmationMessage(message)`	`Form`	Imposta il messaggio di conferma del modulo.
`setCustomClosedFormMessage(message)`	`Form`	Imposta il messaggio da visualizzare se il modulo non accetta risposte.
`setDescription(description)`	`Form`	Imposta la descrizione del modulo.
`setDestination(type, id)`	`Form`	Imposta la destinazione in cui vengono salvate le risposte del modulo.
`setIsQuiz(enabled)`	`Form`	Specifica se il modulo è un quiz.
`setLimitOneResponsePerUser(enabled)`	`Form`	Imposta se il modulo consente una sola risposta per partecipante.
`setProgressBar(enabled)`	`Form`	Specifica se il modulo ha una barra di avanzamento.
`setPublished(enabled)`	`Form`	Indica se il modulo è pubblicato.
`setPublishingSummary(enabled)`	`Form`	Imposta se il modulo mostra un link per visualizzare un riepilogo delle risposte dopo che un utente ha inviato il modulo.
`setShowLinkToRespondAgain(enabled)`	`Form`	Imposta se il modulo mostra un link per inviare un'altra risposta dopo che un rispondente ha completato il modulo.
`setShuffleQuestions(shuffle)`	`Form`	Determina se l'ordine delle domande in ogni pagina del modulo è casuale.
`setTitle(title)`	`Form`	Imposta il titolo del modulo.
`shortenFormUrl(url)`	`String`	Converte un URL lungo per un modulo in un URL breve.
`submitGrades(responses)`	`Form`	Invia i voti per le risposte del modulo specificate.
`supportsAdvancedResponderPermissions()`	`Boolean`	Determina se il modulo supporta la pubblicazione.

Metodi ritirati

Metodo	Tipo restituito	Breve descrizione
`requiresLogin()`	`Boolean`	Determina se il modulo richiede agli intervistati di accedere a un account nello stesso dominio o in un sottodominio prima di rispondere.
`setRequireLogin(requireLogin)`	`Form`	Imposta se il modulo richiede agli intervistati di accedere a un account nello stesso dominio o in un sottodominio prima di rispondere.

Documentazione dettagliata

`addCheckboxGridItem()`

Aggiunge un nuovo elemento domanda, presentato come una griglia di colonne e righe, che consente al rispondente 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();

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'
]);

Indietro

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 un nuovo elemento domanda che consente al rispondente di selezionare una o più caselle di controllo, nonché un campo "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 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']);

Indietro

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

Aggiunge un nuovo elemento domanda che consente al rispondente 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.');

Indietro

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

Aggiunge un nuovo elemento domanda che consente al rispondente 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);

Indietro

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

Aggiunge un nuovo elemento domanda che consente al rispondente 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);

Indietro

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 degli editor per Form. Se l'utente era già presente nell'elenco di spettatori o rispondenti, questo metodo lo rimuove dall'elenco.

// 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 editor to the form.
// TODO(developer): replace the emailAddress.
form.addEditor('editor@uni.edu');

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da aggiungere.

Indietro

Form: questo 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 degli editor per Form. Se l'utente era già presente nell'elenco di spettatori o rispondenti, questo metodo lo rimuove dall'elenco.

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const oldForm = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the editors from the old form.
const users = oldForm.getEditors();

// Creates a new form.
const newForm = FormApp.create('New form');

// Adds the editors to a new form.
users.forEach(user => newForm.addEditor(user));

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da aggiungere.

Indietro

Form: questo 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 degli editor per Form. Se alcuni degli utenti erano già presenti nell'elenco degli spettatori, questo metodo li rimuove dall'elenco.

// 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 editors to the form.
// TODO(developer): replace the emailAddress.
form.addPublishedReaders(['editor1@uni.edu', 'editor2@uni.edu']);

Parametri

Nome	Tipo	Descrizione
`emailAddresses`	`String[]`	Un array di indirizzi email degli utenti da aggiungere.

Indietro

Form: questo 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 al rispondente di selezionare un'opzione 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'
]);

Indietro

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

Aggiunge 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);

Indietro

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 di domanda che consente all'intervistato di selezionare una scelta da un elenco a discesa.

// 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')]);

Indietro

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 domanda che consente all'intervistato di selezionare una scelta da un elenco di pulsanti di opzione o un campo "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]);

Indietro

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 contrassegna 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);

Indietro

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?');

Indietro

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

`addPublishedReader(emailAddress)`

Aggiunge l'utente specificato all'elenco dei rispondenti per Form. Se l'utente era già presente nell'elenco di editor o visualizzatori, questo metodo non ha 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');

// Adds responder to the form.
// TODO(developer): replace the emailAddress.
form.addPublishedReader('responder@uni.edu');

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da aggiungere.

Indietro

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

`addPublishedReader(user)`

Aggiunge l'utente specificato all'elenco dei rispondenti per Form. Se l'utente era già presente nell'elenco di editor o visualizzatori, questo metodo non ha effetto.

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const oldForm = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the responders from the old form.
const users = oldForm.getPublishedReaders();

// Creates a new form.
const newForm = FormApp.create('New form');

// Adds the responders to a new form.
users.forEach(user => newForm.addPublishedReader(user));

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da aggiungere.

Indietro

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

`addPublishedReaders(emailAddresses)`

Aggiunge l'array di utenti specificato all'elenco dei rispondenti per Form. Se l'utente era già presente nell'elenco di editor o visualizzatori, questo metodo non ha 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');

// Adds responders to the form.
// TODO(developer): replace the emailAddress.
form.addPublishedReaders(['responder1@uni.edu', 'responder2@uni.edu']);

Parametri

Nome	Tipo	Descrizione
`emailAddresses`	`String[]`	Un array di indirizzi email degli utenti da aggiungere.

Indietro

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

`addRatingItem()`

Aggiunge un nuovo elemento domanda che consente al rispondente di fornire una valutazione.

// 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 rating item.
const item = form.addRatingItem();

Indietro

RatingItem: 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()`

Aggiunge un nuovo elemento domanda che consente all'intervistato di scegliere un'opzione da una sequenza numerata 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');

Indietro

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');

Indietro

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

Aggiunge un nuovo elemento domanda che consente al rispondente 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?');

Indietro

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

Aggiunge un nuovo elemento domanda che consente al rispondente di indicare un orario 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?');

Indietro

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

Indietro

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 mostra un link per modificare una risposta dopo l'invio.

Indipendentemente da questa impostazione, il metodo FormResponse.getEditResponseUrl() consente a un autore di script che dispone dell'accesso in modifica al modulo di generare un URL che può essere utilizzato per modificare una risposta.

// 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);

Indietro

Boolean: true se il modulo mostra un link "Modifica la tua risposta"; false se non lo mostra.

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 gli indirizzi email 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);

Indietro

Boolean — true se il modulo raccoglie indirizzi email; false se non li raccoglie.

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 FormResponse.withItemResponse(response). Per salvare la risposta assemblata, chiama il numero FormResponse.submit().

Indietro

FormResponse: la risposta al 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 delle risposte del modulo. Questo metodo non elimina le copie delle risposte memorizzate in una destinazione di risposta esterna (come un foglio di lavoro), ma cancella la visualizzazione riepilogativa del modulo.

Indietro

Form: questo 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 del modulo. Genera un'eccezione di scripting se non esiste alcun elemento all'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

Nome	Tipo	Descrizione
`index`	`Integer`	L'indice dell'elemento tra tutti gli elementi del modulo.

Genera

Error: se non esiste alcun elemento all'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 scripting 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

Nome	Tipo	Descrizione
`item`	`Item`	L'elemento da eliminare.

Genera

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 le copie delle risposte memorizzate in una destinazione di risposta esterna (ad esempio un foglio di lavoro), ma rimuove la risposta dalla visualizzazione riepilogativa del modulo. L'ID risposta può essere recuperato con FormResponse.getId().

Parametri

Nome	Tipo	Descrizione
`responseId`	`String`	L'ID della risposta al modulo da eliminare.

Indietro

Form: questo 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);

Indietro

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 visualizzato se il modulo non accetta risposte o una stringa vuota se non è 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);

Indietro

String: il messaggio personalizzato da visualizzare se il modulo non accetta risposte o una stringa vuota se non è 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()`

Recupera 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);

Indietro

String: la 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()`

Recupera l'ID della destinazione delle risposte 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);

Indietro

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

`getDestinationType()`

Restituisce il tipo di destinazione di 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);

Indietro

DestinationType: il tipo di destinazione di 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);

Indietro

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

Recupera l'elenco degli editor per questo Form.

Indietro

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

Indietro

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 elemento 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 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

Nome	Tipo	Descrizione
`id`	`Integer`	L'ID dell'articolo.

Indietro

Item|null: 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 nel 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);

Indietro

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

Recupera 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

Nome	Tipo	Descrizione
`itemType`	`ItemType`	Il tipo di elementi da recuperare.

Indietro

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

`getPublishedReaders()`

Visualizza l'elenco di chi ha risposto a questo Form.

// 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 responders for the form.
const users = form.getPublishedReaders();
users.forEach(user => console.log(user.getEmail()));

Indietro

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

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

Restituisce 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);

Indietro

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

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

Parametri

Nome	Tipo	Descrizione
`responseId`	`String`	L'ID della risposta al modulo.

Indietro

FormResponse: la risposta al modulo.

Genera

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.

Indietro

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

Nome	Tipo	Descrizione
`timestamp`	`Date`	La data e l'ora meno recenti per cui devono essere restituite le risposte del modulo.

Indietro

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

`getShuffleQuestions()`

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

Indietro

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

Recupera 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 del modulo possono 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);

Indietro

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

Recupera 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);

Indietro

String: il 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 partecipante. Se il valore è true, lo script non può inviare risposte del modulo.

Indietro

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

Indietro

Boolean - true se il modulo mostra una barra di avanzamento; false se non la mostra.

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

`hasRespondAgainLink()`

Determina se il modulo mostra un link per inviare un'altra risposta dopo che un rispondente ha completato 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());

Indietro

Boolean - true se il modulo mostra un link "Invia un'altra risposta"; false se non lo mostra.

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 attualmente risposte. Questo valore viene sovrascritto quando viene modificato lo stato di pubblicazione 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 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);

Indietro

Boolean — true se il modulo accetta risposte; false se non le accetta.

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

`isPublished()`

Determina se il modulo è pubblicato.

Questa funzionalità è disponibile solo per i moduli che supportano la pubblicazione. Utilizza supportsAdvancedResponderPermissions() per verificare se il modulo supporta la pubblicazione.

// 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 whether the form is published or not and logs it to the console.
console.log(form.isPublished());

Indietro

Boolean: true se il modulo è pubblicato; false se non lo è.

Genera

Error: se viene chiamato su moduli non supportati.

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 un rispondente ha completato 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);

Indietro

Boolean — true se il modulo mostra un link "Visualizza risposte precedenti"; 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

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

Indietro

Boolean — true se il modulo accetta risposte; false se non le accetta.

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. Genera un'eccezione di scripting se l'indice to non rientra nei limiti.

// 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

Nome	Tipo	Descrizione
`from`	`Integer`	L'indice corrente dell'elemento tra tutti gli elementi del modulo.
`to`	`Integer`	Il nuovo indice dell'elemento tra tutti gli elementi del modulo.

Indietro

Item: l'elemento spostato.

Genera

Error: se uno dei due indici non rientra nei limiti.

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. Genera un'eccezione di scripting se l'indice specificato non rientra nei limiti.

// 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

Nome	Tipo	Descrizione
`item`	`Item`	L'elemento da spostare.
`toIndex`	`Integer`	Il nuovo indice dell'elemento tra tutti gli elementi del modulo.

Indietro

Item: l'elemento spostato.

Genera

Error: se l'indice non rientra nei limiti.

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 di risposta corrente. La destinazione precedente scollegata conserva comunque una copia di tutte le risposte precedenti. Tutti i moduli, inclusi quelli per cui non è impostata una destinazione in modo esplicito, salvano una copia delle risposte nell'archivio delle risposte del modulo. Se il modulo attualmente non ha una 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();

Indietro

Form: questo 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 che hanno accesso generale, ad esempio se Form è condiviso con l'intero dominio dell'utente 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 e dei rispondenti.

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Removes the editor from the form.
// TODO(developer): replace the emailAddress.
form.removeEditor('editor@uni.edu');

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da rimuovere.

Indietro

Form: questo 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)`

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

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const form1 = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the editors from the form.
const users = form1.getEditors();

// Opens another form.
// TODO(developer): Replace the URL with your own.
const form2 = FormApp.openByUrl('https://docs.google.com/forms/d/efg123456/edit');

// Removes editors from the form.
users.forEach(user => form2.removeEditor(user));

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da rimuovere.

Indietro

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

`removePublishedReader(emailAddress)`

Rimuove l'utente specificato dall'elenco dei rispondenti per il Form. Questo metodo non impedisce agli utenti di accedere a Form se appartengono a una classe di utenti che hanno accesso generale, ad esempio se Form è condiviso con l'intero dominio dell'utente 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 e degli editor.

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Removes the responders from the form.
// TODO(developer): replace the emailAddress.
form.removePublishedReader('responder1@uni.edu');

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da rimuovere.

Indietro

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

`removePublishedReader(user)`

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

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const form1 = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the responders from the form.
const users = form1.getPublishedReaders();

// Opens another form.
// TODO(developer): Replace the URL with your own.
const form2 = FormApp.openByUrl('https://docs.google.com/forms/d/efg123456/edit');

// Removes responders from the form.
users.forEach(user => form2.removePublishedReader(user));

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da rimuovere.

Indietro

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

`setAcceptingResponses(enabled)`

Indica se il modulo accetta attualmente risposte. Il valore predefinito per i nuovi moduli è true. Lo stato viene sovrascritto quando viene modificato lo stato di pubblicazione 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 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

Nome	Tipo	Descrizione
`enabled`	`Boolean`	`true` se il modulo deve accettare risposte; `false` se non deve.

Indietro

Form: questo Form, per il concatenamento.

Genera

Error: se attivato su un modulo non pubblicato.

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 mostra un link per modificare una risposta dopo l'invio. Il valore predefinito per i nuovi moduli è false.

Indipendentemente da questa impostazione, il metodo FormResponse.getEditResponseUrl() consente a un autore di script che dispone dell'autorizzazione di modifica del modulo di generare un URL che può essere utilizzato per modificare una risposta.

// 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

Nome	Tipo	Descrizione
`enabled`	`Boolean`	`true` se il modulo deve mostrare un link "Modifica la tua risposta"; `false` in caso contrario.

Indietro

Form: questo 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)`

Determina se il modulo raccoglie gli indirizzi email degli intervistati. 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',
);

// 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

Nome	Tipo	Descrizione
`collect`	`Boolean`	`true` se il modulo deve raccogliere indirizzi email; `false` se non deve farlo.

Indietro

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

Nome	Tipo	Descrizione
`message`	`String`	Il nuovo messaggio di conferma del modulo.

Indietro

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

Nome	Tipo	Descrizione
`message`	`String`	Il messaggio da visualizzare se il modulo non accetta risposte.

Indietro

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

Nome	Tipo	Descrizione
`description`	`String`	La nuova descrizione del modulo.

Indietro

Form: questo 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 per cui non è stata impostata esplicitamente una destinazione, salvano una copia delle risposte nell'archivio delle risposte del modulo.

Parametri

Nome	Tipo	Descrizione
`type`	`DestinationType`	Il tipo di destinazione di risposta del modulo.
`id`	`String`	L'ID della destinazione delle risposte del modulo.

Indietro

Form: questo Form, per il concatenamento.

Genera

Error: se l'ID destinazione specificato 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)`

Specifica se il modulo è un quiz. Il valore predefinito per i nuovi moduli è false.

Le domande con valutazione sono consentite solo nei quiz, quindi l'impostazione false comporta la rimozione di tutte le opzioni di valutazione da tutte le domande.

Le impostazioni del quiz sono disponibili solo nella nuova UI di Moduli; se un modulo viene trasformato in quiz, viene attivata 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

Nome	Tipo	Descrizione
`enabled`	`Boolean`	`true` se le funzionalità dei quiz devono essere abilitate per il modulo; `false` in caso contrario.

Indietro

Form: questo 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 partecipante. Il valore predefinito per i nuovi moduli è false. Se il valore è impostato su true, lo script non può inviare risposte al modulo.

Parametri

Nome	Tipo	Descrizione
`enabled`	`Boolean`	`true` se il modulo deve consentire una sola risposta per intervistato; `false` in caso contrario.

Indietro

Form: questo 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)`

Specifica 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

Nome	Tipo	Descrizione
`enabled`	`Boolean`	`true` se il modulo mostra una barra di avanzamento; `false` se non la mostra.

Indietro

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

`setPublished(enabled)`

Indica se il modulo è pubblicato. Il valore predefinito per i nuovi moduli è true.

Questa funzionalità è disponibile solo per i moduli che supportano la pubblicazione. Utilizza supportsAdvancedResponderPermissions() per verificare se il modulo supporta la pubblicazione.

Un modulo deve essere pubblicato per essere accessibile a chi risponde. Questo metodo sostituisce le chiamate a setAcceptingResponses(enabled).

// 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',
);

// Publishes the form before sharing it.
form.setPublished(true);

// Checks whether the form is published or not and logs it to the console.
console.log(form.isPublished());

Parametri

Nome	Tipo	Descrizione
`enabled`	`Boolean`	`true` se il modulo deve essere pubblicato, `false` in caso contrario.

Indietro

Form: questo Form, per il concatenamento.

Genera

Error: se viene chiamato su moduli non supportati.

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 mostra un link per visualizzare un riepilogo delle risposte dopo che un utente ha inviato il modulo. Il valore predefinito per i nuovi moduli è false.

Parametri

Nome	Tipo	Descrizione
`enabled`	`Boolean`	`true` se il modulo deve mostrare un link "Visualizza risposte precedenti"; `false` in caso contrario.

Indietro

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

`setShowLinkToRespondAgain(enabled)`

Imposta se il modulo mostra un link per inviare un'altra risposta dopo che un rispondente ha completato il modulo. Il valore predefinito per i nuovi moduli è true.

Parametri

Nome	Tipo	Descrizione
`enabled`	`Boolean`	`true` se il modulo deve visualizzare un link "Invia un'altra risposta"; `false` in caso contrario.

Indietro

Form: questo 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)`

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

Parametri

Nome	Tipo	Descrizione
`shuffle`	`Boolean`	`true` se l'ordine delle domande in ogni pagina del modulo deve essere randomizzato; `false` in caso contrario.

Indietro

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

Nome	Tipo	Descrizione
`title`	`String`	Il nuovo titolo del modulo.

Indietro

Form: questo 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 un URL lungo per un modulo in un URL breve. Genera un'eccezione se l'URL lungo non appartiene a Moduli Google.

Parametri

Nome	Tipo	Descrizione
`url`	`String`	L'URL da abbreviare.

Indietro

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 del modulo specificate.

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

Parametri

Nome	Tipo	Descrizione
`responses`	`FormResponse[]`	Un array di tutte le risposte del modulo.

Indietro

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

`supportsAdvancedResponderPermissions()`

Determina se il modulo supporta la pubblicazione. Questo metodo viene utilizzato per determinare se sono disponibili i metodi setPublished(enabled) e isPublished() e le autorizzazioni del risponditore.

// 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 whether the form supports publishing or not and logs it to the
// console.
console.log(form.supportsAdvancedResponderPermissions());

Indietro

Boolean: true se il modulo supporta la pubblicazione; false se non la supporta.

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

Metodi ritirati

`requiresLogin()`

Deprecato. Questa funzione è obsoleta e non deve essere utilizzata nei nuovi script.

Determina se il modulo richiede agli intervistati di accedere a un account nello stesso dominio o in 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);

Indietro

Boolean: true se il modulo richiede l'accesso degli utenti; false se non lo richiede.

`setRequireLogin(requireLogin)`

Deprecato. Questa funzione è obsoleta e non deve essere utilizzata nei nuovi script.

Imposta se il modulo richiede agli intervistati di accedere a un account nello stesso dominio o in un sottodominio prima di rispondere. Il valore predefinito per i nuovi moduli è false, a meno che un amministratore di dominio non lo modifichi.

Questa funzionalità è disponibile solo per i moduli creati dagli utenti di Google Workspace. Non è possibile richiedere l'accesso per gli utenti di altri tipi di Account Google.

// 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

Nome	Tipo	Descrizione
`requireLogin`	`Boolean`	`true` se il modulo richiede l'accesso degli utenti; `false` se non lo richiede.

Indietro

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

Class Form Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Metodi

Metodi ritirati

Documentazione dettagliata

addCheckboxGridItem()

Indietro

Autorizzazione

addCheckboxItem()

Indietro

Autorizzazione

addDateItem()

Indietro

Autorizzazione

addDateTimeItem()

Indietro

Autorizzazione

addDurationItem()

Indietro

Autorizzazione

addEditor(emailAddress)

Parametri

Indietro

Autorizzazione

addEditor(user)

Parametri

Indietro

Autorizzazione

addEditors(emailAddresses)

Parametri

Indietro

Autorizzazione

addGridItem()

Indietro

Autorizzazione

addImageItem()

Indietro

Autorizzazione

addListItem()

Indietro

Autorizzazione

addMultipleChoiceItem()

Indietro

Autorizzazione

addPageBreakItem()

Indietro

Autorizzazione

addParagraphTextItem()

Indietro

Autorizzazione

addPublishedReader(emailAddress)

Parametri

Indietro

Autorizzazione

addPublishedReader(user)

Parametri

Indietro

Autorizzazione

addPublishedReaders(emailAddresses)

Parametri

Indietro

Autorizzazione

addRatingItem()

Indietro

Autorizzazione

addScaleItem()

Indietro

Autorizzazione

addSectionHeaderItem()

Indietro

Autorizzazione

addTextItem()

Indietro

Autorizzazione

addTimeItem()

Indietro

Autorizzazione

addVideoItem()

Indietro

Autorizzazione

canEditResponse()

Class Form

`addCheckboxGridItem()`

`addCheckboxItem()`

`addDateItem()`

`addDateTimeItem()`

`addDurationItem()`

`addEditor(emailAddress)`

`addEditor(user)`

`addEditors(emailAddresses)`

`addGridItem()`

`addImageItem()`

`addListItem()`

`addMultipleChoiceItem()`

`addPageBreakItem()`

`addParagraphTextItem()`

`addPublishedReader(emailAddress)`

`addPublishedReader(user)`

`addPublishedReaders(emailAddresses)`

`addRatingItem()`

`addScaleItem()`

`addSectionHeaderItem()`

`addTextItem()`

`addTimeItem()`

`addVideoItem()`

`canEditResponse()`

`collectsEmail()`

`createResponse()`

`deleteAllResponses()`

`deleteItem(index)`

`deleteItem(item)`

`deleteResponse(responseId)`

`getConfirmationMessage()`

`getCustomClosedFormMessage()`

`getDescription()`

`getDestinationId()`

`getDestinationType()`

`getEditUrl()`

`getEditors()`

`getId()`

`getItemById(id)`

`getItems()`

`getItems(itemType)`

`getPublishedReaders()`

`getPublishedUrl()`

`getResponse(responseId)`

`getResponses()`