Interface Item

Öğe

Başlık ve yardım metni gibi tüm öğelerde ortak olan özellikleri içeren genel bir form öğesi. Öğelere Form üzerinden erişebilir veya öğe oluşturabilirsiniz.

Türe özgü özelliklerde çalışmak için öğenin ItemType özelliğini kontrol etmek üzere getType() işlevini kullanın, ardından öğeyi asCheckboxItem() gibi bir yöntem kullanarak uygun bir sınıfı bulun. 

// 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 bir 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 tablo öğ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 olarak döndürür.
asScaleItem()ScaleItemÖğeyi ölçek öğesi olarak döndürür.
asSectionHeaderItem()SectionHeaderItemÖğeyi bir 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 formun sonuna ekler.
getHelpText()StringÖğenin yardım metnini alır (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için 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ından öğenin dizinini alır.
getTitle()StringÖğenin başlığını alır (SectionHeaderItem olması halinde bazen üstbilgi metni olarak da adlandırılır).
getType()ItemTypeÖğenin ItemType ile gösterilen türünü alır.
setHelpText(text)ItemÖğenin yardım metnini ayarlar (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni de denir).
setTitle(title)ItemÖğenin başlığını ayarlar (SectionHeaderItem özelliğinde bazen başlık metni olarak da adlandırılır).

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 tablo öğesi

Fırlatma

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

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

asCheckboxItem()

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

Return

CheckboxItem — onay kutusu öğesi

Fırlatma

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

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

asDateItem()

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

Return

DateItem — tarih öğesi

Fırlatma

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

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

asDateTimeItem()

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

Return

DateTimeItem — tarih-saat öğesi

Fırlatma

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

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

asDurationItem()

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

Return

DurationItem — süre öğesi

Fırlatma

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

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

asGridItem()

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

Return

GridItem — ızgara öğesi

Fırlatma

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

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

asImageItem()

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

Return

ImageItem — resim öğesi

Fırlatma

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

Fırlatma

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

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

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

Fırlatma

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

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

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

Fırlatma

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

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

asParagraphTextItem()

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

Return

ParagraphTextItem — paragraf metni öğesi

Fırlatma

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

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

asScaleItem()

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

Return

ScaleItem — ölçek öğesi

Fırlatma

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

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

asSectionHeaderItem()

Öğeyi bir 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

Fırlatma

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

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

asTextItem()

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

Return

TextItem — metin öğesi

Fırlatma

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

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

asTimeItem()

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

Return

TimeItem — zaman öğesi

Fırlatma

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

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

asVideoItem()

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

Return

VideoItem: video öğesi

Fırlatma

Error: Öğe bir 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ı, aşağıdaki kapsamlardan bir 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 (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için 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 kapsamlardan bir 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 kapsamlardan bir 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ından öğenin dizinini alır.

Return

Integer — öğenin dizini

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

getTitle()

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

Return

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

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

getType()

Öğenin ItemType ile gösterilen türünü alır.

Return

ItemType: Öğenin türü

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

setHelpText(text)

Öğenin yardım metnini ayarlar (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni de denir).

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 kapsamlardan bir 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 özelliğinde bazen başlık metni olarak da adlandırılır).

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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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