Class FormApp

FormApp

Pozwala na otwarcie istniejącego skryptu Form lub utworzenie nowego.

// Open a form by ID.
var existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Create and open a form.
var newForm = FormApp.create('Form Name');

Właściwości

WłaściwośćTypOpis
AlignmentAlignmentLista typów wyrównania obrazu.
DestinationTypeDestinationTypeLista typów miejsc docelowych, w których mogą być przechowywane odpowiedzi na pytania z formularza.
FeedbackTypeFeedbackTypeLista typów w postaci Feedbacks.
ItemTypeItemTypeLista typów w postaci Items.
PageNavigationTypePageNavigationTypeLista możliwych zachowań podczas poruszania się po stronach.

Metody

MetodaZwracany typKrótki opis
create(title)FormTworzy i zwraca nowy element Form.
createCheckboxGridValidation()CheckboxGridValidationBuilderZwraca instancję CheckboxGridValidationBuilder, która służy do ustawiania weryfikacji CheckboxGridItem.
createCheckboxValidation()CheckboxValidationBuilderZwraca instancję CheckboxValidationBuilder, która służy do ustawiania weryfikacji CheckboxItem.
createFeedback()QuizFeedbackBuilderZwraca instancję TestfeedbackBuilder, której można użyć do ustawienia opinii na temat oceny Item.
createGridValidation()GridValidationBuilderZwraca instancję GridValidationBuilder, która może służyć do ustawiania weryfikacji GridItem.
createParagraphTextValidation()ParagraphTextValidationBuilderZwraca instancję ParagraphTextValidationBuilder, za pomocą której można ustawić weryfikację ParagraphTextItem.
createTextValidation()TextValidationBuilderZwraca instancję TextValidationBuilder, która może służyć do ustawiania weryfikacji TextItem.
getActiveForm()FormZwraca formularz, do którego skrypt jest powiązany z kontenerem.
getUi()UiZwraca wystąpienie środowiska edytora formularzy i interfejsu użytkownika, które umożliwia skryptowi dodanie funkcji, takich jak menu, okna i paski boczne.
openById(id)FormZwraca Form o podanym identyfikatorze.
openByUrl(url)FormZwraca Form z określonym adresem URL.

Szczegółowa dokumentacja

create(title)

Tworzy i zwraca nowy element Form. Zwraca wyjątek, jeśli podany tytuł to null lub jest pusty.

// Create and open a form.
var form = FormApp.create('Form Name');

Parametry

NazwaTypOpis
titleStringnazwa nowego formularza;

Zwróć

Form – nowy formularz

Narzuty

Error – jeśli podany tytuł to null lub jest pusty

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

createCheckboxGridValidation()

Zwraca instancję CheckboxGridValidationBuilder, która służy do ustawiania weryfikacji CheckboxGridItem.

Zwróć

CheckboxGridValidationBuilder


createCheckboxValidation()

Zwraca instancję CheckboxValidationBuilder, która służy do ustawiania weryfikacji CheckboxItem.

Zwróć

CheckboxValidationBuilder


createFeedback()

Zwraca instancję TestfeedbackBuilder, której można użyć do ustawienia opinii na temat oceny Item.

Zwróć

QuizFeedbackBuilder


createGridValidation()

Zwraca instancję GridValidationBuilder, która może służyć do ustawiania weryfikacji GridItem.

Zwróć

GridValidationBuilder


createParagraphTextValidation()

Zwraca instancję ParagraphTextValidationBuilder, za pomocą której można ustawić weryfikację ParagraphTextItem.

Zwróć

ParagraphTextValidationBuilder


createTextValidation()

Zwraca instancję TextValidationBuilder, która może służyć do ustawiania weryfikacji TextItem.

Zwróć

TextValidationBuilder


getActiveForm()

Zwraca formularz, do którego skrypt jest powiązany z kontenerem. Aby wchodzić w interakcje z formularzami, które nie są powiązane z kontenerem, użyj metody openById(id) lub openByUrl(url).

// Get the form to which this script is bound.
var form = FormApp.getActiveForm();

Zwróć

Form – formularz, z którym skrypt jest powiązany, lub null, jeśli skrypt nie jest powiązany z formularzem.

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

getUi()

Zwraca wystąpienie środowiska edytora formularzy i interfejsu użytkownika, które umożliwia skryptowi dodanie funkcji, takich jak menu, okna i paski boczne. Skrypt może wchodzić w interakcję z interfejsem tylko w bieżącym wystąpieniu edytora formularzy (a nie w widoku, który widzi użytkownik) i tylko wtedy, gdy skrypt jest powiązany z formularzem. Więcej informacji znajdziesz w przewodnikach po menu i oknach i paskach bocznych.

// Add a custom menu to the active form, including a separator and a sub-menu.
function onOpen(e) {
  FormApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(FormApp.getUi().createMenu('My sub-menu')
          .addItem('One sub-menu item', 'mySecondFunction')
          .addItem('Another sub-menu item', 'myThirdFunction'))
      .addToUi();
}

Zwróć

Ui – wystąpienie tego formularza i interfejsu użytkownika


openById(id)

Zwraca Form o podanym identyfikatorze. Zwraca wyjątek, jeśli identyfikator jest nieprawidłowy lub użytkownik nie ma uprawnień do otwierania formularza.

// Open a form by ID.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

Parametry

NazwaTypOpis
idStringidentyfikator formularza, który chcesz otworzyć;

Zwróć

Form – formularz o podanym identyfikatorze.

Narzuty

Error – jeśli podany identyfikator jest nieprawidłowy lub użytkownik nie ma wystarczających uprawnień;

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

openByUrl(url)

Zwraca Form z określonym adresem URL. Zwraca wyjątek, jeśli URL jest nieprawidłowy lub użytkownik nie ma uprawnień do otwierania formularza.

// Open a form by URL.
var form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit'
    );

Parametry

NazwaTypOpis
urlStringadres URL formularza, który chcesz otworzyć.

Zwróć

Form – formularz o podanym adresie URL,

Narzuty

Error – jeśli podany adres URL jest nieprawidłowy lub użytkownik nie ma wystarczających uprawnień

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