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. |
Destination | Destination | Form yanıtlarını depolayabilecek hedef türlerinin bir listesi. |
Feedback | Feedback | Feedbacks formu türlerinin bir listesi. |
Item | Item | Items formu türlerinin bir listesi. |
Page | Page | 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şturup döndürür. |
create | Checkbox | Checkbox üzerinde doğrulama ayarlamak için kullanılabilecek bir CheckboxGridValidationBuilder örneği döndürür. |
create | Checkbox | Checkbox üzerinde doğrulama ayarlamak için kullanılabilecek bir CheckboxValidationBuilder örneği döndürür. |
create | Quiz | Not verilebilir bir Item hakkında geri bildirim ayarlamak için kullanılabilecek bir QuizFeedbackBuilder örneği döndürür. |
create | Grid | Grid üzerinde doğrulama ayarlamak için kullanılabilecek bir GridValidationBuilder örneği döndürür. |
create | Paragraph | Paragraph üzerinde doğrulama ayarlamak için kullanılabilecek bir ParagraphTextValidationBuilder örneği döndürür. |
create | Text | Text üzerinde doğrulama ayarlamak için kullanılabilecek bir TextValidationBuilder örneği döndürür. |
get | Form | Komut dosyasının kapsayıcıya bağlı olduğu formu döndürür. |
get | 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. |
open | Form | Belirtilen kimliğe sahip Form öğesini döndürür. |
open | 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
create Checkbox Grid Validation()
Checkbox
üzerinde doğrulama ayarlamak için kullanılabilecek bir CheckboxGridValidationBuilder örneği döndürür.
Return
create Checkbox Validation()
Checkbox
üzerinde doğrulama ayarlamak için kullanılabilecek bir CheckboxValidationBuilder örneği döndürür.
Return
create Feedback()
Not verilebilir bir Item
hakkında geri bildirim ayarlamak için kullanılabilecek bir QuizFeedbackBuilder örneği döndürür.
Return
create Grid Validation()
Grid
üzerinde doğrulama ayarlamak için kullanılabilecek bir GridValidationBuilder örneği döndürür.
Return
create Paragraph Text Validation()
Paragraph
üzerinde doğrulama ayarlamak için kullanılabilecek bir ParagraphTextValidationBuilder örneği döndürür.
Return
create Text Validation()
Text
üzerinde doğrulama ayarlamak için kullanılabilecek bir TextValidationBuilder örneği döndürür.
Return
get Active Form()
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 open
veya open
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
get 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. 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
open By Id(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
open By Url(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