Class FormApp

FormUygulama

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ülkTürAçıklama
AlignmentAlignmentResim hizalama türlerinin listesi.
DestinationTypeDestinationTypeForm yanıtlarını depolayabilecek hedef türlerinin bir listesi.
FeedbackTypeFeedbackTypeFeedbacks formu türlerinin bir listesi.
ItemTypeItemTypeItems formu türlerinin bir 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şturup döndürür.
createCheckboxGridValidation()CheckboxGridValidationBuilderCheckboxGridItem üzerinde doğrulama ayarlamak için kullanılabilecek bir CheckboxGridValidationBuilder örneği döndürür.
createCheckboxValidation()CheckboxValidationBuilderCheckboxItem üzerinde doğrulama ayarlamak için kullanılabilecek bir CheckboxValidationBuilder örneği döndürür.
createFeedback()QuizFeedbackBuilderNot verilebilir bir Item hakkında geri bildirim ayarlamak için kullanılabilecek bir QuizFeedbackBuilder örneği döndürür.
createGridValidation()GridValidationBuilderGridItem üzerinde doğrulama ayarlamak için kullanılabilecek bir GridValidationBuilder örneği döndürür.
createParagraphTextValidation()ParagraphTextValidationBuilderParagraphTextItem üzerinde doğrulama ayarlamak için kullanılabilecek bir ParagraphTextValidationBuilder örneği döndürür.
createTextValidation()TextValidationBuilderTextItem üzerinde doğrulama ayarlamak için kullanılabilecek bir TextValidationBuilder örneği döndürür.
getActiveForm()FormKomut dosyasının kapsayıcıya bağlı olduğu formu döndürür.
getUi()UiKomut 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)FormBelirtilen kimliğe sahip Form öğesini döndürür.
openByUrl(url)FormBelirtilen 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

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

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

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