Bu sayfa, Cloud Translation API ile çevrilmiştir.

Class FormApp

Komut dosyasının mevcut bir Form öğesini açmasına veya yeni bir tane oluşturmasına izin verir.

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

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

Özellikler

Özellik	Tür	Açıklama
`Alignment`	`Alignment`	Resim hizalaması türlerinin sıralaması.
`DestinationType`	`DestinationType`	Form yanıtlarını depolayabilen hedef türlerinin sıralaması.
`FeedbackType`	`FeedbackType`	`Feedbacks` form türlerinin sıralaması.
`ItemType`	`ItemType`	`Items` form türlerinin sıralaması.
`PageNavigationType`	`PageNavigationType`	Sayfalarda gezinmeyle ilgili olası davranışların sıralaması.

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`create(title)`	`Form`	Yeni bir `Form` oluşturur ve döndürür.
`createCheckboxGridValidation()`	`CheckboxGridValidationBuilder`	`CheckboxGridItem` üzerinde doğrulamayı ayarlamak için kullanılabilecek bir CheckboxGridValidationBuilder örneğini döndürür.
`createCheckboxValidation()`	`CheckboxValidationBuilder`	`CheckboxItem` üzerinde doğrulamayı ayarlamak için kullanılabilecek bir CheckboxValidationBuilder örneği döndürür.
`createFeedback()`	`QuizFeedbackBuilder`	Not verilebilir bir `Item` ile ilgili geri bildirim ayarlamak için kullanılabilecek QuizfeedbackBuilder örneğini döndürür.
`createGridValidation()`	`GridValidationBuilder`	`GridItem` üzerinde doğrulamayı ayarlamak için kullanılabilecek bir GridValidationBuilder örneğini döndürür.
`createParagraphTextValidation()`	`ParagraphTextValidationBuilder`	`ParagraphTextItem` üzerinde doğrulamayı ayarlamak için kullanılabilecek bir ParagraphTextValidationBuilder örneğini döndürür.
`createTextValidation()`	`TextValidationBuilder`	`TextItem` üzerinde doğrulamayı ayarlamak için kullanılabilecek bir TextValidationBuilder örneğini döndürür.
`getActiveForm()`	`Form`	Komut dosyasının kapsayıcıya bağlı olduğu formu döndürür.
`getUi()`	`Ui`	Form düzenleyicinin, komut dosyasının menü, iletişim kutusu ve kenar çubuğu gibi özellikler eklemesine izin veren kullanıcı arayüzü ortamının bir örneğini döndürür.
`openById(id)`	`Form`	Belirtilen kimliğe sahip `Form` değerini döndürür.
`openByUrl(url)`	`Form`	Belirtilen URL ile `Form` döndürür.

Ayrıntılı belgeler

`create(title)`

Yeni bir Form oluşturur ve döndürür. Belirtilen başlık null veya boşsa istisna oluşturur.

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

Parametreler

Ad	Tür	Açıklama
`title`	`String`	yeni formun adı

Return

Form - yeni form

Dekoratif yastıklar

Error: Başlık null veya boşsa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

`createCheckboxGridValidation()`

CheckboxGridItem üzerinde doğrulamayı ayarlamak için kullanılabilecek bir CheckboxGridValidationBuilder örneğini döndürür.

Return

CheckboxGridValidationBuilder

`createCheckboxValidation()`

CheckboxItem üzerinde doğrulamayı ayarlamak için kullanılabilecek bir CheckboxValidationBuilder örneği döndürür.

Return

CheckboxValidationBuilder

`createFeedback()`

Not verilebilir bir Item ile ilgili geri bildirim ayarlamak için kullanılabilecek QuizfeedbackBuilder örneğini döndürür.

Return

QuizFeedbackBuilder

`createGridValidation()`

GridItem üzerinde doğrulamayı ayarlamak için kullanılabilecek bir GridValidationBuilder örneğini döndürür.

Return

GridValidationBuilder

`createParagraphTextValidation()`

ParagraphTextItem üzerinde doğrulamayı ayarlamak için kullanılabilecek bir ParagraphTextValidationBuilder örneğini döndürür.

Return

ParagraphTextValidationBuilder

`createTextValidation()`

TextItem üzerinde doğrulamayı ayarlamak için kullanılabilecek bir TextValidationBuilder örneğini döndürür.

Return

TextValidationBuilder

`getActiveForm()`

Komut dosyasının kapsayıcıya bağlı olduğu formu döndürür. Komut dosyasının kapsayıcı bağlı olmadığı formlarla etkileşimde bulunmak için bunun yerine openById(id) veya openByUrl(url) kullanın.

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

Return

Form — komut dosyasının bağlı olduğu form veya komut dosyası bir forma bağlı değilse null

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

`getUi()`

Form düzenleyicinin, komut dosyasının menü, iletişim kutusu ve kenar çubuğu gibi özellikler eklemesine izin veren kullanıcı arayüzü ortamının bir örneğini döndürür. Bir komut dosyası yalnızca komut dosyasının forma bağlı olması durumunda (katılımcının gördüğü görünüm değil) açık bir form düzenleyicinin geçerli örneği için kullanıcı arayüzüyle etkileşimde bulunabilir. Daha fazla bilgi için menüler ile iletişim kutuları ve kenar çubukları kılavuzlarına bakın.

// 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();
}

Return

Ui — bu formun kullanıcı arayüzü ortamının bir örneği

`openById(id)`

Belirtilen kimliğe sahip Form değerini döndürür. Kimlik geçersizse veya kullanıcının formu açma izni yoksa bir istisna oluşturur.

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

Parametreler

Ad	Tür	Açıklama
`id`	`String`	açılacak formun kimliği

Return

Form: Verilen kimliğe sahip form

Dekoratif yastıklar

Error - Belirtilen kimlik geçersizse veya kullanıcının yeterli izinleri yoksa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

`openByUrl(url)`

Belirtilen URL ile Form döndürür. URL geçersizse veya kullanıcının formu açma izni yoksa istisna oluşturur.

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

Parametreler

Ad	Tür	Açıklama
`url`	`String`	formun URL'sini

Return

Form — belirtilen URL'yi içeren form

Dekoratif yastıklar

Error - Belirtilen URL geçersizse veya kullanıcının yeterli izinleri yoksa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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