Formularz zawierający ogólne właściwości i elementy. Właściwości obejmują tytuł, ustawienia i miejsce przechowywania odpowiedzi. Elementy obejmują elementy pytania, takie jak pola wyboru lub opcje, a elementy układu odnoszą się do elementów takich jak przerwy strony. Formularze można tworzyć i otwierać w Form
.
// Open a form by ID and create a new spreadsheet. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const ss = SpreadsheetApp.create('Spreadsheet Name'); // Update form properties via chaining. form.setTitle('Form Name') .setDescription('Description of form') .setConfirmationMessage('Thanks for responding!') .setAllowResponseEdits(true) .setAcceptingResponses(false); // Update the form's response destination. form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId());
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
add | Checkbox | Dodaje nowy element pytania, który jest prezentowany jako siatka kolumn i wierszy i pozwala respondentowi wybrać kilka opcji na wiersz z kolejnych pól wyboru. |
add | Checkbox | Dodaje nowy element pytania, który umożliwia respondentowi zaznaczenie co najmniej 1 pola wyboru, a także opcjonalne pole „inne”. |
add | Date | Dodaje nowy element pytania, który umożliwia respondentowi wskazanie daty. |
add | Date | Dodaje nowy element pytania, który umożliwia respondentowi wskazanie daty i godziny. |
add | Duration | Dodaje nowy element pytania, który pozwala respondentowi wskazać długość czasu. |
add | Form | Dodaje danego użytkownika do listy edytujących Form . |
add | Form | Dodaje danego użytkownika do listy edytujących Form . |
add | Form | Dodaje podany tablicowy zbiór użytkowników do listy edytujących w przypadku Form . |
add | Grid | Dodaje nowy element pytania, który jest prezentowany jako siatka kolumn i wierszy i umożliwia respondentowi wybranie jednej opcji na wiersz z kolejności opcji w przyciskach wyboru. |
add | Image | Dodaje nowy element układu, który wyświetla obraz. |
add | List | Dodaje nowy element pytania, który umożliwia respondentowi wybranie jednej opcji z listy. |
add | Multiple | Dodaje nowy element pytania, który umożliwia respondentowi wybranie jednej opcji z listy przycisków opcji lub opcjonalnego pola „inne”. |
add | Page | Dodaje nowy element układu, który oznacza początek strony. |
add | Paragraph | Dodaje nowy element pytania, który umożliwia respondentowi wpisanie bloku tekstu. |
add | Rating | Dodaje nowy element pytania, który umożliwia respondentowi udzielenie oceny. |
add | Scale | Dodaje nowy element pytania, który umożliwia respondentowi wybranie jednej opcji z numerowanej sekwencji przycisków opcji. |
add | Section | Dodaje nowy element układu, który wizualnie wskazuje początek sekcji. |
add | Text | Dodaje nowy element pytania, który pozwala respondentowi wpisać pojedynczą linijkę tekstu. |
add | Time | Dodaje nowy element pytania, który pozwala respondentowi wskazać porę dnia. |
add | Video | Dodaje nowy element układu, który wyświetla film. |
can | Boolean | Określa, czy po przesłaniu odpowiedzi w formularzu ma być wyświetlany link do jej edycji. |
collects | Boolean | Określa, czy formularz ma zbierać adresy e-mail użytkowników. |
create | Form | Tworzy nową odpowiedź na formularz. |
delete | Form | usuwa wszystkie przesłane odpowiedzi z magazynu odpowiedzi formularza. |
delete | void | Usuwa element o danym indeksie spośród wszystkich elementów w formularzu. |
delete | void | Usuwa podany element. |
delete | Form | Usuwa pojedynczą odpowiedź z magazynu odpowiedzi formularza. |
get | String | Pobiera wiadomość potwierdzającą przesłanie formularza. |
get | String | Pobiera komunikat niestandardowy, który jest wyświetlany, jeśli formularz nie akceptuje odpowiedzi, lub pusty ciąg znaków, jeśli nie ustawiono komunikatu niestandardowego. |
get | String | Pobiera opis formularza. |
get | String | Pobiera identyfikator miejsca docelowego odpowiedzi formularza. |
get | Destination | Pobiera typ miejsca docelowego odpowiedzi formularza. |
get | String | Pobiera adres URL, którego można użyć do uzyskania dostępu do trybu edycji formularza. |
get | User[] | Pobiera listę edytorów tego Form . |
get | String | Pobiera identyfikator formularza. |
get | Item | Pobiera element o podanym identyfikatorze. |
get | Item[] | Pobiera tablicę wszystkich elementów formularza. |
get | Item[] | Pobiera tablicę wszystkich elementów danego typu. |
get | String | Pobiera adres URL, którego można użyć do odpowiedzi na formularz. |
get | Form | Pobiera odpowiedź na pojedynczy formularz na podstawie jego identyfikatora odpowiedzi. |
get | Form | Pobiera tablicę wszystkich odpowiedzi w formularzu. |
get | Form | Pobiera tablicę wszystkich odpowiedzi do formularza po podanej dacie i godzinie. |
get | Boolean | Określa, czy kolejność pytań na każdej stronie formularza jest losowa. |
get | String | Pobiera adres URL, którego można użyć do wyświetlenia podsumowania odpowiedzi na pytania w formularzu. |
get | String | Pobiera tytuł formularza. |
has | Boolean | Określa, czy formularz zezwala na tylko 1 odpowiedź na respondenta. |
has | Boolean | Określa, czy formularz wyświetla pasek postępu. |
has | Boolean | Określa, czy po wypełnieniu formularza przez respondenta wyświetlany jest link do przesyłania kolejnych odpowiedzi. |
is | Boolean | Określa, czy formularz obecnie przyjmuje odpowiedzi. |
is | Boolean | Określa, czy po wypełnieniu formularza przez respondenta wyświetlany jest link do podsumowania odpowiedzi. |
is | Boolean | Określa, czy formularz jest testem. |
move | Item | Przenosi element o danym indeksie spośród wszystkich elementów w formularzu na inny indeks. |
move | Item | Przenosi dany element na określony indeks wśród wszystkich elementów w formularzu. |
remove | Form | Rozłącza formularz z obecnym miejscem docelowym odpowiedzi. |
remove | Form | Usunięcie danego użytkownika z listy edytujących w przypadku Form . |
remove | Form | Usunięcie danego użytkownika z listy edytujących w przypadku Form . |
set | Form | Określa, czy formularz obecnie przyjmuje odpowiedzi. |
set | Form | Określa, czy formularz wyświetla link do edycji odpowiedzi po jej przesłaniu. |
set | Form | Określa, czy formularz ma zbierać adresy e-mail użytkowników. |
set | Form | Ustawia wiadomość potwierdzającą przesłanie formularza. |
set | Form | Określa komunikat, który ma się wyświetlać, gdy formularz nie przyjmuje odpowiedzi. |
set | Form | Ustawia opis formularza. |
set | Form | Ustawia miejsce docelowe, w którym są zapisywane odpowiedzi z formularza. |
set | Form | Określa, czy formularz jest testem. |
set | Form | Określa, czy formularz zezwala na tylko 1 odpowiedź na respondenta. |
set | Form | Określa, czy formularz ma pasek postępu. |
set | Form | Określa, czy po przesłaniu formularza przez respondenta ma się wyświetlać link do podsumowania odpowiedzi. |
set | Form | Określa, czy po wypełnieniu formularza przez respondenta ma się wyświetlać link do przesyłania kolejnej odpowiedzi. |
set | Form | Określa, czy kolejność pytań na każdej stronie formularza ma być losowa. |
set | Form | Ustawia tytuł formularza. |
shorten | String | Konwertuje długi adres URL formularza na krótki adres URL. |
submit | Form | Przesyła oceny dla podanych odpowiedzi w formularzu. |
Szczegółowa dokumentacja
add Checkbox Grid Item()
Dodaje nowy element pytania, który jest prezentowany jako siatka kolumn i wierszy i pozwala respondentowi wybrać kilka opcji na wiersz z kolejnych 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(); 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
Checkbox
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
add Checkbox Item()
Dodaje nowy element pytania, który umożliwia respondentowi zaznaczenie co najmniej 1 pola wyboru, a także opcjonalne pole „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
Checkbox
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
add Date Item()
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
Date
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
add Date Time Item()
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
Date
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
add Duration Item()
Dodaje nowy element pytania, który pozwala respondentowi wskazać długość 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
Duration
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
add Editor(emailAddress)
Dodaje danego użytkownika do listy edytujących Form
. Jeśli użytkownik był już na liście widzów, ta metoda powoduje usunięcie go z tej listy.
Parametry
Nazwa | Typ | Opis |
---|---|---|
email | String | Adres e-mail użytkownika, którego chcesz dodać. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
add Editor(user)
Dodaje danego użytkownika do listy edytujących Form
. Jeśli użytkownik był już na liście widzów, ta metoda powoduje usunięcie go z tej listy.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika, którego chcesz dodać. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
add Editors(emailAddresses)
Dodaje podany tablicowy zbiór użytkowników do listy edytujących w przypadku Form
. Jeśli któryś z użytkowników znajduje się już na liście widzów, ta metoda spowoduje usunięcie go z tej listy.
Parametry
Nazwa | Typ | Opis |
---|---|---|
email | String[] | Tablica adresów e-mail użytkowników, których chcesz dodać. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
add Grid Item()
Dodaje nowy element pytania, który jest prezentowany jako siatka kolumn i wierszy i umożliwia respondentowi wybranie jednej opcji na wiersz z kolejności opcji w przyciskach 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 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
Grid
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
add Image Item()
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
Image
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
add List Item()
Dodaje nowy element pytania, który umożliwia respondentowi wybranie jednej opcji 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
List
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
add Multiple Choice Item()
Dodaje nowy element pytania, który umożliwia respondentowi wybranie jednej opcji z listy przycisków opcji lub opcjonalnego pola „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
Multiple
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
add Page Break Item()
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
Page
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
add Paragraph Text Item()
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
Paragraph
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
add Rating Item()
Dodaje nowy element pytania, który umożliwia respondentowi udzielenie oceny.
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/abc123456/edit', ); // Adds the rating item. const item = form.addRatingItem();
Powrót
Rating
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
add Scale Item()
Dodaje nowy element pytania, który umożliwia respondentowi wybranie jednej opcji z numerowanej 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 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
Scale
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
add Section Header Item()
Dodaje nowy element układu, który wizualnie wskazuje 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
Section
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
add Text Item()
Dodaje nowy element pytania, który pozwala respondentowi wpisać pojedynczą linijkę 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
Text
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
add Time Item()
Dodaje nowy element pytania, który pozwala respondentowi wskazać porę 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
Time
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
add Video Item()
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
Video
– nowo utworzony element.
Autoryzacja
Skrypty, które korzystają 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
can Edit Response()
Określa, czy po przesłaniu odpowiedzi w formularzu ma być wyświetlany link do jej edycji.
Niezależnie od tego ustawienia metoda Form
pozwala autorowi skryptu, który ma uprawnienia do edytowania formularza, wygenerować adres URL, którego można użyć do edycji 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', ); // 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 link „Edytuj odpowiedź”, false
, jeśli nie.
Autoryzacja
Skrypty, które korzystają 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
collects Email()
Określa, czy formularz ma zbierać adresy e-mail użytkownikó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', ); // 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
, jeśli nie.
Autoryzacja
Skrypty, które korzystają 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
create Response()
Tworzy nową odpowiedź na formularz. Aby odpowiedzieć na element pytania, utwórz obiekt Item
z tego elementu, a następnie dołącz go do odpowiedzi w formularzu, wywołując funkcję Form
. Aby zapisać złożoną odpowiedź, wywołaj funkcję Form
.
Powrót
Form
– nowo utworzona odpowiedź na formularz.
Autoryzacja
Skrypty, które korzystają 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
delete All Responses()
usuwa wszystkie przesłane odpowiedzi z magazynu odpowiedzi formularza. Ta metoda nie usuwa kopii odpowiedzi zapisanych w zewnętrznym miejscu docelowym odpowiedzi (np. w arkuszu kalkulacyjnym), ale powoduje wyczyszczenie widoku podsumowania formularza.
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
delete Item(index)
Usuwa element o danym indeksie spośród wszystkich elementów w formularzu. Wyjątek skryptu, jeśli podany indeks nie zawiera żadnego elementu.
// 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, które korzystają 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
delete Item(item)
Usuwa podany element. 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 element nie występuje w formularzu.
Autoryzacja
Skrypty, które korzystają 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
delete Response(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 odpowiedź z widoku podsumowania formularza. Identyfikator odpowiedzi można pobrać za pomocą Form
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
response | String | Identyfikator odpowiedzi z formularza, którą chcesz usunąć. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
get Confirmation Message()
Pobiera wiadomość potwierdzającą przesłanie 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 przesłanie formularza.
Autoryzacja
Skrypty, które korzystają 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
get Custom Closed Form Message()
Pobiera komunikat niestandardowy, który jest wyświetlany, jeśli formularz nie akceptuje odpowiedzi, lub pusty 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 do wyświetlenia, jeśli formularz nie akceptuje odpowiedzi, lub pusty ciąg znaków, jeśli nie ustawiono komunikatu niestandardowego.
Autoryzacja
Skrypty, które korzystają 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
get Description()
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, które korzystają 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
get Destination Id()
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, które korzystają 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
get Destination Type()
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
Destination
– typ miejsca docelowego odpowiedzi formularza.
Autoryzacja
Skrypty, które korzystają 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
get Edit Url()
Pobiera adres URL, którego można użyć do uzyskania dostępu 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 formularza do edycji.
Autoryzacja
Skrypty, które korzystają 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
get Editors()
get Id()
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, które korzystają 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
get Item By Id(id)
Pobiera element o podanym identyfikatorze. Zwraca null
, jeśli identyfikator nie odpowiada elementowi w formularzu.
// 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 elementu. |
Powrót
Item
– element o podanym identyfikatorze lub null
, jeśli element nie istnieje w formularzu.
Autoryzacja
Skrypty, które korzystają 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
get Items()
Pobiera tablicę wszystkich elementó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 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 wszystkich elementów w formularzu.
Autoryzacja
Skrypty, które korzystają 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
get Items(itemType)
Pobiera tablicę wszystkich elementów 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 |
---|---|---|
item | Item | Typ elementów do pobrania. |
Powrót
Item[]
– tablica wszystkich elementów danego typu.
Autoryzacja
Skrypty, które korzystają 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
get Published Url()
Pobiera adres URL, którego można użyć do 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 formularza, na który należy odpowiedzieć.
Autoryzacja
Skrypty, które korzystają 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
get Response(responseId)
Pobiera odpowiedź na pojedynczy formularz na podstawie jego identyfikatora odpowiedzi. Identyfikatory odpowiedzi można pobrać z Form
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
response | String | Identyfikator odpowiedzi na formularz. |
Powrót
Form
– odpowiedź na formularz.
Rzuty
Error
– jeśli odpowiedź nie istnieje,
Autoryzacja
Skrypty, które korzystają 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
get Responses()
Pobiera tablicę wszystkich odpowiedzi w formularzu.
Powrót
Form
– tablica wszystkich odpowiedzi w formularzu.
Autoryzacja
Skrypty, które korzystają 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
get Responses(timestamp)
Pobiera tablicę wszystkich odpowiedzi do formularza po podanej dacie i godzinie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
timestamp | Date | Najwcześniejsza data i godzina, do których odpowiedzi w formularzu powinny być zwracane. |
Powrót
Form
– lista odpowiedzi na pytania w formularzu.
Autoryzacja
Skrypty, które korzystają 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
get Shuffle Questions()
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
, jeśli nie.
Autoryzacja
Skrypty, które korzystają 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
get Summary Url()
Pobiera adres URL, którego można użyć do wyświetlenia podsumowania odpowiedzi na pytania w formularzu. Jeśli set
nie jest ustawiony na true
, tylko użytkownicy z uprawnieniami do edycji formularza mają dostęp do 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 do podsumowania odpowiedzi.
Autoryzacja
Skrypty, które korzystają 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
get Title()
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, które korzystają 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
has Limit One Response Per User()
Określa, czy formularz zezwala na tylko 1 odpowiedź na respondenta. Jeśli wartość to true
, skrypt nie może przesyłać odpowiedzi z formularza.
Powrót
Boolean
– true
, jeśli formularz zezwala na tylko 1 odpowiedź na respondenta, lub false
w przeciwnym razie.
Autoryzacja
Skrypty, które korzystają 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
has Progress Bar()
Określa, czy formularz 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 wyświetla pasek postępu, false
, jeśli nie.
Autoryzacja
Skrypty, które korzystają 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
has Respond Again Link()
Określa, czy po wypełnieniu formularza przez respondenta wyświetlany jest link do przesyłania kolejnych 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 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 link „Prześlij kolejną odpowiedź”; false
, jeśli nie.
Autoryzacja
Skrypty, które korzystają 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
is Accepting Responses()
Określa, czy formularz obecnie przyjmuje 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 akceptuje odpowiedzi, false
, jeśli nie.
Autoryzacja
Skrypty, które korzystają 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
is Publishing Summary()
Określa, czy po wypełnieniu formularza przez respondenta wyświetlany jest link do podsumowania 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 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 formularz wyświetla link „Zobacz poprzednie odpowiedzi”; false
, jeśli nie wyświetla.
Autoryzacja
Skrypty, które korzystają 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
is Quiz()
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 akceptuje odpowiedzi, false
, jeśli nie.
Autoryzacja
Skrypty, które korzystają 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
move Item(from, to)
Przenosi element o danym indeksie spośród wszystkich elementów w formularzu na inny indeks. Jeśli indeks to
wykracza poza zakres, wywołuje 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', ); // 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
– element, który został przeniesiony.
Rzuty
Error
– jeśli którykolwiek z indeksów wykracza poza zakres.
Autoryzacja
Skrypty, które korzystają 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
move Item(item, toIndex)
Przenosi dany element na określony indeks wśród wszystkich elementów w formularzu. Wyjątek skryptu, jeśli podany indeks wykracza poza zakres.
// 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. |
to | Integer | Nowy indeks elementu wśród wszystkich elementów w formularzu. |
Powrót
Item
– element, który został przeniesiony.
Rzuty
Error
– jeśli indeks wykracza poza prawidłowy zakres.
Autoryzacja
Skrypty, które korzystają 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
remove Destination()
Rozłącza formularz z obecnym miejscem docelowym odpowiedzi. Odłączone wcześniej miejsce docelowe nadal zawiera kopię wszystkich poprzednich odpowiedzi. Wszystkie formularze, w tym te, które nie mają wyraźnie określonego miejsca docelowego, zachowują kopię odpowiedzi w magazynie odpowiedzi formularza. Jeśli formularz nie ma obecnie miejsca docelowego odpowiedzi, ta metoda nie ma żadnego wpływu.
// 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
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
remove Editor(emailAddress)
Usunięcie danego użytkownika z listy edytujących w przypadku Form
. Ta metoda nie blokuje dostępu do Form
użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład, jeśli Form
jest udostępniony całej domenie użytkownika 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 również usunięcie użytkownika z listy widzów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
email | String | Adres e-mail użytkownika, którego chcesz usunąć. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
remove Editor(user)
Usunięcie danego użytkownika z listy edytujących w przypadku Form
. Ta metoda nie blokuje dostępu do Form
użytkownikom, którzy należą do grupy użytkowników z ogólnym dostępem. Na przykład, jeśli Form
jest udostępniony całej domenie użytkownika 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 również usunięcie użytkownika z listy widzów.
Parametry
Nazwa | Typ | Opis |
---|---|---|
user | User | Reprezentacja użytkownika do usunięcia. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
set Accepting Responses(enabled)
Określa, czy formularz obecnie przyjmuje odpowiedzi. Wartość domyślna dla 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 ma akceptować odpowiedzi, lub false , jeśli nie. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
set Allow Response Edits(enabled)
Określa, czy formularz wyświetla link do edycji odpowiedzi po jej przesłaniu. Wartość domyślna dla nowych formularzy to false
.
Niezależnie od tego ustawienia metoda Form
umożliwia autorowi skryptu, który ma uprawnienia do edycji formularza, wygenerowanie adresu URL, którego można użyć do edycji 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', ); // 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 ma wyświetlać link „Edytuj odpowiedź”; false jeśli nie. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
set Collect Email(collect)
Określa, czy formularz ma zbierać adresy e-mail użytkowników. Wartość domyślna dla 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. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
set Confirmation Message(message)
Ustawia wiadomość potwierdzającą przesłanie 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 przesłanie formularza, |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
set Custom Closed Form Message(message)
Określa komunikat, który ma się wyświetlać, gdy formularz nie przyjmuje odpowiedzi. Jeśli nie ustawisz żadnej wiadomości, formularz użyje 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, który ma się wyświetlić, gdy formularz nie przyjmuje odpowiedzi. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
set Description(description)
Ustawia opis formularza.
Parametry
Nazwa | Typ | Opis |
---|---|---|
description | String | Nowy opis formularza. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
set Destination(type, id)
Ustawia miejsce docelowe, w którym są zapisywane odpowiedzi z formularza. Wszystkie formularze, w tym te, które nie mają wyraźnie określonego miejsca docelowego, zapisuja kopię odpowiedzi w magazynie odpowiedzi formularza.
Parametry
Nazwa | Typ | Opis |
---|---|---|
type | Destination | Typ miejsca docelowego odpowiedzi formularza. |
id | String | Identyfikator miejsca docelowego odpowiedzi formularza. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Rzuty
Error
– jeśli podany identyfikator miejsca docelowego jest nieprawidłowy.
Autoryzacja
Skrypty, które korzystają 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
set Is Quiz(enabled)
Określa, czy formularz jest testem. Wartość domyślna dla nowych formularzy to false
.
Pytania oceniane są dozwolone tylko w quizach, więc ustawienie tej opcji na false
spowoduje usunięcie wszystkich opcji oceniania ze wszystkich pytań.
Ustawienia testu są dostępne tylko w nowym interfejsie Formularzy. Przekształcanie formularza w test powoduje, że formularz będzie używać 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 quizu mają być włączone w przypadku formularza; false , jeśli nie. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
set Limit One Response Per User(enabled)
Określa, czy formularz zezwala na tylko 1 odpowiedź na respondenta. Wartość domyślna dla nowych formularzy to false
. Jeśli wartość jest ustawiona na true
, skrypt nie może przesyłać odpowiedzi na formularz.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | true , jeśli formularz ma zezwalać na przesłanie tylko 1 odpowiedzi przez każdego respondenta, lub false , jeśli nie. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
set Progress Bar(enabled)
Określa, czy formularz ma pasek postępu. Wartość domyślna dla 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 formularz wyświetla pasek postępu, false , jeśli nie. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
set Publishing Summary(enabled)
Określa, czy po przesłaniu formularza przez respondenta ma się wyświetlać link do podsumowania odpowiedzi. Wartość domyślna dla nowych formularzy to false
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | true jeśli formularz ma wyświetlać link „Zobacz poprzednie odpowiedzi”; false jeśli nie. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
set Show Link To Respond Again(enabled)
Określa, czy po wypełnieniu formularza przez respondenta ma się wyświetlać link do przesyłania kolejnej odpowiedzi. Wartość domyślna dla nowych formularzy to true
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | true jeśli formularz ma wyświetlać link „Prześlij kolejną odpowiedź”; false jeśli nie. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
set Shuffle Questions(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 ma być losowa; false w przeciwnym razie. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
set Title(title)
Ustawia tytuł formularza.
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | Nowy tytuł formularza. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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
shorten Form Url(url)
Konwertuje długi adres URL formularza na krótki adres URL. Wyjątek jest zgłaszany, jeśli długi adres URL nie należy do Formularzy 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, które korzystają 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
submit Grades(responses)
Przesyła oceny dla podanych odpowiedzi w formularzu.
Jeśli Twój kod zawiera element on
, wywołanie submit
powoduje spełnienie warunku on
i wprowadza nieskończoną pętlę. Aby zapobiec nieskończonemu pętli, przed wywołaniem funkcji submit
dodaj kod, który sprawdza, czy oceny już istnieją.
Parametry
Nazwa | Typ | Opis |
---|---|---|
responses | Form | Tablica wszystkich odpowiedzi z formularza. |
Powrót
Form
– ta Form
służy do tworzenia łańcuszków.
Autoryzacja
Skrypty, które korzystają 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