Katılımcının bir radyo düğmeleri dizisinden satır başına bir seçenek seçmesine olanak tanıyan, sütun ve satırlardan oluşan bir tablo olarak sunulan soru öğesi. Öğelere Form üzerinden erişilebilir veya öğeler Form üzerinden oluşturulabilir.
// Open a form by ID and add a new grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addGridItem();
item.setTitle('Rate your interests')
.setRows(['Cars', 'Computers', 'Celebrities'])
.setColumns(['Boring', 'So-so', 'Interesting']);
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
clear | Grid | Bu ızgara öğesinin tüm veri doğrulamalarını kaldırır. |
create | Item | Bu ızgara öğesi için yeni bir Item oluşturur. |
duplicate() | Grid | Bu öğenin bir kopyasını oluşturur ve formun sonuna ekler. |
get | String[] | Izgaradaki her sütunun değerlerini alır. |
get | String | Öğenin yardım metnini (Image, Page ve Section gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) alır. |
get | Integer | Öğenin benzersiz tanımlayıcısını alır. |
get | Integer | Formdaki tüm öğeler arasında öğenin dizin numarasını alır. |
get | String[] | Izgaradaki her satırın değerlerini alır. |
get | String | Öğenin başlığını (Section durumunda bazen üstbilgi metni olarak adlandırılır) alır. |
get | Item | Öğenin türünü Item olarak temsil eder. |
is | Boolean | Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler. |
set | Grid | Izgaranın sütunlarını bir değer dizisine göre ayarlar. |
set | Grid | Öğenin yardım metnini (Image, Page ve Section gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) ayarlar. |
set | Grid | Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler. |
set | Grid | Izgara satırlarını bir değer dizisine göre ayarlar. |
set | Grid | Öğenin başlığını (Section durumunda bazen üstbilgi metni olarak adlandırılır) ayarlar. |
set | Grid | Bu ızgara öğesinin veri doğrulamasını ayarlar. |
Ayrıntılı dokümanlar
clear
Bu ızgara öğesinin tüm veri doğrulamalarını kaldırır.
Return
Grid: zincirleme için bu öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
create
Bu ızgara öğesi için yeni bir Item oluşturur. responses bağımsız değişkeni, ızgaradaki satır sayısı kadar değer içeren bir String[] dizisi olmalıdır. Zorunlu olmayan bir ı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çimle eşleşmezse istisna atar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
responses | String[] | Bu ızgara öğesi için geçerli yanıtlar dizisi |
Return
Item: Öğe yanıtı
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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
Grid: zincirleme için bu Grid öğesinin kopyası
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get
Izgaradaki her sütunun değerlerini alır.
Return
String[]: Katılımcıların formu görüntülerken etiket olarak gördüğü sütun değerleri dizisi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get
Öğenin yardım metnini (Image, Page ve Section gibi düzen öğeleri için bazen 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get
Öğenin benzersiz tanımlayıcısını alır.
Return
Integer: Öğenin kimliği
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get
Formdaki tüm öğeler arasında öğenin dizin numarasını alır.
Return
Integer: Öğenin dizini
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get
Izgaradaki her satırın değerlerini alır.
Return
String[]: Katılımcıların formu görüntülerken etiket olarak gördüğü bir satır değerleri dizisi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get
Öğenin başlığını (Section durumunda bazen üstbilgi metni olarak adlandırılır) alır.
Return
String: Öğenin başlığı veya başlık metni
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get
Öğenin türünü Item olarak temsil eder.
Return
Item: Öğenin türü
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
is
Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
Return
Boolean: Katılımcının soruyu yanıtlaması gerekip gerekmediği
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set
Izgaranın sütunlarını bir değer dizisine göre ayarlar. Belirtilen dizi boşsa 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
Grid: zincirleme için bu öğe
Atışlar
Error: Belirtilen dizi null ise veya boşsa
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set
Öğenin yardım metnini (Image, Page ve Section 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
Grid: Zincirleme için bu Grid
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set
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 yanıtlaması gerekip gerekmediği |
Return
Grid: Geçerli öğe (zincirleme için)
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set
Izgara satırlarını bir değer dizisine göre ayarlar. Belirtilen dizi boşsa istisna oluşturur.
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
Grid: zincirleme için bu öğe
Atışlar
Error: Belirtilen dizi null ise veya boşsa
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set
Öğenin başlığını (Section durumunda bazen üstbilgi metni olarak adlandırılır) ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
title | String | yeni başlık veya başlık metni |
Return
Grid: Zincirleme için bu Grid
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set
Bu ızgara öğesinin veri doğrulamasını ayarlar. Hiçbir require işlevi çağrılmadan null veya bir doğrulama geçirilirse önceki doğrulamalar kaldırılır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
validation | Grid | Bu öğeye uygulanacak bir GridValidation. |
Return
Grid: Zincirleme için bu Grid
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms