Katılımcının seçmesine olanak tanıyan, sütunlardan ve satırlardan oluşan bir tablo olarak sunulan soru öğesi
birden çok seçeneği işaretleyebilirsiniz. Öğelere şuradan erişebilir veya öğe oluşturabilirsiniz:
Form
// Open a form by ID and add a new checkbox 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 veri doğrulamasını kaldırır. |
createResponse(responses) | ItemResponse | Bu onay kutusu tablo öğesi için yeni bir ItemResponse oluşturur. |
duplicate() | CheckboxGridItem | Bu öğenin bir kopyasını oluşturur ve formun sonuna ekler. |
getColumns() | String[] | Izgaradaki her sütunun değerlerini alır. |
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() | Integer | Formdaki tüm öğeler arasından öğenin dizinini alır. |
getRows() | String[] | Izgaradaki her satırın değerlerini 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. |
isRequired() | Boolean | Katılımcının soruyu cevaplaması gerekip gerekmediğini belirler. |
setColumns(columns) | CheckboxGridItem | Izgaranın sütunlarını bir değer dizisine göre ayarlar. |
setHelpText(text) | CheckboxGridItem | Öğenin yardım metnini ayarlar (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni de denir). |
setRequired(enabled) | CheckboxGridItem | Katılımcının soruyu yanıtlaması 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 özelliğinde bazen başlık metni olarak da adlandırılır). |
setValidation(validation) | CheckboxGridItem | Bu onay kutusu tablo öğesi için veri doğrulamasını ayarlar. |
Ayrıntılı belgeler
clearValidation()
Bu tablo öğesi için veri doğrulamasını kaldırır.
Return
CheckboxGridItem — bu öğe, zincirleme kullanım 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
createResponse(responses)
Bu onay kutusu tablo öğesi için yeni bir ItemResponse oluşturur. responses bağımsız değişkeni
giriş sayısı kadar değer içeren String[][] dizi dizisi olmalıdır
"Tamam" düğmesini tıklayın. Zorunlu olmayan bir onay kutusu ızgara sorusu için null öğesi
söz konusu satır için yanıt olmadığını gösterir. Değerlerden herhangi biri
geçerli bir seçimdir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
responses | String[][] | Bu onay kutusu tablo öğesi için geçerli cevaplardan oluşan bir dizi |
Return
ItemResponse - öğe yanıtı
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
duplicate()
Bu öğenin bir kopyasını oluşturur ve formun sonuna ekler.
Return
CheckboxGridItem — zincirleme için bu CheckboxGridItem öğ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
getColumns()
Izgaradaki 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 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
getRows()
Izgaradaki her satırın değerlerini alır.
Return
String[] - Katılımcıların formu görüntülerken etiketler olarak gördüğü satır değerleri dizisi
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
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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setColumns(columns)
Izgaranın sütunlarını bir değer dizisine göre ayarlar. Verilen dizi boş.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
columns | String[] | katılımcıların formu görüntülerken etiket olarak gördüğü bir sütun değerleri dizisi |
Return
CheckboxGridItem — bu öğe, zincirleme kullanım için
Fırlatma
Error: Belirtilen dizi null veya boşsa
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
| 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 kapsamlardan bir 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 yanıtlaması gerekip gerekmediğini belirler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
enabled | Boolean | katılımcının soruyu cevaplaması gerekip gerekmediğini |
Return
CheckboxGridItem — geçerli öğe (zincirleme 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
setRows(rows)
Izgaranın satırlarını bir değer dizisine göre ayarlar. Verilen diziyse bir istisna atar boştur.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
rows | String[] | katılımcıların formu görüntülerken etiket olarak gördüğü bir satır değerleri dizisi |
Return
CheckboxGridItem — bu öğe, zincirleme kullanım için
Fırlatma
Error: Belirtilen dizi null veya boşsa
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
| 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setValidation(validation)
Bu onay kutusu tablo öğesi için veri doğrulamasını ayarlar. Boş veya geçersiz bir doğrulama çağrıldığında, önceki doğrulamalar kaldırılır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
validation | CheckboxGridValidation | Bu öğeye uygulanacak bir CheckboxGridValidation değeri. |
Return
CheckboxGridItem — bu CheckboxGridItem, 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