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
Ad | Kısa açıklama |
---|
Yöntemler
Yöntem | Dö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() | Item | Bu öğ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() | Integer | Formdaki 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()
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()
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
Ad | Tür | Açıklama |
---|---|---|
text | String | yeni 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
Ad | Tür | Açıklama |
---|---|---|
title | String | yeni 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