Class FormApp

FormApp

Bir 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 hizalama türlerinin listesi.
DestinationType	DestinationType	Form yanıtlarını depolayabilen hedef türlerinin listesi.
FeedbackType	FeedbackType	Feedbacks form türlerinin listesi.
ItemType	ItemType	Items form türlerinin listesi.
PageNavigationType	PageNavigationType	Sayfalarda gezinmeyle ilgili olası davranışların listesi.

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
createCheckboxValidation()	CheckboxValidationBuilder	CheckboxItem
createFeedback()	QuizFeedbackBuilder	Notlandırılabilir bir öğede geri bildirim ayarlamak için kullanılabilecek bir QuizFeedbackBuilder örneğini döndürür Item
createGridValidation()	GridValidationBuilder	GridItem üzerinde doğrulamayı ayarlamak için kullanılabilecek bir GridValidationBuilder örneği döndürür.
createParagraphTextValidation()	ParagraphTextValidationBuilder	ParagraphTextItem.
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üzenleyicisinin, komut dosyasının aşağıdaki işlemleri yapmasına izin veren kullanıcı arayüzü ortamının bir örneğini döndürür: Menü, iletişim kutusu ve kenar çubuğu gibi özellikler ekleyin.
openById(id)	Form	Belirtilen kimliğe sahip Form değerini döndürür.
openByUrl(url)	Form	Belirtilen URL'ye sahip Form değerini 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 ise istisna atar veya boş bırakın.

// 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

Fırlatma

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

Yetkilendirme

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

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

---

createCheckboxGridValidation()

CheckboxGridItem

Return

CheckboxGridValidationBuilder

---

createCheckboxValidation()

CheckboxItem

Return

CheckboxValidationBuilder

---

createFeedback()

Notlandırılabilir bir öğede geri bildirim ayarlamak için kullanılabilecek bir QuizFeedbackBuilder örneğini döndürür Item

Return

QuizFeedbackBuilder

---

createGridValidation()

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

Return

GridValidationBuilder

---

createParagraphTextValidation()

ParagraphTextItem.

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. Kullanıcının okuyabileceği formlarla komut dosyası kapsayıcıya bağlı değil, 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 null komut dosyası formu

Yetkilendirme

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

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

---

getUi()

Form düzenleyicisinin, komut dosyasının aşağıdaki işlemleri yapmasına izin veren kullanıcı arayüzü ortamının bir örneğini döndürür: Menü, iletişim kutusu ve kenar çubuğu gibi özellikler ekleyin. Bir komut dosyası yalnızca geçerli bir açık form düzenleyicisi örneğidir (katılımcının gördüğü görünüm değil) ve yalnızca komut dosyası forma bağlı olmalıdır. Daha fazla menü, iletişim kutusu ve kenar çubuğu 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ısının formu açma izni yok.

// 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 - belirtilen kimliğe sahip form

Fırlatma

Error: Belirtilen kimlik geçersizse veya kullanıcı yeterli bilgiye sahip değilse izinler

Yetkilendirme

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

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

---

openByUrl(url)

Belirtilen URL'ye sahip Form değerini döndürür. URL geçersizse veya Kullanıcının formu açma izni yok.

// 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	açılacak formun URL'si

Return

Form - belirtilen URL'ye sahip form

Fırlatma

Error: Belirtilen URL geçersizse veya kullanıcı yeterli içeriğe sahip değilse izinler

Yetkilendirme

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

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