Ta strona została przetłumaczona przez Cloud Translation API.

Class FormApp

Zezwala skryptowi na otwarcie istniejącego elementu 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ść	Typ	Opis
`Alignment`	`Alignment`	Lista typów wyrównania obrazów.
`DestinationType`	`DestinationType`	Lista typów miejsc docelowych, w których mogą być przechowywane odpowiedzi z formularza.
`FeedbackType`	`FeedbackType`	Lista typów formularza `Feedbacks`.
`ItemType`	`ItemType`	Lista typów formularza `Items`.
`PageNavigationType`	`PageNavigationType`	Lista możliwych zachowań podczas poruszania się po stronach.

Metody

Metoda	Zwracany typ	Krótki opis
`create(title)`	`Form`	Tworzy i zwraca nowy obiekt `Form`.
`createCheckboxGridValidation()`	`CheckboxGridValidationBuilder`	Zwraca wystąpienie obiektu CheckboxGridValidationBuilder, którego można użyć do ustawienia weryfikacji obiektu `CheckboxGridItem`.
`createCheckboxValidation()`	`CheckboxValidationBuilder`	Zwraca wystąpienie obiektu CheckboxValidationBuilder, którego można użyć do ustawienia weryfikacji obiektu `CheckboxItem`.
`createFeedback()`	`QuizFeedbackBuilder`	Zwraca wystąpienie obiektu QuizfeedbackBuilder, którego można używać do ustawiania opinii na temat elementu `Item` z możliwością oceny.
`createGridValidation()`	`GridValidationBuilder`	Zwraca wystąpienie obiektu GridValidationBuilder, którego można użyć do ustawienia weryfikacji obiektu `GridItem`.
`createParagraphTextValidation()`	`ParagraphTextValidationBuilder`	Zwraca wystąpienie obiektu ParagraphTextValidationBuilder, którego można użyć do ustawienia weryfikacji na obiekcie `ParagraphTextItem`.
`createTextValidation()`	`TextValidationBuilder`	Zwraca wystąpienie obiektu TextValidationBuilder, którego można użyć do sprawdzenia poprawności elementu `TextItem`.
`getActiveForm()`	`Form`	Zwraca formę, do której skrypt jest powiązany z kontenerem container-bound.
`getUi()`	`Ui`	Zwraca wystąpienie środowiska interfejsu użytkownika edytora formularzy, które umożliwia skryptowi dodawanie takich funkcji jak menu, okna i paski boczne.
`openById(id)`	`Form`	Zwraca wartość `Form` o określonym identyfikatorze.
`openByUrl(url)`	`Form`	Zwraca wartość `Form` z określonym adresem URL.

Szczegółowa dokumentacja

`create(title)`

Tworzy i zwraca nowy obiekt Form. Jeśli podany tytuł ma wartość null lub jest pusty, powoduje zgłoszenie wyjątku.

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

Parametry

Nazwa	Typ	Opis
`title`	`String`	nazwa nowego formularza;

Powroty

Form – nowy formularz

Rzuty

Error – jeśli tytuł ma wartość null lub jest pusty.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`createCheckboxGridValidation()`

Zwraca wystąpienie obiektu CheckboxGridValidationBuilder, którego można użyć do ustawienia weryfikacji obiektu CheckboxGridItem.

Powroty

CheckboxGridValidationBuilder

`createCheckboxValidation()`

Zwraca wystąpienie obiektu CheckboxValidationBuilder, którego można użyć do ustawienia weryfikacji obiektu CheckboxItem.

Powroty

CheckboxValidationBuilder

`createFeedback()`

Zwraca wystąpienie obiektu QuizfeedbackBuilder, którego można używać do ustawiania opinii na temat elementu Item z możliwością oceny.

Powroty

QuizFeedbackBuilder

`createGridValidation()`

Zwraca wystąpienie obiektu GridValidationBuilder, którego można użyć do ustawienia weryfikacji obiektu GridItem.

Powroty

GridValidationBuilder

`createParagraphTextValidation()`

Zwraca wystąpienie obiektu ParagraphTextValidationBuilder, którego można użyć do ustawienia weryfikacji na obiekcie ParagraphTextItem.

Powroty

ParagraphTextValidationBuilder

`createTextValidation()`

Zwraca wystąpienie obiektu TextValidationBuilder, którego można użyć do sprawdzenia poprawności elementu TextItem.

Powroty

TextValidationBuilder

`getActiveForm()`

Zwraca formę, do której skrypt jest powiązany z kontenerem container-bound. Do interakcji z formularzami, do których skrypt nie jest powiązany z kontenerem, użyj openById(id) lub openByUrl(url).

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

Powroty

Form – forma, z którą powiązany jest skrypt, lub null, jeśli skrypt nie jest powiązany z formularzem;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getUi()`

Zwraca wystąpienie środowiska interfejsu użytkownika edytora formularzy, które umożliwia skryptowi dodawanie takich funkcji jak menu, okna i paski boczne. Skrypt może wchodzić w interakcje z interfejsem tylko w przypadku bieżącego wystąpienia otwartego edytora formularzy (a nie widoku wyświetlanego użytkownikowi) i tylko wtedy, gdy skrypt jest powiązany z formularzem. Więcej informacji znajdziesz w przewodnikach po menu oraz oknach dialogowych 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();
}

Powroty

Ui – wystąpienie środowiska interfejsu użytkownika tego formularza

`openById(id)`

Zwraca wartość Form o określonym identyfikatorze. Zwraca wyjątek, jeśli identyfikator jest nieprawidłowy lub użytkownik nie ma uprawnień do otwarcia formularza.

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

Parametry

Nazwa	Typ	Opis
`id`	`String`	identyfikator formularza, który chcesz otworzyć

Powroty

Form – formularz o podanym identyfikatorze,

Rzuty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`openByUrl(url)`

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

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

Parametry

Nazwa	Typ	Opis
`url`	`String`	adres URL formularza, który chcesz otworzyć

Powroty

Form – formularz o podanym adresie URL,

Rzuty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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