Soru öğesi; yanıt verenin bir dizi onay kutusu arasından satır başına birden çok seçenek belirlemesini sağlayan, sütunlardan ve satırlardan oluşan bir ızgara şeklinde sunulur. Öğelere Form
aracılığıyla erişilebilir veya öğe oluşturulabilir.
// Open a form by ID and add a new checkgox grid item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxGridItem(); item.setTitle('Where did you celebrate New Years?') .setRows(['New York', 'San Francisco', 'London']) .setColumns(['2014', '2015', '2016', '2017']);
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
clearValidation() | CheckboxGridItem | Bu tablo öğesi için tüm veri doğrulamalarını kaldırır. |
createResponse(responses) | ItemResponse | Bu onay kutusu ızgara öğesi için yeni bir ItemResponse oluşturur. |
duplicate() | CheckboxGridItem | Bu öğenin bir kopyasını oluşturur ve bunu formun sonuna ekler. |
getColumns() | String[] | Tablodaki her sütunun değerlerini alır. |
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. |
getRows() | String[] | Tablodaki her satır için değerleri 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). |
isRequired() | Boolean | Katılımcının soruyu cevaplaması gerekip gerekmediğini belirler. |
setColumns(columns) | CheckboxGridItem | Izgara sütunlarını bir değer dizisine göre ayarlar. |
setHelpText(text) | CheckboxGridItem | Öğ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. |
setRequired(enabled) | CheckboxGridItem | Katılımcının soruyu cevaplaması gerekip gerekmediğini belirler. |
setRows(rows) | CheckboxGridItem | Izgaranın satırlarını bir değer dizisine göre ayarlar. |
setTitle(title) | CheckboxGridItem | Öğenin başlığını ayarlar (SectionHeaderItem durumunda başlık metni de denir). |
setValidation(validation) | CheckboxGridItem | Bu onay kutusu ızgara öğesi için veri doğrulamasını ayarlar. |
Ayrıntılı belgeler
clearValidation()
Bu tablo öğesi için tüm veri doğrulamalarını kaldırır.
Return
CheckboxGridItem
— bu öğe (Zincirleme 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
createResponse(responses)
Bu onay kutusu ızgara öğesi için yeni bir ItemResponse
oluşturur. responses
bağımsız değişkeni, onay kutusu tablosundaki giriş sayısı kadar değer içeren String[][]
dizi dizisi olmalıdır. Zorunlu olmayan bir onay kutusu ızgara sorusu için null
öğesi, bu satıra yanıt verilmediğini gösterir. Değerlerden herhangi biri geçerli bir seçimle eşleşmiyorsa istisna oluşturur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
responses | String[][] | bu onay kutusu ızgara öğesi için geçerli yanıt dizileri dizisi |
Return
ItemResponse
: Öğe yanıtı
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
duplicate()
Bu öğenin bir kopyasını oluşturur ve bunu formun sonuna ekler.
Return
CheckboxGridItem
— zincirleme bağlantı için bu CheckboxGridItem
öğ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
getColumns()
Tablodaki her sütunun değerlerini alır.
Return
String[]
: Katılımcıların formu görüntülerken etiket olarak gördüğü bir sütun değerleri dizisi
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
getRows()
Tablodaki her satır için değerleri alır.
Return
String[]
- Katılımcıların formu görüntülerken etiket olarak gördüğü satır değerleri dizisi
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
isRequired()
Katılımcının soruyu cevaplaması gerekip gerekmediğini belirler.
Return
Boolean
- Katılımcının soruyu yanıtlaması gerekip gerekmediğ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
setColumns(columns)
Izgara sütunlarını bir değer dizisine göre ayarlar. Belirtilen dizi boşsa bir istisna oluşturur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columns | String[] | Katılımcıların formu görüntülerken etiket olarak gördüğü sütun değerleri dizisi |
Return
CheckboxGridItem
— bu öğe (Zincirleme için)
Dekoratif yastıklar
Error
- belirtilen dizi null
veya boşsa
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
CheckboxGridItem
— bu CheckboxGridItem
, 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
setRequired(enabled)
Katılımcının soruyu cevaplaması gerekip gerekmediğini belirler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
enabled | Boolean | katılımcının soruyu cevaplaması gerekip gerekmediği |
Return
CheckboxGridItem
- geçerli öğe (zincirleme 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
setRows(rows)
Izgaranın satırlarını bir değer dizisine göre ayarlar. Belirtilen dizi boşsa bir istisna atar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rows | String[] | Katılımcıların formu görüntülerken etiket olarak gördüğü satır değerleri dizisi |
Return
CheckboxGridItem
— bu öğe (Zincirleme için)
Dekoratif yastıklar
Error
- belirtilen dizi null
veya boşsa
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
CheckboxGridItem
— bu CheckboxGridItem
, 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
setValidation(validation)
Bu onay kutusu ızgara öğesi için veri doğrulamasını ayarlar. Herhangi bir zorunlu işlev çağrılmadığı sürece null değerinin veya doğrulamanın iletilmesi, önceki doğrulamaları kaldırır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
validation | CheckboxGridValidation | Bu öğeye uygulanacak bir CheckboxGridValidation. |
Return
CheckboxGridItem
— bu CheckboxGridItem
, 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