Class FormApp

FormApp

Bir 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 numaralandırılması.
DestinationTypeDestinationTypeForm yanıtlarını depolayabilecek hedef türlerinin numaralandırılması.
FeedbackTypeFeedbackTypeFeedbacks biçim türlerinin numaralandırılması.
ItemTypeItemTypeItems biçim türlerinin numaralandırılması.
PageNavigationTypePageNavigationTypeSayfalarda gezinmek için olası davranışların numaralandırılması.
RatingIconTypeRatingIconTypePuan simgesi türlerinin numaralandırılması RatingIcons

Yöntemler

YöntemDönüş türüKısa açıklama
create(title)FormYeni bir Form oluşturur ve döndürür.
create(title, isPublished)Formİstenen yayınlama durumunda yeni bir Form oluşturur ve 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 verilebilen 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()UiForm düzenleyicinin, komut dosyasına menüler, iletişim kutuları ve kenar çubukları gibi özellikler eklemesine olanak tanıyan kullanıcı arayüzü ortamının bir örneğini döndürür.
openById(id)FormBelirtilen kimliğe sahip Form değerini döndürür.
openByUrl(url)FormBelirtilen URL'ye sahip Form öğesini 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.
const form = FormApp.create('Form Name');

Parametreler

AdTürAçıklama
titleStringYeni formun adı.

Return

Form: Yeni form.

Verdiği hatalar

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

Yetkilendirme

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

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

create(title, isPublished)

İstenen yayınlama durumunda yeni bir Form oluşturur ve döndürür. Belirtilen başlık null veya boşsa istisna oluşturur. 

// Create, publish and open a form.
const form = FormApp.create('Form Name', true);

Parametreler

AdTürAçıklama
titleStringYeni formun adı.
isPublishedBooleanFormun yayınlanıp yayınlanmayacağı.

Return

Form: Yeni form.

Verdiği hatalar

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

Yetkilendirme

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

  • 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 verilebilen 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ı, aşağıdaki kapsamlardan 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ına menüler, iletişim kutuları ve kenar çubukları gibi özellikler eklemesine olanak tanıyan kullanıcı arayüzü ortamının bir örneğini döndürür. Bir komut dosyası yalnızca açık bir form düzenleyicinin mevcut örneğinin kullanıcı arayüzüyle (yanıtlayanın gördüğü görünüm değil) ve yalnızca komut dosyası forma bağlıysa etkileşimde bulunabilir. Daha fazla bilgi için menüler ve iletişim kutuları ve kenar çubukları ile ilgili kılavuzlara 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 istisna oluşturur. 

// Open a form by ID.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

Parametreler

AdTürAçıklama
idStringAçılacak formun kimliği

Return

Form: Belirli kimliğe sahip form

Verdiği hatalar

Error: Belirtilen kimlik geçersizse veya kullanıcının yeterli izni yoksa

Yetkilendirme

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

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

openByUrl(url)

Belirtilen URL'ye sahip Form öğesini 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.
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

Verdiği hatalar

Error: Belirtilen URL geçersizse veya kullanıcının yeterli izni yoksa

Yetkilendirme

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

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