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şilebilir veya öğeler oluşturulabilir.

Türe özgü özellikler üzerinde işlem yapmak 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.
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 ızgarası öğ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 bir ı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 derecelendirme öğ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 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 (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için 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 dizinini alır.
getTitle()StringÖğenin başlığını alır (bazen SectionHeaderItem durumunda üstbilgi metni olarak adlandırılır).
getType()ItemTypeÖğenin türünü ItemType olarak alır.
setHelpText(text)ItemÖğenin yardım metnini (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni olarak da adlandırılır) ayarlar.
setTitle(title)ItemÖğenin başlığını ayarlar (bazen SectionHeaderItem durumunda başlık metni olarak adlandırılır).

Ayrıntılı belgeler

asCheckboxGridItem()

Öğeyi onay kutusu ızgarası öğesi olarak döndürür. ItemType daha önce CHECKBOX_GRID değilse komut dosyası oluşturma istisnası oluşturur.

Return

CheckboxGridItem: Onay kutusu tablosu öğesi

Verdiği hatalar

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

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

asCheckboxItem()

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

Return

CheckboxItem: Onay kutusu öğesi

Verdiği hatalar

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

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

asDateItem()

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

Return

DateItem: Tarih öğesi

Verdiği hatalar

Error: Öğenin tarih öğesi olmaması durumunda

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

asDateTimeItem()

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

Return

DateTimeItem: Tarih/saat öğesi

Verdiği hatalar

Error: Öğenin tarih-saat öğesi olmaması durumunda

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

asDurationItem()

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

Return

DurationItem: Süre öğesi

Verdiği hatalar

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

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

asGridItem()

Öğeyi bir ızgara öğesi olarak döndürür. ItemType daha önce GRID değilse komut dosyası oluşturma istisnası oluşturur.

Return

GridItem: Izgara öğesi

Verdiği hatalar

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

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

asImageItem()

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

Return

ImageItem: Resim öğesi

Verdiği hatalar

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

asListItem()

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

Return

ListItem: Liste öğesi

Verdiği hatalar

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

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

asMultipleChoiceItem()

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

Return

MultipleChoiceItem: Çoktan seçmeli öğe

Verdiği hatalar

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

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

asPageBreakItem()

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

Return

PageBreakItem: Sayfa sonu öğesi

Verdiği hatalar

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

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

asParagraphTextItem()

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

Return

ParagraphTextItem: Paragraf metni öğesi

Verdiği hatalar

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

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

asRatingItem()

Öğeyi derecelendirme öğesi olarak döndürür. ItemType daha önce RATING değilse ScriptingException oluşturur. 

// 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.

Verdiği hatalar

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

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

asScaleItem()

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

Return

ScaleItem: Ölçek öğesi

Verdiği hatalar

Error: Öğenin ölçek öğesi olmaması durumunda

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

asSectionHeaderItem()

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

Return

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

Verdiği hatalar

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

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

asTextItem()

Öğeyi metin öğesi olarak döndürür. ItemType daha önce TEXT değilse bir komut dosyası oluşturma istisnası oluşturur.

Return

TextItem: Metin öğesi

Verdiği hatalar

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

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

asTimeItem()

Öğeyi zaman öğesi olarak döndürür. ItemType daha önce TIME değilse bir komut dosyası oluşturma istisnası oluşturur.

Return

TimeItem: Zaman öğesi

Verdiği hatalar

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

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

asVideoItem()

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

Return

VideoItem: Video öğesi

Verdiği hatalar

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ı, aşağıdaki kapsamlardan 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 (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için 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ı, aşağıdaki kapsamlardan 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 kapsamlardan 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 kapsamlardan 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 (bazen SectionHeaderItem durumunda üstbilgi metni olarak 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 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ü ItemType olarak alır.

Return

ItemType: Öğenin türü

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

setHelpText(text)

Öğenin yardım metnini (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için 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ı, aşağıdaki kapsamlardan 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 (bazen SectionHeaderItem durumunda başlık metni olarak adlandırılır).

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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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