Un modulo che contiene proprietà ed elementi generali. Le proprietà includono titolo, impostazioni e
dove vengono archiviate le risposte. Gli elementi includono domande come caselle di controllo o elementi di opzione, mentre
gli elementi di layout fanno riferimento 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. 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
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
addCheckboxGridItem() | CheckboxGridItem | Aggiunge un nuovo elemento di domanda, presentato come griglia di colonne e righe, che consente al intervistato di selezionare più opzioni per riga da una sequenza di caselle di controllo. |
addCheckboxItem() | CheckboxItem | Aggiunge un nuovo elemento di domanda che consente all'intervistato di selezionare una o più caselle di controllo, nonché un campo "altro" facoltativo. |
addDateItem() | DateItem | Aggiunge un nuovo elemento di domanda che consente al partecipante di indicare una data. |
addDateTimeItem() | DateTimeItem | Aggiunge un nuovo elemento di domanda che consente al partecipante di indicare una data e un'ora. |
addDurationItem() | DurationItem | Aggiunge un nuovo elemento di domanda che consente al partecipante 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 specificato di utenti all'elenco degli editor per Form . |
addGridItem() | GridItem | Aggiunge un nuovo elemento di domanda, presentato come griglia di colonne e righe, che consente al risponditore di selezionare una scelta per riga da una sequenza di pulsanti di opzione. |
addImageItem() | ImageItem | Aggiunge un nuovo elemento del layout che mostra un'immagine. |
addListItem() | ListItem | Aggiunge un nuovo elemento di domanda che consente al partecipante di selezionare una scelta da un elenco a discesa. |
addMultipleChoiceItem() | MultipleChoiceItem | Aggiunge un nuovo elemento a 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 del layout che contrassegna l'inizio di una pagina. |
addParagraphTextItem() | ParagraphTextItem | Aggiunge un nuovo elemento a domanda che consente all'intervistato di inserire un blocco di testo. |
addScaleItem() | ScaleItem | Aggiunge un nuovo elemento di domanda che consente al partecipante di scegliere un'opzione da una sequenza numerata di pulsanti di opzione. |
addSectionHeaderItem() | SectionHeaderItem | Aggiunge un nuovo elemento del layout che indica visivamente l'inizio di una sezione. |
addTextItem() | TextItem | Aggiunge un nuovo elemento di domanda che consente all'intervistato di inserire una singola riga di testo. |
addTimeItem() | TimeItem | Aggiunge un nuovo elemento di domanda che consente al partecipante di indicare un'ora del giorno. |
addVideoItem() | VideoItem | Viene aggiunto un nuovo elemento di layout che mostra un video. |
canEditResponse() | Boolean | Determina se il modulo mostra un link per modificare una risposta dopo averla inviata. |
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 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 risposte del modulo. |
getConfirmationMessage() | String | Visualizza il messaggio di conferma del modulo. |
getCustomClosedFormMessage() | String | Restituisce il messaggio personalizzato che viene visualizzato se il modulo non accetta risposte o una stringa vuota se non è impostato alcun messaggio personalizzato. |
getDescription() | String | Restituisce la descrizione del modulo. |
getDestinationId() | String | Restituisce l'ID della destinazione di risposta 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[] | Consente di acquisire l'elenco degli editor di Form . |
getId() | String | Consente di acquisire l'ID del modulo. |
getItemById(id) | Item | Recupera l'elemento con un determinato ID. |
getItems() | Item[] | Restituisce un array di tutti gli elementi nel modulo. |
getItems(itemType) | Item[] | Restituisce un array di tutti gli elementi di un determinato tipo. |
getPublishedUrl() | String | Recupera l'URL che può essere utilizzato per rispondere al modulo. |
getResponse(responseId) | FormResponse | Restituisce una singola risposta del 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 è randomizzato. |
getSummaryUrl() | String | Restituisce l'URL che può essere utilizzato per visualizzare un riepilogo delle risposte del modulo. |
getTitle() | String | Restituisce il titolo del modulo. |
hasLimitOneResponsePerUser() | Boolean | Determina se il modulo consente una sola risposta per intervistato. |
hasProgressBar() | Boolean | Determina se nel modulo viene visualizzata una barra di avanzamento. |
hasRespondAgainLink() | Boolean | Determina se il modulo mostra un link per inviare un'altra risposta dopo che l'intervistato lo completa. |
isAcceptingResponses() | Boolean | Determina se al momento il modulo accetta risposte. |
isPublishingSummary() | Boolean | Determina se il modulo mostra un link per visualizzare un riepilogo delle risposte dopo che l'intervistato 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 a un altro indice specifico. |
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 attuale. |
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 . |
requiresLogin() | Boolean | Determina se il modulo richiede agli intervistati di accedere a un account nello stesso dominio o a un sottodominio prima di rispondere. |
setAcceptingResponses(enabled) | Form | Consente di impostare se il modulo accetta attualmente risposte. |
setAllowResponseEdits(enabled) | Form | Consente di impostare se il modulo deve mostrare un link per modificare una risposta dopo averla inviata. |
setCollectEmail(collect) | Form | Consente di impostare 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 | Consente di impostare se il modulo è un quiz. |
setLimitOneResponsePerUser(enabled) | Form | Consente di impostare se il modulo consente una sola risposta per intervistato. |
setProgressBar(enabled) | Form | Consente di impostare se il modulo ha una barra di avanzamento. |
setPublishingSummary(enabled) | Form | Consente di impostare se il modulo deve mostrare un link per visualizzare un riepilogo delle risposte dopo che l'intervistato lo ha inviato. |
setRequireLogin(requireLogin) | Form | Consente di impostare se il modulo richiede agli intervistati di accedere a un account nello stesso dominio o a un sottodominio prima di rispondere. |
setShowLinkToRespondAgain(enabled) | Form | Consente di impostare se il modulo mostra un link per inviare un'altra risposta dopo che l'intervistato lo completa. |
setShuffleQuestions(shuffle) | Form | Consente di stabilire 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 fornite. |
Documentazione dettagliata
addCheckboxGridItem()
Aggiunge un nuovo elemento di domanda, presentato come griglia di colonne e righe, che consente al 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']);
Ritorni
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 di domanda che consente all'intervistato 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']);
Ritorni
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 di domanda che consente al partecipante 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.');
Ritorni
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 di 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);
Ritorni
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 di domanda che consente al partecipante 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);
Ritorni
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à
nell'elenco degli spettatori, scegli questo metodo per escluderlo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente da aggiungere. |
Ritorni
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à
nell'elenco degli spettatori, scegli questo metodo per escluderlo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente da aggiungere. |
Ritorni
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 specificato di utenti all'elenco degli editor per Form
. Se uno degli utenti era già presente nell'elenco degli spettatori, questo metodo lo promuove fuori dall'elenco degli spettatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddresses | String[] | Un array di indirizzi email degli utenti da aggiungere. |
Ritorni
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 di domanda, presentato come griglia di colonne e righe, che consente al risponditore 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']);
Ritorni
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 del 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);
Ritorni
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 al partecipante 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') ]);
Ritorni
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 a 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]);
Ritorni
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 del 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);
Ritorni
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 a 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?');
Ritorni
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()
Aggiunge un nuovo elemento di domanda che consente al partecipante 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');
Ritorni
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 del 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');
Ritorni
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 di domanda che consente all'intervistato 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?');
Ritorni
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 di domanda che consente al partecipante 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?');
Ritorni
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()
Viene aggiunto 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);
Ritorni
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 averla inviata.
Indipendentemente da questa impostazione, il metodo FormResponse.getEditResponseUrl()
consente all'autore dello script con accesso in modifica al modulo di generare un URL che possa 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);
Ritorni
Boolean
: true
se il modulo mostra un link "Modifica la tua risposta"; 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
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);
Ritorni
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 elemento ItemResponse
dall'elemento, quindi allegalo alla risposta di questo modulo chiamando FormResponse.withItemResponse(response)
. Per salvare la risposta assemblata, chiama FormResponse.submit()
.
Ritorni
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 le copie delle risposte archiviate in una destinazione di risposta esterna (come un foglio di lavoro), ma cancella la visualizzazione di riepilogo del modulo.
Ritorni
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 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
Nome | Tipo | Descrizione |
---|---|---|
index | Integer | L'indice dell'elemento tra tutti gli elementi nel modulo. |
Tiri
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 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. |
Tiri
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 risposte del modulo. Questo metodo non elimina le copie delle risposte archiviate in una destinazione di risposta esterna (come un foglio di lavoro), ma rimuove la risposta dalla visualizzazione di riepilogo del modulo. L'ID risposta può essere recuperato con FormResponse.getId()
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
responseId | String | L'ID della risposta del modulo da eliminare. |
Ritorni
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()
Visualizza 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);
Ritorni
String
: 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()
Restituisce il messaggio personalizzato che viene 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);
Ritorni
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()
Restituisce 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);
Ritorni
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()
Restituisce l'ID della 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/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);
Ritorni
String
: l'ID della 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
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);
Ritorni
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);
Ritorni
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()
Consente di acquisire l'elenco degli editor di Form
.
Ritorni
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()
Consente di acquisire 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);
Ritorni
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 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 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'elemento. |
Ritorni
Item
: l'elemento con l'ID specificato oppure 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);
Ritorni
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
Nome | Tipo | Descrizione |
---|---|---|
itemType | ItemType | Il tipo di elementi da recuperare. |
Ritorni
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);
Ritorni
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)
Restituisce una singola risposta del modulo in base al relativo ID risposta. Gli ID risposta possono essere recuperati da FormResponse.getId()
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
responseId | String | L'ID per la risposta del modulo. |
Ritorni
FormResponse
: la risposta del modulo.
Tiri
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.
Ritorni
FormResponse[]
: 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 in cui devono essere restituite le risposte del modulo. |
Ritorni
FormResponse[]
: l'elenco 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
getShuffleQuestions()
Determina se l'ordine delle domande in ogni pagina del modulo è randomizzato.
Ritorni
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()
Restituisce 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 il 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);
Ritorni
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()
Restituisce 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);
Ritorni
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.
Ritorni
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 nel modulo viene visualizzata 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());
Ritorni
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
hasRespondAgainLink()
Determina se il modulo mostra un link per inviare un'altra risposta dopo che l'intervistato lo completa.
// 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());
Ritorni
Boolean
: true
se il modulo mostra un link "Invia un'altra risposta"; 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
isAcceptingResponses()
Determina se al momento 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);
Ritorni
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 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);
Ritorni
Boolean
: true
se il modulo mostra un link "Vedi le 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());
Ritorni
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 a un altro indice specifico. Genera un'eccezione di script 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
Nome | Tipo | Descrizione |
---|---|---|
from | Integer | L'indice corrente dell'elemento tra tutti gli elementi nel modulo. |
to | Integer | Il nuovo indice dell'elemento tra tutti gli elementi nel modulo. |
Ritorni
Item
: l'elemento spostato.
Tiri
Error
: se uno dei due indici è fuori dai 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 relativa agli script se l'indice specificato è fuori dai 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 nel modulo. |
Ritorni
Item
: l'elemento spostato.
Tiri
Error
: se l'indice è fuori dai 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 attuale. La destinazione precedente scollegata conserva ancora una copia di tutte le risposte precedenti. Tutti i moduli, inclusi quelli che non hanno una destinazione impostata esplicitamente, salvano una copia delle risposte nell'archivio delle risposte del modulo. Se al momento il modulo 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();
Ritorni
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 con accesso generale, ad esempio se Form
è condiviso con l'intero dominio dell'utente o se Form
si trova su un Drive condiviso a cui l'utente può accedere.
Per i file di Drive, l'utente viene rimosso anche dall'elenco dei visualizzatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente da rimuovere. |
Ritorni
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)
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
è condiviso con l'intero dominio dell'utente o se Form
si trova su un Drive condiviso a cui l'utente può accedere.
Per i file di Drive, l'utente viene rimosso anche dall'elenco dei visualizzatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente da rimuovere. |
Ritorni
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
requiresLogin()
Determina se il modulo richiede agli intervistati di accedere a un account nello stesso dominio o a 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);
Ritorni
Boolean
: true
se il modulo richiede l'accesso da parte degli utenti; false
in caso contrario.
setAcceptingResponses(enabled)
Consente di impostare se il modulo accetta attualmente 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
Nome | Tipo | Descrizione |
---|---|---|
enabled | Boolean | true se il modulo deve accettare risposte; false se non deve. |
Ritorni
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
setAllowResponseEdits(enabled)
Consente di impostare se il modulo deve mostrare un link per modificare una risposta dopo averla inviata. Il valore predefinito per i nuovi moduli è false
.
Indipendentemente da questa impostazione, il metodo FormResponse.getEditResponseUrl()
consente all'autore dello script con autorizzazione di modifica del modulo di generare un URL che possa 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 contenere un link "Modifica la tua risposta"; false in caso contrario. |
Ritorni
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)
Consente di impostare 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 gli indirizzi email; false in caso contrario. |
Ritorni
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. |
Ritorni
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 è 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. |
Ritorni
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. |
Ritorni
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 che non hanno una destinazione impostata esplicitamente, salvano una copia delle risposte nell'archivio risposte del modulo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
type | DestinationType | Il tipo di destinazione di risposta del modulo. |
id | String | L'ID della destinazione di risposta del modulo. |
Ritorni
Form
- Questo Form
, per il concatenamento.
Tiri
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)
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 questa opzione su false
comporta la rimozione di tutte
le opzioni di valutazione da tutte le domande.
Le impostazioni dei quiz sono disponibili solo nella nuova interfaccia utente di Moduli. La creazione di un modulo ne consente l'attivazione utilizzando la nuova interfaccia utente.
// 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 attivate per il modulo; false in caso contrario. |
Ritorni
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)
Consente di impostare se il modulo consente una sola risposta per intervistato. Il valore predefinito per i nuovi moduli è
false
. Se il valore è impostato su true
, lo script non può inviare risposte del modulo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
enabled | Boolean | true se il modulo deve consentire una sola risposta per intervistato; false in caso contrario. |
Ritorni
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)
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
Nome | Tipo | Descrizione |
---|---|---|
enabled | Boolean | true se il modulo mostra una barra di avanzamento; false in caso contrario. |
Ritorni
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
setPublishingSummary(enabled)
Consente di impostare se il modulo deve mostrare un link per visualizzare un riepilogo delle risposte dopo che l'intervistato lo ha inviato. Il valore predefinito per i nuovi moduli è false
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
enabled | Boolean | true se il modulo deve visualizzare un link "Visualizza le risposte precedenti"; false in caso contrario. |
Ritorni
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
setRequireLogin(requireLogin)
Consente di impostare se il modulo richiede agli intervistati di accedere a un account nello stesso dominio o a 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. Agli utenti di altri tipi di Account Google non può essere richiesto di eseguire l'accesso.
// 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 in caso contrario. |
Ritorni
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)
Consente di impostare se il modulo mostra un link per inviare un'altra risposta dopo che l'intervistato lo completa. Il valore predefinito per i nuovi moduli è true
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
enabled | Boolean | true se il modulo deve contenere un link "Invia un'altra risposta"; false in caso contrario. |
Ritorni
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)
Consente di stabilire 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. |
Ritorni
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. |
Ritorni
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. |
Ritorni
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 fornite.
Se il codice include un trigger onFormSubmit
, la chiamata di submitGrades()
attiva la condizione onFormSubmit
e causa un ciclo infinito. Per evitare il ciclo infinito, aggiungi un codice che verifichi se esistono già voti prima di chiamare submitGrades()
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
responses | FormResponse[] | Un array di tutte le risposte del modulo. |
Ritorni
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