Class Form

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

Formularz zawierający ogólne właściwości i elementy. Właściwości obejmują tytuł, ustawienia i miejsce przechowywania odpowiedzi. Elementy pytania obejmują elementy takie jak pola wyboru i elementy radiowe, a elementy układu dotyczą między innymi podziałów stron. Formularze można otwierać i tworzyć na stronie FormApp.

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

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

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

Metody

MetodaZwracany typKrótki opis
addCheckboxGridItem()CheckboxGridItemDodaje nowy element pytania przedstawiony w postaci siatki kolumn i wierszy, w której respondent może wybrać wiele opcji w danym wierszu w ramach sekwencji pól wyboru.
addCheckboxItem()CheckboxItemDodaje nowy element pytania, który pozwala respondentowi wybrać jedno lub kilka pól wyboru, a także opcjonalne pole „&"”.
addDateItem()DateItemDołącza nowy element pytania, który pozwala użytkownikowi określić datę.
addDateTimeItem()DateTimeItemDołącza nowy element pytania, który pozwala użytkownikowi określić datę i godzinę.
addDurationItem()DurationItemDodaje nowy element pytania, który umożliwia respondentowi wskazanie czasu trwania.
addEditor(emailAddress)FormDodaje danego użytkownika do listy edytorów Form.
addEditor(user)FormDodaje danego użytkownika do listy edytorów Form.
addEditors(emailAddresses)FormDodaje daną tablicę użytkowników do listy edytorów Form.
addGridItem()GridItemDodaje nowy element pytania, wyświetlany w postaci siatki i wierszy, w którym użytkownik może wybrać po 1 wierszu z sekwencji przycisków.
addImageItem()ImageItemDodaje nowy element układu, który wyświetla obraz.
addListItem()ListItemDołącza nowy element pytania, który pozwala respondentowi wybrać jeden z listy.
addMultipleChoiceItem()MultipleChoiceItemDodaje nowy element pytania, który pozwala respondentowi wybrać jeden z przycisków na liście opcji lub opcjonalne pole „&"”.
addPageBreakItem()PageBreakItemDołącza nowy element układu, który oznacza początek strony.
addParagraphTextItem()ParagraphTextItemDołącza nowy element pytania, który pozwala użytkownikowi wpisać blok tekstu.
addScaleItem()ScaleItemDodaje nowy element pytania, który pozwala respondentowi wybrać jedną z numerowanych opcji.
addSectionHeaderItem()SectionHeaderItemDołącza nowy element układu, który wizualnie wskazuje początek sekcji.
addTextItem()TextItemDołącza nowy element pytania, który pozwala użytkownikowi wpisać jeden wiersz tekstu.
addTimeItem()TimeItemDołącza nowy element pytania, który pozwala użytkownikowi określić porę dnia.
addVideoItem()VideoItemDodaje nowy element układu, który wyświetla film.
canEditResponse()BooleanOkreśla, czy po przesłaniu formularza jest wyświetlany link umożliwiający edytowanie odpowiedzi.
collectsEmail()BooleanOkreśla, czy formularz zbiera adresy e-mail ankietowanych.
createResponse()FormResponseTworzy nową odpowiedź na formularz.
deleteAllResponses()FormUsuwa wszystkie przesłane odpowiedzi z magazynu odpowiedzi.
deleteItem(index)voidUsuwa element z danego indeksu wśród wszystkich elementów w formularzu.
deleteItem(item)voidUsuwa określony element.
deleteResponse(responseId)FormUsuwa pojedynczą odpowiedź z magazynu formularzy.
getConfirmationMessage()StringPobiera komunikat z potwierdzeniem formularza.
getCustomClosedFormMessage()StringPobiera komunikat niestandardowy, który będzie wyświetlany, jeśli formularz nie przyjmuje odpowiedzi. W przypadku braku wiadomości przekazujemy pusty ciąg znaków.
getDescription()StringPobiera opis formularza.
getDestinationId()StringPobiera identyfikator miejsca docelowego odpowiedzi z formularza.
getDestinationType()DestinationTypePobiera typ miejsca docelowego odpowiedzi z formularza.
getEditUrl()StringPobiera adres URL, który może służyć do uzyskiwania dostępu do trybu edycji formularza.
getEditors()User[]Pobiera listę edytorów Form.
getId()StringPobiera identyfikator formularza.
getItemById(id)ItemPobiera element o podanym identyfikatorze.
getItems()Item[]Pobiera tablicę wszystkich elementów formularza.
getItems(itemType)Item[]Pobiera tablicę wszystkich elementów określonego typu.
getPublishedUrl()StringPobiera adres URL, którego można użyć do udzielenia odpowiedzi na formularz.
getResponse(responseId)FormResponsePobiera odpowiedź z 1 formularza na podstawie swojego identyfikatora odpowiedzi.
getResponses()FormResponse[]Pobiera tablicę wszystkich odpowiedzi z formularza.
getResponses(timestamp)FormResponse[]Pobiera tablicę wszystkich odpowiedzi formularza po określonej dacie i godzinie.
getShuffleQuestions()BooleanOkreśla, czy kolejność pytań na każdej stronie formularza jest losowa.
getSummaryUrl()StringPobiera adres URL, którego można używać do wyświetlania podsumowania odpowiedzi z formularza.
getTitle()StringPobiera tytuł formularza.
hasLimitOneResponsePerUser()BooleanOkreśla, czy w formularzu można wypełnić tylko jedną odpowiedź.
hasProgressBar()BooleanOkreśla, czy formularz ma wyświetlać pasek postępu.
hasRespondAgainLink()BooleanOkreśla, czy formularz wyświetla link umożliwiający przesłanie kolejnej odpowiedzi po wypełnieniu formularza.
isAcceptingResponses()BooleanOkreśla, czy formularz przyjmuje obecnie odpowiedzi.
isPublishingSummary()BooleanOkreśla, czy formularz ma wyświetlać link do wyświetlenia podsumowania odpowiedzi po wypełnieniu formularza.
isQuiz()BooleanOkreśla, czy formularz jest quizem.
moveItem(from, to)ItemPrzeniesienie elementu z danego indeksu do wszystkich elementów w formularzu do innego.
moveItem(item, toIndex)ItemPowoduje przeniesienie danego elementu do danego indeksu między wszystkimi elementami w formularzu.
removeDestination()FormOdłączanie formularza od miejsca docelowego odpowiedzi.
removeEditor(emailAddress)FormDanego użytkownika nie ma na liście edytorów Form.
removeEditor(user)FormDanego użytkownika nie ma na liście edytorów Form.
requiresLogin()BooleanOkreśla, czy formularz wymaga od użytkowników zalogowania się na konto w tej samej domenie lub subdomenie, zanim udzieli on odpowiedzi.
setAcceptingResponses(enabled)FormOkreśla, czy formularz przyjmuje obecnie odpowiedzi.
setAllowResponseEdits(enabled)FormOkreśla, czy po przesłaniu formularza jest wyświetlany link umożliwiający edytowanie odpowiedzi.
setCollectEmail(collect)FormOkreśla, czy formularz zbiera adresy e-mail ankietowanych.
setConfirmationMessage(message)FormUstawia komunikat z potwierdzeniem formularza.
setCustomClosedFormMessage(message)FormPowoduje wyświetlenie wiadomości, jeśli formularz nie przyjmuje odpowiedzi.
setDescription(description)FormUstawia opis formularza.
setDestination(type, id)FormOkreśla miejsce docelowe, w którym są zapisywane odpowiedzi na pytania formularza.
setIsQuiz(enabled)FormOkreśla, czy formularz jest quizem.
setLimitOneResponsePerUser(enabled)FormOkreśla, czy formularz zezwala tylko na jedną odpowiedź na respondenta.
setProgressBar(enabled)FormOkreśla, czy formularz ma pasek postępu.
setPublishingSummary(enabled)FormOkreśla, czy formularz ma wyświetlać link do wyświetlenia podsumowania odpowiedzi po przesłaniu formularza.
setRequireLogin(requireLogin)FormOkreśla, czy formularz wymaga od użytkowników zalogowania się na konto w tej samej domenie lub subdomenie, zanim udzieli on odpowiedzi.
setShowLinkToRespondAgain(enabled)FormOkreśla, czy po wypełnieniu formularza użytkownik zobaczy link umożliwiający przesłanie kolejnej odpowiedzi.
setShuffleQuestions(shuffle)FormOkreśla, czy kolejność pytań na każdej stronie formularza jest losowa.
setTitle(title)FormUstawia tytuł formularza.
shortenFormUrl(url)StringKonwertuje długi adres URL formularza na krótki adres URL.
submitGrades(responses)FormUmożliwia przesłanie ocen dla odpowiedzi z formularza.

Szczegółowa dokumentacja

addCheckboxGridItem()

Dodaje nowy element pytania przedstawiony w postaci siatki kolumn i wierszy, w której respondent może wybrać wiele opcji w danym wierszu w ramach sekwencji pól wyboru.

Zwróć

CheckboxGridItem – nowo utworzony element

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 pozwala respondentowi wybrać jedno lub kilka pól wyboru, a także opcjonalne pole „&"”.

Zwróć

CheckboxItem – nowo utworzony element

Autoryzacja

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

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

addDateItem()

Dołącza nowy element pytania, który pozwala użytkownikowi określić datę.

Zwróć

DateItem – nowo utworzony element

Autoryzacja

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

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

addDateTimeItem()

Dołącza nowy element pytania, który pozwala użytkownikowi określić datę i godzinę.

Zwróć

DateTimeItem – nowo utworzony element

Autoryzacja

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

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

addDurationItem()

Dodaje nowy element pytania, który umożliwia respondentowi wskazanie czasu trwania.

Zwróć

DurationItem – nowo utworzony element

Autoryzacja

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

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

addEditor(emailAddress)

Dodaje danego użytkownika do listy edytorów Form. Jeśli użytkownik był już na liście, ta metoda spowoduje, że zniknie on z listy widzów.

Parametry

NazwaTypOpis
emailAddressStringAdres e-mail użytkownika, którego chcesz dodać.

Zwróć

FormForm do łańcucha.

Autoryzacja

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

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

addEditor(user)

Dodaje danego użytkownika do listy edytorów Form. Jeśli użytkownik był już na liście, ta metoda spowoduje, że zniknie on z listy widzów.

Parametry

NazwaTypOpis
userUserWskazanie użytkownika do dodania.

Zwróć

FormForm do łańcucha.

Autoryzacja

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

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

addEditors(emailAddresses)

Dodaje daną tablicę użytkowników do listy edytorów Form. Jeśli któryś z użytkowników znalazł się już na liście widzów, ta metoda spowoduje wykluczenie go z listy widzów.

Parametry

NazwaTypOpis
emailAddressesString[]Tablica adresów e-mail użytkowników, których chcesz dodać.

Zwróć

FormForm do łańcucha.

Autoryzacja

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

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

addGridItem()

Dodaje nowy element pytania, wyświetlany w postaci siatki i wierszy, w którym użytkownik może wybrać po 1 wierszu z sekwencji przycisków.

Zwróć

GridItem – nowo utworzony element

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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.

Zwróć

ImageItem – nowo utworzony element

Autoryzacja

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

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

addListItem()

Dołącza nowy element pytania, który pozwala respondentowi wybrać jeden z listy.

Zwróć

ListItem – nowo utworzony element

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 pozwala respondentowi wybrać jeden z przycisków na liście opcji lub opcjonalne pole „&"”.

Zwróć

MultipleChoiceItem – nowo utworzony element

Autoryzacja

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

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

addPageBreakItem()

Dołącza nowy element układu, który oznacza początek strony.

Zwróć

PageBreakItem – nowo utworzony element

Autoryzacja

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

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

addParagraphTextItem()

Dołącza nowy element pytania, który pozwala użytkownikowi wpisać blok tekstu.

Zwróć

ParagraphTextItem – nowo utworzony element

Autoryzacja

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

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

addScaleItem()

Dodaje nowy element pytania, który pozwala respondentowi wybrać jedną z numerowanych opcji.

Zwróć

ScaleItem – nowo utworzony element

Autoryzacja

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

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

addSectionHeaderItem()

Dołącza nowy element układu, który wizualnie wskazuje początek sekcji.

Zwróć

SectionHeaderItem – nowo utworzony element

Autoryzacja

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

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

addTextItem()

Dołącza nowy element pytania, który pozwala użytkownikowi wpisać jeden wiersz tekstu.

Zwróć

TextItem – nowo utworzony element

Autoryzacja

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

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

addTimeItem()

Dołącza nowy element pytania, który pozwala użytkownikowi określić porę dnia.

Zwróć

TimeItem – nowo utworzony element

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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.

Zwróć

VideoItem – nowo utworzony element

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 jest wyświetlany link umożliwiający edytowanie odpowiedzi.

Niezależnie od tego ustawienia metoda FormResponse.getEditResponseUrl() zezwala autorowi skryptu, który ma uprawnienia do edycji formularza, na generowanie adresu URL do edycji odpowiedzi.

Zwróć

Booleantrue, jeśli formularz wyświetla &&;quot; Edytuj odpowiedź; false; jeśli nie

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 ankietowanych.

Zwróć

Booleantrue, jeśli formularz zawiera adresy e-mail; false – jeśli nie

Autoryzacja

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

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

createResponse()

Tworzy nową odpowiedź na formularz. Aby odpowiedzieć na pytanie, utwórz ItemResponse z tego elementu, a następnie dołącz do tej odpowiedzi formularz, wywołując FormResponse.withItemResponse(response). Aby zapisać zgromadzonych odpowiedzi, wywołaj polecenie FormResponse.submit().

Zwróć

FormResponse – nowo utworzona odpowiedź w formularzu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 magazynu odpowiedzi. Ta metoda nie powoduje usunięcia kopii odpowiedzi przechowywanych w zewnętrznym miejscu docelowym odpowiedzi (takim jak arkusz kalkulacyjny), ale powoduje usunięcie widoku podsumowania formularza.

Zwróć

Form – ten Form do łańcucha

Autoryzacja

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

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

deleteItem(index)

Usuwa element z danego indeksu wśród wszystkich elementów w formularzu. Zwraca wyjątek skryptu, jeśli w danym indeksie nie ma elementu.

Parametry

NazwaTypOpis
indexIntegerindeks elementu wśród wszystkich elementów w formularzu

Narzuty

Error – jeśli w danym indeksie nie ma elementu,

Autoryzacja

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

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

deleteItem(item)

Usuwa określony element. Zwraca wyjątek skryptu, jeśli element został już usunięty.

Parametry

NazwaTypOpis
itemItemelement do usunięcia

Narzuty

Error – jeśli element nie istnieje w formularzu,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 magazynu formularzy. Ta metoda nie powoduje usunięcia kopii odpowiedzi zapisanych w zewnętrznym miejscu docelowym odpowiedzi (np. arkusza kalkulacyjnego), ale powoduje usunięcie odpowiedzi z widoku podsumowania formularza. Identyfikator odpowiedzi można pobrać za pomocą metody FormResponse.getId().

Parametry

NazwaTypOpis
responseIdStringidentyfikator odpowiedzi na formularz, który chcesz usunąć.

Zwróć

Form – ten Form do łańcucha

Autoryzacja

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

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

getConfirmationMessage()

Pobiera komunikat z potwierdzeniem formularza.

Zwróć

String – wiadomość z potwierdzeniem formularza

Autoryzacja

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

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

getCustomClosedFormMessage()

Pobiera komunikat niestandardowy, który będzie wyświetlany, jeśli formularz nie przyjmuje odpowiedzi. W przypadku braku wiadomości przekazujemy pusty ciąg znaków.

Zwróć

String – niestandardowa wiadomość, która wyświetli się, gdy formularz nie będzie odpowiadać, lub pusty ciąg tekstowy, jeśli nie ustawiono żadnej wiadomości.

Autoryzacja

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

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

getDescription()

Pobiera opis formularza.

Zwróć

String – opis formularza

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 z formularza.

Zwróć

String – identyfikator miejsca docelowego odpowiedzi,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 z formularza.

Zwróć

DestinationType – typ miejsca docelowego odpowiedzi

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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óry może służyć do uzyskiwania dostępu do trybu edycji formularza.

Zwróć

String – URL do edytowania formularza,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 Form.

Zwróć

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

Autoryzacja

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

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

getId()

Pobiera identyfikator formularza.

Zwróć

String – identyfikator formularza;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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.

Parametry

NazwaTypOpis
idIntegeridentyfikator elementu

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 formularza.

Zwróć

Item[] – tablica wszystkich elementów formularza;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 określonego typu.

Parametry

NazwaTypOpis
itemTypeItemTypetyp elementów do pobrania.

Zwróć

Item[] – tablica wszystkich elementów danego typu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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órego można użyć do udzielenia odpowiedzi na formularz.

Zwróć

String – adres URL odpowiedzi na formularz.

Autoryzacja

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

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

getResponse(responseId)

Pobiera odpowiedź z 1 formularza na podstawie swojego identyfikatora odpowiedzi. Identyfikatory odpowiedzi można pobrać z FormResponse.getId().

Parametry

NazwaTypOpis
responseIdStringidentyfikator odpowiedzi na formularz;

Zwróć

FormResponse – odpowiedź na formularz;

Narzuty

Error – jeśli odpowiedź nie istnieje

Autoryzacja

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

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

getResponses()

Pobiera tablicę wszystkich odpowiedzi z formularza.

Zwróć

FormResponse[] – tablica wszystkich odpowiedzi na formularz;

Autoryzacja

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

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

getResponses(timestamp)

Pobiera tablicę wszystkich odpowiedzi formularza po określonej dacie i godzinie.

Parametry

NazwaTypOpis
timestampDatenajwcześniejsza data i godzina, dla której zostaną zwrócone odpowiedzi z formularza

Zwróć

FormResponse[] – lista odpowiedzi na pytania z formularza.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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.

Zwróć

Booleantrue, jeśli kolejność pytań na każdej stronie formularza jest losowa; false, jeśli nie

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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żywać do wyświetlania podsumowania odpowiedzi z formularza. Jeśli zasada setPublishingSummary(enabled) nie jest ustawiona na true, dostęp do adresu URL mają tylko użytkownicy z uprawnieniami do edycji.

Zwróć

String – URL wyświetlający podsumowanie odpowiedzi;

Autoryzacja

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

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

getTitle()

Pobiera tytuł formularza.

Zwróć

String – tytuł formularza.

Autoryzacja

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

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

hasLimitOneResponsePerUser()

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

Zwróć

Booleantrue, jeśli formularz zezwala tylko na jedną odpowiedź na respondenta; false jeśli nie

Autoryzacja

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

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

hasProgressBar()

Określa, czy formularz ma wyświetlać pasek postępu.

Zwróć

Booleantrue, jeśli formularz zawiera pasek postępu; false – jeśli nie

Autoryzacja

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

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

Określa, czy formularz wyświetla link umożliwiający przesłanie kolejnej odpowiedzi po wypełnieniu formularza.

Zwróć

Booleantrue, jeśli formularz wyświetla &&;; prześlij kolejną odpowiedź; false; jeśli nie

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 przyjmuje obecnie odpowiedzi.

Zwróć

Booleantrue, jeśli formularz przyjmuje odpowiedzi; false – jeśli nie

Autoryzacja

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

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

isPublishingSummary()

Określa, czy formularz ma wyświetlać link do wyświetlenia podsumowania odpowiedzi po wypełnieniu formularza.

Zwróć

Booleantrue, jeśli formularz wyświetla &" wyświetl poprzednie odpowiedzi; false; jeśli nie

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 quizem.

Zwróć

Booleantrue, jeśli formularz przyjmuje odpowiedzi; false – jeśli nie

Autoryzacja

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

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

moveItem(from, to)

Przeniesienie elementu z danego indeksu do wszystkich elementów w formularzu do innego. Zwraca wyjątek skryptu, jeśli indeks to wykracza poza granice.

Parametry

NazwaTypOpis
fromIntegerbieżący indeks elementu wśród wszystkich elementów w formularzu
toIntegernowy indeks elementu wśród wszystkich elementów w formularzu

Zwróć

Item – przeniesiony element

Narzuty

Error – jeśli któryś z indeksów wykracza poza granice

Autoryzacja

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

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

moveItem(item, toIndex)

Powoduje przeniesienie danego elementu do danego indeksu między wszystkimi elementami w formularzu. Zwraca wyjątek skryptu, jeśli dany indeks wykracza poza granice.

Parametry

NazwaTypOpis
itemItemelement do przeniesienia
toIndexIntegernowy indeks elementu wśród wszystkich elementów w formularzu

Zwróć

Item – przeniesiony element

Narzuty

Error – indeks wykracza poza granice

Autoryzacja

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

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

removeDestination()

Odłączanie formularza od miejsca docelowego odpowiedzi. Odłączone poprzednie miejsce docelowe nadal zawiera kopię wszystkich wcześniejszych odpowiedzi. Wszystkie formularze, w tym te, które nie mają wyraźnie określonego miejsca docelowego, zapisz kopię odpowiedzi w formularzu odpowiedzi. Jeśli formularz nie ma obecnie miejsca docelowego odpowiedzi, ta metoda nie działa.

Zwróć

Form – ten Form do łańcucha

Autoryzacja

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

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

removeEditor(emailAddress)

Danego użytkownika nie ma na liście edytorów Form. Ta metoda nie blokuje użytkownikom dostępu do jednostki organizacyjnej Form, jeśli należą one do grupy użytkowników, którzy mają dostęp ogólny – na przykład gdy Form jest udostępniony całej domenie użytkownika lub jeśli Form jest na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików z Dysku ten użytkownik zostanie też usunięty z listy przeglądających.

Parametry

NazwaTypOpis
emailAddressStringAdres e-mail użytkownika, którego chcesz usunąć.

Zwróć

FormForm do łańcucha.

Autoryzacja

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

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

removeEditor(user)

Danego użytkownika nie ma na liście edytorów Form. Ta metoda nie blokuje użytkownikom dostępu do jednostki organizacyjnej Form, jeśli należą one do grupy użytkowników, którzy mają dostęp ogólny – na przykład gdy Form jest udostępniony całej domenie użytkownika lub jeśli Form jest na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików z Dysku ten użytkownik zostanie też usunięty z listy przeglądających.

Parametry

NazwaTypOpis
userUserPrezentacja użytkownika do usunięcia.

Zwróć

FormForm do łańcucha.

Autoryzacja

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

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

requiresLogin()

Określa, czy formularz wymaga od użytkowników zalogowania się na konto w tej samej domenie lub subdomenie, zanim udzieli on odpowiedzi.

Zwróć

Booleantrue, jeśli formularz wymaga zalogowania się; false – jeśli nie


setAcceptingResponses(enabled)

Określa, czy formularz przyjmuje obecnie odpowiedzi. Domyślnym nowym formularzem jest true.

Parametry

NazwaTypOpis
enabledBooleantrue, jeśli formularz powinien zaakceptować odpowiedzi; false – jeśli nie

Zwróć

Form – ten Form do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 formularza jest wyświetlany link umożliwiający edytowanie odpowiedzi. Domyślnie nowe formularze to false.

Niezależnie od tego ustawienia metoda FormResponse.getEditResponseUrl() zezwala autorowi skryptu na edytowanie formularza i generowanie adresu URL, który można wykorzystać do edytowania odpowiedzi.

Parametry

NazwaTypOpis
enabledBooleantrue, jeśli formularz powinien wyświetlać link „Edytuj odpowiedź”; false jeśli nie

Zwróć

Form – ten Form do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 zbiera adresy e-mail ankietowanych. Domyślnie nowe formularze to false.

Parametry

NazwaTypOpis
collectBooleantrue, jeśli formularz powinien zbierać adresy e-mail; false – jeśli nie

Zwróć

Form – ten Form do łańcucha

Autoryzacja

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

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

setConfirmationMessage(message)

Ustawia komunikat z potwierdzeniem formularza.

Parametry

NazwaTypOpis
messageStringnowa wiadomość z potwierdzeniem

Zwróć

Form – ten Form do łańcucha

Autoryzacja

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

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

setCustomClosedFormMessage(message)

Powoduje wyświetlenie wiadomości, jeśli formularz nie przyjmuje odpowiedzi. Jeśli nie ustawisz żadnej wiadomości, w formularzu używany będzie komunikat domyślny.

Parametry

NazwaTypOpis
messageStringkomunikat wyświetlany, gdy formularz nie przyjmuje odpowiedzi;

Zwróć

Form – ten Form do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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

NazwaTypOpis
descriptionStringnowy opis formularza

Zwróć

Form – ten Form do łańcucha

Autoryzacja

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

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

setDestination(type, id)

Określa miejsce docelowe, w którym są zapisywane odpowiedzi na pytania formularza. Wszystkie formularze, w tym te, które nie mają wyraźnie określonego miejsca docelowego, zapisz kopię odpowiedzi w formularzu odpowiedzi.

Parametry

NazwaTypOpis
typeDestinationTypetyp miejsca docelowego odpowiedzi na formularz,
idStringidentyfikator miejsca docelowego odpowiedzi

Zwróć

Form – ten Form do łańcucha

Narzuty

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 quizem. Domyślnym nowym formularzem jest false.

Ocenianie pytań jest dozwolone tylko w Testach. Jeśli więc ustawisz wartość fałsz, wszystkie opcje oceniania zostaną usunięte ze wszystkich pytań.

Ustawienia quizu są dostępne tylko w nowym interfejsie Formularzy. Utworzenie formularza quizu spowoduje włączenie go do korzystania z nowego interfejsu.

Parametry

NazwaTypOpis
enabledBooleantrue, jeśli w formularzu powinny być włączone funkcje quizu; false – jeśli nie

Zwróć

Form – ten Form do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 tylko na jedną odpowiedź na respondenta. Domyślnie nowe formularze to false. Jeśli ma wartość true, skrypt w ogóle nie może przesyłać odpowiedzi.

Parametry

NazwaTypOpis
enabledBooleantrue – jeśli formularz powinien zezwalać tylko na jedną odpowiedź (false); jeśli nie

Zwróć

Form – ten Form do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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. Domyślnym nowym formularzem jest false.

Parametry

NazwaTypOpis
enabledBooleantrue, jeśli formularz powinien wyświetlać pasek postępu; false, jeśli nie

Zwróć

Form – ten Form do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 formularz ma wyświetlać link do wyświetlenia podsumowania odpowiedzi po przesłaniu formularza. Domyślnym nowym formularzem jest false.

Parametry

NazwaTypOpis
enabledBooleantrue, jeśli formularz powinien wyświetlać &&;link do poprzednich odpowiedzi; false; jeśli nie

Zwróć

Form – ten Form do łańcucha

Autoryzacja

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

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

setRequireLogin(requireLogin)

Określa, czy formularz wymaga od użytkowników zalogowania się na konto w tej samej domenie lub subdomenie, zanim udzieli on odpowiedzi. Ustawieniem domyślnym nowych formularzy jest false, chyba że administrator domeny je zmieni.

Ta funkcja jest dostępna tylko w przypadku formularzy utworzonych przez użytkowników Google Workspace. Użytkownicy innych typów kont Google nie mogą się logować.

Parametry

NazwaTypOpis
requireLoginBooleantrue, jeśli formularz wymaga zalogowania się; false – jeśli nie

Zwróć

Form – bieżący formularz (do łańcucha).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 użytkownik zobaczy link umożliwiający przesłanie kolejnej odpowiedzi. Domyślnym nowym formularzem jest true.

Parametry

NazwaTypOpis
enabledBooleantrue, jeśli formularz powinien wyświetlać &&;prześlij kolejną odpowiedź; false; jeśli nie

Zwróć

Form – ten Form do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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

NazwaTypOpis
shuffleBooleantrue, jeśli kolejność pytań na każdej stronie formularza powinna być losowa; false, jeśli nie

Zwróć

Form – ten Form do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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

NazwaTypOpis
titleStringnowy tytuł formularza

Zwróć

Form – ten Form do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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. Zwraca wyjątek, jeśli długi URL nie pasuje do Formularzy Google.

Parametry

NazwaTypOpis
urlString

Zwróć

String – adres URL w formacie http://goo.gl/forms/1234

Autoryzacja

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

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

submitGrades(responses)

Umożliwia przesłanie ocen dla odpowiedzi z formularza.

Jeśli kod zawiera regułę onFormSubmit, wywołanie metody submitGrades() powoduje uruchomienie warunku onFormSubmit i pętlę nieskończoną. Aby uniknąć nieskończonej pętli, przed wywołaniem metody submitGrades() dodaj kod, który sprawdza, czy oceny już istnieją.

Parametry

NazwaTypOpis
responsesFormResponse[]

Zwróć

FormForm do łańcucha.

Autoryzacja

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

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