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

Class FormApp

Komut dosyasının mevcut bir Form dosyasını açmasına veya yeni bir dosya oluşturmasına olanak tanır.

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

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

Özellikler

Mülk	Tür	Açıklama
`Alignment`	`Alignment`	Resim hizalama türlerinin listesi.
`DestinationType`	`DestinationType`	Form yanıtlarını depolayabilecek hedef türlerinin bir listesi.
`FeedbackType`	`FeedbackType`	`Feedbacks` formu türlerinin bir listesi.
`ItemType`	`ItemType`	`Items` formu türlerinin bir listesi.
`PageNavigationType`	`PageNavigationType`	Sayfalarda gezinmeyle ilgili olası davranışların listesi.
`RatingIconType`	`RatingIconType`	Puan simgesi türlerinin listesi `RatingIcons`

Yöntemler

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

Ayrıntılı dokümanlar

`create(title)`

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

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

Parametreler

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

Return

Form: Yeni form

Atışlar

Error: Belirtilen başlık null ise veya boşsa

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`createCheckboxGridValidation()`

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

Return

CheckboxGridValidationBuilder

`createCheckboxValidation()`

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

Return

CheckboxValidationBuilder

`createFeedback()`

Not verilebilir bir Item hakkında geri bildirim ayarlamak için kullanılabilecek bir QuizFeedbackBuilder örneği döndürür.

Return

QuizFeedbackBuilder

`createGridValidation()`

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

Return

GridValidationBuilder

`createParagraphTextValidation()`

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

Return

ParagraphTextValidationBuilder

`createTextValidation()`

TextItem üzerinde doğrulama ayarlamak için kullanılabilecek bir TextValidationBuilder örneği 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ıya 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.
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getUi()`

Komut dosyasının menü, iletişim kutusu ve kenar çubuğu gibi özellikler eklemesine olanak tanıyan form düzenleyicinin kullanıcı arayüzü ortamının bir örneğini döndürür. Bir komut dosyası yalnızca açık form düzenleyicinin mevcut örneğinin kullanıcı arayüzüyle (katılımcının gördüğü görünüm değil) etkileşime geçebilir ve yalnızca komut dosyası forma bağlıysa. Daha fazla bilgi için menüler ve iletişim kutuları ve kenar çubukları ile ilgili kılavuzları inceleyin.

// 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 öğesini döndürür. Kimlik geçersizse veya kullanıcının formu açma izni yoksa istisna oluşturur.

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

Parametreler

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

Return

Form: Belirtilen kimliğe sahip form

Atışlar

Error: Belirtilen kimlik geçersizse veya kullanıcının yeterli izni yoksa

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`openByUrl(url)`

Belirtilen URL ile Form değerini döndürür. URL geçersizse veya kullanıcının formu açma izni yoksa istisna atar.

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

Parametreler

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

Return

Form: Belirtilen URL'ye sahip form

Atışlar

Error: Belirtilen URL geçersizse veya kullanıcının yeterli izni yoksa

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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