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

ÖzellikTürAçıklama
AlignmentAlignmentResim hizalama türlerinin listesi.
DestinationTypeDestinationTypeForm yanıtlarını depolayabilen hedef türlerinin listesi.
FeedbackTypeFeedbackTypeFeedbacks form türlerinin listesi.
ItemTypeItemTypeItems form türlerinin listesi.
PageNavigationTypePageNavigationTypeSayfalarda gezinmeyle ilgili olası davranışların listesi.

Yöntemler

YöntemDönüş türüKısa açıklama
create(title)FormYeni bir Form oluşturur ve döndürür.
createCheckboxGridValidation()CheckboxGridValidationBuilder CheckboxGridItem
createCheckboxValidation()CheckboxValidationBuilder CheckboxItem
createFeedback()QuizFeedbackBuilderNotlandırılabilir bir öğede geri bildirim ayarlamak için kullanılabilecek bir QuizFeedbackBuilder örneğini döndürür Item
createGridValidation()GridValidationBuilderGridItem üzerinde doğrulamayı ayarlamak için kullanılabilecek bir GridValidationBuilder örneği döndürür.
createParagraphTextValidation()ParagraphTextValidationBuilder ParagraphTextItem.
createTextValidation()TextValidationBuilderTextItem üzerinde doğrulamayı ayarlamak için kullanılabilecek bir TextValidationBuilder örneğini döndürür.
getActiveForm()FormKomut dosyasının kapsayıcıya bağlı olduğu formu döndürür.
getUi()UiForm 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)FormBelirtilen kimliğe sahip Form değerini döndürür.
openByUrl(url)FormBelirtilen 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

AdTürAçıklama
titleStringyeni 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()

createCheckboxValidation()

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()

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

AdTürAçıklama
idStringaçı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

AdTürAçıklama
urlStringaçı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