Interface Item

Öğe

Tüm öğelerde ortak olan özellikleri (başlık ve yardım metni gibi) içeren genel bir form öğesi. Öğelere Form ile erişilebilir veya öğe oluşturulabilir.

Türe özgü özellikler üzerinde çalışmak için öğenin ItemType özelliğini kontrol etmek üzere getType() kullanın, ardından asCheckboxItem() gibi bir yöntemle öğeyi uygun sınıfa yayınlayın. 

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

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

// Cast the generic item to the text-item class.
if (item.getType() == 'TEXT') {
  var 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 tablo öğ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 bir süre öğesi olarak döndürür.
asGridItem()GridItemÖğeyi tablo öğesi olarak döndürür.
asImageItem()ImageItemÖğeyi bir 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 bir paragraf metni öğesi olarak döndürür.
asScaleItem()ScaleItemÖğeyi bir ö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 zaman öğ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 bunu formun sonuna ekler.
getHelpText()StringÖğenin yardım metnini alır (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır).
getId()IntegerÖğenin benzersiz tanımlayıcısını alır.
getIndex()IntegerFormdaki tüm öğeler arasında öğenin dizinini alır.
getTitle()StringÖğenin başlığını alır (SectionHeaderItem durumunda başlık metni de denir).
getType()ItemTypeÖğenin türünü alır (ItemType ile gösterilir).
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ı ayarlar (SectionHeaderItem durumunda başlık metni de denir).

Ayrıntılı belgeler

asCheckboxGridItem()

Öğeyi onay kutusu tablo öğesi olarak döndürür. ItemType zaten CHECKBOX_GRID değilse komut dosyası istisnası atar.

Return

CheckboxGridItem — onay kutusu ızgara öğesi

Dekoratif yastıklar

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

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

asCheckboxItem()

Öğeyi onay kutusu öğesi olarak döndürür. ItemType zaten CHECKBOX değilse komut dosyası istisnası atar.

Return

CheckboxItem — onay kutusu öğesi

Dekoratif yastıklar

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

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

asDateItem()

Öğeyi tarih öğesi olarak döndürür. ItemType zaten DATE değilse komut dosyası istisnası atar.

Return

DateItem — tarih öğesi

Dekoratif yastıklar

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

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

asDateTimeItem()

Öğeyi tarih-saat öğesi olarak döndürür. ItemType zaten DATETIME değilse komut dosyası istisnası atar.

Return

DateTimeItem — tarih ve saat öğesi

Dekoratif yastıklar

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

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

asDurationItem()

Öğeyi bir süre öğesi olarak döndürür. ItemType zaten DURATION değilse komut dosyası istisnası atar.

Return

DurationItem — süre öğesi

Dekoratif yastıklar

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

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

asGridItem()

Öğeyi tablo öğesi olarak döndürür. ItemType zaten GRID değilse komut dosyası istisnası atar.

Return

GridItem - ızgara öğesi

Dekoratif yastıklar

Error: Öğe, tablo öğesi değilse

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

asImageItem()

Öğeyi bir resim öğesi olarak döndürür. ItemType zaten IMAGE değilse komut dosyası istisnası atar.

Return

ImageItem — resim öğesi

Dekoratif yastıklar

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

asListItem()

Öğeyi liste öğesi olarak döndürür. ItemType zaten LIST değilse komut dosyası istisnası atar.

Return

ListItem - liste öğesi

Dekoratif yastıklar

Error - Öğe bir liste öğesi değilse

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

asMultipleChoiceItem()

Öğeyi çoktan seçmeli öğe olarak döndürür. ItemType zaten MULTIPLE_CHOICE değilse komut dosyası istisnası atar.

Return

MultipleChoiceItem: çoktan seçmeli öğe

Dekoratif yastıklar

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

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

asPageBreakItem()

Öğeyi sayfa sonu öğesi olarak döndürür. ItemType zaten PAGE_BREAK değilse komut dosyası istisnası atar.

Return

PageBreakItem - sayfa sonu öğesi

Dekoratif yastıklar

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

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

asParagraphTextItem()

Öğeyi bir paragraf metni öğesi olarak döndürür. ItemType zaten PARAGRAPH_TEXT değilse komut dosyası istisnası atar.

Return

ParagraphTextItem — paragraf metni öğesi

Dekoratif yastıklar

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

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

asScaleItem()

Öğeyi bir ölçek öğesi olarak döndürür. ItemType zaten SCALE değilse komut dosyası istisnası atar.

Return

ScaleItem: ölçek öğesi

Dekoratif yastıklar

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

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

asSectionHeaderItem()

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

Return

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

Dekoratif yastıklar

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

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

asTextItem()

Öğeyi metin öğesi olarak döndürür. ItemType zaten TEXT değilse komut dosyası istisnası atar.

Return

TextItem - metin öğesi

Dekoratif yastıklar

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

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

asTimeItem()

Öğeyi zaman öğesi olarak döndürür. ItemType zaten TIME değilse komut dosyası istisnası atar.

Return

TimeItem - zaman öğesi

Dekoratif yastıklar

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

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

asVideoItem()

Öğeyi video öğesi olarak döndürür. ItemType zaten VIDEO değilse komut dosyası istisnası atar.

Return

VideoItem - video öğesi

Dekoratif yastıklar

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

duplicate()

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

Return

Item — zincirleme bağlantı için bu Item öğesinin kopyası

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

getHelpText()

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

Return

String — öğenin yardım metni veya açıklama metni

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

getId()

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

Return

Integer - öğenin kimliği

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

getIndex()

Formdaki tüm öğeler arasında öğenin dizinini alır.

Return

Integer - öğenin dizini

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

getTitle()

Öğenin başlığını alır (SectionHeaderItem durumunda başlık metni de denir).

Return

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

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

getType()

Öğenin türünü alır (ItemType ile gösterilir).

Return

ItemType - öğenin türü

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

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 — bu Item, zincirleme bağlantı için

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

setTitle(title)

Öğenin başlığını ayarlar (SectionHeaderItem durumunda başlık metni de denir).

Parametreler

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

Return

Item — bu Item, zincirleme bağlantı için

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