Class Form

Formularz zawierający ogólne właściwości i elementy. Obejmują one tytuł, ustawienia i miejsce przechowywania odpowiedzi. Elementy obejmują pytania, takie jak pola wyboru lub opcje, a elementy układu to np. podziały stron. Dostęp do formularzy można uzyskać lub tworzyć je w FormApp.

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

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

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

Metody

Metoda	Zwracany typ	Krótki opis
`addCheckboxGridItem()`	`CheckboxGridItem`	Dodaje nowe pytanie w formie siatki kolumn i wierszy, w której użytkownik może wybrać wiele opcji w każdym wierszu z ciągu pól wyboru.
`addCheckboxItem()`	`CheckboxItem`	Dodaje nowy element pytania, który umożliwia użytkownikowi zaznaczenie co najmniej jednego pola wyboru, a także opcjonalnego pola „Inne”.
`addDateItem()`	`DateItem`	Dodaje nowe pytanie, które umożliwia użytkownikowi podanie daty.
`addDateTimeItem()`	`DateTimeItem`	Dodaje nowe pytanie, które umożliwia użytkownikowi podanie daty i godziny.
`addDurationItem()`	`DurationItem`	Dodaje nowe pytanie, które umożliwia użytkownikowi określenie czasu.
`addEditor(emailAddress)`	`Form`	Dodaje podanego użytkownika do listy edytujących `Form`.
`addEditor(user)`	`Form`	Dodaje podanego użytkownika do listy edytujących `Form`.
`addEditors(emailAddresses)`	`Form`	Dodaje podaną tablicę użytkowników do listy edytujących `Form`.
`addGridItem()`	`GridItem`	Dodaje nowe pytanie w formie siatki kolumn i wierszy, w której respondent może wybrać jedną odpowiedź w każdym wierszu z ciągu przycisków opcji.
`addImageItem()`	`ImageItem`	Dodaje nowy element układu, który wyświetla obraz.
`addListItem()`	`ListItem`	Dodaje nowe pytanie, w którym użytkownik może wybrać jedną odpowiedź z listy rozwijanej.
`addMultipleChoiceItem()`	`MultipleChoiceItem`	Dodaje nowy element pytania, który umożliwia użytkownikowi wybranie jednej opcji z listy opcji lub opcjonalnego pola „Inne”.
`addPageBreakItem()`	`PageBreakItem`	Dodaje nowy element układu, który oznacza początek strony.
`addParagraphTextItem()`	`ParagraphTextItem`	Dodaje nowe pytanie, w którym respondent może wpisać blok tekstu.
`addPublishedReader(emailAddress)`	`Form`	Dodaje podanego użytkownika do listy osób odpowiadających na `Form`.
`addPublishedReader(user)`	`Form`	Dodaje podanego użytkownika do listy osób odpowiadających na `Form`.
`addPublishedReaders(emailAddresses)`	`Form`	Dodaje podaną tablicę użytkowników do listy osób odpowiadających na `Form`.
`addRatingItem()`	`RatingItem`	Dołącza nowy element pytania, który umożliwia użytkownikowi wystawienie oceny.
`addScaleItem()`	`ScaleItem`	Dodaje nowe pytanie, które umożliwia użytkownikowi wybranie jednej opcji z numerowanego ciągu przycisków opcji.
`addSectionHeaderItem()`	`SectionHeaderItem`	Dodaje nowy element układu, który wizualnie wskazuje początek sekcji.
`addTextItem()`	`TextItem`	Dodaje nowy element pytania, który umożliwia użytkownikowi wpisanie jednego wiersza tekstu.
`addTimeItem()`	`TimeItem`	Dodaje nowe pytanie, które umożliwia użytkownikowi wskazanie pory dnia.
`addVideoItem()`	`VideoItem`	Dodaje nowy element układu, który wyświetla film.
`canEditResponse()`	`Boolean`	Określa, czy po przesłaniu formularza wyświetla się link umożliwiający edytowanie odpowiedzi.
`collectsEmail()`	`Boolean`	Określa, czy formularz zbiera adresy e-mail użytkowników.
`createResponse()`	`FormResponse`	Tworzy nową odpowiedź w formularzu.
`deleteAllResponses()`	`Form`	Usuwa wszystkie przesłane odpowiedzi z miejsca przechowywania odpowiedzi w formularzu.
`deleteItem(index)`	`void`	Usuwa element o podanym indeksie spośród wszystkich elementów w formularzu.
`deleteItem(item)`	`void`	Usuwa dany element.
`deleteResponse(responseId)`	`Form`	Usuwa pojedynczą odpowiedź z miejsca przechowywania odpowiedzi w formularzu.
`getConfirmationMessage()`	`String`	Pobiera wiadomość potwierdzającą przesłanie formularza.
`getCustomClosedFormMessage()`	`String`	Pobiera niestandardowy komunikat wyświetlany, gdy formularz nie akceptuje odpowiedzi, lub pusty ciąg znaków, jeśli nie ustawiono żadnego niestandardowego komunikatu.
`getDescription()`	`String`	Pobiera opis formularza.
`getDestinationId()`	`String`	Pobiera identyfikator miejsca docelowego odpowiedzi na formularz.
`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 tego `Form`.
`getId()`	`String`	Pobiera identyfikator formularza.
`getItemById(id)`	`Item\|null`	Pobiera element o podanym identyfikatorze.
`getItems()`	`Item[]`	Pobiera tablicę wszystkich elementów w formularzu.
`getItems(itemType)`	`Item[]`	Pobiera tablicę wszystkich elementów danego typu.
`getPublishedReaders()`	`User[]`	Pobiera listę osób, które odpowiedziały na ten `Form`.
`getPublishedUrl()`	`String`	Pobiera adres URL, który można wykorzystać do odpowiedzi na formularz.
`getResponse(responseId)`	`FormResponse`	Pobiera pojedynczą odpowiedź na formularz na podstawie jej identyfikatora.
`getResponses()`	`FormResponse[]`	Zwraca tablicę wszystkich odpowiedzi w formularzu.
`getResponses(timestamp)`	`FormResponse[]`	Zwraca tablicę wszystkich odpowiedzi na formularz 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 w formularzu.
`getTitle()`	`String`	Pobiera tytuł formularza.
`hasLimitOneResponsePerUser()`	`Boolean`	Określa, czy formularz zezwala na tylko jedną odpowiedź na użytkownika.
`hasProgressBar()`	`Boolean`	Określa, czy w formularzu ma być wyświetlany pasek postępu.
`hasRespondAgainLink()`	`Boolean`	Określa, czy po wypełnieniu formularza przez użytkownika wyświetla się link do przesłania kolejnej odpowiedzi.
`isAcceptingResponses()`	`Boolean`	Określa, czy formularz obecnie przyjmuje odpowiedzi.
`isPublished()`	`Boolean`	Określa, czy formularz jest opublikowany.
`isPublishingSummary()`	`Boolean`	Określa, czy po wypełnieniu formularza przez użytkownika ma się w nim wyświetlać link do podsumowania odpowiedzi.
`isQuiz()`	`Boolean`	Określa, czy formularz jest testem.
`moveItem(from, to)`	`Item`	Przenosi element o podanym indeksie w formularzu na inny podany indeks.
`moveItem(item, toIndex)`	`Item`	Przenosi dany element na podany indeks wśród wszystkich elementów formularza.
`removeDestination()`	`Form`	Rozłącza formularz z bieżącym miejscem docelowym odpowiedzi.
`removeEditor(emailAddress)`	`Form`	Usuwa podanego użytkownika z listy osób edytujących `Form`.
`removeEditor(user)`	`Form`	Usuwa podanego użytkownika z listy osób edytujących `Form`.
`removePublishedReader(emailAddress)`	`Form`	Usuwa danego użytkownika z listy osób, które odpowiedziały na `Form`.
`removePublishedReader(user)`	`Form`	Usuwa danego użytkownika z listy osób, które odpowiedziały na `Form`.
`setAcceptingResponses(enabled)`	`Form`	Określa, czy formularz obecnie przyjmuje odpowiedzi.
`setAllowResponseEdits(enabled)`	`Form`	Określa, czy po przesłaniu odpowiedzi w formularzu ma się wyświetlać link do jej edycji.
`setCollectEmail(collect)`	`Form`	Określa, czy formularz ma zbierać adresy e-mail respondentów.
`setConfirmationMessage(message)`	`Form`	Ustawia wiadomość potwierdzającą przesłanie formularza.
`setCustomClosedFormMessage(message)`	`Form`	Ustawia wiadomość, która ma się wyświetlać, jeśli formularz nie przyjmuje odpowiedzi.
`setDescription(description)`	`Form`	Ustawia opis formularza.
`setDestination(type, id)`	`Form`	Ustawia miejsce docelowe, w którym zapisywane są odpowiedzi z formularza.
`setIsQuiz(enabled)`	`Form`	Określa, czy formularz jest testem.
`setLimitOneResponsePerUser(enabled)`	`Form`	Określa, czy formularz zezwala na przesłanie tylko jednej odpowiedzi przez użytkownika.
`setProgressBar(enabled)`	`Form`	Określa, czy formularz ma pasek postępu.
`setPublished(enabled)`	`Form`	Określa, czy formularz jest opublikowany.
`setPublishingSummary(enabled)`	`Form`	Określa, czy po przesłaniu formularza przez użytkownika ma się w nim wyświetlać link do podsumowania odpowiedzi.
`setShowLinkToRespondAgain(enabled)`	`Form`	Określa, czy po wypełnieniu formularza przez użytkownika wyświetla się link do przesłania kolejnej odpowiedzi.
`setShuffleQuestions(shuffle)`	`Form`	Określa, czy kolejność pytań na każdej stronie formularza jest 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 w Formularzach.
`supportsAdvancedResponderPermissions()`	`Boolean`	Określa, czy formularz obsługuje publikowanie.

Wycofane metody

Metoda	Zwracany typ	Krótki opis
`requiresLogin()`	`Boolean`	Określa, czy przed udzieleniem odpowiedzi użytkownicy muszą zalogować się na konto w tej samej domenie lub subdomenie.
`setRequireLogin(requireLogin)`	`Form`	Określa, czy przed udzieleniem odpowiedzi na formularz użytkownicy muszą zalogować się na konto w tej samej domenie lub poddomenie.

Szczegółowa dokumentacja

`addCheckboxGridItem()`

Dodaje nowe pytanie w formie siatki kolumn i wierszy, w której użytkownik może wybrać wiele opcji w każdym wierszu z ciągu 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

CheckboxGridItem – nowo utworzony element.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 użytkownikowi zaznaczenie co najmniej jednego pola wyboru, a także 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 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 użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`addDateItem()`

Dodaje nowe pytanie, które umożliwia użytkownikowi podanie 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 użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`addDateTimeItem()`

Dodaje nowe pytanie, które umożliwia użytkownikowi podanie 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 użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`addDurationItem()`

Dodaje nowe pytanie, które umożliwia użytkownikowi określenie 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 użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`addEditor(emailAddress)`

Dodaje podanego użytkownika do listy edytujących Form. Jeśli użytkownik był już na liście osób, które wyświetliły lub odpowiedziały na ankietę, ta metoda usuwa go z tej 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 editor to the form.
// TODO(developer): replace the emailAddress.
form.addEditor('editor@uni.edu');

Parametry

Nazwa	Typ	Opis
`emailAddress`	`String`	Adres e-mail użytkownika, którego chcesz dodać.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`addEditor(user)`

Dodaje podanego użytkownika do listy edytujących Form. Jeśli użytkownik był już na liście osób, które wyświetliły lub odpowiedziały na ankietę, ta metoda usuwa go z tej listy.

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

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

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

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

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika do dodania.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 edytujących Form. Jeśli któryś z użytkowników był już na liście widzów, ta metoda usunie go z tej 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 editors to the form.
// TODO(developer): replace the emailAddress.
form.addPublishedReaders(['editor1@uni.edu', 'editor2@uni.edu']);

Parametry

Nazwa	Typ	Opis
`emailAddresses`	`String[]`	Tablica adresów e-mail użytkowników, których chcesz dodać.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`addGridItem()`

Dodaje nowe pytanie w formie siatki kolumn i wierszy, w której respondent może wybrać jedną odpowiedź w każdym wierszu z ciągu 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 użyciem co najmniej jednego 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 użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`addListItem()`

Dodaje nowe pytanie, w którym użytkownik może wybrać jedną odpowiedź z listy rozwijanej.

// 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 użyciem co najmniej jednego 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 użytkownikowi wybranie jednej opcji z listy 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

MultipleChoiceItem – nowo utworzony element.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`addParagraphTextItem()`

Dodaje nowe pytanie, w którym respondent może wpisać blok 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 użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`addPublishedReader(emailAddress)`

Dodaje podanego użytkownika do listy osób odpowiadających na Form. Jeśli użytkownik był już na liście edytujących lub wyświetlających, ta metoda nie ma 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');

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

Parametry

Nazwa	Typ	Opis
`emailAddress`	`String`	Adres e-mail użytkownika, którego chcesz dodać.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`addPublishedReader(user)`

Dodaje podanego użytkownika do listy osób odpowiadających na Form. Jeśli użytkownik był już na liście edytujących lub wyświetlających, ta metoda nie ma wpływu.

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

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

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

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

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika do dodania.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`addPublishedReaders(emailAddresses)`

Dodaje podaną tablicę użytkowników do listy osób odpowiadających na Form. Jeśli użytkownik był już na liście edytujących lub wyświetlających, ta metoda nie ma 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');

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

Parametry

Nazwa	Typ	Opis
`emailAddresses`	`String[]`	Tablica adresów e-mail użytkowników, których chcesz dodać.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`addRatingItem()`

Dołącza nowy element pytania, który umożliwia użytkownikowi wystawienie 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

RatingItem – nowo utworzony element.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`addScaleItem()`

Dodaje nowe pytanie, które umożliwia użytkownikowi wybranie jednej opcji z numerowanego ciągu 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 użyciem co najmniej jednego 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 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

SectionHeaderItem – nowo utworzony element.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 użytkownikowi 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 użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`addTimeItem()`

Dodaje nowe pytanie, które umożliwia użytkownikowi 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 użyciem co najmniej jednego 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 użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`canEditResponse()`

Określa, czy po przesłaniu formularza wyświetla się link umożliwiający edytowanie odpowiedzi.

Niezależnie od tego ustawienia metoda FormResponse.getEditResponseUrl() umożliwia autorowi skryptu, który ma uprawnienia do edycji formularza, wygenerowanie adresu URL, za pomocą którego można edytować odpowiedź.

// 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 w formularzu wyświetla się link „Edytuj odpowiedź”; false, jeśli nie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`collectsEmail()`

Określa, czy formularz 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 obiekt ItemResponse na podstawie pytania, a następnie dołącz go do odpowiedzi na formularz, wywołując FormResponse.withItemResponse(response). Aby zapisać złożoną odpowiedź, wywołaj FormResponse.submit().

Powrót

FormResponse – nowo utworzona odpowiedź na formularz.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`deleteAllResponses()`

Usuwa wszystkie przesłane odpowiedzi z miejsca przechowywania odpowiedzi w formularzu. Ta metoda nie usuwa kopii odpowiedzi przechowywanych w zewnętrznym miejscu docelowym odpowiedzi (np. w arkuszu kalkulacyjnym), ale czyści widok podsumowania formularza.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`deleteItem(index)`

Usuwa element o podanym indeksie spośród wszystkich elementów w formularzu. Zgłasza wyjątek skryptu, jeśli pod podanym indeksem nie ma ż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.

Zgłasza

Error – jeśli pod danym indeksem nie ma elementu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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.

Zgłasza

Error – jeśli element nie istnieje w formularzu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`deleteResponse(responseId)`

Usuwa pojedynczą odpowiedź z miejsca przechowywania odpowiedzi w formularzu. W ten sposób nie usuniesz kopii odpowiedzi zapisanych w zewnętrznym miejscu docelowym odpowiedzi (np. w arkuszu kalkulacyjnym), ale usuniesz odpowiedź z widoku podsumowania formularza. Identyfikator odpowiedzi można pobrać za pomocą FormResponse.getId().

Parametry

Nazwa	Typ	Opis
`responseId`	`String`	Identyfikator odpowiedzi na formularz, którą chcesz usunąć.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getConfirmationMessage()`

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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getCustomClosedFormMessage()`

Pobiera niestandardowy komunikat wyświetlany, gdy formularz nie akceptuje odpowiedzi, lub pusty ciąg znaków, jeśli nie ustawiono żadnego niestandardowego komunikatu.

// 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, który ma się wyświetlać, jeśli formularz nie przyjmuje odpowiedzi, lub pusty ciąg znaków, jeśli nie ustawiono żadnego komunikatu niestandardowego.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getDestinationId()`

Pobiera identyfikator miejsca docelowego 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',
);

// 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 użyciem co najmniej jednego 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 w formularzu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getEditors()`

Pobiera listę edytorów tego Form.

Powrót

User[] – tablica użytkowników z uprawnieniami do edycji.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`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 użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getItemById(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 produktu.

Powrót

Item|null – element o podanym identyfikatorze lub null, jeśli element nie istnieje w formularzu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getItems()`

Pobiera tablicę wszystkich elementów 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 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getItems(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
`itemType`	`ItemType`	Typ elementów do pobrania.

Powrót

Item[] – tablica wszystkich elementów tego typu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getPublishedReaders()`

Pobiera listę osób, które odpowiedziały na ten Form.

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

// Gets the responders for the form.
const users = form.getPublishedReaders();
users.forEach(user => console.log(user.getEmail()));

Powrót

User[] – tablica użytkowników z uprawnieniami do odpowiadania.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getPublishedUrl()`

Pobiera adres URL, który można wykorzystać 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, pod którym można odpowiedzieć na formularz.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getResponse(responseId)`

Pobiera pojedynczą odpowiedź na formularz na podstawie jej identyfikatora. Identyfikatory odpowiedzi można pobrać z FormResponse.getId().

Parametry

Nazwa	Typ	Opis
`responseId`	`String`	Identyfikator odpowiedzi na formularz.

Powrót

FormResponse – odpowiedź na formularz.

Zgłasza

Error – jeśli odpowiedź nie istnieje.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getResponses()`

Zwraca tablicę wszystkich odpowiedzi w formularzu.

Powrót

FormResponse[] – tablica wszystkich odpowiedzi na formularz.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getResponses(timestamp)`

Zwraca tablicę wszystkich odpowiedzi na formularz po określonej dacie i godzinie.

Parametry

Nazwa	Typ	Opis
`timestamp`	`Date`	Najwcześniejsza data i godzina, od której mają być zwracane odpowiedzi na formularz.

Powrót

FormResponse[] – lista odpowiedzi na formularz.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 jeśli nie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 w formularzu. Jeśli zasada setPublishingSummary(enabled) nie jest ustawiona na true, tylko użytkownicy z uprawnieniami do edycji formularza mogą uzyskać 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, pod którym można wyświetlić podsumowanie odpowiedzi.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`hasLimitOneResponsePerUser()`

Określa, czy formularz zezwala na tylko jedną odpowiedź na użytkownika. Jeśli wartość to true, skrypt nie może w ogóle przesyłać odpowiedzi z formularza.

Powrót

Boolean – true jeśli formularz zezwala na przesłanie tylko 1 odpowiedzi przez respondenta; false w przeciwnym razie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`hasProgressBar()`

Określa, czy w formularzu ma być wyświetlany 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 w formularzu wyświetla się pasek postępu; false, jeśli nie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`hasRespondAgainLink()`

Określa, czy po wypełnieniu formularza przez użytkownika wyświetla się link do przesłania kolejnej 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 w formularzu jest widoczny link „Prześlij kolejną odpowiedź”; false, jeśli nie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`isAcceptingResponses()`

Określa, czy formularz obecnie przyjmuje odpowiedzi. Zostanie on zastąpiony, gdy zmieni się stan publikacji 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 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, jeśli nie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`isPublished()`

Określa, czy formularz jest opublikowany.

Ta funkcja jest dostępna tylko w przypadku formularzy, które obsługują publikowanie. Użyj supportsAdvancedResponderPermissions(), aby sprawdzić, czy formularz obsługuje publikowanie.

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

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

Powrót

Boolean – true, jeśli formularz jest opublikowany; false, jeśli nie jest.

Zgłasza

Error – jeśli wywołanie nastąpi w nieobsługiwanych formularzach.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`isPublishingSummary()`

Określa, czy po wypełnieniu formularza przez użytkownika ma się w nim wyświetlać 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 w formularzu wyświetla się link „Zobacz poprzednie odpowiedzi”; false jeśli nie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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, jeśli nie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`moveItem(from, to)`

Przenosi element o podanym indeksie w formularzu na inny podany indeks. Zwraca 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 formularza.
`to`	`Integer`	Nowy indeks elementu wśród wszystkich elementów w formularzu.

Powrót

Item – przeniesiony element.

Zgłasza

Error – jeśli którykolwiek indeks wykracza poza zakres.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`moveItem(item, toIndex)`

Przenosi dany element na podany indeks wśród wszystkich elementów formularza. Zgłasza wyjątek skryptu, jeśli podany 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.

Zgłasza

Error – jeśli indeks wykracza poza prawidłowy zakres.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`removeDestination()`

Rozłącza formularz z bieżącym miejscem docelowym odpowiedzi. Odłączone poprzednie miejsce docelowe nadal zawiera kopię wszystkich poprzednich odpowiedzi. Wszystkie formularze, w tym te, które nie mają wyraźnie ustawionego miejsca docelowego, zapisują kopię odpowiedzi w magazynie odpowiedzi formularza. Jeśli formularz nie ma obecnie miejsca docelowego odpowiedzi, ta metoda nie ma żadnego efektu.

// 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 — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`removeEditor(emailAddress)`

Usuwa podanego użytkownika z listy osób edytujących Form. Ta metoda nie blokuje dostępu do Form użytkownikom, którzy należą do klasy użytkowników mających ogólny dostęp – 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.Form

W przypadku plików na Dysku powoduje to również usunięcie użytkownika z listy przeglądających i odpowiadających.

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

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

Parametry

Nazwa	Typ	Opis
`emailAddress`	`String`	Adres e-mail użytkownika, którego chcesz usunąć.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`removeEditor(user)`

W przypadku plików na Dysku powoduje to również usunięcie użytkownika z listy osób, które mogą je wyświetlać.

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

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

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

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

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika do usunięcia.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`removePublishedReader(emailAddress)`

Usuwa danego użytkownika z listy osób, które odpowiedziały na Form. Ta metoda nie blokuje użytkownikom dostępu do Form, jeśli należą oni do klasy użytkowników, którzy mają ogólny dostęp, np. 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.Form

W przypadku plików na Dysku spowoduje to również usunięcie użytkownika z listy osób, które mogą wyświetlać i edytować pliki.

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

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

Parametry

Nazwa	Typ	Opis
`emailAddress`	`String`	Adres e-mail użytkownika, którego chcesz usunąć.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`removePublishedReader(user)`

W przypadku plików na Dysku spowoduje to również usunięcie użytkownika z listy osób, które mogą wyświetlać i edytować pliki.

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

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

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

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

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika do usunięcia.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setAcceptingResponses(enabled)`

Określa, czy formularz obecnie przyjmuje odpowiedzi. W przypadku nowych formularzy domyślnie jest włączona opcja true. Stan jest zastępowany, gdy zmienia się stan publikacji 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 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 przyjmować odpowiedzi; `false` jeśli nie ma przyjmować odpowiedzi.

Powrót

Form — ten Form do łączenia.

Zgłasza

Error – jeśli jest włączona w nieopublikowanym formularzu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setAllowResponseEdits(enabled)`

Określa, czy po przesłaniu odpowiedzi w formularzu ma się wyświetlać link do jej edycji. Wartość domyślna w przypadku nowych formularzy to false.

Niezależnie od tego ustawienia metoda FormResponse.getEditResponseUrl() umożliwia autorowi skryptu, który ma uprawnienia do edytowania formularza, wygenerowanie adresu URL, za pomocą którego można edytować odpowiedź.

// 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 w formularzu ma się wyświetlać link „Edytuj odpowiedź”; `false` jeśli nie.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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ć adresy e-mail respondentów. W przypadku nowych formularzy domyślnie jest włączona opcja 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 — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setConfirmationMessage(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 — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setCustomClosedFormMessage(message)`

Ustawia wiadomość, która ma się wyświetlać, jeśli formularz nie przyjmuje odpowiedzi. Jeśli nie ustawisz żadnej wiadomości, formularz będzie używać domyślnej wiadomości.

// 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świetlać, gdy formularz nie przyjmuje odpowiedzi.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setDestination(type, id)`

Ustawia miejsce docelowe, w którym zapisywane są odpowiedzi z formularza. Wszystkie formularze, w tym te, które nie mają jawnie ustawionego miejsca docelowego, zapisują kopię odpowiedzi w magazynie odpowiedzi formularza.

Parametry

Nazwa	Typ	Opis
`type`	`DestinationType`	Typ miejsca docelowego odpowiedzi z formularza.
`id`	`String`	Identyfikator miejsca docelowego odpowiedzi formularza.

Powrót

Form — ten Form do łączenia.

Zgłasza

Error – jeśli podany identyfikator miejsca docelowego jest nieprawidłowy.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setIsQuiz(enabled)`

Określa, czy formularz jest testem. W przypadku nowych formularzy domyślnie jest włączona opcja false.

Pytania z oceną są dozwolone tylko w testach, 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łcenie formularza w test powoduje, że zaczyna on korzystać z 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 w formularzu mają być włączone funkcje quizu; `false`, jeśli nie.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setLimitOneResponsePerUser(enabled)`

Określa, czy formularz zezwala na przesłanie tylko jednej odpowiedzi przez użytkownika. W przypadku nowych formularzy domyślnie jest włączona opcja 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 powinien zezwalać na przesłanie tylko 1 odpowiedzi przez osobę odpowiadającą; `false` – jeśli nie.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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. W przypadku nowych formularzy domyślnie jest włączona opcja 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 wyświetla się pasek postępu; `false` jeśli nie.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setPublished(enabled)`

Określa, czy formularz jest opublikowany. W przypadku nowych formularzy domyślnie jest włączona opcja true.

Ta funkcja jest dostępna tylko w przypadku formularzy, które obsługują publikowanie. Użyj supportsAdvancedResponderPermissions(), aby sprawdzić, czy formularz obsługuje publikowanie.

Aby formularz był dostępny dla osób odpowiadających, musi zostać opublikowany. Ta metoda zastępuje wywołania setAcceptingResponses(enabled).

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

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

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

Parametry

Nazwa	Typ	Opis
`enabled`	`Boolean`	`true`, jeśli formularz ma zostać opublikowany, `false`, jeśli nie.

Powrót

Form — ten Form do łączenia.

Zgłasza

Error – jeśli wywołanie nastąpi w nieobsługiwanych formularzach.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setPublishingSummary(enabled)`

Określa, czy po przesłaniu formularza przez użytkownika ma się w nim wyświetlać link do podsumowania odpowiedzi. W przypadku nowych formularzy domyślnie jest włączona opcja false.

Parametry

Nazwa	Typ	Opis
`enabled`	`Boolean`	`true` czy w formularzu ma się wyświetlać link „Zobacz poprzednie odpowiedzi”; `false` jeśli nie.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setShowLinkToRespondAgain(enabled)`

Określa, czy po wypełnieniu formularza przez użytkownika wyświetla się link do przesłania kolejnej odpowiedzi. W przypadku nowych formularzy domyślnie jest włączona opcja true.

Parametry

Nazwa	Typ	Opis
`enabled`	`Boolean`	`true` czy w formularzu ma się wyświetlać link „Prześlij kolejną odpowiedź”; `false` jeśli nie.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 jest losowa.

Parametry

Nazwa	Typ	Opis
`shuffle`	`Boolean`	`true` czy kolejność pytań na każdej stronie formularza ma być losowa; `false` jeśli nie.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 w Formularzach.

Jeśli kod zawiera wyzwalacz onFormSubmit, wywołanie submitGrades() powoduje uruchomienie warunku onFormSubmit i powstanie nieskończonej pętli. Aby zapobiec nieskończonej pętli, dodaj kod, który sprawdza, czy oceny już istnieją, zanim wywołasz funkcję submitGrades().

Parametry

Nazwa	Typ	Opis
`responses`	`FormResponse[]`	Tablica wszystkich odpowiedzi na formularz.

Powrót

Form — ten Form do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`supportsAdvancedResponderPermissions()`

Określa, czy formularz obsługuje publikowanie. Ta metoda służy do określania, czy dostępne są metody setPublished(enabled) i isPublished() oraz uprawnienia odpowiadającego.

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

// Checks whether the form supports publishing or not and logs it to the
// console.
console.log(form.supportsAdvancedResponderPermissions());

Powrót

Boolean – true, jeśli formularz obsługuje publikowanie; false, jeśli nie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

Wycofane metody

`requiresLogin()`

Wycofano. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Określa, czy przed udzieleniem odpowiedzi użytkownicy muszą zalogować się na konto w tej samej domenie lub subdomenie.

// 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 zalogowania się użytkowników; false, jeśli nie.

`setRequireLogin(requireLogin)`

Wycofano. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Określa, czy przed udzieleniem odpowiedzi na formularz użytkownicy muszą zalogować się na konto w tej samej domenie lub poddomenie. Domyślnie w nowych formularzach jest włączona opcja false, chyba że administrator domeny zmieni to ustawienie.

Ta funkcja jest dostępna tylko w przypadku formularzy utworzonych przez użytkowników Google Workspace. Wymaganie logowania nie może dotyczyć użytkowników innych typów kont Google.

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

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

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

Parametry

Nazwa	Typ	Opis
`requireLogin`	`Boolean`	`true`, jeśli formularz wymaga zalogowania się użytkowników; `false`, jeśli nie.

Powrót

Form – bieżący formularz (do łączenia).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

Class Form Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Metody

Wycofane metody

Szczegółowa dokumentacja

addCheckboxGridItem()

Powrót

Autoryzacja

addCheckboxItem()

Powrót

Autoryzacja

addDateItem()

Powrót

Autoryzacja

addDateTimeItem()

Powrót

Autoryzacja

addDurationItem()

Powrót

Autoryzacja

addEditor(emailAddress)

Parametry

Powrót

Autoryzacja

addEditor(user)

Parametry

Powrót

Autoryzacja

addEditors(emailAddresses)

Parametry

Powrót

Autoryzacja

addGridItem()

Powrót

Autoryzacja

addImageItem()

Powrót

Autoryzacja

addListItem()

Powrót

Autoryzacja

addMultipleChoiceItem()

Powrót

Autoryzacja

addPageBreakItem()

Powrót

Autoryzacja

addParagraphTextItem()

Powrót

Autoryzacja

addPublishedReader(emailAddress)

Parametry

Powrót

Autoryzacja

addPublishedReader(user)

Parametry

Powrót

Autoryzacja

addPublishedReaders(emailAddresses)

Parametry

Powrót

Autoryzacja

addRatingItem()

Powrót

Autoryzacja

addScaleItem()

Powrót

Autoryzacja

addSectionHeaderItem()

Powrót

Autoryzacja

addTextItem()

Powrót

Autoryzacja

addTimeItem()

Powrót

Autoryzacja

addVideoItem()

Powrót

Autoryzacja

canEditResponse()

Class Form

`addCheckboxGridItem()`

`addCheckboxItem()`

`addDateItem()`

`addDateTimeItem()`

`addDurationItem()`

`addEditor(emailAddress)`

`addEditor(user)`

`addEditors(emailAddresses)`

`addGridItem()`

`addImageItem()`

`addListItem()`

`addMultipleChoiceItem()`

`addPageBreakItem()`

`addParagraphTextItem()`

`addPublishedReader(emailAddress)`

`addPublishedReader(user)`

`addPublishedReaders(emailAddresses)`

`addRatingItem()`

`addScaleItem()`

`addSectionHeaderItem()`

`addTextItem()`

`addTimeItem()`

`addVideoItem()`

`canEditResponse()`

`collectsEmail()`

`createResponse()`

`deleteAllResponses()`

`deleteItem(index)`

`deleteItem(item)`

`deleteResponse(responseId)`

`getConfirmationMessage()`

`getCustomClosedFormMessage()`

`getDescription()`

`getDestinationId()`

`getDestinationType()`

`getEditUrl()`

`getEditors()`

`getId()`

`getItemById(id)`

`getItems()`

`getItems(itemType)`

`getPublishedReaders()`

`getPublishedUrl()`

`getResponse(responseId)`

`getResponses()`