Formularz zawierający ogólne właściwości i elementy. Właściwości obejmują tytuł, ustawienia i miejsce
odpowiedzi są zapisywane. Elementy obejmują pytania, takie jak pola wyboru lub opcje,
elementy odnoszą się na przykład do podziałów stron. Formularze są dostępne i tworzone na koncie 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());
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
addCheckboxGridItem() | CheckboxGridItem | Dodaje nowy element pytania, prezentowany w postaci siatki kolumn i wierszy, co umożliwia zaznaczania wielu opcji wyboru w każdym wierszu z sekwencji pól wyboru. |
addCheckboxItem() | CheckboxItem | Dodaje nowy element pytania, który umożliwia respondentowi zaznaczenie co najmniej jednego pola wyboru, jak oraz opcjonalnie „inne”, . |
addDateItem() | DateItem | Dodaje nowy element pytania, który umożliwia respondentowi wskazanie daty. |
addDateTimeItem() | DateTimeItem | Dodaje nowy element pytania, który umożliwia respondentowi wskazanie daty i godziny. |
addDurationItem() | DurationItem | Dodaje nowy element pytania, który umożliwia respondentowi wskazanie długości czasu. |
addEditor(emailAddress) | Form | Dodaje danego użytkownika do listy edytorów zasobu Form . |
addEditor(user) | Form | Dodaje danego użytkownika do listy edytorów zasobu Form . |
addEditors(emailAddresses) | Form | Dodaje podaną tablicę użytkowników do listy edytorów zasobu Form . |
addGridItem() | GridItem | Dodaje nowy element pytania, prezentowany w postaci siatki kolumn i wierszy, co umożliwia w celu wybrania jednej opcji w każdym wierszu z sekwencji przycisków opcji. |
addImageItem() | ImageItem | Dodaje nowy element układu, który wyświetla obraz. |
addListItem() | ListItem | Dodaje nowy element pytania, który umożliwia respondentowi wybranie jednej odpowiedzi z menu z listy. |
addMultipleChoiceItem() | MultipleChoiceItem | Dodaje nowy element pytania, który umożliwia respondentowi wybranie jednej odpowiedzi z listy opcji. lub opcjonalny przycisk „Inne”, . |
addPageBreakItem() | PageBreakItem | Dodaje nowy element układu, który oznacza początek strony. |
addParagraphTextItem() | ParagraphTextItem | Dodaje nowy element pytania, który umożliwia respondentowi wpisanie bloku tekstu. |
addScaleItem() | ScaleItem | Dodaje nowy element pytania, który pozwala respondentowi wybrać jedną opcję z ponumerowanych kolejność przycisków opcji. |
addSectionHeaderItem() | SectionHeaderItem | Dodaje nowy element układu, który wizualnie pokazuje początek sekcji. |
addTextItem() | TextItem | Dodaje nowy element pytania, który umożliwia respondentowi wpisanie jednego wiersza tekstu. |
addTimeItem() | TimeItem | Dodaje nowy element pytania, który umożliwia respondentowi wskazanie pory dnia. |
addVideoItem() | VideoItem | Dodaje nowy element układu, który wyświetla film. |
canEditResponse() | Boolean | Określa, czy w formularzu ma być wyświetlany link umożliwiający edycję odpowiedzi po jej przesłaniu. |
collectsEmail() | Boolean | Określa, czy formularz zbiera dane od respondentów adresy e-mail. |
createResponse() | FormResponse | Tworzy nową odpowiedź w formularzu. |
deleteAllResponses() | Form | Usuwa wszystkie przesłane odpowiedzi z magazynu odpowiedzi formularza. |
deleteItem(index) | void | Usuwa element w danym indeksie spośród wszystkich elementów formularza. |
deleteItem(item) | void | Usuwa dany element. |
deleteResponse(responseId) | Form | Usuwa pojedynczą odpowiedź z magazynu odpowiedzi formularza. |
getConfirmationMessage() | String | Pobiera komunikat z potwierdzeniem formularza. |
getCustomClosedFormMessage() | String | Pobiera komunikat niestandardowy, który jest wyświetlany, jeśli formularz nie przyjmuje odpowiedzi lub jest pusty jest to ciąg znaków, jeśli nie ustawiono komunikatu niestandardowego. |
getDescription() | String | Pobiera opis formularza. |
getDestinationId() | String | Pobiera identyfikator miejsca docelowego odpowiedzi formularza. |
getDestinationType() | DestinationType | Pobiera typ miejsca docelowego odpowiedzi formularza. |
getEditUrl() | String | Pobiera adres URL, którego można użyć, aby uzyskać dostęp do trybu edycji formularza. |
getEditors() | User[] | Pobiera listę edytorów elementu Form . |
getId() | String | Pobiera identyfikator formularza. |
getItemById(id) | Item | Pobiera produkt o podanym identyfikatorze. |
getItems() | Item[] | Pobiera tablicę ze wszystkimi elementami formularza. |
getItems(itemType) | Item[] | Pobiera tablicę ze wszystkimi elementami danego typu. |
getPublishedUrl() | String | Pobiera adres URL, którego można użyć do udzielenia odpowiedzi na formularz. |
getResponse(responseId) | FormResponse | Pobiera odpowiedź z pojedynczego formularza na podstawie jej identyfikatora. |
getResponses() | FormResponse[] | Pobiera tablicę wszystkich odpowiedzi formularza. |
getResponses(timestamp) | FormResponse[] | Pobiera tablicę wszystkich odpowiedzi formularza po określonej dacie i godzinie. |
getShuffleQuestions() | Boolean | Określa, czy kolejność pytań na każdej stronie formularza jest losowa. |
getSummaryUrl() | String | Pobiera adres URL, którego można użyć do wyświetlenia podsumowania odpowiedzi z formularza. |
getTitle() | String | Pobiera tytuł formularza. |
hasLimitOneResponsePerUser() | Boolean | Określa, czy każdy użytkownik może odpowiedzieć tylko na 1 odpowiedź w formularzu. |
hasProgressBar() | Boolean | Określa, czy formularz ma wyświetlać pasek postępu. |
hasRespondAgainLink() | Boolean | Określa, czy w formularzu wyświetla się link umożliwiający przesłanie kolejnej odpowiedzi po użytkowniku wypełnia formularz. |
isAcceptingResponses() | Boolean | Określa, czy formularz przyjmuje obecnie odpowiedzi. |
isPublishingSummary() | Boolean | Określa, czy formularz ma wyświetlać link wyświetlający podsumowanie odpowiedzi po użytkowniku wypełnia formularz. |
isQuiz() | Boolean | Określa, czy formularz jest testem. |
moveItem(from, to) | Item | Przenosi element o danym indeksie między wszystkimi elementami w formularzu do innego danego indeksu. |
moveItem(item, toIndex) | Item | Przenosi dany element do danego indeksu wśród wszystkich elementów w formularzu. |
removeDestination() | Form | Odłącza formularz od bieżącego miejsca docelowego odpowiedzi. |
removeEditor(emailAddress) | Form | Usuwa danego użytkownika z listy edytorów zasobu Form . |
removeEditor(user) | Form | Usuwa danego użytkownika z listy edytorów zasobu Form . |
requiresLogin() | Boolean | Określa, czy formularz wymaga od respondentów logowania się na konto w tej samej domenie, czy subdomenę. |
setAcceptingResponses(enabled) | Form | Określa, czy formularz przyjmuje obecnie odpowiedzi. |
setAllowResponseEdits(enabled) | Form | Określa, czy w formularzu ma być wyświetlany link do edytowania odpowiedzi po jej przesłaniu. |
setCollectEmail(collect) | Form | Określa, czy formularz ma zbierać dane od respondentów adresy e-mail. |
setConfirmationMessage(message) | Form | Ustawia komunikat z potwierdzeniem formularza. |
setCustomClosedFormMessage(message) | Form | Ustawia komunikat wyświetlany, gdy formularz nie przyjmuje odpowiedzi. |
setDescription(description) | Form | Ustawia opis formularza. |
setDestination(type, id) | Form | Określa miejsce, w którym są zapisywane odpowiedzi z formularza. |
setIsQuiz(enabled) | Form | Określa, czy formularz ma być testem. |
setLimitOneResponsePerUser(enabled) | Form | Określa, czy w formularzu każdy użytkownik może udzielić tylko jednej odpowiedzi. |
setProgressBar(enabled) | Form | Określa, czy formularz ma pasek postępu. |
setPublishingSummary(enabled) | Form | Określa, czy w formularzu ma być wyświetlany link do podsumowania odpowiedzi po przesłaniu przez użytkownika formularza. |
setRequireLogin(requireLogin) | Form | Określa, czy formularz wymaga od respondentów logowania się na konto w tej samej domenie czy zanim na nie odpowiesz. |
setShowLinkToRespondAgain(enabled) | Form | Określa, czy w formularzu ma być wyświetlany link umożliwiający przesłanie kolejnej odpowiedzi po wypełnieniu formularza przez użytkownika formularza. |
setShuffleQuestions(shuffle) | Form | Określa, czy kolejność pytań na każdej stronie formularza ma być losowa. |
setTitle(title) | Form | Ustawia tytuł formularza. |
shortenFormUrl(url) | String | Konwertuje długi adres URL formularza na krótki adres URL. |
submitGrades(responses) | Form | Przesyła oceny dla podanych odpowiedzi Form. |
Szczegółowa dokumentacja
addCheckboxGridItem()
Dodaje nowy element pytania, prezentowany w postaci siatki kolumn i wierszy, co umożliwia zaznaczania wielu opcji wyboru w każdym wierszu z sekwencji pól wyboru.
// 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']);
Powrót
CheckboxGridItem
– nowo utworzony element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addCheckboxItem()
Dodaje nowy element pytania, który umożliwia respondentowi zaznaczenie co najmniej jednego pola wyboru, jak oraz opcjonalnie „inne”, .
// 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']);
Powrót
CheckboxItem
– nowo utworzony element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addDateItem()
Dodaje nowy element pytania, który umożliwia respondentowi wskazanie daty.
// 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.');
Powrót
DateItem
– nowo utworzony element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addDateTimeItem()
Dodaje nowy element pytania, który umożliwia respondentowi wskazanie daty i godziny.
// 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);
Powrót
DateTimeItem
– nowo utworzony element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addDurationItem()
Dodaje nowy element pytania, który umożliwia respondentowi wskazanie długości czasu.
// 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);
Powrót
DurationItem
– nowo utworzony element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addEditor(emailAddress)
Dodaje danego użytkownika do listy edytorów zasobu Form
. Jeśli użytkownik był już
na liście widzów, ta metoda wycofuje użytkownika z listy widzów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | Adres e-mail użytkownika, którego chcesz dodać. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addEditor(user)
Dodaje danego użytkownika do listy edytorów zasobu Form
. Jeśli użytkownik był już
na liście widzów, ta metoda wycofuje użytkownika z listy widzów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika, który ma zostać dodany. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addEditors(emailAddresses)
Dodaje podaną tablicę użytkowników do listy edytorów zasobu Form
. Jeśli któryś z
Użytkownicy byli już na liście widzów, więc ta metoda powoduje wyeliminowanie ich z listy
widzów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddresses | String[] | Tablica adresów e-mail użytkowników do dodania. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addGridItem()
Dodaje nowy element pytania, prezentowany w postaci siatki kolumn i wierszy, co umożliwia w celu wybrania jednej opcji w każdym wierszu z sekwencji przycisków opcji.
// 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']);
Powrót
GridItem
– nowo utworzony element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addImageItem()
Dodaje nowy element układu, który wyświetla obraz.
// 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);
Powrót
ImageItem
– nowo utworzony element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addListItem()
Dodaje nowy element pytania, który umożliwia respondentowi wybranie jednej odpowiedzi z menu z listy.
// 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') ]);
Powrót
ListItem
– nowo utworzony element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addMultipleChoiceItem()
Dodaje nowy element pytania, który umożliwia respondentowi wybranie jednej odpowiedzi z listy opcji. lub opcjonalny przycisk „Inne”, .
// 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]);
Powrót
MultipleChoiceItem
– nowo utworzony element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addPageBreakItem()
Dodaje nowy element układu, który oznacza początek strony.
// 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);
Powrót
PageBreakItem
– nowo utworzony element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addParagraphTextItem()
Dodaje nowy element pytania, który umożliwia respondentowi wpisanie bloku tekstu.
// 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?');
Powrót
ParagraphTextItem
– nowo utworzony element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addScaleItem()
Dodaje nowy element pytania, który pozwala respondentowi wybrać jedną opcję z ponumerowanych kolejność przycisków opcji.
// 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');
Powrót
ScaleItem
– nowo utworzony element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addSectionHeaderItem()
Dodaje nowy element układu, który wizualnie pokazuje początek sekcji.
// 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');
Powrót
SectionHeaderItem
– nowo utworzony element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addTextItem()
Dodaje nowy element pytania, który umożliwia respondentowi wpisanie jednego wiersza tekstu.
// 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?');
Powrót
TextItem
– nowo utworzony element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addTimeItem()
Dodaje nowy element pytania, który umożliwia respondentowi wskazanie pory dnia.
// 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?');
Powrót
TimeItem
– nowo utworzony element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addVideoItem()
Dodaje nowy element układu, który wyświetla film.
// 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);
Powrót
VideoItem
– nowo utworzony element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
canEditResponse()
Określa, czy w formularzu ma być wyświetlany link umożliwiający edycję odpowiedzi po jej przesłaniu.
Niezależnie od tego ustawienia metoda FormResponse.getEditResponseUrl()
zezwala
autor skryptu, który ma uprawnienia do edycji formularza, by wygenerować URL umożliwiający edycję
.
// 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);
Powrót
Boolean
– true
, jeśli formularz zawiera opcję „Edytuj swoją odpowiedź” link; false
, jeśli:
nie działa.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
collectsEmail()
Określa, czy formularz zbiera dane od respondentów adresy e-mail.
// 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);
Powrót
Boolean
– true
, jeśli formularz zbiera adresy e-mail; false
.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse()
Tworzy nową odpowiedź w formularzu. Aby odpowiedzieć na pytanie, utwórz ItemResponse
z produktu, a następnie dołącz go do odpowiedzi na ten formularz, dzwoniąc pod numer FormResponse.withItemResponse(response)
. Aby zapisać utworzoną odpowiedź, wywołaj FormResponse.submit()
.
Powrót
FormResponse
– nowo utworzona odpowiedź z formularza.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
deleteAllResponses()
Usuwa wszystkie przesłane odpowiedzi z magazynu odpowiedzi formularza. Ta metoda nie usuwa kopii odpowiedzi zapisanych w zewnętrznym miejscu docelowym (np. w arkuszu kalkulacyjnym), ale nie wyczyścić widok podsumowania formularza.
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
deleteItem(index)
Usuwa element w danym indeksie spośród wszystkich elementów formularza. Zgłasza wyjątek skryptu .
// 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); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
index | Integer | Indeks elementu wśród wszystkich elementów w formularzu. |
Rzuty
Error
– jeśli w danym indeksie nie ma elementu,
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
deleteItem(item)
Usuwa dany element. Zgłasza wyjątek skryptu, jeśli element został już usunięty.
// 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); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
item | Item | Element do usunięcia. |
Rzuty
Error
– jeśli elementu nie ma w formularzu,
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
deleteResponse(responseId)
Usuwa pojedynczą odpowiedź z magazynu odpowiedzi formularza. Ta metoda nie usuwa kopii
odpowiedzi zapisanych w zewnętrznym miejscu docelowym odpowiedzi (np. w arkuszu kalkulacyjnym), ale usuwa
w widoku podsumowania formularza. Identyfikator odpowiedzi można pobrać za pomocą funkcji FormResponse.getId()
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
responseId | String | Identyfikator odpowiedzi na formularz, którą chcesz usunąć. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getConfirmationMessage()
Pobiera komunikat z potwierdzeniem formularza.
// 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);
Powrót
String
– wiadomość potwierdzająca treść formularza.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getCustomClosedFormMessage()
Pobiera komunikat niestandardowy, który jest wyświetlany, jeśli formularz nie przyjmuje odpowiedzi lub jest pusty jest to ciąg znaków, jeśli nie ustawiono komunikatu niestandardowego.
// 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);
Powrót
String
– komunikat niestandardowy wyświetlany, gdy formularz nie przyjmuje odpowiedzi lub jest pusty.
jest to ciąg znaków, jeśli nie ustawiono komunikatu niestandardowego.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getDescription()
Pobiera opis formularza.
// 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);
Powrót
String
– opis formularza.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getDestinationId()
Pobiera identyfikator miejsca docelowego odpowiedzi formularza.
// 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);
Powrót
String
– identyfikator miejsca docelowego odpowiedzi formularza.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getDestinationType()
Pobiera typ miejsca docelowego odpowiedzi formularza.
// 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);
Powrót
DestinationType
– typ miejsca docelowego odpowiedzi formularza.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getEditUrl()
Pobiera adres URL, którego można użyć, aby uzyskać dostęp do trybu edycji formularza.
// 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);
Powrót
String
– adres URL do edytowania formularza.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getEditors()
getId()
Pobiera identyfikator formularza.
// 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);
Powrót
String
– identyfikator formularza,
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getItemById(id)
Pobiera produkt o podanym identyfikatorze. Zwraca null
, jeśli identyfikator nie odpowiada elementowi w
formularza.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
id | Integer | Identyfikator produktu. |
Powrót
Item
– element o podanym identyfikatorze lub element null
, jeśli nie ma go w formularzu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getItems()
Pobiera tablicę ze wszystkimi elementami formularza.
// 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);
Powrót
Item[]
– tablica ze wszystkimi elementami w formularzu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getItems(itemType)
Pobiera tablicę ze wszystkimi elementami danego typu.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
itemType | ItemType | Typ elementów do pobrania. |
Powrót
Item[]
– tablica ze wszystkimi elementami danego typu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getPublishedUrl()
Pobiera adres URL, którego można użyć do udzielenia odpowiedzi na formularz.
// 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);
Powrót
String
– adres URL służący do odpowiadania na formularz.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getResponse(responseId)
Pobiera odpowiedź z pojedynczego formularza na podstawie jej identyfikatora. Identyfikatory odpowiedzi można pobrać z FormResponse.getId()
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
responseId | String | Identyfikator odpowiedzi w formularzu. |
Powrót
FormResponse
– odpowiedź na formularz.
Rzuty
Error
– jeśli odpowiedź nie istnieje;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getResponses()
Pobiera tablicę wszystkich odpowiedzi formularza.
Powrót
FormResponse[]
– tablica wszystkich odpowiedzi formularza.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getResponses(timestamp)
Pobiera tablicę wszystkich odpowiedzi formularza po określonej dacie i godzinie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
timestamp | Date | Data i godzina, dla których powinny zostać zwrócone odpowiedzi z formularza. |
Powrót
FormResponse[]
– lista odpowiedzi na pytania z formularza.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getShuffleQuestions()
Określa, czy kolejność pytań na każdej stronie formularza jest losowa.
Powrót
Boolean
– true
, jeśli kolejność pytań na każdej stronie formularza jest losowa;
false
.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getSummaryUrl()
Pobiera adres URL, którego można użyć do wyświetlenia podsumowania odpowiedzi z formularza. Jeśli setPublishingSummary(enabled)
nie ma ustawienia true
, tylko użytkownicy z uprawnieniami do edycji
formularz może uzyskać dostęp do tego adresu 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);
Powrót
String
– adres URL umożliwiający wyświetlanie podsumowania odpowiedzi.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Pobiera tytuł formularza.
// 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);
Powrót
String
– tytuł formularza,
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
hasLimitOneResponsePerUser()
Określa, czy każdy użytkownik może odpowiedzieć tylko na 1 odpowiedź w formularzu. Jeśli wartość to true
, skrypt w ogóle nie może przesyłać odpowiedzi na pytania z formularza.
Powrót
Boolean
– true
, jeśli formularz pozwala na użycie tylko jednej odpowiedzi na użytkownika; false
.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
hasProgressBar()
Określa, czy formularz ma wyświetlać pasek postępu.
// 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());
Powrót
Boolean
– true
, jeśli formularz zawiera pasek postępu; false
.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
hasRespondAgainLink()
Określa, czy w formularzu wyświetla się link umożliwiający przesłanie kolejnej odpowiedzi po użytkowniku wypełnia formularz.
// 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());
Powrót
Boolean
– true
, jeśli formularz zawiera opcję „Prześlij kolejną odpowiedź” link; false
, jeśli:
nie działa.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isAcceptingResponses()
Określa, czy formularz przyjmuje obecnie odpowiedzi.
// 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);
Powrót
Boolean
– true
, jeśli formularz przyjmuje odpowiedzi; false
.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isPublishingSummary()
Określa, czy formularz ma wyświetlać link wyświetlający podsumowanie odpowiedzi po użytkowniku wypełnia formularz.
// 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);
Powrót
Boolean
– true
, jeśli w formularzu wyświetla się opcja „Zobacz poprzednie odpowiedzi” link; false
, jeśli:
nie działa.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isQuiz()
Określa, czy formularz jest testem.
// 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());
Powrót
Boolean
– true
, jeśli formularz przyjmuje odpowiedzi; false
.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
moveItem(from, to)
Przenosi element o danym indeksie między wszystkimi elementami w formularzu do innego danego indeksu. Wyrzuca a
wyjątek skryptu, jeśli indeks to
jest poza zakresem.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
from | Integer | Bieżący indeks elementu wśród wszystkich elementów w formularzu. |
to | Integer | Nowy indeks elementu wśród wszystkich elementów w formularzu. |
Powrót
Item
– przeniesiony element.
Rzuty
Error
– jeśli jeden z indeksów jest poza zakresem.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
moveItem(item, toIndex)
Przenosi dany element do danego indeksu wśród wszystkich elementów w formularzu. Wykonuje skrypt. wyjątek, jeśli dany indeks jest poza zakresem.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
item | Item | Element do przeniesienia. |
toIndex | Integer | Nowy indeks elementu wśród wszystkich elementów w formularzu. |
Powrót
Item
– przeniesiony element.
Rzuty
Error
– jeśli indeks jest poza zakresem.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
removeDestination()
Odłącza formularz od bieżącego miejsca docelowego odpowiedzi. Odłączone poprzednie miejsce docelowe nadal jest aktywne zachowuje kopię wszystkich poprzednich odpowiedzi. Wszystkie formularze, w tym te, które nie zawierają atrybutu wyraźnie ustawione miejsce docelowe, zapisz w magazynie odpowiedzi formularza. Jeśli formularz nie zawiera obecnie miejsce docelowe odpowiedzi, ta metoda nie ma skutków.
// 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();
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
removeEditor(emailAddress)
Usuwa danego użytkownika z listy edytorów zasobu Form
. Ta metoda nie:
zablokuj dostęp do usługi Form
użytkownikom, którzy należą do klasy użytkowników, którzy
ogólny dostęp – na przykład jeśli domena Form
jest udostępniona całej domenie
domeny lub jeśli Form
znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.
W przypadku plików na Dysku spowoduje to też usunięcie użytkownika z listy przeglądających.
Parametry
Nazwa | Typ | Opis |
---|---|---|
emailAddress | String | Adres e-mail użytkownika, którego chcesz usunąć. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
removeEditor(user)
Usuwa danego użytkownika z listy edytorów zasobu Form
. Ta metoda nie:
zablokuj dostęp do usługi Form
użytkownikom, którzy należą do klasy użytkowników, którzy
ogólny dostęp – na przykład jeśli domena Form
jest udostępniona całej domenie
domeny lub jeśli Form
znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.
W przypadku plików na Dysku spowoduje to też usunięcie użytkownika z listy przeglądających.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika do usunięcia. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
requiresLogin()
Określa, czy formularz wymaga od respondentów logowania się na konto w tej samej domenie, czy subdomenę.
// 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);
Powrót
Boolean
– true
, jeśli formularz wymaga od użytkownika zalogowania się. false
.
setAcceptingResponses(enabled)
Określa, czy formularz przyjmuje obecnie odpowiedzi. Ustawienie domyślne nowych formularzy to 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());
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | true , jeśli formularz powinien przyjmować odpowiedzi; false , jeśli nie powinien. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setAllowResponseEdits(enabled)
Określa, czy w formularzu ma być wyświetlany link do edytowania odpowiedzi po jej przesłaniu. Domyślna wartość dla
nowe formularze: false
.
Niezależnie od tego ustawienia metoda FormResponse.getEditResponseUrl()
zezwala
autor skryptu, który ma uprawnienia do edycji formularza w celu wygenerowania adresu URL, który może służyć do edycji
.
// 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());
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | true , jeśli formularz powinien wyświetlać opcję „Edytuj swoją odpowiedź” link; false , jeśli nie. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setCollectEmail(collect)
Określa, czy formularz ma zbierać dane od respondentów adresy e-mail. Ustawienie domyślne nowych formularzy to
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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
collect | Boolean | true , jeśli formularz ma zbierać adresy e-mail; false , jeśli:
nie działa. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setConfirmationMessage(message)
Ustawia komunikat z potwierdzeniem formularza.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
message | String | Nowa wiadomość potwierdzająca formularz. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setCustomClosedFormMessage(message)
Ustawia komunikat wyświetlany, gdy formularz nie przyjmuje odpowiedzi. Jeśli nie zostanie ustawiony żaden komunikat, formularza używa wiadomości domyślnej.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
message | String | Komunikat wyświetlany, gdy formularz nie przyjmuje odpowiedzi. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setDescription(description)
Ustawia opis formularza.
Parametry
Nazwa | Typ | Opis |
---|---|---|
description | String | Nowy opis formularza. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setDestination(type, id)
Określa miejsce, w którym są zapisywane odpowiedzi z formularza. Wszystkie formularze, także te, które nie wyraźnie określić miejsce docelowe, zapisz kopie odpowiedzi w pliku .
Parametry
Nazwa | Typ | Opis |
---|---|---|
type | DestinationType | Typ miejsca docelowego odpowiedzi formularza. |
id | String | Identyfikator miejsca docelowego odpowiedzi formularza. |
Powrót
Rzuty
Error
– jeśli podany identyfikator miejsca docelowego jest nieprawidłowy.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setIsQuiz(enabled)
Określa, czy formularz ma być testem. Ustawienie domyślne nowych formularzy to false
.
Pytania ocenione są dozwolone tylko w Testach, więc ustawienie tej opcji na false
powoduje, że wszystkie
opcje oceniania, które zostaną usunięte ze wszystkich pytań.
Ustawienia testu są dostępne tylko w nowym interfejsie Formularzy. przekształcanie formularza w quiz do wykorzystania nowego interfejsu.
// 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());
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | true , jeśli funkcje testu mają być włączone w formularzu; false , jeśli
Nie. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setLimitOneResponsePerUser(enabled)
Określa, czy w formularzu każdy użytkownik może udzielić tylko jednej odpowiedzi. Ustawienie domyślne nowych formularzy to
false
Jeśli wartość jest ustawiona na true
, skrypt nie może przesyłać odpowiedzi na formularz na stronie
wszystko.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | true , jeśli formularz powinien zezwalać tylko na 1 odpowiedź; false , jeśli nie. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setProgressBar(enabled)
Określa, czy formularz ma pasek postępu. Ustawienie domyślne nowych formularzy to 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());
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | true , jeśli w formularzu jest wyświetlany pasek postępu; false . |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPublishingSummary(enabled)
Określa, czy w formularzu ma być wyświetlany link do podsumowania odpowiedzi po przesłaniu przez użytkownika
formularza. Ustawienie domyślne nowych formularzy to false
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | true , jeśli formularz powinien wyświetlać opcję „Zobacz poprzednie odpowiedzi” link; false , jeśli nie. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequireLogin(requireLogin)
Określa, czy formularz wymaga od respondentów logowania się na konto w tej samej domenie czy
zanim na nie odpowiesz. Ustawienie domyślne nowych formularzy to false
, chyba że domena
administrator zmienia wartość domyślną.
Ta funkcja jest dostępna tylko w przypadku formularzy utworzonych przez użytkowników Google Workspace. Użytkownicy innych usług określone typy kont Google nie mogą być wymagane do logowania.
// 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());
Parametry
Nazwa | Typ | Opis |
---|---|---|
requireLogin | Boolean | true , jeśli formularz wymaga od użytkowników zalogowania się. false , jeśli:
nie działa. |
Powrót
Form
– obecny format (do tworzenia łańcuchów).
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setShowLinkToRespondAgain(enabled)
Określa, czy w formularzu ma być wyświetlany link umożliwiający przesłanie kolejnej odpowiedzi po wypełnieniu formularza przez użytkownika
formularza. Ustawienie domyślne nowych formularzy to true
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | true , jeśli formularz powinien wyświetlać opcję „Prześlij kolejną odpowiedź” link; false , jeśli nie. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setShuffleQuestions(shuffle)
Określa, czy kolejność pytań na każdej stronie formularza ma być losowa.
Parametry
Nazwa | Typ | Opis |
---|---|---|
shuffle | Boolean | true , jeśli kolejność pytań na każdej stronie formularza powinna być
losowe; false , jeśli nie. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Ustawia tytuł formularza.
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | Nowy tytuł formularza. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
shortenFormUrl(url)
Konwertuje długi adres URL formularza na krótki adres URL. Zgłasza wyjątek, jeśli długi adres URL nie zawiera które są dostępne w Formularzach Google.
Parametry
Nazwa | Typ | Opis |
---|---|---|
url | String | Adres URL do skrócenia. |
Powrót
String
– adres URL w formacie http://goo.gl/forms/1234
.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
submitGrades(responses)
Przesyła oceny dla podanych odpowiedzi Form.
Jeśli kod zawiera regułę onFormSubmit
, wywołasz funkcję submitGrades()
wywołuje warunek onFormSubmit
i powoduje wykonanie pętli nieskończonej. Aby zapobiec
nieskończona pętla, dodaj kod, który sprawdza, czy oceny już istnieją, przed wywołaniem funkcji submitGrades()
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
responses | FormResponse[] | Tablica wszystkich odpowiedzi na formularz. |
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms