Interface Item

Öğe

Başlık ve yardım metni gibi tüm öğelere ortak özellikleri içeren genel bir form öğesi. Öğelere Form'ten erişilebilir veya bu klasörden öğe oluşturulabilir.

Türe özgü özelliklerde işlem yapmak için öğenin ItemType değerini kontrol etmek üzere getType()'ü kullanın, ardından asCheckboxItem() gibi bir yöntem kullanarak öğeyi uygun sınıfa yayınlayın. 

// Create a new form and add a text item.
const form = FormApp.create('Form Name');
form.addTextItem();

// Access the text item as a generic item.
const items = form.getItems();
const item = items[0];

// Cast the generic item to the text-item class.
if (item.getType() === 'TEXT') {
  const textItem = item.asTextItem();
  textItem.setRequired(false);
}

Sınıfları uygulama

AdKısa açıklama

Yöntemler

YöntemDönüş türüKısa açıklama
asCheckboxGridItem()CheckboxGridItemÖğeyi onay kutusu ızgara öğesi olarak döndürür.
asCheckboxItem()CheckboxItemÖğeyi onay kutusu öğesi olarak döndürür.
asDateItem()DateItemÖğeyi tarih öğesi olarak döndürür.
asDateTimeItem()DateTimeItemÖğeyi tarih-saat öğesi olarak döndürür.
asDurationItem()DurationItemÖğeyi süre öğesi olarak döndürür.
asGridItem()GridItemÖğeyi ızgara öğesi olarak döndürür.
asImageItem()ImageItemÖğeyi resim öğesi olarak döndürür.
asListItem()ListItemÖğeyi liste öğesi olarak döndürür.
asMultipleChoiceItem()MultipleChoiceItemÖğeyi çoktan seçmeli öğe olarak döndürür.
asPageBreakItem()PageBreakItemÖğeyi sayfa sonu öğesi olarak döndürür.
asParagraphTextItem()ParagraphTextItemÖğeyi paragraf metni öğesi olarak döndürür.
asRatingItem()RatingItemÖğeyi puan öğesi olarak döndürür.
asScaleItem()ScaleItemÖğeyi ölçek öğesi olarak döndürür.
asSectionHeaderItem()SectionHeaderItemÖğeyi bölüm başlığı öğesi olarak döndürür.
asTextItem()TextItemÖğeyi metin öğesi olarak döndürür.
asTimeItem()TimeItemÖğeyi saat öğesi olarak döndürür.
asVideoItem()VideoItemÖğeyi video öğesi olarak döndürür.
duplicate()ItemBu öğenin bir kopyasını oluşturur ve formun sonuna ekler.
getHelpText()StringÖğenin yardım metnini (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) alır.
getId()IntegerÖğenin benzersiz tanımlayıcısını alır.
getIndex()IntegerFormdaki tüm öğeler arasında öğenin dizin numarasını alır.
getTitle()StringÖğenin başlığını (SectionHeaderItem durumunda bazen üstbilgi metni olarak adlandırılır) alır.
getType()ItemTypeÖğenin türünü ItemType olarak temsil eder.
setHelpText(text)ItemÖğenin yardım metnini (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) ayarlar.
setTitle(title)ItemÖğenin başlığını (SectionHeaderItem durumunda bazen üstbilgi metni olarak adlandırılır) ayarlar.

Ayrıntılı dokümanlar

asCheckboxGridItem()

Öğeyi onay kutusu ızgara öğesi olarak döndürür. ItemType henüz CHECKBOX_GRID değilse komut dosyası istisnası oluşturur.

Return

CheckboxGridItem: onay kutusu tablosu öğesi

Atışlar

Error: Öğe onay kutusu ızgara öğesi değilse

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

asCheckboxItem()

Öğeyi onay kutusu öğesi olarak döndürür. ItemType henüz CHECKBOX değilse komut dosyası istisnası oluşturur.

Return

CheckboxItem: onay kutusu öğesi

Atışlar

Error: Öğe onay kutusu öğesi değilse

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

asDateItem()

Öğeyi tarih öğesi olarak döndürür. ItemType henüz DATE değilse komut dosyası istisnası oluşturur.

Return

DateItem: tarih öğesi

Atışlar

Error: Öğe tarih öğesi değilse

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

asDateTimeItem()

Öğeyi tarih-saat öğesi olarak döndürür. ItemType henüz DATETIME değilse komut dosyası istisnası oluşturur.

Return

DateTimeItem: tarih/saat öğesi

Atışlar

Error: Öğe tarih/saat öğesi değilse

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

asDurationItem()

Öğeyi süre öğesi olarak döndürür. ItemType henüz DURATION değilse komut dosyası istisnası oluşturur.

Return

DurationItem: Süre öğesi

Atışlar

Error: Öğe bir süre öğesi değilse

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

asGridItem()

Öğeyi ızgara öğesi olarak döndürür. ItemType henüz GRID değilse komut dosyası istisnası oluşturur.

Return

GridItem: ızgara öğesi

Atışlar

Error: Öğe bir ızgara öğesi değilse

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

asImageItem()

Öğeyi resim öğesi olarak döndürür. ItemType henüz IMAGE değilse komut dosyası istisnası oluşturur.

Return

ImageItem: resim öğesi

Atışlar

Error: Öğe resim öğesi değilse

asListItem()

Öğeyi liste öğesi olarak döndürür. ItemType henüz LIST değilse komut dosyası istisnası oluşturur.

Return

ListItem: liste öğesi

Atışlar

Error: Öğe liste öğesi değilse

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

asMultipleChoiceItem()

Öğeyi çoktan seçmeli öğe olarak döndürür. ItemType henüz MULTIPLE_CHOICE değilse komut dosyası istisnası oluşturur.

Return

MultipleChoiceItem: Çoktan seçmeli öğe

Atışlar

Error: Öğe çoktan seçmeli bir öğe değilse

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

asPageBreakItem()

Öğeyi sayfa sonu öğesi olarak döndürür. ItemType henüz PAGE_BREAK değilse komut dosyası istisnası oluşturur.

Return

PageBreakItem: sayfa sonu öğesi

Atışlar

Error: Öğe sayfa sonu öğesi değilse

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

asParagraphTextItem()

Öğeyi paragraf metni öğesi olarak döndürür. ItemType henüz PARAGRAPH_TEXT değilse komut dosyası istisnası oluşturur.

Return

ParagraphTextItem: paragraf metni öğesi

Atışlar

Error: Öğe paragraf metni öğesi değilse

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

asRatingItem()

Öğeyi puan öğesi olarak döndürür. ItemType henüz RATING değilse ScriptingException atar. 

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Fetch any item which is of type rating.
const item = form.getItems(FormApp.ItemType.RATING)[0];

// Convert the item to a rating item.
const ratingItem = item.asRatingItem();

Return

RatingItem: Derecelendirme öğesi.

Atışlar

Error: Öğe bir derecelendirme öğesi değilse

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

asScaleItem()

Öğeyi ölçek öğesi olarak döndürür. ItemType henüz SCALE değilse komut dosyası istisnası oluşturur.

Return

ScaleItem: Ölçek öğesi

Atışlar

Error: Öğe ölçek öğesi değilse

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

asSectionHeaderItem()

Öğeyi bölüm başlığı öğesi olarak döndürür. ItemType henüz SECTION_HEADER değilse komut dosyası istisnası oluşturur.

Return

SectionHeaderItem: bölüm başlığı öğesi

Atışlar

Error: Öğe bir bölüm başlığı öğesi değilse

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

asTextItem()

Öğeyi metin öğesi olarak döndürür. ItemType henüz TEXT değilse komut dosyası istisnası oluşturur.

Return

TextItem: metin öğesi

Atışlar

Error: Öğe metin öğesi değilse

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

asTimeItem()

Öğeyi saat öğesi olarak döndürür. ItemType henüz TIME değilse komut dosyası istisnası oluşturur.

Return

TimeItem: Zaman öğesi

Atışlar

Error: Öğe bir zaman öğesi değilse

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

asVideoItem()

Öğeyi video öğesi olarak döndürür. ItemType henüz VIDEO değilse komut dosyası istisnası oluşturur.

Return

VideoItem: video öğesi

Atışlar

Error: Öğe video öğesi değilse

duplicate()

Bu öğenin bir kopyasını oluşturur ve formun sonuna ekler.

Return

Item: zincirleme için bu Item öğesinin kopyası

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

getHelpText()

Öğenin yardım metnini (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) alır.

Return

String: Öğenin yardım metni veya açıklama metni

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

getId()

Öğenin benzersiz tanımlayıcısını alır.

Return

Integer: Öğenin kimliği

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

getIndex()

Formdaki tüm öğeler arasında öğenin dizin numarasını alır.

Return

Integer: Öğenin dizini

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

getTitle()

Öğenin başlığını (SectionHeaderItem durumunda bazen üstbilgi metni olarak adlandırılır) alır.

Return

String: Öğenin başlığı veya başlık metni

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

getType()

Öğenin türünü ItemType olarak temsil eder.

Return

ItemType: Öğenin türü

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

setHelpText(text)

Öğenin yardım metnini (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) ayarlar.

Parametreler

AdTürAçıklama
textStringyeni yardım metni

Return

Item: Zincirleme için bu Item

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

setTitle(title)

Öğenin başlığını (SectionHeaderItem durumunda bazen üstbilgi metni olarak adlandırılır) ayarlar.

Parametreler

AdTürAçıklama
titleStringyeni başlık veya başlık metni

Return

Item: Zincirleme için bu Item

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