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
createCheckboxValidation()
CheckboxItem
üzerinde doğrulamayı ayarlamak için kullanılabilecek bir CheckboxValidationBuilder örneği döndürür.
Return
createFeedback()
Not verilebilir bir Item
ile ilgili geri bildirim ayarlamak için kullanılabilecek QuizfeedbackBuilder örneğini döndürür.
Return
createGridValidation()
GridItem
üzerinde doğrulamayı ayarlamak için kullanılabilecek bir GridValidationBuilder örneğini döndürür.
Return
createParagraphTextValidation()
ParagraphTextItem
üzerinde doğrulamayı ayarlamak için kullanılabilecek bir ParagraphTextValidationBuilder örneğini döndürür.
Return
createTextValidation()
TextItem
üzerinde doğrulamayı ayarlamak için kullanılabilecek bir TextValidationBuilder örneğini döndürür.
Return
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